lsst.jointcal.jointcal.JointcalConfig Class Reference
Inheritance diagram for lsst.jointcal.jointcal.JointcalConfig:
Public Member Functions | |
| validate (self) | |
| setDefaults (self) | |
| getSpatialBoundsConnections (self) | |
Public Attributes | |
| outputs | |
Detailed Description
Configuration for JointcalTask
Definition at line 197 of file jointcal.py.
Member Function Documentation
◆ getSpatialBoundsConnections()
|
inherited |
Definition at line 193 of file jointcal.py.
◆ setDefaults()
| lsst.jointcal.jointcal.JointcalConfig.setDefaults | ( | self | ) |
Definition at line 426 of file jointcal.py.
◆ validate()
| lsst.jointcal.jointcal.JointcalConfig.validate | ( | self | ) |
Definition at line 416 of file jointcal.py.
Member Data Documentation
◆ allowLineSearch
|
static |
Initial value:
= pexConfig.Field(
doc="Allow a line search during minimization, if it is reasonable for the model"
" (models with a significant non-linear component, e.g. constrainedPhotometry).",
dtype=bool,
default=False
)
Definition at line 248 of file jointcal.py.
◆ applyColorTerms
|
static |
Initial value:
= pexConfig.Field(
doc="Apply photometric color terms to reference stars?"
"Requires that colorterms be set to a ColortermLibrary",
dtype=bool,
default=False
)
Definition at line 294 of file jointcal.py.
◆ astrometryChipOrder
|
static |
Initial value:
= pexConfig.Field(
doc="Order of the per-chip transform for the constrained astrometry model.",
dtype=int,
default=1,
)
Definition at line 259 of file jointcal.py.
◆ astrometryDoRankUpdate
|
static |
Initial value:
= pexConfig.Field(
doc=("Do the rank update step during minimization (should not change the astrometry fit). "
"Skipping this can help deal with models that are too non-linear."),
dtype=bool,
default=True,
)
Definition at line 315 of file jointcal.py.
◆ astrometryModel
|
static |
Initial value:
= pexConfig.ChoiceField(
doc="Type of model to fit to astrometry",
dtype=str,
default="constrained",
allowed={"simple": "One polynomial per ccd",
"constrained": "One polynomial per ccd, and one polynomial per visit"}
)
Definition at line 274 of file jointcal.py.
◆ astrometryOutlierRelativeTolerance
|
static |
Initial value:
= pexConfig.Field(
doc=("Convergence tolerance for outlier rejection threshold when fitting astrometry. Iterations will "
"stop when the fractional change in the chi2 cut level is below this value. If tolerance is set "
"to zero, iterations will continue until there are no more outliers. We suggest a value of 0.002"
"as a balance between a shorter minimization runtime and achieving a final fitted model that is"
"close to the solution found when removing all outliers."),
dtype=float,
default=0,
)
Definition at line 326 of file jointcal.py.
◆ astrometryRefCat
|
staticinherited |
Initial value:
= pipeBase.connectionTypes.PrerequisiteInput(
doc="The astrometry reference catalog to match to loaded input catalog sources.",
name="gaia_dr2_20200414",
storageClass="SimpleCatalog",
dimensions=("skypix",),
deferLoad=True,
multiple=True,
)
Definition at line 88 of file jointcal.py.
◆ astrometryReferenceErr
|
static |
Initial value:
= pexConfig.Field(
doc=("Uncertainty on reference catalog coordinates [mas] to use in place of the `coord_*Err` fields. "
"If None, then raise an exception if the reference catalog is missing coordinate errors. "
"If specified, overrides any existing `coord_*Err` values."),
dtype=float,
default=None,
optional=True
)
Definition at line 365 of file jointcal.py.
◆ astrometryReferenceSelector
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=ReferenceSourceSelectorTask,
doc="How to down-select the loaded astrometry reference catalog.",
)
Definition at line 357 of file jointcal.py.
◆ astrometryRefObjLoader
|
static |
Initial value:
= pexConfig.ConfigField(
dtype=LoadReferenceObjectsConfig,
doc="Reference object loader for astrometric fit",
)
Definition at line 345 of file jointcal.py.
◆ astrometrySimpleOrder
|
static |
Initial value:
= pexConfig.Field(
doc="Polynomial order for fitting the simple astrometry model.",
dtype=int,
default=3,
)
Definition at line 254 of file jointcal.py.
◆ astrometryVisitOrder
|
static |
Initial value:
= pexConfig.Field(
doc="Order of the per-visit transform for the constrained astrometry model.",
dtype=int,
default=5,
)
Definition at line 264 of file jointcal.py.
◆ colorterms
|
static |
Initial value:
= pexConfig.ConfigField(
doc="Library of photometric reference catalog name to color term dict.",
dtype=ColortermLibrary,
)
Definition at line 300 of file jointcal.py.
◆ debugOutputPath
|
static |
Initial value:
= pexConfig.Field(
dtype=str,
default=".",
doc=("Path to write debug output files to. Used by "
"`writeInitialModel`, `writeChi2Files*`, `writeInitMatrix`.")
)
Definition at line 404 of file jointcal.py.
◆ detailedProfile
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
default=False,
doc="Output separate profiling information for different parts of jointcal, e.g. data read, fitting"
)
Definition at line 410 of file jointcal.py.
◆ dimensions
|
staticinherited |
Definition at line 133 of file jointcal.py.
◆ doAstrometry
|
static |
Initial value:
= pexConfig.Field(
doc="Fit astrometry and write the fitted result.",
dtype=bool,
default=True
)
Definition at line 201 of file jointcal.py.
◆ doc
|
staticinherited |
Definition at line 130 of file jointcal.py.
◆ doPhotometry
|
static |
Initial value:
= pexConfig.Field(
doc="Fit photometry and write the fitted result.",
dtype=bool,
default=True
)
Definition at line 206 of file jointcal.py.
◆ inputCamera
|
staticinherited |
Initial value:
= pipeBase.connectionTypes.PrerequisiteInput(
doc="The camera instrument that took these observations.",
name="camera",
storageClass="Camera",
dimensions=("instrument",),
isCalibration=True,
)
Definition at line 63 of file jointcal.py.
◆ inputSourceTableVisit
|
staticinherited |
Initial value:
= pipeBase.connectionTypes.Input(
doc="Source table in parquet format, per visit",
name="sourceTable_visit",
storageClass="DataFrame",
dimensions=("instrument", "visit"),
deferLoad=True,
multiple=True,
)
Definition at line 70 of file jointcal.py.
◆ inputVisitSummary
|
staticinherited |
Initial value:
= pipeBase.connectionTypes.Input(
doc=("Per-visit consolidated exposure metadata built from calexps. "
"These catalogs use detector id for the id and must be sorted for "
"fast lookups of a detector."),
name="visitSummary",
storageClass="ExposureCatalog",
dimensions=("instrument", "visit"),
deferLoad=True,
multiple=True,
)
Definition at line 78 of file jointcal.py.
◆ matchCut
|
static |
Initial value:
= pexConfig.Field(
doc="Matching radius between fitted and reference stars (arcseconds)",
dtype=float,
default=3.0,
)
Definition at line 228 of file jointcal.py.
◆ maxAstrometrySteps
|
static |
Initial value:
= pexConfig.Field(
doc="Maximum number of minimize iterations to take when fitting astrometry.",
dtype=int,
default=20,
)
Definition at line 340 of file jointcal.py.
◆ maxPhotometrySteps
|
static |
Initial value:
= pexConfig.Field(
doc="Maximum number of minimize iterations to take when fitting photometry.",
dtype=int,
default=20,
)
Definition at line 335 of file jointcal.py.
◆ minMeasuredStarsPerCcd
|
static |
Initial value:
= pexConfig.Field(
doc="Minimum number of measuredStars per ccdImage before printing warnings",
dtype=int,
default=100,
)
Definition at line 238 of file jointcal.py.
◆ minMeasurements
|
static |
Initial value:
= pexConfig.Field(
doc="Minimum number of associated measured stars for a fitted star to be included in the fit",
dtype=int,
default=2,
)
Definition at line 233 of file jointcal.py.
◆ minRefStarsPerCcd
|
static |
Initial value:
= pexConfig.Field(
doc="Minimum number of measuredStars per ccdImage before printing warnings",
dtype=int,
default=30,
)
Definition at line 243 of file jointcal.py.
◆ name
|
staticinherited |
Definition at line 131 of file jointcal.py.
◆ outlierRejectSigma
|
static |
Initial value:
= pexConfig.Field(
doc="How many sigma to reject outliers at during minimization.",
dtype=float,
default=5.0,
)
Definition at line 321 of file jointcal.py.
◆ outputPhotoCalib
|
staticinherited |
Initial value:
= pipeBase.connectionTypes.Output(
doc=("Per-tract, per-visit photometric calibrations derived from the fitted model."
" These catalogs only contain entries for detectors with an output, and use"
" the detector id for the catalog id, sorted on id for fast lookups of a detector."),
name="jointcalPhotoCalibCatalog",
storageClass="ExposureCatalog",
dimensions=("instrument", "visit", "skymap", "tract"),
multiple=True
)
Definition at line 114 of file jointcal.py.
◆ outputs
|
inherited |
Definition at line 183 of file jointcal.py.
◆ outputWcs
|
staticinherited |
Initial value:
= pipeBase.connectionTypes.Output(
doc=("Per-tract, per-visit world coordinate systems derived from the fitted model."
" These catalogs only contain entries for detectors with an output, and use"
" the detector id for the catalog id, sorted on id for fast lookups of a detector."),
name="jointcalSkyWcsCatalog",
storageClass="ExposureCatalog",
dimensions=("instrument", "visit", "skymap", "tract"),
multiple=True
)
Definition at line 105 of file jointcal.py.
◆ photometryDoRankUpdate
|
static |
Initial value:
= pexConfig.Field(
doc=("Do the rank update step during minimization. "
"Skipping this can help deal with models that are too non-linear."),
dtype=bool,
default=True,
)
Definition at line 309 of file jointcal.py.
◆ photometryErrorPedestal
|
static |
Initial value:
= pexConfig.Field(
doc="Systematic term to apply to the measured error on flux or magnitude as a "
"fraction of source flux or magnitude delta (e.g. 0.05 is 5% of flux or +50 millimag).",
dtype=float,
default=0.0,
)
Definition at line 221 of file jointcal.py.
◆ photometryModel
|
static |
Initial value:
= pexConfig.ChoiceField(
doc="Type of model to fit to photometry",
dtype=str,
default="constrainedMagnitude",
allowed={"simpleFlux": "One constant zeropoint per ccd and visit, fitting in flux space.",
"constrainedFlux": "Constrained zeropoint per ccd, and one polynomial per visit,"
" fitting in flux space.",
"simpleMagnitude": "One constant zeropoint per ccd and visit,"
" fitting in magnitude space.",
"constrainedMagnitude": "Constrained zeropoint per ccd, and one polynomial per visit,"
" fitting in magnitude space.",
}
)
Definition at line 281 of file jointcal.py.
◆ photometryRefCat
|
staticinherited |
Initial value:
= pipeBase.connectionTypes.PrerequisiteInput(
doc="The photometry reference catalog to match to loaded input catalog sources.",
name="ps1_pv3_3pi_20170110",
storageClass="SimpleCatalog",
dimensions=("skypix",),
deferLoad=True,
multiple=True,
)
Definition at line 96 of file jointcal.py.
◆ photometryReferenceSelector
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=ReferenceSourceSelectorTask,
doc="How to down-select the loaded photometry reference catalog.",
)
Definition at line 361 of file jointcal.py.
◆ photometryRefObjLoader
|
static |
Initial value:
= pexConfig.ConfigField(
dtype=LoadReferenceObjectsConfig,
doc="Reference object loader for photometric fit",
)
Definition at line 349 of file jointcal.py.
◆ photometryVisitOrder
|
static |
Initial value:
= pexConfig.Field(
doc="Order of the per-visit polynomial transform for the constrained photometry model.",
dtype=int,
default=7,
)
Definition at line 304 of file jointcal.py.
◆ positionErrorPedestal
|
static |
Initial value:
= pexConfig.Field(
doc="Systematic term to apply to the measured position error (pixels)",
dtype=float,
default=0.02,
)
Definition at line 216 of file jointcal.py.
◆ sourceFluxType
|
static |
Initial value:
= pexConfig.Field(
dtype=str,
doc="Source flux field to use in source selection and to get fluxes from the catalog.",
default='apFlux_12_0'
)
Definition at line 211 of file jointcal.py.
◆ sourceSelector
|
static |
Initial value:
= sourceSelectorRegistry.makeField(
doc="How to select sources for cross-matching",
default="science"
)
Definition at line 353 of file jointcal.py.
◆ storageClass
|
staticinherited |
Definition at line 132 of file jointcal.py.
◆ useInputWcs
|
static |
Initial value:
= pexConfig.Field(
doc="Use the input calexp WCSs to initialize a SimpleAstrometryModel.",
dtype=bool,
default=True,
)
Definition at line 269 of file jointcal.py.
◆ writeChi2FilesInitialFinal
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
doc=("Write .csv files containing the contributions to chi2 for the initialization and final fit. "
"Output files will be written to `config.debugOutputPath` and will "
"be of the form `astrometry_[initial|final]_chi2-TRACT-FILTER."),
default=False
)
Definition at line 383 of file jointcal.py.
◆ writeChi2FilesOuterLoop
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
doc=("Write .csv files containing the contributions to chi2 for the outer fit loop. "
"Output files will be written to `config.debugOutputPath` and will "
"be of the form `astrometry_init-NN_chi2-TRACT-FILTER`."),
default=False
)
Definition at line 390 of file jointcal.py.
◆ writeInitialModel
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
doc=("Write the pre-initialization model to text files, for debugging. "
"Output files will be written to `config.debugOutputPath` and will be "
"of the form `initial_astrometry_model-TRACT_FILTER.txt`."),
default=False
)
Definition at line 397 of file jointcal.py.
◆ writeInitMatrix
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
doc=("Write the pre/post-initialization Hessian and gradient to text files, for debugging. "
"Output files will be written to `config.debugOutputPath` and will "
"be of the form 'astrometry_[pre|post]init-TRACT-FILTER-mat.txt'. "
"Note that these files are the dense versions of the matrix, and so may be very large."),
default=False
)
Definition at line 375 of file jointcal.py.
The documentation for this class was generated from the following file:
- python/lsst/jointcal/jointcal.py
Generated on Fri Apr 24 2026 08:50:55 for lsst.jointcal by
1.13.2