pssolar(1gmt)
NAME
pssolar - Plot day-light terminators and other sunlight parameters
SYNOPSIS
pssolar [ -B[p|s]parameters ] [ -C ] [ -Gfill|c ] [ -I[lon/lat][+d<date>][+z<TZ>] ] [ -Jparameters ] [ -K ] [ -M ] [ -N ] [ -O ] [ -P ] [ -Q ] [ -Rregion ] [ -T<dcna>[+d<date>][+z<TZ>]] [ -U[stamp] ] [ -V[level] ] [ -Wpen ] [ -Xx_offset ] [ -Yy_offset ] [ -bobinary ] [ -ccopies ] [ -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, nautical 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 ...)
Set map boundary intervals.
-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 dedimal days, day length in
minutes, 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][+d<date>][+z<TZ>]
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 +d<date> in ISO format, e.g,
+d2000-04-25, to compute sun parameters for this date. If
necessary, append time zone via +z<TZ>.
-Jparameters (more ...)
Select map projection.
-K (more ...)
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 ...)
Append to existing PostScript plot.
-P (more ...)
Select "Portrait" plot orientation.
-R[unit]xmin/xmax/ymin/ymax[r] (more ...)
Specify the region of interest.
-T<dcna>[+d<date>][+z<TZ>]
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
twilight. Add +d<date> 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 +z<TZ>.
-U[just/dx/dy/][c|label] (more ...)
Draw GMT time stamp logo on plot.
-V[level] (more ...)
Select verbosity level [c].
-W[-|+][pen][attr] (more ...)
Set pen attributes for lines or the outline of symbols
[Defaults: width = default, color = black, style = solid]. A
leading + will use the lookup color (via -C) for both symbol
fill and outline pen color, while a leading - will set outline
pen color and turn off symbol fill. You can also append one or
more line attribute modifiers: +ooffsetu will start and stop
drawing the line the given distance offsets from the end point.
Append unit u from c|i|p to indicate plot distance on the map or
append map distance units instead (see below) [Cartesian
distances]; +s will draw the line using a PostScript Bezier
spline [linear spline]; +vvspecs will place a vector head at the
ends of the lines. You can use +vb and +ve to specify separate
vector specs at each end [shared specs]. See the Vec_attributes
for more information.
-X[a|c|f|r][x-shift[u]]
-Y[a|c|f|r][y-shift[u]] (more ...)
Shift plot origin.
-bo[ncols][type] (more ...)
Select native binary output.
-ccopies (more ...)
Specify number of plot copies [Default is 1].
-h[i|o][n][+c][+d][+rremark][+rtitle] (more ...)
Skip or produce header record(s).
-ocols[,...] (more ...)
Select output columns (0 is first column).
-p[x|y|z]azim/elev[/zlevel][+wlon0/lat0[/z0]][+vx0/y0] (more ...)
Select perspective view.
-t[transp] (more ...)
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 -JX -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, pscoast, psxy
COPYRIGHT
2016, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
