view release on metacpan or  search on metacpan

eg/passes  view on Meta::CPAN

     -split is not asserted);
 v - event (Astro::Coord::ECI::TLE PASS_EVENT_* numeric code);
 V - event (string, if available from Astro::Coord::ECI::TLE);
 % - a literal '%'.

The behavior when any other character follows the '%' is undefined. The
word 'undefined' does not mean that you get a literal C<undef> under
those circumstances. It means that the behavior (whatever it is) may not
be what you expect or want, and that it may change without notice.

All times are formatted according to the value of the C<--time-format>
option.

The default template is '%V %L %T' (that is, the name of the event,
whether the satellite is lit or shadowed, and the time of the event).

=item -finish iso_time_or_days

This option specifies the finish time. It is either an ISO-8601-ish
string such as is legal for C<-start>, or a plus sign followed by an
integer, which is the number of days after the C<-start> time.

The default is '+7'.

=item -geometric

This option specifies that rise and set take place when the satellite
crosses the geometric horizon, regardless of the setting of the
C<-horizon> option. If not asserted, rise and set take place when the
satellite crosses the elevation specified by the C<-horizon> option.

This option can be negated by specifying C<-nogeometric>.

The default is C<-nogeometric>

=item -gmt

This option specifies that times be either GMT (if asserted) or local
(if negated). It can be negated by specifying C<-nogmt>.

The default is C<-nogmt>.

=item -height meters_above_geoid

This option specifies the observer's height in meters above the WGS84
geoid.

The default is 0.

=item -horizon degrees_of_elevation

This option specifies the effective horizon in degrees above (or below,
if negative) the geometric horizon.

The default is 0.

=item -join joining_string

This option specifies the string to be inserted between events in the
output. This string is run through the templating system before use, but
the only supported characters after a percent sign are 't' to insert a
horizontal tab, 'n' to insert a newline, and '%' to insert a literal
percent sign.  The results of using any other character after a percent
sign are undefined.

The default is '%n%t' (that is, a newline followed by a horizontal tab).

=item -latitude degrees_north_of_equator

This option specifies the observer's latitude in degrees. South
latitudes are negative.

This option must be specified. There is no default.

=item -longitude degrees_east_of_prime_meridian

This option specifies the observer's longitude in degrees east of
Greenwich England. West longitudes are negative.

This option must be specified. There is no default.

=item -password spacetrack_password

This option specifies the Space Track password.

This option must be specified. There is no default.

=item -split

This option reports individual events of a pass separately. This may be
more useful for telling how many satellites are above the horizon at a
given time. If negated (which is the default, and which can be specified
explicitly by C<-nosplit>) you get all events for the pass on the same
line.

The default is C<-noevent>.

=item -start iso_time

This option specifies the start time as an ISO-8601-ish time. Only the
year-month-day-hour-minute-second version of the specification is
implemented. Years must be 4 digits, and all other fields must be two
digits. Trailing fields can be omitted, and default to 00 or 01 as
appropriate. Non-numeric characters may appear between fields, and after
the final field. So, for example,

 -start 2010-04-01:00:00:00

specifies a start at midnight of April 1 2010. In fact, so does

 -start 201004

As a convenience, the date portion can be replaced by one of the strings
C<yesterday>, C<today>, or C<tomorrow>. So data starting today at noon
can be specified as

 -start today12

The default is 'today', meaning midnight, since all the time fields
default to 0.

=item -split