NAME

       pspolar - Plot polarities on the inferior focal half-sphere on maps


SYNOPSIS

       pspolar files -Jparameters -Rwest/east/south/north -Dlongitude/latitude
       -Msize   -S<symbol><size>   [   -Btickinfo   ]   [    -Clongitude/lati-
       tude[/dash_width/pointsize]  ] [ -Fred/green/blue ] [ -Gfill ] [ -gfill
       ] [ -H ] [ -h ] [ -K ] [ -L ]  [  -N  ]  [  -O  ]  [  -P  ]  [  -sHalf-
       size[v[[<v_width/h_length/h_width/shape>]][g[<r/g/b>]][l]    [    -Tan-
       gle/form/justify/fontsize ] [ -t<pen> ] [ -U[label] ] [ -V ] [ -Wpen  ]
       [ -Xx-shift ] [ -Yy-shift ] [ -ccopies ]


DESCRIPTION

       pspolar  reads data values from files [or standard input] and generates
       PostScript code that will plot stations on focal mechanisms on  a  map.
       The PostScript code is written to standard output.

       Parameters are expected to be in the following columns

       1,2,3,4
              station_code, azimuth, take-off angle, polarity

              polarity :
              - compression can be c,C,u,U,+
              - rarefaction can be d,D,r,R,-
              - not defined is anything else



ARGUMENTS

       files  List one or more file-names. If no files are given, pspolar will
       read standard input.

       -J     Selects the map projection. Scale is  UNIT/degree,  1:xxxxx,  or
              width  in  UNIT  (upper case modifier).  UNIT is cm, inch, or m,
              depending on the MEASURE_UNIT setting in .gmtdefaults, but  this
              can  be overridden on the command line by appending the c, i, or
              m to the scale/width value.

              CYLINDRICAL PROJECTIONS:

              -Jclon0/lat0/scale (Cassini)
              -Jjlon0/scale (Miller)
              -Jmscale (Mercator - Greenwich and Equator as origin)
              -Jmlon0/lat0/scale (Mercator - Give meridian and standard paral-
              lel)
              -Joalon0/lat0/azimuth/scale   (Oblique   Mercator  -  point  and
              azimuth)
              -Joblon0/lat0/lon1/lat1/scale (Oblique Mercator - two points)
              -Joclon0/lat0/lonp/latp/scale  (Oblique  Mercator  -  point  and
              pole)
              -Jqlon0/scale  (Equidistant  Cylindrical  Projection (Plate Car-
              ree))
              -Jtlon0/scale (TM - Transverse Mercator, with Equator as y = 0)
              -Jtlon0/lat0/scale (TM - Transverse Mercator, set origin)
              -Juzone/scale (UTM - Universal Transverse Mercator)
              -Jylon0/lats/scale (Basic Cylindrical Projection)

              AZIMUTHAL PROJECTIONS:

              -Jalon0/lat0/scale (Lambert).
              -Jelon0/lat0/scale (Equidistant).
              -Jflon0/lat0/horizon/scale (Gnomonic).
              -Jglon0/lat0/scale (Orthographic).
              -Jslon0/lat0/[slat/]scale (General Stereographic)

              CONIC PROJECTIONS:

              -Jblon0/lat0/lat1/lat2/scale (Albers)
              -Jdlon0/lat0/lat1/lat2/scale (Equidistant)
              -Jllon0/lat0/lat1/lat2/scale (Lambert)

              MISCELLANEOUS PROJECTIONS:

              -Jhlon0/scale (Hammer)
              -Jilon0/scale (Sinusoidal)
              -Jk[f|s]lon0/scale (Eckert IV (f) and VI (s))
              -Jnlon0/scale (Robinson)
              -Jrlon0/scale (Winkel Tripel)
              -Jvlon0/scale (Van der Grinten)
              -Jwlon0/scale (Mollweide)

              NON-GEOGRAPHICAL PROJECTIONS:

              -Jp[a]scale[/origin] (polar (theta,r)  coordinates,  optional  a
              for azimuths and offset theta [0])
              -Jxx-scale[l|ppow][/y-scale[l|ppow]]  (Linear,  log,  and  power
              scaling)
              More details can be found in the psbasemap manpages.

       -R     west, east, south, and north specify the Region of interest.  To
              specify boundaries in degrees and minutes [and seconds], use the
              dd:mm[:ss] format. Append r if lower left and  upper  right  map
              coordinates are given instead of wesn.

       -Dlongitude/latitude
              Maps the bubble at given longitude and latitude point.

       -Msize Sets  the  size of the beach ball to plot polarities in. Size is
              in inch (unless c, i, m, or p is appended).

       -S<symbol_type><size>
              Selects symbol_type and symbol size.  Size is in inch (unless c,
              i,  m,  or  p  is  appended).   Choose  symbol type from st(a)r,
              (c)ircle, (d)iamond, (h)exagon,  (i)nverted  triangle,  (p)oint,
              (s)quare, (t)riangle, (x)cross.



OPTIONS

       No space between the option flag and the associated arguments.

       -B     Sets map boundary tickmark intervals. See psbasemap for details.

       -C     Offsets focal mechanisms to the latitude and longitude specified
              in the last two columns of the input file.

       -Efill Selects  filling of symbols for stations in extensive quadrants.
              Set the shade (0-255) or color (r/g/b) [Default is 250/250/250].
              If -Efill is the same as -Ffill, use -e to outline.

       -e[pen]
              Outline  symbols in extensive quadrants using pen or the default
              pen (see -W).

       -Ffill Sets background color of the beach ball. Default is no fill.

       -f[pen]
              Outline the beach ball using pen or the default pen (see -W).

       -Gfill Selects filling of symbols for stations in  compressional  quad-
              rants.   Set  the  shade  (0-255)  or  color (r/g/b) [Default is
              0/0/0].

       -g[pen]
              Outline symbols in compressional  quadrants  using  pen  or  the
              default pen (see -W).

       -H     Input file(s) has Header record(s). Number of header records can
              be changed by editing  your  .gmtdefaults  file.  If  used,  GMT
              default is 1 header record.

       -h     Use special format derived from HYPO71 output

       -K     More  PostScript code will be appended later [Default terminates
              the plot system].

       -N     Does NOT skip symbols that  fall  outside  map  border  [Default
              plots points inside border only].

       -bo    Selects binary output. Append s for single precision [Default is
              double].

       -P     Selects Portrait plotting mode [GMT Default  is  Landscape,  see
              gmtdefaults to change this].

       -shalf-size/[V[<v_width/h_length/h_width/shape>]][G<r/g/b>][L]
              Plots S polarity azimuth.
              S  polarity is in last column.  It may be a vector (V option) or
              a  segment.   Give  half-size,v_width,h_length,h_width  in  inch
              (unless  c, i, m, or p is appended).  [L] option is for outline.

       -Tangle/form/justify/fontsize in points
              To write station code. [Default is 0.0/0/5/12].

       -t<pen>
              Set pen color to write station code. Default  uses  the  default
              pen (see -W).

       -U     Draw  Unix System time stamp on plot. User may specify where the
              lower left corner of the stamp should fall on the page  relative
              to  lower  left corner of plot. Optionally, append a label, or c
              (which will  plot  the  command  string.).  The  GMT  parameters
              UNIX_TIME  and  UNIX_TIME_POS can affect the appearance; see the
              gmtdefaults man page for details.

       -V     Selects verbose mode, which will send progress reports to stderr
              [Default runs "silently"].

       -W     Set current pen attributes
               [Defaults: width = 1, color = 0/0/0, texture = solid].

       -X -Y  Shift  origin of plot by (x-shift,y-shift).  Prepend a for abso-
              lute coordinates; the default (r) will reset plot origin.

       -:     Toggles between  (longitude,latitude)  and  (latitude,longitude)
              input/output.  [Default  is  (longitude,latitude)].   Applies to
              geographic coordinates only.

       -c     Specifies the number of plot copies. [Default is 1]


EXAMPLES

       pspolar << END -R239/240/34/35.2 -JM8 -N -Sc0.4 -H1 -D239.5/34.5 -M5 >!
       test.ps
       stat azim ih pol
       0481 11 147 c
       6185 247 120 d
       0485 288 114 +
       0490 223 112 -
       0487 212 109 .
       END
       or
       pspolar << END -R239/240/34/35.2 -JM8 -N -Sc0.4 -H1 -D239.5/34.5 -M5 -h
       >! test.ps
       Date Or. time stat azim ih
       910223 1 22 0481 11 147 ipu0
       910223 1 22 6185 247 120 ipd0
       910223 1 22 0485 288 114 epu0
       910223 1 22 0490 223 112 epd0
       910223 1 22 0487 212 109 epu0
       END



SEE ALSO

       gmt(GMTMANSECTION), psbasemap(GMTMANSECTION) psxy(GMTMANSECTION)


REFERENCES

       Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.
       Aki, K. and P. Richards, Quantitative Seismology, Freeman, 1980.


AUTHORS

       Genevieve Patau
       Seismology Dept.
       Institut de Physique du Globe de Paris
       (patau@ipgp.jussieu.fr)



                                  1 Jan 2004                        PSPOLAR(l)

Man(1) output converted with man2html