sofia_redux.calibration: Flux Calibration Algorithms¶
The sofia_redux.calibration
package contains data reduction algorithms for the
flux calibration of imaging instruments. It is designed to be used with
SOFIA pipelines, integrated into the sofia_redux
package. Currently,
the FORCAST, FLITECAM, and HAWC+ instruments are supported.
Getting Started¶
Using Calibration Utilities¶
The primary calibration functions provided by this package are:
Apply a correction for atmospheric opacity
Compute aperture photometry and calibration parameters on known flux standards
Apply flux calibration to an image
The easiest access to these functions are provided in the
sofia_redux.calibration.pipecal_util
submodule, as apply_tellcor
, run_photometry
,
and apply_fluxcal
respectively. A standalone script, called
sofia_redux.calibration.pipecal_applyphot
is also available to directly calculate
photometry and store the results in FITS headers.
Submodule¶
Reference/API¶
sofia_redux.calibration.pipecal_applyphot Module¶
Calculate aperture photometry and update FITS header.
Functions¶
|
Calculate photometry on a FITS image and store results to FITS header. |
sofia_redux.calibration.pipecal_calfac Module¶
Calculate a calibration factor from a standard flux value.
Functions¶
|
Calculate the calibration factor for a flux standard. |
sofia_redux.calibration.pipecal_config Module¶
Calibration configuration.
Functions¶
|
Parse all reference files and return appropriate configuration values. |
|
Read response files. |
sofia_redux.calibration.pipecal_fitpeak Module¶
Fit a 2D function to an image.
Functions¶
|
Function for an elliptical Gaussian profile. |
|
Function for an elliptical Lorentzian profile. |
|
Function for an elliptical Moffat profile. |
|
Fit a peak profile to a 2D image. |
sofia_redux.calibration.pipecal_photometry Module¶
Fit a source and perform aperture photometry.
Functions¶
|
Perform aperture photometry and profile fits on image data. |
sofia_redux.calibration.pipecal_rratio Module¶
Calculate response ratio for atmospheric correction.
Functions¶
|
Calculate the R ratio for a given ZA and Altitude or PWV. |
sofia_redux.calibration.pipecal_util Module¶
Utility and convenience functions for common pipecal use cases.
Functions¶
|
Robust average of zenith angle from FITS header. |
|
Robust average of altitude from FITS header. |
|
Robust average of precipitable water vapor from FITS header. |
|
Estimate the position of a standard source in the image. |
|
Add calibration-related keywords to a header. |
|
Add photometry-related keywords to a header. |
|
Retrieve a flux calibration factor from configuration. |
|
Apply a flux calibration factor to an image. |
|
Retrieve a telluric correction factor from configuration. |
|
Apply a telluric correction factor to an image. |
|
Run photometry on an image of a standard source. |
sofia_redux.calibration.pipecal_error Module¶
Base class for pipecal errors.
Classes¶
A ValueError raised by pipecal functions. |