map_fit

Syntax

map_fit --help
map_fit [-vb] [-old] [-ew errwgt] [-mw modelwgt] [-s source] [mapname]

Synopsis

Perform the Spherical Harmonic Fitting on a convection map file.

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.
`-ecdip`	use eccentric dipole coordinates rather than AACGM.
`-ew errwgt`	set the error weighting to errwgt, which can be either yes or no. If yes, the data vector errors will be taken from the values in the grid file (default). If no, the average error of the data vectors will be assigned to all data vectors.
`-mw modelwgt`	set the model weighting to modelwgt, which can be either yes or no. If no, the average error of the data vectors will be scaled by the order of the fit and then applied to the model vectors (default). If yes, the average error of the data vectors will not be scaled by the order of the fit before being applied to the model vectors.
`-o order`	set the order of the fit to be order.
`-s source`	set the text string indicating the data source to source.
`mapname`	filename of the `cnvmap` format file. If this is omitted, the file will
	be read from standard input.

Description

Performs spherical harmonic fitting on a convection map file.

The file created is written to standard output.

The input map file must contain valid model data to ensure that the fit converges.

Examples

map_fit -old -ew y -mw n 19981020.map > 19981020.shf.map

Performs spherical harmonic fitting on the map file called "19981020.map". Errors are weighted and model weighting is set to normalized. The file created is called "19981020.shf.map" and status is logged to standard error.