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

doc/rst/source/modules-classic.rst

@@ -127,6 +127,7 @@ All modules are requested via a call to the :doc:`gmt` program.
     supplements/geodesy/earthtide
     supplements/geodesy/gpsgridder
     supplements/geodesy/psvelo
+    supplements/geology/psstereonet
     supplements/gsfml/fzanalyzer
     supplements/gsfml/fzblender
     supplements/gsfml/fzinformer
@@ -298,6 +299,7 @@ Supplemental Modules
     - :doc:`/supplements/geodesy/earthtide`
     - :doc:`/supplements/geodesy/gpsgridder`
     - :doc:`/supplements/geodesy/psvelo`
+    - :doc:`/supplements/geology/psstereonet`
     - :doc:`/supplements/gsfml/fzanalyzer`
     - :doc:`/supplements/gsfml/fzblender`
     - :doc:`/supplements/gsfml/fzinformer`
@@ -621,6 +623,13 @@ geodesy
 | :doc:`/supplements/geodesy/psvelo`         | |psvelo_purpose|     |
 +--------------------------------------------+----------------------+
 
+geology
+-------
+
++---------------------------------------------+-----------------------+
+| :doc:`/supplements/geology/psstereonet`     | |psstereonet_purpose| |
++---------------------------------------------+-----------------------+
+
 GSFML
 -----
 

doc/rst/source/modules.rst

@@ -132,6 +132,7 @@ All modules are requested via a call to the :doc:`gmt` program.
    supplements/geodesy/earthtide
    supplements/geodesy/gpsgridder
    supplements/geodesy/velo
+   supplements/geology/stereonet
    supplements/gshhg/gshhg
    supplements/img/img2grd
    supplements/mgd77/mgd77convert
@@ -309,6 +310,7 @@ Supplemental Modules
     - :doc:`/supplements/geodesy/earthtide`
     - :doc:`/supplements/geodesy/gpsgridder`
     - :doc:`/supplements/geodesy/velo`
+    - :doc:`/supplements/geology/stereonet`
     - :doc:`/supplements/gsfml/fzanalyzer`
     - :doc:`/supplements/gsfml/fzblender`
     - :doc:`/supplements/gsfml/fzinformer`
@@ -652,6 +654,13 @@ geodesy
 | :doc:`/supplements/geodesy/velo`           | |velo_purpose|       |
 +--------------------------------------------+----------------------+
 
+geology
+-------
+
++--------------------------------------------+----------------------+
+| :doc:`/supplements/geology/stereonet`      | |stereonet_purpose|  |
++--------------------------------------------+----------------------+
+
 GSFML
 -----
 

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/geology/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/geology/psstereonet.rst

@@ -0,0 +1,69 @@
+.. index:: ! psstereonet
+.. include:: ../module_supplements_purpose.rst_
+
+***********
+psstereonet
+***********
+
+|psstereonet_purpose|
+
+Synopsis
+--------
+
+.. include:: ../../common_SYN_OPTs.rst_
+
+**gmt psstereonet** [ *table* ]
+[ |-J|\ **A**\|\ **S**\ *width* ]
+[ |-A|\ [*annot*\ [/*tick*]] ]
+[ |SYN_OPT-B| ]
+[ |-G|\ *fill* ]
+[ |-K| ]
+[ |-L|\ *pen* ]
+[ |-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`