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)
Man(1) output converted with
man2html