|
HMI Ring Diagrams
Pipeline Module Specifications
|
rdfitc
Module Version
0.9 16 IX 2009
General Description
rdfitc implements the procedure of Basu and Antia (ApJ 512, 458;
Solar Phys 192, 469) for fitting 3-d solar acoustic power spectra to
a multi-parameter model for line and background characteristics
Status
This version has been superseded by Version 1.0
Never used for ring-diagram pipelines
Included in JSOC release 5.6 as rdfitc
The source code and Makefile are in the JSOC CVS repository
This version supersedes Version 0.8
Usage
rdfitc [-nvx2] in= InputDescriptor out= OutputDescriptor
[param= val ...]
Flags
-n no fitting (diagnostics only)
-v run verbose
-x extra reporting of number of iterations
-2 calculate second derivatives explicitly
Parameters
in the name of an input data set (record selection)
guessfile Name of a file containing the initial frequency guesses;
should be a rooted pathname.
Default: /home/rick/rings/fit/sb_ringfit/freq.guess
out Name of the output data series (or file)
Default: fit.out
The value of the out parameter is interpreted as the name of
of a data series, and if such a series exists with insert
permission, the output fit files and logs will be inserted as
records in that series; otherwise, the value will be interpreted
as the name of a file to which the fit parameters are written,
and the log information goes to stderr.
nmin Minimum radial (vertical) order to fit. Default: 0
nmax Maximum radial order to fit. Default: 8
lmin Minimum equivalent spherical-harmonic degree to fit. Default: 100
lmax Maximum degree to fit. Default: 1400
fmin Minimum frequency to fit [μHz]. Default: 900
fmax Maximum frequency to fit [μHz]. Default: 7000
bfgsct Number of iterations for bfgs function.. Default: 125
linminct Number of iterations for linmim function.. Default: 15
ux Initial guess for zonal flow speed [m/s]. Default: 0.0
uy Initial guess for meridional flow speed [m/s]. Default: 0.0
Input Data series class:
power spectra of data cubes
Input keys used or inspected:
WCSNAME, CTYPE1, CTYPE2, CTYPE3, CUNIT1, CUNIT2, CUNIT3, CDELT1, CDELT2, CDELT3
DELTA_K*, RSunRef, DELTA_NU*, D_OMEGA*, LOG_BASE
* only if preferred keys not found
Sample input series:
mdi.rdVpspec_dp
Output Data series class:
ring diagram mode fits
Output keys set (if possible):
CarrTime*, Module, Source
* if not propagated
Input keys propagated to output (if possible):
PrimeKeyString, CarrRot, CMLon, CarrTime, LonHG, LatHG, MidTime, Duration,
MapProj, MapScale, PosAng, Width, Height, ZonalTrk, ZonalVel, MeridTrk, MeridVel,
Sample output series:
mdi.rdVfitsc_dp
Changes from Previous Version
— Output is to DRMS, and conforms to current standard for output series
— Frequency scalings are based on WCS keywords in input when possible;
keywords propagated from tracking are not used (though propoagated)
— In versions built prior to 16 Nov 2009, the values printed for k (but
not l) were too large by a factor of 4π2
Bugs in current version
The output column for δν (5) is labeled w_0 (and identical with
column 19), since there is no formal uncertainty on the frequency.
It should, however, be the uncertainty on w_0.
The quality parameters sn (amplitude/background) and pk (the fit
power-law exponent for ν(l) are not printed (simply because they
were not included in the standard).
If either of the flags -2x are given the output will not conform to
the standard; the flag -2 is not correctly interpreted in any case.
Not all keywords are properly copied from input.
It is implicitly assumed (not checked) that the input power spectrum
is centred, with CRPIX1 = cols / 2 + 1, CRPIX2 = rows / 2 + 1, CRPIX3 = 1,
CRVALi = 0.0, and that the units are in Mm-1 and sec-1; only the units
are verified. The code will not work properly if the number of rows or
columns is odd.