istp_text

Syntax

istp_text --help
istp_text [-cf cfgname] [-h] [-path pathname] [-sd yyyymmdd] [-st hr:mn] [-ed yyyymmdd] [-et hr:mn] [-ex hr:mn [-gse] [-pos] [-mfi] [-swe] [-mag] [-pla] [-mgf] [-lep] [-cpi] [-ace] [-wind] [-imp8] [-geotail]

Synopsis

Extract ASCII listings of ISTP data from CDF files.

Options

`--help`	print the help message and exit.
`--version`	print the RST version number and exit.
`-cf cfname`	read command line options from the file cfname.
`-h`	include headers in the text file.
`-path path`	read the data files from the directory path.
`-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.
`-gse`	plot in GSE coordinates, not GSM.
`-pos`	include spacecraft position in the text file.
`-mfi`	include MFI data.
`-swe`	include SWE data.
`-mag`	include MAG data.
`-pla`	include PLA data.
`-mgf`	include MGF data.
`-lep`	include LEP data.
`-cpi`	include CPI data.
`-ace`	include ACE data.
`-wind`	include Wind data.
`-imp8`	include IMP8 data.
`-geotail`	include Geotail data.

Description

Generates a plain ASCII text file containing ISTP magnetic field and solar wind data from a set of CDF files. The file is written to standard output.

The program usually produces 24 hours of magnetic field data in GSM co-ordinates for a given start date and satellite.

The data files are taken from the sub-directories "ace", "wind", "imp8" and "geotail", of the path given by the "-path" option or by the environment variable ISTP_PATH.

Examples

istp_text  -ace -sd 19990406 > mfi.txt

Generate a text file containing 24 hours of ACE data starting at 00:00UT on April, 6 1999. The output is stored in the file "mfi.txt".

istp_text -wind -mfi -swe -pos -sd 19971014 -st 4:00 -ex 8:00 > 19981112.wnd.txt

Generate a text file containing 8 hours of Wind MFI, SWE and position data starting at 04:00UT October 14, 1997. The output is stored in the file "19981112.wnd.txt".

istp_text -ace -mfi -pos -sd 19990406 -st 6:00 -ed 19990408 -et 12:00 > mfi+pos.txt

Generate a text file containing ACE MFI and Position data, starting at 06:00UT April 6, 1999 and ending at 12:00UT April 8,1999. The output is stored in the file "mfi+pos.txt".