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.
iridium
This Perl script uses Astro::SpaceTrack (not included) to download
Iridium data from http://celestrak.com/ and predict flares for the
next two days at the given location, which is hard-coded as Los
Pinos, Ciudad Mexico, Mexico. It takes about 30 seconds on a
lightly-loaded 800 MHz PowerPC G4.
iss
This Perl script uses Astro::SpaceTrack (not included) to download
orbital data from http://spaceflight.nasa.gov/realdata/elements/ and
predict visibility for the next week from the given location, which
is hard-coded as 80 Wellington Street Ottawa Ontario Canada.
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.
tle_period.t
This is not really a test, since I have no canonical data to test
against. It is really a demonstration of the effect the model chosen
and geophysical constants used have on the calculation of period. It
expects to be run from the main distribution directory as (e.g.)
perl -Mblib eg/tle_period.t
and it expects to find the orbital elements file sgp4-ver.tle in the
t directory.
t/xml
This demonstration script downloads International Space Station TLE
data from Celestrak, predicts passes over The Hague, Netherlands,
and displays the results as XML, using XML::Writer. The pass_variant
attribute is used to control what events of a pass are displayed.
visual
This script has nothing directly to do with this package. What it
does is to download the Celestrak web site's list of visual
satellites, and Mike McCants' visual list (with magnitudes) and
compares the two. With the -merge option, it also gets McCants'
total list and produces a magnitude table suitable for
Astro::Coord::ECI::TLE, which is why this script is here.
# ex: set textwidth=72 autoindent :