Curve of Growth#
The curve of growth method (CoG) is described in Yu et al. (2020).
dysh tries to follow the description given by Yu et al. (2020), but there are some differences.
Here we describe the dysh implementation of the CoG method, which is available through the Spectrum.cog method or through the dysh.spectra.core.curve_of_growth().
An example of how to use Spectrum.cog is provided in the HI survey tutorial.
Central Velocity#
If no central velocity is specified (parameter vc), it will be computed using the first moment of the spectrum inside the ranges defined by bchan and echan.
That is
where \(T(v_{i})\) are the flux values at channels \(v_{i}\).
This method is not robust, meaning that small baseline deviations from a flat response will bias the result.
To minimize these effects we recommend selecting a spectral range around the spectral line of interest, either using the bchan and echan arguments or by cropping the spectrum.
If no value of vc is provided, the uncertainty in the estimated \(v_{\mathrm{c}}\) is computed as
where \(N\) is the number of channels and \(\sigma\) is the rms in the line free channels.
Line Area#
For the line area (or line intensity, flux intensity, integrated intensity) we use the same definition as Yu et al. (2020), their equation (1). To determine the line area, \(F_{\mathrm{t}}\), we take the median of \(F_{\mathrm{t}}(v)\) after it becomes flat. To determine the point at which \(F_{\mathrm{t}}(v)\) becomes flat, we estimate the slope of \(F_{\mathrm{t}}(v)\) and take the point at which the slope, \(s\), satisfies
with \(f\) being the parameter flat_tol (defaults to 0.1) and \(\sigma_{s}\) is the rms of \(s\).
The estimated line area is returned as the flux entry in the return dictionary.
The uncertainty in the line area is estimated as the rms of \(F_{\mathrm{t}}(v)\) after it becomes flat.
This also incorporates 3% of the line area, which was determined empirically using synthetic spectra (added in quadrature to the rms of \(F_{\mathrm{t}}(v)\)).
The uncertainty in the line area is returned as the flux_std entry in the return dictionary.
Line Width#
For the line width we use the same definition as Yu et al. (2020).
As the authors note, this is different than \(W_{x}\) in that the line widths are those that enclose a certain fraction of the line intensity, whereas \(W_{x}\) is the line width at a fraction \(x\) of the peak flux.
The line width is returned as the width entry in the return dictionary.
This entry is another dictionary, where each key is the fraction of the flux and the value the width at that fraction.
For example,
cog = Spectrum.cog()
cog["width"][0.5]
is the line width that encompases 50% of the line area.
To estimate the uncertainty in the line width we compute the error in the normalized curve of growth, \(\hat{F}=F_{\mathrm{t}}(v)/F_{\mathrm{t}}\),
with \(\sigma_{F_{\mathrm{t}}(v)}\) the uncertainty in the curve of growth \(F_{\mathrm{t}}(v)\) and \(\sigma_{F_{\mathrm{t}}}\) the uncertainty in the line area.
We estimate \(\sigma_{F_{\mathrm{t}}(v)}\) as the rms in the line free channels times the channel width.
Then, we compute the width adding and subtracting \(\sigma_{\hat{F}}\) to \(\hat{F}\) at each fraction of the line area.
The final uncertainty is the maximum between the difference of the width and the width plus \(\sigma_{\hat{F}}\), the width minus \(\sigma_{\hat{F}}\), and the channel width.
We add 1% of the line width to the uncertainty in the line width, which was determined empirically using synthetic spectra.
The uncertainty in the line width is returned as the width_std entry in the return dictionary.
And, as the width entry, it is also a dictionary.
Flux and Shape Assymetry#
For the flux assymetry, \(A_{F}\), we use the definition of Yu et al. (2020).
This is returned as the A_F entry in the return dictionary.
We do not provide an estimate for the uncertainty in \(A_{F}\).
For the second assymetry parameter, \(A_{C}\), we use the definition of Yu et al. (2020).
This is returned as the A_C entry in the return dictionary.
We do not provide an estimate for the uncertainty in \(A_{C}\).
The assymetry parameters \(A_{F}\) and \(A_{C}\) are close to unity for symmetric line profiles, and greater for more assymetric line profiles.
Concentration#
For the concentration of the line profile, \(C_{V}\), we use the definition of Yu et al. (2020)
where \(V_{85}\) and \(V_{25}\) are the line widths at 85% and 25% of the total flux, respectively.
The concentration is returned as the C_V parameter in the return dictionary.
We do not provide an estimate for the uncertainty in \(C_{V}\).
As noted by Yu et al. (2020), a Gaussian profile has \(C_{V}=3.9\), while a boxcar prifile has \(C_{V}=3.4\).