pssolar(1) GMT pssolar(1)
NAME
pssolar - Plot day-light terminators and other sunlight parameters
SYNOPSIS
pssolar [ -B[p|s]parameters ] [ -C ] [ -Gfill|c ] [ -I[lon/lat][+ddate][+zTZ] ] [ -Jparameters ] [ -K ] [ -M ] [ -N ] [ -O ] [ -P ] [ -Q ] [ -Rregion ] [ -Tdcna[+ddate][+zTZ]] [ -U[stamp] ] [ -V[level] ] [ -Wpen ] [ -Xx_offset ] [ -Yy_offset ] [ -bobinary ] [ -hheaders ] [ -oflags ] [ -pflags ] [ -ttransp ] Note: No space is allowed between the option flag and the associated arguments.
DESCRIPTION
pssolar Calculate and plot the day-night terminator and the civil, nau- tical and astronomical twilights.
REQUIRED ARGUMENTS
There are no required arguments but either -I or -T must be selected.
OPTIONAL ARGUMENTS
-B[p|s]parameters (more a|) Set map boundary frame and axes attributes. -C Formats the report selected by -I using tab-separated fields on a single line. The output is Sun Lon Lat Azimuth Elevation in degrees, Sunrise Sunset Noon in decimal days, day length in min- utes, SolarElevationCorrected corrected for the effect of refraction index and Equation of time in minutes. Note that if no position is provided in -Ilon/lat the data after Elevation refers to the point (0,0). -Gfill|c Select color or pattern for filling of terminators; or use -Gc for clipping [Default is no fill]. Deactivate clipping by appending the output of gmt psclip -C. -I[lon/lat][+ddate][+zTZ] 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 +ddate in ISO format, e.g, +d2000-04-25, to compute sun parameters for this date. If neces- sary, append time zone via +zTZ. -Jparameters (more a|) Select map projection. -K (more a|) Do not finalize the PostScript plot. -M Write terminator(s) as a multisegment ASCII (or binary, see -bo) file to standard output. No plotting occurs. -N Invert the sense of what is inside and outside the terminator. Only used with clipping (-Gc) and cannot be used together with -B. -O (more a|) Append to existing PostScript plot. -P (more a|) Select aPortraita plot orientation. -Rxmin/xmax/ymin/ymax[+r][+uunit] (more a|) Specify the region of interest. -Tdcna[+ddate][+zTZ] Plot (or dump; see -M) one or more terminators defined via the dcna flags. Where: d means day/night terminator; c means civil twilight; n means nautical twilight; a means astronomical twi- light. Add +ddate in ISO format, e.g, +d2000-04-25T12:15:00 to know where the day-night was at that date. If necessary, append time zone via +zTZ. -U[[just]/dx/dy/][c|label] (more a|) Draw GMT time stamp logo on plot. -V[level] (more a|) Select verbosity level [c]. -W[-|+][pen] (more a|) Set pen attributes for lines or the outline of symbols [Defaults: width = default, color = black, style = solid]. -X[a|c|f|r][x-shift[u]] -Y[a|c|f|r][y-shift[u]] (more a|) Shift plot origin. -bo[ncols][type] (more a|) Select native binary output. -h[i|o][n][+c][+d][+rremark][+rtitle] (more a|) Skip or produce header record(s). -ocols[,a|] (more a|) Select output columns (0 is first column). -p[x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0] (more a|) Select perspective view. -t[transp] (more a|) Set PDF transparency level in percent.
EXAMPLES
Print current Sun position and Sunrise, Sunset times at: gmt pssolar -I-7.93/37.079+d2016-02-04T10:01:00 Plot the day-night and civil twilight gmt pscoast -Rd -W0.1p -JQ0/14c -Ba -BWSen -Dl -A1000 -P -K > terminator.ps gmt pssolar -R -J -W1p -Tdc -O >> terminator.ps Set up a clip path overlay based on the day/night terminator: gmt pssolar -R -J -Gc -Tc -O -K >> someplot.ps
SEE ALSO
gmt(1), psclip(1), pscoast(1), psxy(1)
COPYRIGHT
2017, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe 5.4.2 Jun 24, 2017 pssolar(1)
gmt5 5.4.2 - Generated Thu Jun 29 15:48:47 CDT 2017