map_ascii

Syntax

map_ascii --help
map_ascii [-vb] [-old] [-sd yyyymmdd] [-st hr:mn] [-ed yyyymmdd] [-et hr:mn] [-ex hr:mn] name

Synopsis

Calculate the derived potential from a section of a map format file and produce a plain ASCII text file as output.\n

The output format header is: (start timestamp) (end timestamp) (minimum magnetic lat)\n

(Number of grid points)\n\n

where the timestamps have a format of: year month day hour minute second\n\n

The output data arrays is: (potential at that point) (count/flag for data point) (geographic lat) (geographic lon) (magnetic lat) (magnetic lon) (magnetic local time)\n

Options

`--help`	print the help message and exit.
`--version`	print the RST version number and exit.
`-vb`	verbose. Log information to the console.
`-old`	the input file is a `map` format file.
`-old_aacgm`	uses the older AACGM software and coefficients. The default is to use AACGM-v2.
`-sd yyyymmdd`	extract starting from the date yyyymmdd.
`-st hr:mn`	extract starting from the time hr:mn.
`-ed yyyymmdd`	stop extracting at the date yyyymmdd.
`-et hr:mn`	stop extracting at the time hr:mn.
`-ex hr:mn`	extract an interval whose extent is hr:mn.
`name`	filename of the `cnvmap` format file to trim. If this is omitted, the file is read from standard input.

Description

Calculate the derived potential from a section of a map format file and produce a plain ASCII text file as output.

The file is written to standard output

Examples

map_ascii -old 20030405.map > 20030405.txt

Generate a plain ASCII, derived potential file from the file "20030405.map". The potentials are stored in the file "20030405.txt".