view release on metacpan or  search on metacpan

script/satpass  view on Meta::CPAN

If the location contains whitespace, it must be quoted. Example:

 satpass> geocode_us '1600 pennsylvania ave washington dc'

Because of restrictions on the use of the Geocoder.us site, you may not
use this command for commercial purposes.

If you wish to use this command, you must install the
B<Geo::Coder::OSM> module.

=item geocode_vi

 satpass> geocode_vi location

The U.S. Virgin Islands are handled by L<geocode_us|/geocode_us>.

=item height

 satpass> height latitude longitude country

This command attempts to look up the height above sea level at the
given latitude and longitude in the given country. The country is an
ISO 3166 two-character country code, and defaults to the contents of the
L<country|/country> parameter.

Yes, technically country is redundant given latitude and longitude, but
I lacked a means to take advantage of this in practice.

This command actually works by dispatching to one of the following
height_* commands, which may also be invoked explicitly. In fact,
it is the existence of such a command that makes a given country
code work.

The latitude and longitude can be omitted, in which case the current
L<latitude|/latitude> and L<longitude|/longitude> parameters are
used.

In addition to the global options, the following options are available
for this command:

-all causes all results to be fetched, rather than just the 'best' one.
This probably makes no difference in the value you get, since the
results are assumed to be in descending order of goodness, and we
return the first one.

-retry_on_zero specifies the number of times to retry the query if the
result is zero. The default is 0, but you can specify more.

-source_layer specifies the data set to retrieve the height from. The
default is '-1', which specifies the 'best' dataset. This is ignored
unless -all is asserted, and you can probably ignore it too.

These options are also available on all of the 'height_*' commands.

=item height_af

 satpass> height_af latitude longitude

Afghanistan is handled by L<height_us|/height_us>, since this is
(supposedly) covered by the U.S. Geological Survey's Afghanistan
Digital Elevation Model.

=item height_as

 satpass> height_as latitude longitude

American Samoa is handled by L<height_us|/height_us>.

=item height_ca

 satpass> height_ca latitude longitude

This command is equivalent to L<height_us|/height_us> and in fact is
handled by it since the U.S. Geological Survey dataset includes all of
North America. But in order to cover some observed weirdness in the
data returned, -source_layer is defaulted to 'SRTM.C_1TO19_3' and
-retry_on_zero is defaulted to 3.

=item height_fm

 satpass> height_fm latitude longitude

The Federated States of Micronesia are handled by L<height_us|/height_us>.

=item height_gu

 satpass> height_gu latitude longitude

Guam is handled by L<height_us|/height_us>.

=item height_mh

 satpass> height_mh latitude longitude

The Marshall Islands are handled by L<height_us|/height_us>.

=item height_mp

 satpass> height_mp latitude longitude

The Northern Mariana Islands are handled by L<height_us|/height_us>.

=item height_pr

 satpass> height_pr latitude longitude

Puerto Rico is handled by L<height_us|/height_us>.

=item height_pw

 satpass> height_pw latitude longitude

Palau is handled by L<height_us|/height_us>.

=item height_us

 satpass> height_us latitude longitude

This command attempts to look up the height above sea level at the
given latitude and longitude in the U.S. Geological Survey's EROS
Web Services (L<http://gisdata.usgs.gov/>). If the lookup succeeds,
the latitude and longitude parameters are set to the arguments and
the height parameter is set to the result.

The latitude and longitude default to the current
L<latitude|/latitude> and L<longitude|/longitude> parameters.

If you wish to use this command, you must install the
B<Geo::Webservice::Elevation::USGS> module.

B<Caveat:> It is the author's experience that this resource is not
always available. You should probably geocode your usual location
and put its latitude, longitude and height in the initialization
file. You can use macros to define alternate locations if you
want.

=item height_vi

 satpass> height_vi latitude longitude

The U.S. Virgin Islands are handled by L<height_us|/height_us>.

=item help

 satpass> help

This command can be used to get usage help. Without arguments, it
displays the documentation for this script (hint: you are reading this
now). You can get documentation for related Perl modules by specifying
the appropriate arguments, as follows:

 eci ------ Astro::Coord::ECI
 iridium -- Astro::Coord::ECI::TLE::Iridium
 moon ----- Astro::Coord::ECI::Moon
 sun ------ Astro::Coord::ECI::Sun
 st ------- Astro::SpaceTrack
 star ----- Astro::Coord::ECI::Star
 tle ------ Astro::Coord::ECI::TLE
 utils ---- Astro::Coord::ECI::Utils

The viewer is whatever is the default for your system.

If you set the L<webcmd|/webcmd> parameter properly, this
command will launch the L<https://metacpan.org/> page for this
package, and any arguments will be ignored.

=item list

 satpass> list

This command displays the observing list. Each body's NORAD ID, name
(if available), dataset epoch, and orbital period are displayed. If
the observing list is empty, you get a message to that effect.

In addition to the global options, the following options are legal for
the list command:

-choose chooses bodies from the observing list. It works the same way
as the L<choose|/choose> command, but does not alter the observing
list. You can specify multiple bodies by specifying -choose multiple