.\" Man page generated from reStructuredText.
.
.TH "PSPOLAR" "1gmt" "Jan 10, 2019" "5.4.5" "GMT"
.SH NAME
pspolar \- Plot polarities on the inferior focal half-sphere on maps
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
pspolar [ \fItable\fP ]  \fB\-D\fP\fIlon/lat\fP  \fB\-J\fP\fIparameters\fP
 \fB\-R\fP\fIregion\fP
 \fB\-M\fP\fIsize\fP  \fB\-S\fP\fI<symbol><size>\fP
[  \fB\-B\fP[\fBp\fP|\fBs\fP]\fIparameters\fP ]
[  \fB\-C\fP\fIlon\fP/\fIlat\fP[/\fIdash_width\fP/\fIpointsize\fP] ]
[  \fB\-E\fP\fIcolor\fP ]
[  \fB\-F\fP\fIcolor\fP ]
[  \fB\-G\fP\fIcolor\fP ]
[  \fB\-K\fP ] [  \fB\-L\fP ] [  \fB\-N\fP ]
[  \fB\-O\fP ]
[  \fB\-Q\fP\fImode\fP[\fIargs\fP] ]
[  \fB\-T\fP\fIangle\fP/\fIform\fP/\fIjustify\fP/\fIfontsize\fP ]
[  \fB\-U\fP[\fIstamp\fP] ]
[  \fB\-V\fP[\fIlevel\fP] ]
[  \fB\-W\fP\fIpen\fP ]
[  \fB\-X\fP\fIx_offset\fP ]
[  \fB\-Y\fP\fIy_offset\fP ]
[ \fB\-di\fPnodata ]
[ \fB\-e\fPregexp ]
[ \fB\-h\fPheaders ]
[ \fB\-i\fPflags ]
[ \fB\-t\fPtransp ]
[ \fB\-:\fP[\fBi\fP|\fBo\fP] ]
.sp
\fBNote:\fP No space is allowed between the option flag and the associated arguments.
.SH DESCRIPTION
.sp
\fBpspolar\fP reads data values from \fIfiles\fP [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.
.sp
Parameters are expected to be in the following columns:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB1\fP,\fB2\fP,\fB3\fP:
station_code, azimuth, take\-off angle
.TP
\fB4\fP:
polarity:
.INDENT 7.0
.IP \(bu 2
compression can be c,C,u,U,+
.IP \(bu 2
rarefaction can be d,D,r,R,\-
.IP \(bu 2
not defined is anything else
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH REQUIRED ARGUMENTS
.INDENT 0.0
.TP
.B \fItable\fP
One or more ASCII (or binary, see \fB\-bi\fP[\fIncols\fP][\fItype\fP]) data
table file(s) holding a number of data columns. If no tables are given
then we read from standard input.  
.UNINDENT
.INDENT 0.0
.TP
\fB\-J\fP\fIparameters\fP (more ...)
Select map projection.  
.UNINDENT
.INDENT 0.0
.TP
\fB\-R\fP\fIwest\fP/\fIeast\fP/\fIsouth\fP/\fInorth\fP[/\fIzmin\fP/\fIzmax\fP][\fB+r\fP][\fB+u\fP\fIunit\fP]
\fIwest\fP, \fIeast\fP, \fIsouth\fP, and \fInorth\fP specify the region of interest,
and you may specify them in decimal degrees or in
[±]dd:mm[:ss.xxx][\fBW\fP|\fBE\fP|\fBS\fP|\fBN\fP] format
Append \fB+r\fP if lower left
and upper right map coordinates are given instead of w/e/s/n. The
two shorthands \fB\-Rg\fP and \fB\-Rd\fP stand for global domain (0/360
and \-180/+180 in longitude respectively, with \-90/+90 in latitude).
Alternatively for grid creation, give \fBR\fP\fIcode\fP\fIlon\fP/\fIlat\fP/\fInx\fP/\fIny\fP, where
\fIcode\fP is a 2\-character combination of L, C, R (for left, center, or right)
and T, M, B for top, middle, or bottom. e.g., BL for lower left.  This
indicates which point on a rectangular region the \fIlon\fP/\fIlat\fP coordinate
refers to, and the grid dimensions \fInx\fP and \fIny\fP with grid spacings via
\fB\-I\fP is used to create the corresponding region.
Alternatively, specify the name of an existing grid file and the
\fB\-R\fP settings (and grid spacing, if applicable) are copied from
the grid. Appending \fB+u\fP\fIunit\fP expects projected (Cartesian)
coordinates compatible with chosen \fB\-J\fP and we inversely project
to determine actual rectangular geographic region.
For perspective view (\fB\-p\fP), optionally append /\fIzmin\fP/\fIzmax\fP\&.
In case of perspective view (\fB\-p\fP), a z\-range (\fIzmin\fP, \fIzmax\fP)
can be appended to indicate the third dimension. This needs to be
done only when using the \fB\-Jz\fP option, not when using only the
\fB\-p\fP option. In the latter case a perspective view of the plane is
plotted, with no third dimension.  
.UNINDENT
.INDENT 0.0
.TP
\fB\-D\fP\fIlongitude/latitude\fP
Maps the bubble at given longitude and latitude point.
.UNINDENT
.INDENT 0.0
.TP
\fB\-M\fP\fIsize\fP
Sets the size of the beach ball to plot polarities in. \fISize\fP is in
default units (unless \fBc\fP, \fBi\fP, or \fBp\fP is appended).
.UNINDENT
.INDENT 0.0
.TP
\fB\-S\fP\fI<symbol_type><size>\fP
Selects \fIsymbol_type\fP and symbol \fIsize\fP\&. Size is in default inits (unless
\fBc\fP, \fBi\fP, or \fBp\fP is appended). Choose symbol type from
st(\fIa\fP)r, (\fIc\fP)ircle, (\fId\fP)iamond, (\fIh\fP)exagon, (\fIi\fP)nverted
triangle, (\fIp\fP)oint, (\fIs\fP)quare, (\fIt\fP)riangle, (\fIx\fP)cross.
.UNINDENT
.SH OPTIONAL ARGUMENTS
.INDENT 0.0
.TP
\fB\-B\fP[\fBp\fP|\fBs\fP]\fIparameters\fP (more ...)
Set map boundary frame and axes attributes.
.UNINDENT
.INDENT 0.0
.TP
\fB\-C\fP
Offsets focal mechanisms to the latitude and longitude specified in
the last two columns of the input file.
.UNINDENT
.INDENT 0.0
.TP
\fB\-E\fP\fIcolor\fP
Selects filling of symbols for stations in extensive quadrants. Set
the color [Default is 250]. If \fB\-E\fP\fIcolor\fP is the same as
\fB\-F\fP\fIcolor\fP, use \fB\-e\fP to outline.
.UNINDENT
.INDENT 0.0
.TP
\fB\-F\fP\fIcolor\fP
Sets background color of the beach ball. Default is no fill.
.UNINDENT
.INDENT 0.0
.TP
\fB\-G\fP\fIcolor\fP
Selects filling of symbols for stations in compressional quadrants.
Set the color [Default is black].
.UNINDENT
.INDENT 0.0
.TP
\fB\-K\fP (more ...)
Do not finalize the PostScript plot.
.UNINDENT
.INDENT 0.0
.TP
\fB\-N\fP
Does \fBnot\fP skip symbols that fall outside map border [Default plots points inside border only].
.UNINDENT
.INDENT 0.0
.TP
\fB\-O\fP (more ...)
Append to existing PostScript plot.
.UNINDENT
.INDENT 0.0
.TP
\fB\-P\fP (more ...)
Select "Portrait" plot orientation.
.UNINDENT
.INDENT 0.0
.TP
\fB\-Q\fP\fImode\fP[\fIargs\fP]
Sets one or more attributes; repeatable. The various combinations are
.INDENT 7.0
.TP
\fB\-Qe\fP[pen]
Outline symbols in extensive quadrants using \fIpen\fP or the default pen (see  \fB\-W\fP).
.TP
\fB\-Qf\fP[pen]
Outline the beach ball using \fIpen\fP or the default pen (see  \fB\-W\fP).
.TP
\fB\-Qg\fP[pen]
Outline symbols in compressional quadrants using \fIpen\fP or the default pen (see  \fB\-W\fP).
.TP
\fB\-Qh\fP
Use special format derived from HYPO71 output
.TP
\fB\-Qs\fP\fIhalf\-size\fP[\fB+v\fP\fIv_size\fP[\fIvecspecs\fP]]
Plots S polarity azimuth. S polarity is in last column. Append \fB+v\fP to select a vector
and append head size and any vector specifications.  If \fB+v\fP is given without arguments then we
default to \fB+v\fP0.3i+e+gblack [Default is a line segment].
Give \fIhalf\-size\fP in default units (unless \fBc\fP, \fBi\fP, or \fBp\fP is appended).
See \fI\%Vector Attributes\fP for specifying additional attributes.
.TP
\fB\-Qt\fP\fIpen\fP
Set pen color to write station code. Default uses the default pen (see  \fB\-W\fP).
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
\fB\-T\fP\fIangle/form/justify/fontsize in points\fP
To write station code. [Default is 0.0/0/5/12].
.UNINDENT
.INDENT 0.0
.TP
\fB\-U\fP[[\fIjust\fP]/\fIdx\fP/\fIdy\fP/][\fBc\fP|\fIlabel\fP] (more ...)
Draw GMT time stamp logo on plot.
.UNINDENT
.INDENT 0.0
.TP
\fB\-V\fP[\fIlevel\fP] (more ...)
Select verbosity level [c].  
.UNINDENT
.INDENT 0.0
.TP
\fB\-W\fP[\fB\-\fP|\fB+\fP][\fIpen\fP][\fIattr\fP] (more ...)
Set current pen attributes [Defaults: width = default, color = black, style = solid].
.UNINDENT
.sp
\fB\-X\fP[\fBa\fP|\fBc\fP|\fBf\fP|\fBr\fP][\fIx\-shift\fP[\fBu\fP]]
.INDENT 0.0
.TP
\fB\-Y\fP[\fBa\fP|\fBc\fP|\fBf\fP|\fBr\fP][\fIy\-shift\fP[\fBu\fP]] (more ...)
Shift plot origin.
.UNINDENT
.INDENT 0.0
.TP
\fB\-di\fP\fInodata\fP (more ...)
Replace input columns that equal \fInodata\fP with NaN.  
.UNINDENT
.INDENT 0.0
.TP
\fB\-e\fP[\fB~\fP]\fI"pattern"\fP \fB|\fP \fB\-e\fP[\fB~\fP]/\fIregexp\fP/[\fBi\fP] (more ...)
Only accept data records that match the given pattern.  
.UNINDENT
.INDENT 0.0
.TP
\fB\-i\fP\fIcols\fP[\fB+l\fP][\fB+s\fP\fIscale\fP][\fB+o\fP\fIoffset\fP][,\fI\&...\fP] (more ...)
Select input columns and transformations (0 is first column).
.UNINDENT
.INDENT 0.0
.TP
\fB\-t\fP[\fItransp\fP] (more ...)
Set PDF transparency level in percent.
.UNINDENT
.INDENT 0.0
.TP
\fB\-:\fP[\fBi\fP|\fBo\fP] (more ...)
Swap 1st and 2nd column on input and/or output.
.UNINDENT
.INDENT 0.0
.TP
\fB\-^\fP or just \fB\-\fP
Print a short message about the syntax of the command, then exits (NOTE: on Windows just use \fB\-\fP).
.TP
\fB\-+\fP or just \fB+\fP
Print an extensive usage (help) message, including the explanation of
any module\-specific option (but not the GMT common options), then exits.
.TP
\fB\-?\fP or no arguments
Print a complete usage (help) message, including the explanation of all options, then exits.
.UNINDENT
.SH VECTOR ATTRIBUTES
.sp
Several modifiers may be appended to the vector\-producing options to
specify the placement of vector heads, their shapes, and the
justification of the vector. Below, left and right refers to the
side of the vector line when viewed from the start point to the
end point of the segment:
.INDENT 0.0
.INDENT 3.5
\fB+a\fP\fIangle\fP sets the angle of the vector head apex [30].
.sp
\fB+b\fP places a vector head at the beginning of the vector path [none].
Optionally, append \fBt\fP for a terminal line, \fBc\fP for a circle,
\fBa\fP for arrow [Default], \fBi\fP for tail, \fBA\fP for plain arrow,
and \fBI\fP for plain tail.
Further append \fBl\fP|\fBr\fP to only draw the left or right
side of this head [both sides].
.sp
\fB+e\fP places a vector head at the end of the vector path [none].
Optionally, append \fBt\fP for a terminal line, \fBc\fP for a circle,
\fBa\fP for arrow [Default], \fBi\fP for tail, \fBA\fP for plain arrow,
and \fBI\fP for plain tail.
Further append \fBl\fP|\fBr\fP to only draw the left or right
side of this head [both sides].
.sp
\fB+g\fP\-|\fIfill\fP turns off vector head fill (if \-) or sets the vector
head fill [Default fill is used, which may be no fill].
.sp
\fB+h\fP\fIshape\fP sets the shape of the vector head (range \-2/2). Default
is controlled by MAP_VECTOR_SHAPE [0].
.sp
\fB+l\fP draws half\-arrows, using only the left side of specified heads [both sides].
.sp
\fB+m\fP places a vector head at the mid\-point the vector path [none].
Append \fBf\fP or \fBr\fP for forward or reverse direction of the vector [forward].
Optionally, append \fBt\fP for a terminal line, \fBc\fP for a circle, or
\fBa\fP for arrow head [Default].
Further append \fBl\fP|\fBr\fP to only draw the left or right
side of this head [both sides].  Cannot be combined with \fB+b\fP or \fB+e\fP\&.
.sp
\fB+n\fP\fInorm\fP scales down vector attributes (pen thickness, head size)
with decreasing length, where vectors shorter than \fInorm\fP will have
their attributes scaled by length/\fInorm\fP [arrow attributes remains
invariant to length].
.sp
\fB+o\fP\fIplon\fP/\fIplat\fP specifies the oblique pole for the great or
small circles.  Only needed for great circles if \fB+q\fP is given.
.sp
\fB+p\fP[\-][\fIpen\fP] sets the vector pen attributes. If \fIpen\fP has a
leading \- then the head outline is not drawn. [Default pen is used, and
head outline is drawn]
.sp
\fB+q\fP means the input \fIangle\fP, \fIlength\fP data instead represent the \fIstart\fP and \fIstop\fP
opening angles of the arc segment relative to the given point.
.sp
\fB+r\fP draws half\-arrows, using only the right side of specified heads [both sides].
.sp
\fB+t\fP[\fBb\fP|\fBe\fP]\fItrim\fP will shift the beginning or end point (or both)
along the vector segment by the given \fItrim\fP; append suitable unit. If the modifiers
\fBb\fP|\fBe\fP are not used then \fItrim\fP may be two values separated by a slash,
which is used to specify different trims for the two ends.  Positive trims
will shorted the vector while negative trims will lengthen it [no trim].
.UNINDENT
.UNINDENT
.sp
In addition, all but circular vectors may take these modifiers:
.INDENT 0.0
.INDENT 3.5
\fB+j\fP\fIjust\fP determines how the input \fIx\fP,\fIy\fP point relates to the
vector. Choose from \fBb\fPeginning [default], \fBe\fPnd, or \fBc\fPenter.
.sp
\fB+s\fP means the input \fIangle\fP, \fIlength\fP are instead the \fIx\fP, \fIy\fP
coordinates of the vector end point.
.UNINDENT
.UNINDENT
.sp
Finally, Cartesian vectors may take these modifiers:
.INDENT 0.0
.INDENT 3.5
\fB+z\fP\fIscale\fP[\fIunit\fP] expects input \fIdx\fP,\fIdy\fP vector components and
uses the \fIscale\fP to convert to polar coordinates with length in given unit.
.UNINDENT
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gmt pspolar \-R239/240/34/35.2 \-JM8c \-N \-Sc0.4 \-h1 \-D39.5/34.5 \-M5 << END > test.ps
#stat azim ih pol
0481 11 147 c
6185 247 120 d
0485 288 114 +
0490 223 112 \-
0487 212 109 .
END
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
or
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gmt pspolar \-R239/240/34/35.2 \-JM8c \-N \-Sc0.4 \-h1 \-D239.5/34.5 \-M5 <<END > 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
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
psmeca,
psvelo,
pscoupe,
gmt, psbasemap, psxy
.SH REFERENCES
.sp
Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.
.sp
Aki, K. and P. Richards, Quantitative Seismology, Freeman, 1980.
.SH AUTHORS
.sp
Genevieve Patau, \fILaboratory of Seismogenesis <http://www.ipgp.fr/rech/sismogenese/>\fP,
Institut de Physique du Globe de Paris, Departement de Sismologie, Paris, France
.SH COPYRIGHT
2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
.\" Generated by docutils manpage writer.
.