## NAME

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

## SYNOPSIS

           pspolar files -Jparameters -Rwest/east/south/north  -Dlon
           gitude/latitude  -Msize  -S<symbol><size> [ -Btickinfo ] [
           -Clongitude/latitude[/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]
           [ -Tangle/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  MEA
                  SURE_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 ori
                  gin)
                  -Jmlon0/lat0/scale (Mercator -  Give  meridian  and
                  standard parallel)
                  -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 Carree))
                  -Jtlon0/scale (TM - Transverse Mercator, with Equa
                  tor 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  man
                  pages.

           -R     west,  east, south, and north specify the Region of
                  interest. To specify boundaries in degrees and min
                  utes  [and  seconds],  use  the  dd:mm[:ss] format.
                  Append r if lower left and upper right map  coordi
                  nates 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  argu
           ments.

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

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

           -Efill Selects filling of symbols for stations  in  exten
                  sive  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 compres
                  sional  quadrants.   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 .gmt
                  defaults  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].

           -O     Selects Overlay plot mode  [Default  initializes  a
                  new plot system].

           -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 out
                  line.

           -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 spec
                  ify 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  appear
                  ance; 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 absolute coordinates; the  default  (r)  will
                  reset plot origin.

           -:     Toggles  between  (longitude,latitude)  and  (lati
                  tude,longitude) input/output. [Default  is  (longi
                  tude,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(l), psbasemap(l) psxy(l)

## 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 Feb 2002                 PSPOLAR(l)