view release on metacpan or  search on metacpan

eg/README  view on Meta::CPAN

This directory contains examples of how to use Astro::Coord::ECI and
its subclasses. The following examples are provided:

almanac
    This Perl script produces an almanac of Sun and Moon positions for
    the current day, or optionally for the next day. By default the
    almanac is for 1600 Pennsylvania Avenue Washington DC, but this can
    be changed by setting environment variable ALMANAC_POSITION, or
    specifying latitude north (degrees), longitude east (degrees),
    and height (meters) on the command. The option -help gets you
    brief help.

Astro-Coord-ECI.yml
    This CPAN client prefs file causes the satpass script to be
    installed by default. To use this file, place a copy of it in your
    CPAN client's preferences directory (e.g. .cpan/prefs for the 'cpan'
    client and a Unix-like operating system.)

azimuth
    This Perl script finds the next time the Sun passes a given azimuth
    (defaulting to 180 degrees) at Number 10 Downing Street.

closest
    This Perl script takes as input a time (suitable for Date::Manip), a
    right ascension and declination (both in degrees) and a list of the
    names of files containing TLE data. The output is the OID, right
    ascension, declination, and angular separation (in degrees) of the
    bodies closest to the given position as seen from Parliament House
    in Australia.

convert_tle
    This Perl script reads orbital data in either TLE or JSON format,
    and converts it to the other format. The JSON is similar to (read:
    uses the same keys as) the Space Track REST interface. The -help
    option gets you the documentation.

iss
    This Perl script uses Astro::SpaceTrack (not included) to download
    orbital data for the International Space Station and the Chinese
    Space Station, and predict visibility for the next week from the
    given location, which is hard-coded as 80 Wellington Street Ottawa
    Ontario Canada.

maidenhead
    This Perl script converts posiitons between latitude/longitude and
    Maidenhead locator grid positions.

passes
    This Perl script is kind of a "poor man's satpass", which downloads
    TLE data for the requested satellites (Astro::SpaceTrack and a Space
    Track account are required), and lists rise and set times in
    chronological order. You specify your location, Space Track account
    information, and other options either on the command line, in an
    initialization file, or both places. The --help option gets you the
    documentation.

positions
    This Perl script takes on its command line the names of files
    containing TLE data. All are read, and the elevation, azimuth and
    range of all satellites is displayed at one minute intervals for the
    current GMT day. Output is supressed when the satellite is below the
    horizon. The position is hard-wired to Parliament House, Australia.

sh_script
    This shell script executes the satpass Perl script (which comes with
    this distribution) passing it commands from a 'here document.' These
    commands download International Space Station data from
    http://spaceflight.nasa.gov/realdata/elements/ and predict
    visibility at the current time from 1600 Pennsylvania Avenue,
    Washington DC, USA.

solstice
    This Perl script calculates equinoxes and solstices for the given
    year, defaulting to the current year, in either UTC or local time.
    If DateTime::Calendar::Christian is available, dates will be given
    in the Julian or Gregorian calendars as appropriate.