1PSPOLAR(1) Generic Mapping Tools PSPOLAR(1)
2
6 pspolar - Plot polarities on the inferior focal half-sphere on maps
7
9 pspolar files -Jparameters -Rwest/east/south/north[r] -Dlon/lat -Msize
10 -S<symbol><size> [ -B[p|s]parameters ] [ -Clon/lat[/dash_width/point‐
11 size] ] [ -Fcolor ] [ -Gfill ] [ -gfill ] [ -H[i][nrec] ] [ -h ] [ -K ]
12 [ -L ] [ -N ] [ -O ] [ -P ] [ -sHalf-
13 size[v[[v_width/h_length/h_width/shape]][g[color]][l] [ -Tan‐
14 gle/form/justify/fontsize ] [ -tpen ] [ -U[just/dx/dy/][c|label] ] [ -V
15 ] [ -Wpen ] [ -X[a|c|r][x-shift[u]] ] [ -Y[a|c|r][y-shift[u]] ] [
16 -ccopies ]
17
19 pspolar reads data values from files [or standard input] and generates
20 PostScript code that will plot stations on focal mechanisms on a map.
21 The PostScript code is written to standard output.
22 Parameters are expected to be in the following columns
24 1,2,3,4
26 station_code, azimuth, take-off angle, polarity
27 polarity:
29 - compression can be c,C,u,U,+
30 - rarefaction can be d,D,r,R,-
31 - not defined is anything else
32
35 files List one or more file-names. If no files are given, pspolar will
36 read standard input.
37 -J Selects the map projection. Scale is UNIT/degree, 1:xxxxx, or
39 width in UNIT (upper case modifier). UNIT is cm, inch, or m,
40 depending on the MEASURE_UNIT setting in .gmtdefaults4, but this
41 can be overridden on the command line by appending c, i, or m to
42 the scale/width value. When central meridian is optional,
43 default is center of longitude range on -R option. Default
44 standard parallel is the equator. For map height, max dimen‐
45 sion, or min dimension, append h, +, or - to the width, respec‐
46 tively.
47 More details can be found in the psbasemap man pages.
48 CYLINDRICAL PROJECTIONS:
50 -Jclon0/lat0/scale (Cassini)
52 -Jcyl_stere/[lon0/[lat0/]]scale (Cylindrical Stereographic)
53 -Jj[lon0/]scale (Miller)
54 -Jm[lon0/[lat0/]]scale (Mercator)
55 -Jmlon0/lat0/scale (Mercator - Give meridian and standard paral‐
56 lel)
57 -Jo[a]lon0/lat0/azimuth/scale (Oblique Mercator - point and
58 azimuth)
59 -Jo[b]lon0/lat0/lon1/lat1/scale (Oblique Mercator - two points)
60 -Joclon0/lat0/lonp/latp/scale (Oblique Mercator - point and
61 pole)
62 -Jq[lon0/[lat0/]]scale (Cylindrical Equidistant)
63 -Jtlon0/[lat0/]scale (TM - Transverse Mercator)
64 -Juzone/scale (UTM - Universal Transverse Mercator)
65 -Jy[lon0/[lat0/]]scale (Cylindrical Equal-Area)
66 CONIC PROJECTIONS:
68 -Jblon0/lat0/lat1/lat2/scale (Albers)
70 -Jdlon0/lat0/lat1/lat2/scale (Conic Equidistant)
71 -Jllon0/lat0/lat1/lat2/scale (Lambert Conic Conformal)
72 AZIMUTHAL PROJECTIONS:
74 -Jalon0/lat0[/horizon]/scale (Lambert Azimuthal Equal-Area)
76 -Jelon0/lat0[/horizon]/scale (Azimuthal Equidistant)
77 -Jflon0/lat0[/horizon]/scale (Gnomonic)
78 -Jglon0/lat0[/horizon]/scale (Orthographic)
79 -Jglon0/lat0/altitude/azimuth/tilt/twist/Width/Height/scale
80 (General Perspective).
81 -Jslon0/lat0[/horizon][/slat]/scale (General Stereographic)
82 MISCELLANEOUS PROJECTIONS:
84 -Jh[lon0/]scale (Hammer)
86 -Ji[lon0/]scale (Sinusoidal)
87 -Jkf[lon0/]scale (Eckert IV)
88 -Jk[s][lon0/]scale (Eckert IV)
89 -Jn[lon0/]scale (Robinson)
90 -Jr[lon0/]scale (Winkel Tripel)
91 -Jv[lon0/]scale (Van der Grinten)
92 -Jw[lon0/]scale (Mollweide)
93 NON-GEOGRAPHICAL PROJECTIONS:
95 -Jp[a]scale[/origin][r|z] (Polar coordinates (theta,r))
97 -Jxx-scale[d|l|ppow|t|T][/y-scale[d|l|ppow|t|T]] (Linear, log,
98 and power scaling)
99 -R west, east, south, and north specify the Region of interest, and
101 you may specify them in decimal degrees or in
102 [+-]dd:mm[:ss.xxx][W|E|S|N] format. Append r if lower left and
103 upper right map coordinates are given instead of w/e/s/n. The
104 two shorthands -Rg and -Rd stand for global domain (0/360 and
105 -180/+180 in longitude respectively, with -90/+90 in latitude).
106 -Dlongitude/latitude
108 Maps the bubble at given longitude and latitude point.
109 -Msize Sets the size of the beach ball to plot polarities in. Size is
111 in inch (unless c, i, m, or p is appended).
112 -S<symbol_type><size>
114 Selects symbol_type and symbol size. Size is in inch (unless c,
115 i, m, or p is appended). Choose symbol type from st(a)r,
116 (c)ircle, (d)iamond, (h)exagon, (i)nverted triangle, (p)oint,
117 (s)quare, (t)riangle, (x)cross.
118
120 No space between the option flag and the associated arguments.
121 -B Sets map boundary annotation and tickmark intervals; see the
123 psbasemap man page for all the details.
124 -C Offsets focal mechanisms to the latitude and longitude specified
126 in the last two columns of the input file.
127 -Efill Selects filling of symbols for stations in extensive quadrants.
129 Set the shade (0-255) or color (r/g/b) [Default is 250/250/250].
130 If -Efill is the same as -Ffill, use -e to outline.
131 -e[pen]
133 Outline symbols in extensive quadrants using pen or the default
134 pen (see -W).
135 -Ffill Sets background color of the beach ball. Default is no fill.
137 -f[pen]
139 Outline the beach ball using pen or the default pen (see -W).
140 -Gfill Selects filling of symbols for stations in compressional quad‐
142 rants. Set the shade (0-255) or color (r/g/b) [Default is
143 0/0/0].
144 -g[pen]
146 Outline symbols in compressional quadrants using pen or the
147 default pen (see -W).
148 -H Input file(s) has Header record(s). Number of header records
150 can be changed by editing your .gmtdefaults4 file. If used, GMT
151 default is 1 header record. Use -Hi if only input data should
152 have header records [Default will write out header records if
153 the input data have them]. Blank lines and lines starting with #
154 are always skipped.
155 -h Use special format derived from HYPO71 output
157 -K More PostScript code will be appended later [Default terminates
159 the plot system].
160 -N Does NOT skip symbols that fall outside map border [Default
162 plots points inside border only].
163 -O Selects Overlay plot mode [Default initializes a new plot sys‐
165 tem].
166 -P Selects Portrait plotting mode [Default is Landscape, see gmtde‐
168 faults to change this].
169 -shalf-size/[V[v_width/h_length/h_width/shape]][Gr/g/b][L]
171 Plots S polarity azimuth.
172 S polarity is in last column. It may be a vector (V option) or
173 a segment. Give half-size,v_width,h_length,h_width in inch
174 (unless c, i, m, or p is appended). [L] option is for outline.
175 -Tangle/form/justify/fontsize in points
177 To write station code. [Default is 0.0/0/5/12].
178 -tpen Set pen color to write station code. Default uses the default
180 pen (see -W).
181 -U Draw Unix System time stamp on plot. By adding just/dx/dy/, the
183 user may specify the justification of the stamp and where the
184 stamp should fall on the page relative to lower left corner of
185 the plot. For example, BL/0/0 will align the lower left corner
186 of the time stamp with the lower left corner of the plot.
187 Optionally, append a label, or c (which will plot the command
188 string.). The GMT parameters UNIX_TIME, UNIX_TIME_POS, and
189 UNIX_TIME_FORMAT can affect the appearance; see the gmtdefaults
190 man page for details. The time string will be in the locale set
191 by the environment variable TZ (generally local time).
192 -V Selects verbose mode, which will send progress reports to stderr
194 [Default runs "silently"].
195 -W Set current pen attributes
197 [Defaults: width = 1, color = 0/0/0, texture = solid].
198 -X -Y Shift plot origin relative to the current origin by (x-shift,y-
200 shift) and optionally append the length unit (c, i, m, p). You
201 can prepend a to shift the origin back to the original position
202 after plotting, or prepend r [Default] to reset the current
203 origin to the new location. If -O is used then the default (x-
204 shift,y-shift) is (0,0), otherwise it is (r1i, r1i) or (r2.5c,
205 r2.5c). Alternatively, give c to align the center coordinate (x
206 or y) of the plot with the center of the page based on current
207 page size.
208 -: Toggles between (longitude,latitude) and (latitude,longitude)
210 input and/or output. [Default is (longitude,latitude)]. Append
211 i to select input only or o to select output only. [Default
212 affects both].
213 -c Specifies the number of plot copies. [Default is 1].
215
217 pspolar -R239/240/34/35.2 -JM8 -N -Sc0.4 -H1 -D239.5/34.5 -M5 <<END>!
218 test.ps
219 stat azim ih pol
220 0481 11 147 c
221 6185 247 120 d
222 0485 288 114 +
223 0490 223 112 -
224 0487 212 109 .
225 END
226 or
227 pspolar -R239/240/34/35.2 -JM8 -N -Sc0.4 -H1 -D239.5/34.5 -M5 -h
228 <<END>! test.ps
229 Date Or. time stat azim ih
230 910223 1 22 0481 11 147 ipu0
231 910223 1 22 6185 247 120 ipd0
232 910223 1 22 0485 288 114 epu0
233 910223 1 22 0490 223 112 epd0
234 910223 1 22 0487 212 109 epu0
235 END
236
239 GMT(1), psbasemap(1), psxy(1)
240
242 Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.
243 Aki, K. and P. Richards, Quantitative Seismology, Freeman, 1980.
244
246 Genevieve Patau
247 Seismology Dept.
248 Institut de Physique du Globe de Paris
249 (patau@ipgp.jussieu.fr)
250GMT 4.3.1 15 May 2008 PSPOLAR(1)