NAME

nigeodown - download and install geomagnetic quantities

USAGE

nigeodown infile outdir

DESCRIPTION

nigeodown downloads geomagnetic data for use with NICER software tools. The data are downloaded and installed automatically.

nigeodown is intended to run somewhat automatically so that users can use it with automated software scripts. Thus, there are no "ask" parameters, only hidden parameters with sensible defaults.

The 'infile' is the URL where the geomagnetic data are stored, as a gzipped tar archive file. The 'outdir' is where the unarchived geomagnetic FITS files should be installed.

The task tries to download the data with both the 'curl' and 'wget' programs. If both programs fail or are not accessible, the task will die with an error.

The task will create outdir if it is not already created. outdir should be writable by the user.

By default outdir=$GEOMAG_PATH, which means that the task will consult the GEOMAG_PATH environment variable. Users are encouraged to set this environment variable to the location where they will store geomagnetic data.

PARAMETERS

(infile) [string]
URL where geomagnetic data can be obtained, as a zipped tar file.

(outdir="$GEOMAG_PATH") [string]
Output directory where data files will be installed. This directory must be writable, and the task will attempt to create it if it does not already exist. The usage $VARNAME indicates to use the indicated environment variable as the output directory, with $GEOMAG_PATH being the recommended environment variable name.
(chatter = 2) [integer, 0 - 5]
Controls the amount of informative text written to standard output.

EXAMPLES

Download geomagnetic data to $HOME/geomag

        export GEOMAG_PATH=$HOME/geomag
        nigeodown 
Note that users are encouraged to place the "export GEOMAG_PATH" statement in their .bashrc or equivalent.

SEE ALSO

nicerl2

geomagterp

LAST MODIFIED

Oct 2022