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 -Jpoly/[lon0/[lat0/]]scale ((American) Polyconic)
73 AZIMUTHAL PROJECTIONS:
75 -Jalon0/lat0[/horizon]/scale (Lambert Azimuthal Equal-Area)
77 -Jelon0/lat0[/horizon]/scale (Azimuthal Equidistant)
78 -Jflon0/lat0[/horizon]/scale (Gnomonic)
79 -Jglon0/lat0[/horizon]/scale (Orthographic)
80 -Jglon0/lat0/altitude/azimuth/tilt/twist/Width/Height/scale
81 (General Perspective).
82 -Jslon0/lat0[/horizon]/scale (General Stereographic)
83 MISCELLANEOUS PROJECTIONS:
85 -Jh[lon0/]scale (Hammer)
87 -Ji[lon0/]scale (Sinusoidal)
88 -Jkf[lon0/]scale (Eckert IV)
89 -Jk[s][lon0/]scale (Eckert VI)
90 -Jn[lon0/]scale (Robinson)
91 -Jr[lon0/]scale (Winkel Tripel)
92 -Jv[lon0/]scale (Van der Grinten)
93 -Jw[lon0/]scale (Mollweide)
94 NON-GEOGRAPHICAL PROJECTIONS:
96 -Jp[a]scale[/origin][r|z] (Polar coordinates (theta,r))
98 -Jxx-scale[d|l|ppow|t|T][/y-scale[d|l|ppow|t|T]] (Linear, log,
99 and power scaling)
100 -R west, east, south, and north specify the Region of interest, and
102 you may specify them in decimal degrees or in
103 [+-]dd:mm[:ss.xxx][W|E|S|N] format. Append r if lower left and
104 upper right map coordinates are given instead of w/e/s/n. The
105 two shorthands -Rg and -Rd stand for global domain (0/360 and
106 -180/+180 in longitude respectively, with -90/+90 in latitude).
107 Alternatively, specify the name of an existing grid file and the
108 -R settings (and grid spacing, if applicable) are copied from
109 the grid.
110 -Dlongitude/latitude
112 Maps the bubble at given longitude and latitude point.
113 -Msize Sets the size of the beach ball to plot polarities in. Size is
115 in inch (unless c, i, m, or p is appended).
116 -S<symbol_type><size>
118 Selects symbol_type and symbol size. Size is in inch (unless c,
119 i, m, or p is appended). Choose symbol type from st(a)r,
120 (c)ircle, (d)iamond, (h)exagon, (i)nverted triangle, (p)oint,
121 (s)quare, (t)riangle, (x)cross.
122
124 No space between the option flag and the associated arguments.
125 -B Sets map boundary annotation and tickmark intervals; see the
127 psbasemap man page for all the details.
128 -C Offsets focal mechanisms to the latitude and longitude specified
130 in the last two columns of the input file.
131 -Efill Selects filling of symbols for stations in extensive quadrants.
133 Set the shade (0-255) or color (r/g/b) [Default is 250/250/250].
134 If -Efill is the same as -Ffill, use -e to outline.
135 -e[pen]
137 Outline symbols in extensive quadrants using pen or the default
138 pen (see -W).
139 -Ffill Sets background color of the beach ball. Default is no fill.
141 -f[pen]
143 Outline the beach ball using pen or the default pen (see -W).
144 -Gfill Selects filling of symbols for stations in compressional quad‐
146 rants. Set the shade (0-255) or color (r/g/b) [Default is
147 0/0/0].
148 -g[pen]
150 Outline symbols in compressional quadrants using pen or the
151 default pen (see -W).
152 -H Input file(s) has header record(s). If used, the default number
154 of header records is N_HEADER_RECS. Use -Hi if only input data
155 should have header records [Default will write out header
156 records if the input data have them]. Blank lines and lines
157 starting with # are always skipped.
158 -h Use special format derived from HYPO71 output
160 -K More PostScript code will be appended later [Default terminates
162 the plot system].
163 -N Does NOT skip symbols that fall outside map border [Default
165 plots points inside border only].
166 -O Selects Overlay plot mode [Default initializes a new plot sys‐
168 tem].
169 -P Selects Portrait plotting mode [Default is Landscape, see gmtde‐
171 faults to change this].
172 -shalf-size/[V[v_width/h_length/h_width/shape]][Gr/g/b][L]
174 Plots S polarity azimuth.
175 S polarity is in last column. It may be a vector (V option) or
176 a segment. Give half-size,v_width,h_length,h_width in inch
177 (unless c, i, m, or p is appended). [L] option is for outline.
178 -Tangle/form/justify/fontsize in points
180 To write station code. [Default is 0.0/0/5/12].
181 -tpen Set pen color to write station code. Default uses the default
183 pen (see -W).
184 -U Draw Unix System time stamp on plot. By adding just/dx/dy/, the
186 user may specify the justification of the stamp and where the
187 stamp should fall on the page relative to lower left corner of
188 the plot. For example, BL/0/0 will align the lower left corner
189 of the time stamp with the lower left corner of the plot.
190 Optionally, append a label, or c (which will plot the command
191 string.). The GMT parameters UNIX_TIME, UNIX_TIME_POS, and
192 UNIX_TIME_FORMAT can affect the appearance; see the gmtdefaults
193 man page for details. The time string will be in the locale set
194 by the environment variable TZ (generally local time).
195 -V Selects verbose mode, which will send progress reports to stderr
197 [Default runs "silently"].
198 -W Set current pen attributes
200 [Defaults: width = 1, color = 0/0/0, texture = solid].
201 -X -Y Shift plot origin relative to the current origin by (x-shift,y-
203 shift) and optionally append the length unit (c, i, m, p). You
204 can prepend a to shift the origin back to the original position
205 after plotting, or prepend r [Default] to reset the current
206 origin to the new location. If -O is used then the default (x-
207 shift,y-shift) is (0,0), otherwise it is (r1i, r1i) or (r2.5c,
208 r2.5c). Alternatively, give c to align the center coordinate (x
209 or y) of the plot with the center of the page based on current
210 page size.
211 -: Toggles between (longitude,latitude) and (latitude,longitude)
213 input and/or output. [Default is (longitude,latitude)]. Append
214 i to select input only or o to select output only. [Default
215 affects both].
216 -c Specifies the number of plot copies. [Default is 1].
218
220 pspolar -R239/240/34/35.2 -JM8 -N -Sc0.4 -H1 -D239.5/34.5 -M5 <<END>!
221 test.ps
222 stat azim ih pol
223 0481 11 147 c
224 6185 247 120 d
225 0485 288 114 +
226 0490 223 112 -
227 0487 212 109 .
228 END
229 or
230 pspolar -R239/240/34/35.2 -JM8 -N -Sc0.4 -H1 -D239.5/34.5 -M5 -h
231 <<END>! test.ps
232 Date Or. time stat azim ih
233 910223 1 22 0481 11 147 ipu0
234 910223 1 22 6185 247 120 ipd0
235 910223 1 22 0485 288 114 epu0
236 910223 1 22 0490 223 112 epd0
237 910223 1 22 0487 212 109 epu0
238 END
239
242 GMT(1), psbasemap(1), psxy(1)
243
245 Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.
246 Aki, K. and P. Richards, Quantitative Seismology, Freeman, 1980.
247
249 Genevieve Patau
250 Seismology Dept.
251 Institut de Physique du Globe de Paris
252 (patau@ipgp.jussieu.fr)
253GMT 4.5.6 10 Mar 2011 PSPOLAR(1)