wcslib (8.2.2)

Usage: fitshdr [-q N] [<infile>]

List headers from a FITS file specified on the command line, or else on
stdin, printing them as 80-character keyrecords without trailing blanks.

Options:
  -q N         Quit after reading the Nth header, where N is an integer
               (optional space between -q and N).

Usage: sundazel [<option>] [<yyyymmdd>]

sundazel computes the local time of the Sun's passage through the
specified apparent longitude or latitude in a user-defined coordinate
system, for the specified location on the specified date (default today).

The Sun's apparent hour angle, azimuth, elevation, and the longitude and
latitude in user coordinates are also printed, in degrees.  Refraction is
accounted for.

sundazel may also be used to compute the time of sunrise and set, the
Sun's right ascension and declination, and the Equation of Time.

Options:
  -p <option>
       The Solar passage required and, if relevant, the coordinate value
       in degrees:
         sunrise           Sunrise.
         sunset            Sunset.
         lng=<lng>         Longitude of the Sun in the user-defined
                           coordinate system.
         lat=<lat>         Latitude of the Sun in the user-defined
                           coordinate system.
  -l <lng>,<lat>
       Longitude and latitude of the observer.
  -t <tz>
       The observer's time zone, positive east of Greenwich (hr).
  -u <az>,<el>,<zlng>
       Azimuth and elevation of the pole of the user-defined coordinate
       system, and the longitude of the zenith (deg).  See below.
  -n   Set the user-defined coordinate system as one with pole due north
       on the horizon, with zero of longitude at the zenith.
  -w   Set the user-defined coordinate system as one with pole due west
       on the horizon, with zero of longitude at the zenith.
  -v   Also print the Sun's right ascension, declination (deg), and the
       Equation of Time (min).

The user-defined coordinate system is a right-handed spherical coordinate
system with its pole at the specified azimuth and elevation, and with
zenith having the specified longitude.  If omitted, the default is a
right-handed system with its pole at the zenith and prime meridian due
north, i.e. similar to azimuth and elevation except that longitude
increases in the reverse sense to azimuth, i.e. from north through west
rather than north through east.

Setting a range of azimuth or elevation often provides a poor criterion
for timing the passage of the Sun, for example in determining when it
shines directly through a skylight, or when an awning casts a shadow on a
particular point on the ground.  In such cases the projection of the
skylight or awning from the ground onto the sky should be considered.
Some other coordinate system may provide a better fit to the region of the
sky thereby defined.  For example, the passage of the Sun across a
skylight oriented at azimuth alpha might be handled via a coordinate
system with pole on the horizon at that azimuth and considering the Sun's
passage through a range of longitude in this system.  Perhaps better might
be to use a coordinate system with pole at alpha-90 and considering a
range of latitude.

Sunrise and sunset correspond to first/last contact of the Sun's limb on
the horizon, corresponding to apparent elevation -0.27 deg (true elevation
-0.79 deg).  If no options are specified, the default is to calculate the
time of sunset.  If more than one p option is specified, only the last is
effective.

tofits turns a list of FITS header keyrecords, one per line, into a proper
FITS header by padding them with blanks to 80 characters and stripping out
newline characters.  It also pads the header to an integral number of 2880-
byte blocks if necessary.

The input byte stream is assumed to be ASCII-encoded.  Characters outside
the set of text characters allowed by FITS (ASCII 0x20 to 0x7E) are ignored
with the sole exception that a byte with value 0xA0 (non-breaking space in
all variants of ISO/IEC 8859) is translated to an ordinary space (0x20).
Thus input encoded in ISO/IEC 8859 or UTF-8 should be interpreted correctly,
with any illegal characters in keycomments simply being ignored.

tofits has no options and operates as a filter, reading from stdin and
writing to stdout, e.g.

    tofits < infile > outfile

Input lines beginning with '#' are treated as comments.