AstrometryTask¶
AstrometryTask
matches a source catalog with objects from a reference
catalog and attempts to fit a WCS.
Processing summary¶
AstrometryTask
runs this sequence of operations:
- Find position reference stars that overlap the exposure.
- Match input source catalog to the position reference stars.
- Fit a WCS based on the matches.
Python API summary¶
from lsst.meas.astrom.astrometry import AstrometryTask
-
class
(refObjLoader, schema=None, **kwargs)AstrometryTask
Match an input source catalog with objects from a reference catalog and solve for the WCS
...
-
attribute
config
Access configuration fields and retargetable subtasks.
See also
See the AstrometryTask
API reference for complete details.
Retargetable subtasks¶
matcher¶
- Default
lsst.meas.astrom.matchPessimisticB.MatchPessimisticBTask
- Field type
ConfigurableField
referenceSelector¶
- Default
lsst.meas.algorithms.sourceSelector.ReferenceSourceSelectorTask
- Field type
ConfigurableField
sourceSelector¶
- Default
'science'
- Field type
- Single-selection
RegistryField
- Choices
'science'
lsst.meas.algorithms.sourceSelector.ScienceSourceSelectorTask
'references'
lsst.meas.algorithms.sourceSelector.ReferenceSourceSelectorTask
'objectSize'
lsst.meas.algorithms.objectSizeStarSelector.ObjectSizeStarSelectorTask
'flagged'
lsst.meas.algorithms.flaggedSourceSelector.FlaggedSourceSelectorTask
'astrometry'
lsst.meas.algorithms.astrometrySourceSelector.AstrometrySourceSelectorTask
'matcher'
lsst.meas.algorithms.matcherSourceSelector.MatcherSourceSelectorTask
'diaCatalog'
lsst.ip.diffim.diaCatalogSourceSelector.DiaCatalogSourceSelectorTask
wcsFitter¶
- Default
lsst.meas.astrom.fitTanSipWcs.FitTanSipWcsTask
- Field type
ConfigurableField
Configuration fields¶
forceKnownWcs¶
matchDistanceSigma¶
- Default
2
- Field type
float
RangeField
- Range
- [0,inf)
maxIter¶
- Default
3
- Field type
int
RangeField
- Range
- [1,inf)
minMatchDistanceArcSec¶
- Default
0.001
- Field type
float
RangeField
- Range
- [0,inf)
Examples¶
See lsst.pipe.tasks.photoCal.PhotoCalTask
.
Note
Task documentation is currently in the process of being converted from the old (Doxygen) system to this site. Until that conversion is complete, refer to the Doxygen documentation for PhotoCalTask.
Debugging¶
The lsst.pipe.base.CmdLineTask
command line task interface supports a flag -d to import debug.py from your PYTHONPATH; see lsstDebug
for more about debug.py files.
The available variables in AstrometryTask are
- display (bool)
- If True display information at three stages: after finding reference objects, after matching sources to reference objects, and after fitting the WCS; defaults to False
- frame (int)
- frame to use to display the reference objects; the next two frames are used to display the match list and the results of the final WCS; defaults to 0
To investigate the meas_astrom_astrometry_Debug, put something like
import lsstDebug
def DebugInfo(name):
debug = lsstDebug.getInfo(name) # N.b. lsstDebug.Info(name) would call us recursively
if name == "lsst.meas.astrom.astrometry":
debug.display = True
return debug
lsstDebug.Info = DebugInfo
into your debug.py file and run this task with the –debug flag.