WIP. Add stereonet module for plotting structural geology stereonets (Schmidt/Wulff)

doc/rst/source/modules-classic.rst

@@ -173,6 +173,7 @@ All modules are requested via a call to the :doc:`gmt` program.
     supplements/spotter/polespotter
     supplements/spotter/rotconverter
     supplements/spotter/rotsmoother
+    supplements/stereonet/psstereonet
     supplements/windbarbs/psbarb
     supplements/windbarbs/grdbarb
     supplements/x2sys/x2sys_binlist
@@ -344,6 +345,7 @@ Supplemental Modules
     - :doc:`/supplements/spotter/polespotter`
     - :doc:`/supplements/spotter/rotconverter`
     - :doc:`/supplements/spotter/rotsmoother`
+    - :doc:`/supplements/stereonet/psstereonet`
     - :doc:`/supplements/windbarbs/grdbarb`
     - :doc:`/supplements/windbarbs/psbarb`
     - :doc:`/supplements/x2sys/x2sys_binlist`
@@ -762,6 +764,13 @@ spotter
 | :doc:`/supplements/spotter/rotsmoother`               | |rotsmoother_purpose|  |
 +-------------------------------------------------------+------------------------+
 
+stereonet
+---------
+
++---------------------------------------------+-----------------------+
+| :doc:`/supplements/stereonet/psstereonet`   | |psstereonet_purpose| |
++---------------------------------------------+-----------------------+
+
 windbarbs
 ---------
 

doc/rst/source/modules.rst

@@ -174,6 +174,7 @@ All modules are requested via a call to the :doc:`gmt` program.
    supplements/spotter/polespotter
    supplements/spotter/rotconverter
    supplements/spotter/rotsmoother
+   supplements/stereonet/stereonet
    supplements/windbarbs/barb
    supplements/windbarbs/grdbarb
    supplements/x2sys/x2sys_binlist
@@ -356,6 +357,7 @@ Supplemental Modules
     - :doc:`/supplements/spotter/polespotter`
     - :doc:`/supplements/spotter/rotconverter`
     - :doc:`/supplements/spotter/rotsmoother`
+    - :doc:`/supplements/stereonet/stereonet`
     - :doc:`/supplements/windbarbs/barb`
     - :doc:`/supplements/windbarbs/grdbarb`
     - :doc:`/supplements/x2sys/x2sys_binlist`
@@ -795,6 +797,13 @@ spotter
 | :doc:`/supplements/spotter/rotsmoother`  | |rotsmoother_purpose|  |
 +------------------------------------------+------------------------+
 
+stereonet
+---------
+
++--------------------------------------------+----------------------+
+| :doc:`/supplements/stereonet/stereonet`    | |stereonet_purpose|  |
++--------------------------------------------+----------------------+
+
 windbarbs
 ---------
 

doc/rst/source/reference/map-projections.rst

@@ -290,6 +290,9 @@ at 0/0) is known as the *equal-area* (Schmidt) stereonet and used for
 plotting fold axes, fault planes, and the like. An *equal-angle* (Wulff)
 stereonet can be obtained by using the stereographic projection
 (discussed later). The stereonets produced by these two projections appear below.
+The :doc:`/supplements/stereonet/stereonet` module builds on these two projections and
+converts structural measurements (strike/dip or trend/plunge) into the coordinates they
+expect.
 
 .. _GMT_stereonets:
 

doc/rst/source/supplements/module_supplements_purpose.rst_

@@ -8,6 +8,10 @@
 
 .. |psvelo_purpose| replace:: Plot velocity vectors, crosses, anisotropy bars and wedges
 
+.. |stereonet_purpose| replace:: Plot structural geology data on a stereonet
+
+.. |psstereonet_purpose| replace:: Plot structural geology data on a stereonet
+
 .. |fzanalyzer_purpose| replace:: Analysis of fracture zones using crossing profiles
 
 .. |fzblender_purpose| replace:: Produce a smooth blended FZ trace

doc/rst/source/supplements/stereonet/psstereonet.rst

@@ -0,0 +1,74 @@
+.. index:: ! psstereonet
+.. include:: ../module_supplements_purpose.rst_
+
+***********
+psstereonet
+***********
+
+WARNING: This module is new and still under active development. Syntax, defaults, and output may change without notice in a future release.
+-------------------------------------------------------------------------------------------------------------------------------------------
+
+|psstereonet_purpose|
+
+Synopsis
+--------
+
+.. include:: ../../common_SYN_OPTs.rst_
+
+**gmt psstereonet** [ *table* ]
+[ |-J|\ **A**\|\ **S**\ *width* ]
+[ |-A|\ [*annot*\ [/*tick*]] ]
+[ |SYN_OPT-B| ]
+[ |-C|\ *cpt* ]
+[ |-G|\ *fill* ]
+[ |-K| ]
+[ |-L|\ *pen* ]
+[ |-M|\ [**c**\|\ **p**] ]
+[ |-O| ] [ |-P| ]
+[ |-S|\ *symbol*\ [*size*] ]
+[ |-T|\ [**d**\|\ **l**\|\ **p**][**+u**] ]
+[ |SYN_OPT-U| ]
+[ |SYN_OPT-V| ]
+[ |-W|\ *pen* ]
+[ |SYN_OPT-X| ]
+[ |SYN_OPT-Y| ]
+[ |SYN_OPT-bi| ]
+[ |SYN_OPT-di| ]
+[ |SYN_OPT-e| ]
+[ |SYN_OPT-f| ]
+[ |SYN_OPT-g| ]
+[ |SYN_OPT-h| ]
+[ |SYN_OPT-i| ]
+[ |SYN_OPT-p| ]
+[ |SYN_OPT-qi| ]
+[ |SYN_OPT-s| ]
+[ |SYN_OPT-t| ]
+[ |SYN_OPT-:| ]
+[ |SYN_OPT--| ]
+
+|No-spaces|
+
+.. include:: stereonet.rst
+    :start-after: .. module_common_begins
+    :end-before: .. module_common_ends
+
+.. include:: ../../common_classic.rst_
+
+Examples
+--------
+
+.. include:: ../../explain_example.rst_
+
+To plot eight fault planes given as *strike dip* on a 12-centimeter-wide Schmidt net,
+drawing the cyclographic traces in red and the poles as blue crosses, try::
+
+    gmt psstereonet faults.txt -JA12c -B -W1p,red -Sx0.3c -L1p,blue -P > faults.ps
+
+See Also
+--------
+
+:doc:`gmt </gmt>`, :doc:`gmt.conf </gmt.conf>`,
+:doc:`psbasemap </psbasemap>`,
+:doc:`psxy </psxy>`,
+:doc:`psrose </psrose>`,
+:doc:`/supplements/seis/pspolar`