1PSSOLAR(1)                            GMT                           PSSOLAR(1)
2
3
4

NAME

6       pssolar - Plot day-light terminators and other sunlight parameters
7

SYNOPSIS

9       pssolar   [    -B[p|s]parameters   ]   [    -C   ]   [   -Gfill|c  ]  [
10       -I[lon/lat][+ddate][+zTZ] ] [  -Jparameters ] [  -K ] [  -M ] [  -N ] [
11       -O ] [ -P ] [  -Q ] [  -Rregion ] [  -Tdcna[+ddate][+zTZ]] [  -U[stamp]
12       ] [  -V[level] ] [  -Wpen ] [  -Xx_offset ] [  -Yy_offset ] [ -bobinary
13       ] [ -hheaders ] [ -oflags ] [ -pflags ] [ -ttransp ]
14
15       Note:  No  space  is allowed between the option flag and the associated
16       arguments.
17

DESCRIPTION

19       pssolar Calculate and plot the day-night terminator and the civil, nau‐
20       tical and astronomical twilights.
21

REQUIRED ARGUMENTS

23       There are no required arguments but either -I or -T must be selected.
24

OPTIONAL ARGUMENTS

26       -B[p|s]parameters (more ...)
27              Set map boundary frame and axes attributes.
28
29       -C     Formats  the report selected by -I using tab-separated fields on
30              a single line. The output is Sun Lon Lat  Azimuth  Elevation  in
31              degrees, Sunrise Sunset Noon in decimal days, day length in min‐
32              utes,  SolarElevationCorrected  corrected  for  the  effect   of
33              refraction  index  and Equation of time in minutes. Note that if
34              no position is provided in -Ilon/lat the  data  after  Elevation
35              refers to the point (0,0).
36
37       -Gfill|c
38              Select  color  or pattern for filling of terminators; or use -Gc
39              for clipping [Default  is  no  fill].   Deactivate  clipping  by
40              appending the output of gmt psclip -C.
41
42       -I[lon/lat][+ddate][+zTZ]
43              Print  current  sun  position  as well as Azimuth and Elevation.
44              Append lon/lat to print also the times of Sunrise, Sunset,  Noon
45              and  length  of  the  day.   Add  +ddate  in  ISO  format,  e.g,
46              +d2000-04-25, to compute sun parameters for this date. If neces‐
47              sary, append time zone via +zTZ.
48
49       -Jparameters (more ...)
50              Select map projection.
51
52       -K (more ...)
53              Do not finalize the PostScript plot.
54
55       -M     Write terminator(s) as a multisegment ASCII (or binary, see -bo)
56              file to standard output. No plotting occurs.
57
58       -N     Invert the sense of what is inside and outside  the  terminator.
59              Only  used  with clipping (-Gc) and cannot be used together with
60              -B.
61
62       -O (more ...)
63              Append to existing PostScript plot.
64
65       -P (more ...)
66              Select "Portrait" plot orientation.
67
68       -Rxmin/xmax/ymin/ymax[+r][+uunit] (more ...)
69              Specify the region of interest.
70
71       -Tdcna[+ddate][+zTZ]
72              Plot (or dump; see -M) one or more terminators defined  via  the
73              dcna  flags.  Where: d means day/night terminator; c means civil
74              twilight; n means nautical twilight; a means  astronomical  twi‐
75              light.   Add +ddate in ISO format, e.g, +d2000-04-25T12:15:00 to
76              know where the day-night was at that date. If necessary,  append
77              time zone via +zTZ.
78
79       -U[[just]/dx/dy/][c|label] (more ...)
80              Draw GMT time stamp logo on plot.
81
82       -V[level] (more ...)
83              Select verbosity level [c].
84
85       -W[-|+][pen] (more ...)
86              Set   pen  attributes  for  lines  or  the  outline  of  symbols
87              [Defaults: width = default, color = black, style = solid].
88
89       -X[a|c|f|r][x-shift[u]]
90
91       -Y[a|c|f|r][y-shift[u]] (more ...)
92              Shift plot origin.
93
94       -bo[ncols][type] (more ...)
95              Select native binary output.
96
97       -h[i|o][n][+c][+d][+rremark][+rtitle] (more ...)
98              Skip or produce header record(s).
99
100       -ocols[,...] (more ...)
101              Select output columns (0 is first column).
102
103       -p[x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0] (more ...)
104              Select perspective view.
105
106       -t[transp] (more ...)
107              Set PDF transparency level in percent.
108

EXAMPLES

110       Print current Sun position and Sunrise, Sunset times at:
111
112              gmt pssolar -I-7.93/37.079+d2016-02-04T10:01:00
113
114       Plot the day-night and civil twilight
115
116              gmt pscoast -Rd -W0.1p -JQ0/14c -Ba -BWSen -Dl -A1000 -P -K > terminator.ps
117
118              gmt pssolar -R -J -W1p -Tdc -O >> terminator.ps
119
120       Set up a clip path overlay based on the day/night terminator:
121
122              gmt pssolar -R -J -Gc -Tc -O -K >> someplot.ps
123

SEE ALSO

125       gmt, psclip, pscoast, psxy
126

128       2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
129
130
131
132
1335.4.5                            Feb 24, 2019                       PSSOLAR(1)
Impressum