pspolar



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


SYNOPSIS

       pspolar  files  -Jparameters   -Rwest/east/south/north   [
       -Dlongitude/latitude -Msize -Ssymbol/size [ -Btickinfo ] [
       -Clongitude/latitude   [/tiret_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]
       [ -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.



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)

              -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/lati­
              tude  Maps  the bubble at given longitude and lati­
              tude 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>sizeSelects symbol type  and  symbol
              size .
              Size is in inch (unless c, i, m, or p is appended).
              Choose symbol type between
                 st(a)r,    (c)ircle,    (d)iamond,    (h)exagon,
              (i)nvtriangle
              (p)oint, (s)quare, (t)riangle, (x)cross

       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 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 attributes>] Outline symbols  in  extensive
              quadrants.
              Default pen attributes is W pen attributes.

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

              -f[<pen  attributes>]  Outline  the   beach   ball.
              Default pen attributes is W pen attributes.

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

              -g[<pen  attributes>]  Outline  symbols in compres­
              sional quadrants.  Default pen attributes is W  pen
              attributes.

       -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-

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

              -t<pen attributes>
              To  write  station  code.  Default  attributes is W
              attributes.

       -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.)

       -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]
              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


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
       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 Seismolgy, Freeman,
       1980.


AUTHORS

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






























Man(1) output converted with man2html