.\" Man page generated from reStructuredText.
.
.TH "PSSOLAR" "1gmt" "May 21, 2019" "5.4.5" "GMT"
.SH NAME
pssolar \- Plot day-light terminators and other sunlight parameters
.
.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
\fBpssolar\fP
[  \fB\-B\fP[\fBp\fP|\fBs\fP]\fIparameters\fP ]
[  \fB\-C\fP ]
[  \fB\-G\fP\fIfill\fP|\fBc\fP ]
[  \fB\-I\fP[\fIlon/lat\fP][\fB+d\fP\fIdate\fP][\fB+z\fP\fITZ\fP] ]
[  \fB\-J\fP\fIparameters\fP ]
[  \fB\-K\fP ]
[  \fB\-M\fP ]
[  \fB\-N\fP ]
[  \fB\-O\fP ] [ \fB\-P\fP ] [  \fB\-Q\fP ]
[  \fB\-R\fP\fIregion\fP ]
[  \fB\-T\fP\fBdcna\fP[\fB+d\fP\fIdate\fP][\fB+z\fP\fITZ\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\-bo\fPbinary ]
[ \fB\-h\fPheaders ]
[ \fB\-o\fPflags ]
[ \fB\-p\fPflags ]
[ \fB\-t\fPtransp ]
.sp
\fBNote:\fP No space is allowed between the option flag and the associated arguments.
.SH DESCRIPTION
.sp
\fBpssolar\fP Calculate and plot the day\-night terminator and the civil, nautical and astronomical twilights.
.SH REQUIRED ARGUMENTS
.sp
There are no required arguments but either \fB\-I\fP or \fB\-T\fP must be selected.
.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
Formats the report selected by \fB\-I\fP using tab\-separated fields on a single line. The
output is Sun \fILon Lat Azimuth Elevation\fP in degrees, \fISunrise Sunset Noon\fP in decimal days,
\fIday length\fP in minutes, \fISolarElevationCorrected\fP corrected for the effect of refraction index
and \fIEquation of time\fP in minutes. Note that if no position is provided in \fB\-I\fP\fIlon/lat\fP the
data after \fIElevation\fP refers to the point (0,0).
.UNINDENT
.INDENT 0.0
.TP
\fB\-G\fP\fIfill\fP|\fBc\fP
Select color or pattern for filling of terminators; or use \fB\-Gc\fP for clipping [Default is no fill].
Deactivate clipping by appending the output of gmt psclip \fB\-C\fP\&.
.UNINDENT
.INDENT 0.0
.TP
\fB\-I\fP[\fIlon/lat\fP][\fB+d\fP\fIdate\fP][\fB+z\fP\fITZ\fP]
Print current sun position as well as Azimuth and Elevation. Append lon/lat to print also the times of
Sunrise, Sunset, Noon and length of the day.
Add \fB+d\fP\fIdate\fP in ISO format, e.g, \fB+d\fP\fI2000\-04\-25\fP, to compute sun parameters
for this date. If necessary, append time zone via \fB+z\fP\fITZ\fP\&.
.UNINDENT
.INDENT 0.0
.TP
\fB\-J\fP\fIparameters\fP (more ...)
Select map projection.  
.UNINDENT
.INDENT 0.0
.TP
\fB\-K\fP (more ...)
Do not finalize the PostScript plot.
.UNINDENT
.INDENT 0.0
.TP
\fB\-M\fP
Write terminator(s) as a multisegment ASCII (or binary, see \fB\-b\fP\fIo\fP) file to standard output. No plotting occurs.
.UNINDENT
.INDENT 0.0
.TP
\fB\-N\fP
Invert the sense of what is inside and outside the terminator.  Only
used with clipping (\fB\-Gc\fP) and cannot be used together with \fB\-B\fP\&.
.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\-R\fP\fIxmin\fP/\fIxmax\fP/\fIymin\fP/\fIymax\fP[\fB+r\fP][\fB+u\fP\fIunit\fP] (more ...)
Specify the region of interest.  
.UNINDENT
.INDENT 0.0
.TP
\fB\-Tdcna\fP[\fB+d\fP\fIdate\fP][\fB+z\fP\fITZ\fP]
Plot (or dump; see \fB\-M\fP) one or more terminators defined via the \fBdcna\fP flags. Where:
\fBd\fP means day/night terminator; \fBc\fP means civil twilight; \fBn\fP means nautical twilight;
\fBa\fP means astronomical twilight.  Add \fB+d\fP\fIdate\fP in ISO format, e.g, \fB+d\fP\fI2000\-04\-25T12:15:00\fP
to know where the day\-night was at that date. If necessary, append time zone via \fB+z\fP\fITZ\fP\&.
.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] (more ...)
Set pen attributes for lines or the outline of symbols [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\-bo\fP[\fIncols\fP][\fItype\fP] (more ...)
Select native binary output.  
.UNINDENT
.INDENT 0.0
.TP
\fB\-h\fP[\fBi\fP|\fBo\fP][\fIn\fP][\fB+c\fP][\fB+d\fP][\fB+r\fP\fIremark\fP][\fB+r\fP\fItitle\fP] (more ...)
Skip or produce header record(s).  
.UNINDENT
.INDENT 0.0
.TP
\fB\-o\fP\fIcols\fP[,...] (more ...)
Select output columns (0 is first column).
.UNINDENT
.INDENT 0.0
.TP
\fB\-p\fP[\fBx\fP|\fBy\fP|\fBz\fP]\fIazim\fP[/\fIelev\fP[/\fIzlevel\fP]][\fB+w\fP\fIlon0\fP/\fIlat0\fP[/\fIz0\fP]][\fB+v\fP\fIx0\fP/\fIy0\fP] (more ...)
Select perspective view.  
.UNINDENT
.INDENT 0.0
.TP
\fB\-t\fP[\fItransp\fP] (more ...)
Set PDF transparency level in percent.
.UNINDENT
.SH EXAMPLES
.sp
Print current Sun position and Sunrise, Sunset times at:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gmt pssolar \-I\-7.93/37.079+d2016\-02\-04T10:01:00
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
Plot the day\-night and civil twilight
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gmt pscoast \-Rd \-W0.1p \-JQ0/14c \-Ba \-BWSen \-Dl \-A1000 \-P \-K > terminator.ps

gmt pssolar \-R \-J \-W1p \-Tdc \-O >> terminator.ps
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
Set up a clip path overlay based on the day/night terminator:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gmt pssolar \-R \-J \-Gc \-Tc \-O \-K >> someplot.ps
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
gmt, psclip, pscoast, psxy
.SH COPYRIGHT
2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
.\" Generated by docutils manpage writer.
.