makedata.pl - Produces calibrated FGM data using raw data and calibration files. Based on gsepos4cd1s_multi provided by eg. Compressed input files are transparently managed.
makedata.pl [--year year] --month month --days days_list [--begin begin_time] [--end end_time] [--fgmcalfile fgmcalfile] [--spacecraft spacecraft] [--coordinates coordinate_system] [--resolution resolution] [--outdir output_directory] [--name filename] [--ICL] [--version version] [--(no)archived] [--help]
This script produces calibrated FGM data using raw data and calibration files with various resolutions and in various coordinate systems. If daily calibration files for range 7 are found, they are used, otherwise, the default range 7 calibration files are used.
The year. One or two digits. Default is the current year.
The month. One or two digits. Mandatory argument.
The spacecraft number (1-4) or list of spacecraft e.g -s '1 3 4'.
Default all spacecraft.
List of days given as a string. Ranges are permitted,
e.g -d '3 12 15-28 30'. Mandatory argument.
Specify the starting time. Full format is hh:mm:ss.mmm. If only the first part
ot the format is given, the rest is filled with zeroes. e.g. -b 2 is
same as -b 02:00:00:000 or -b 03:45 is same as
-b 03:45:00.000. Default is 00:00:00.000.
Specify the end time of the interval. Same format as for -begin option.
Deafult is 23:59:59.999.
The output coordinate system. Default is GSE. Valid values are:
=item I<sr> for spin-reference system,
The resolution of output data. It can be given as an integer n or as 1/n. Also spin can be used to obtain spin averaged data. If not specified the data is not interpolated and the output will have the actual acquisition rate.
Use the Imperial College London raw data. Default is to use the ESTEC raw data.
The destination directory for the output files. Default is $FGMROOT/data/output/$coordposress.
The base name of the output file. Output file name will be CNfilename.dat. Default is CN_YYYYMMDD_hh:mm-hh:mm_coordPosRes.dat
Specify the fgmcal calibration file to use. It also sets the $FGMPATH environment variable to the directory where the calibration file resides.
Version of the calibration files. If this option is not given then the environment variable FGMVERSION is used. If FGMVERSION is not set, then the default version is 3. Has no effect if the calibration file is given using the -fgmcalfile option.
Use the archived calibration files. This is the default and sets the $FGMPATH environment variable to archived calibration files directory, $FGMROOT/archive/calfiles/fgmcal/YYYY/MM/. If this option is negated with --noarchived then the existing $FGMPATH environment variable is used, or falls back to the default path $FGMROOT/data/dcalf/ if $FGMPATH is not already set. Has no effect if the calibration file is given using the --fgmcalfile option.
Prints a brief help message.
Root for the FGM calibration directory structure. Default to /home/FGM/ if not set.
Path to the fgmcal calibration files. Default to $FGMROOT/archive/calfiles/fgmcal/YYYY/MM/ or to $FGMROOT/data/dcalf/ if --noarchived option is used. The basename of the fgmcal file is used if this it is given via the -fgmcalfile option.
Path to orbit parameters files. Default to $FGMROOT/log/atorb/ if not set.
Path to orbit parameters files. Default to $FGMROOT/log/atorb/ if not set.
$FGMROOT/data/raw/ICL/ - Imperial input path. Raw files are searched recursively in this directory.
$FGMROOT/data/raw/ESTEC/ - ESTEC (default) input path. Raw files are searched recursively in this directory.
/home/FGM/archive/calfiles/fgmcal/20$yy/$mm/ - calibration files path.
CN_YYYYMMDD_Vnn.fgmcal, CN_YYYYMMDDrange7.fgmcal - daily calibration files.
CN_range7.fgmcal - default range 7 calibration files.
$FGMROOT/data/output/coordPosRes - output directory unless -o option is used.
CN_YYYYMMDD_hh:mm-hh:mm_coordPosRes.dat - output file
This script uses the following:
ddsmrg, ddscut, fgmtel, fgmcal, fgmhrt, fgmav, fgmpos, igmvec.
Dragos Constantinescu <d.constantinescu@tu-bs.de>