ecdipeval

Syntax

ecdipeval --help
ecdipeval [-i] [-lat lat] [-lon lon] [-alt alt] [-fmt format]
ecdipeval [-i] [-f filename] [-fmt format]

Synopsis

Convert to and from eccentric dipole coordinates.

Options

`--help`	print the help message and exit.
`--version`	print the RST version number and exit.
`-i`	perform the inverse conversion.
`-mlt`	perform the conversion between magnetic longitude and magnetic local time.
`-lat lat`	calculate for the latitude lat.
`-lon lon`	calculate for the longitude lon.
`-alt alt`	calculate for the altitude in kilometers, alt.
`-re Re`	calculate for the Earth radius in kilometers, Re (inverse only).
`-d yyyymmdd`	calculate for the date yyyymmdd.
`-t hr:mn`	calculate for the time hr:mn.
`-fmt format`	use the string fmt, to format the output.
`-f filename`	read a sequence of latitudes, longitudes and altitudes from the ASCII file, filename.

Description

Converts to and from eccentric dipole coordinates. The output is written to standard output using the formatting string given by the "-fmt" option. The format string should be in the same format as that used by the printf function and will take two double precision floating point numbers as arguments.

If the "-f" option is given, the latitude,longitude and altitude are read from a space separated ASCII file. If the filename is "-" input is read from standard input.

Examples

ecdipeval -lat 85.4 -lon 32.4 -alt 300.0

Convert the coordinate given by latitude of 85.4 degrees, longitude 32.4 degrees and altitude of 300 kilometers to eccentric dipole coordinates.

ecdipeval -i -f ecdip.txt

Convert the eccentric dipole coordinates in the file "ecdip.txt", back to geographic coordinates.