make_fit

Syntax

Synopsis

Creates a fit or fitacf format file from a raw (dat) or rawacf format file using one of the SuperDARN fitting algorithms. A description of each fitting algorithm is available at https://radar-software-toolkit-rst.readthedocs.io/en/latest/user_guide/make_fit/

Options

`--help`	print the help message and exit.
`--version`	print the RST version number and exit.
`rawacfname`	filename of the `rawacf` format file. If this is omitted the file is read from standard input.
`-fitacf3`	Uses FitACF 3.0 fitting algorithm
`-fitacf2`	Uses FitACF 2.5 fitting algorithm
`-lmfit2`	Uses LMFit 2.0 fitting algorithm (Not yet implemented: use make_lmfit2 binary)
`-lmfit1`	Uses LMFit 1.0 fitting algorithm
`-fitex2`	Uses FitEx 2.0 fitting algorithm
`-fitex1`	Uses FitEx 1.0 fitting algorithm
`-tdiff tdiff`	Use a fixed value of tdiff (in units of microseconds) when calculating elevation angles.
`-tdiff_method method`	Use tdiff values from the calibration method of method when calculating elevation angles (0: Ponomarenko-2015; 1: Burrell-2016; 2: Ponomarenko-2018; 3: Chisham-2018; 4: Chisham-2021; 5: Thomas-2024). Note: this option overrides -tdiff
`-old`	input file is in `raw` (`dat`) file format and the output should be in `fit` file format.
`-old_elev`	use old elevation angle algorithm(s).
`rawname`	filename of the `raw` (`dat`) format file.
`fitname`	filename of the `fit` format file to create.
`[inxname]`	filename of the associated index file to create.

Description

Creates a fit or fitacf format file from a raw (dat) or rawacf format file. If the "-old" option is not specified then the fitacf format file is written to standard output.

Examples

make_fit -fitacf3 -vb 19981105.kap.rawacf > 19981105.kap.fitacf3

Generates a fitacf file using FitACF3.0 from the rawacf file "19981105.kap.rawacf" to produce a file called "19981105.kap.fitacf". Status is logged on standard error.

make_fit -fitacf2 19981105.kap.rawacf > 19981105.kap.fitacf2

Generates a fitacf file using FitACF2.5 from the rawacf file "19981105.kap.rawacf" to produce a file called "19981105.kap.fitacf". Status is logged on standard error.

make_fit -fitacf2 -old 19971020.gbr.dat 19971020.gbr.fit 19971020.gbr.inx

Generates a fit file using FitACF2.5 from the dat file "19971020.gbr.dat" to produce a file called "19971020.gbr.fit" and an index file called "19971020.gbr.inx".