lsst.meas.astrom

Tasks and methods for finding an astrometric solution, including:

• AstrometryTask compute an astrometric solution for a set of sources detected

  on an Exposure

Default subtasks used by AstrometryTask:

• MatchOptimisticBTask match sources to reference objects

• FitTanSipWcsTask fit a TAN-SIP WCS given a list of matches of sources

  and reference objects

Contributing

lsst.meas.astrom is developed at https://github.com/lsst/meas_astrom. You can find Jira issues for this module under here.

Task reference

Tasks

AstrometryTask

Match an input source catalog with objects from a reference catalog and solve for the WCS.

DirectMatchTask

Simple, brute force matching of a source catalog to a reference catalog.

FitSipDistortionTask

Fit a TAN-SIP WCS given a list of reference object/source matches.

FitTanSipWcsTask

Fit a TAN-SIP WCS given a list of reference object/source matches.

MatchOptimisticBTask

Match sources to reference objects using the Optimistic Pattern Matcher B algorithm of Tabur 2007.

MatchPessimisticBTask

Match sources to reference objects.

RefMatchTask

Match an input source catalog with objects from a reference catalog.

Python API reference

lsst.meas.astrom Package

Functions

approximateWcs(wcs, bbox[, order, nx, ny, ...])	Approximate an existing WCS as a TAN-SIP WCS
compose(*args, **kwargs)	Overloaded function.
construct_pattern_and_shift_rot_matrix(...)
denormalizeMatches(matches[, matchMeta])	Generate a denormalized Catalog of matches
displayAstrometry([refCat, sourceCat, ...])	Show an astrometry debug image.
makeCreateWcsWithSip(*args, **kwargs)	Overloaded function.
makeMatchStatistics(*args, **kwargs)	Overloaded function.
makeMatchStatisticsInPixels(*args, **kwargs)	Overloaded function.
makeMatchStatisticsInRadians(*args, **kwargs)	Overloaded function.
makeProxies(*args, **kwargs)	Overloaded function.
makeWcs(sipForward, sipReverse, skyOrigin)
plotAstrometry(matches[, refCat, sourceCat, ...])	Plot reference objects, sources and matches
radec_to_xy(ra_vec, dec_vec, factor, wcs)
rotateWcsPixelsBy90(wcs, nQuarter, dimensions)
setMatchDistance(matches)	Set the distance field of the matches in a match list to the distance in radians on the sky.
transformWcsPixels(wcs, s)

Classes

AstrometryConfig(*args, **kw)	Config for AstrometryTask.
AstrometryError(msg, **kwargs)	Parent class for failures in astrometric fitting.
AstrometryFitFailure(msg, **kwargs)	Raised if the astrometry fitter fails.
AstrometryTask([refObjLoader, schema])	Match an input source catalog with objects from a reference catalog and solve for the WCS.
BadAstrometryFit(distMean, maxMeanDist, ...)	Raised if the quality of the astrometric fit is worse than some threshold.
CatalogExtras(catalog[, select, ...])	Store frequently-reference (meta)data relevant for matching a catalog.
ComparableCatalog(catalog, column_coord1, ...)	A catalog with sources with coordinate columns in some standard format/units.
ConvertCatalogCoordinatesConfig(*args, **kw)	Configuration for the MatchProbabilistic matcher.
CreateWcsWithSipReferenceMatch
CreateWcsWithSipSourceMatch
DirectMatchConfig(*args, **kw)	Configuration for DirectMatchTask.
DirectMatchConfigWithoutLoader(*args, **kw)	Configuration for DirectMatchTask when an already-initialized refObjLoader will be passed to this task.
DirectMatchTask([refObjLoader])	Simple, brute force matching of a source catalog to a reference catalog.
FitAffineWcsConfig(*args, **kw)	Config for FitTanSipWcsTask.
FitAffineWcsTask([config, name, parentTask, log])	Fit a TAN-SIP WCS given a list of reference object/source matches.
FitSipDistortionConfig(*args, **kw)	Config for FitSipDistortionTask
FitSipDistortionTask(**kwargs)	Fit a TAN-SIP WCS given a list of reference object/source matches.
FitTanSipWcsConfig(*args, **kw)	Config for FitTanSipWcsTask.
FitTanSipWcsTask([config, name, parentTask, log])	Fit a TAN-SIP WCS given a list of reference object/source matches.
LeastSqFitter1dPoly
LeastSqFitter2dPoly
MatchOptimisticBConfig(*args, **kw)	Configuration for MatchOptimisticBTask
MatchOptimisticBControl
MatchOptimisticBTask(**kwargs)	Match sources to reference objects using the Optimistic Pattern Matcher B algorithm of Tabur 2007.
MatchPessimisticBConfig(*args, **kw)	Configuration for MatchPessimisticBTask
MatchPessimisticBTask(**kwargs)	Match sources to reference objects.
MatchProbabilisticConfig(*args, **kw)	Configuration for the MatchProbabilistic matcher.
MatchProbabilisticTask(**kwargs)	Run MatchProbabilistic on a reference and target catalog covering the same tract.
MatchSrcToCatalogue
MatchTolerance([maxMatchDist])	Stores match tolerances for use in lsst.meas.astrom.AstrometryTask and later iterations of the matcher.
MatchTolerancePessimistic([maxMatchDist, ...])	Stores match tolerances for use in AstrometryTask and later iterations of the matcher.
MatcherFailure(msg, **kwargs)	Raised if the matcher fails.
MatcherProbabilistic(config)	A probabilistic, greedy catalog matcher.
OutlierRejectionControl
PatternResult
PessimisticPatternMatcherB(reference_array, log)	Class implementing a pessimistic version of Optimistic Pattern Matcher B (OPMb) from `Tabur (2007)`_, as described in `DMTN-031`_
PolynomialTransform
ProxyPair
RecordProxy
RefMatchConfig(*args, **kw)
RefMatchTask([refObjLoader])	Match an input source catalog with objects from a reference catalog.
ScaledPolynomialTransform
ScaledPolynomialTransformFitter
SipForwardTransform
SipReverseTransform
TransformedSkyWcsMaker(inputSkyWcs)	Convenience class for appending a shifting an input SkyWcs on sky and appending an affine transform.