lsst.pipe.tasks g253578fa50+e0a50b457a
Loading...
Searching...
No Matches
lsst.pipe.tasks.functors.LocalWcs Class Reference
Inheritance diagram for lsst.pipe.tasks.functors.LocalWcs:
lsst.pipe.tasks.functors.Functor lsst.pipe.tasks.functors.ComputePixelScale lsst.pipe.tasks.functors.ConvertDetectorAngleToPositionAngle lsst.pipe.tasks.functors.ConvertPixelSqToArcsecondsSq lsst.pipe.tasks.functors.ConvertPixelToArcseconds

Public Member Functions

 __init__ (self, colCD_1_1, colCD_1_2, colCD_2_1, colCD_2_2, **kwargs)
 
 computeDeltaRaDec (self, x, y, cd11, cd12, cd21, cd22)
 
 computeSkySeparation (self, ra1, dec1, ra2, dec2)
 
 getSkySeparationFromPixel (self, x1, y1, x2, y2, cd11, cd12, cd21, cd22)
 
 computePositionAngle (self, ra1, dec1, ra2, dec2)
 
 getPositionAngleFromDetectorAngle (self, theta, cd11, cd12, cd21, cd22)
 
 name (self)
 
 noDup (self)
 
 columns (self)
 
 multilevelColumns (self, data, columnIndex=None, returnTuple=False)
 
 __call__ (self, data, dropna=False)
 
 difference (self, data1, data2, **kwargs)
 
 fail (self, df)
 
 shortname (self)
 

Public Attributes

 colCD_1_1 = colCD_1_1
 
 colCD_1_2 = colCD_1_2
 
 colCD_2_1 = colCD_2_1
 
 colCD_2_2 = colCD_2_2
 
 filt = filt
 
str dataset = dataset if dataset is not None else self._defaultDataset
 
 log = logging.getLogger(type(self).__name__)
 
 name
 

Protected Member Functions

 _get_data_columnLevels (self, data, columnIndex=None)
 
 _get_data_columnLevelNames (self, data, columnIndex=None)
 
 _colsFromDict (self, colDict, columnIndex=None)
 
 _func (self, df, dropna=True)
 
 _get_columnIndex (self, data)
 
 _get_data (self, data)
 
 _setLevels (self, df)
 
 _dropna (self, vals)
 

Protected Attributes

 _noDup = noDup
 

Static Protected Attributes

str _defaultDataset = 'ref'
 
tuple _dfLevels = ('column',)
 
bool _defaultNoDup = False
 

Detailed Description

Computations using the stored localWcs.

Definition at line 1222 of file functors.py.

Constructor & Destructor Documentation

◆ __init__()

lsst.pipe.tasks.functors.LocalWcs.__init__ ( self,
colCD_1_1,
colCD_1_2,
colCD_2_1,
colCD_2_2,
** kwargs )

Definition at line 1226 of file functors.py.

Member Function Documentation

◆ __call__()

lsst.pipe.tasks.functors.Functor.__call__ ( self,
data,
dropna = False )
inherited

Definition at line 353 of file functors.py.

◆ _colsFromDict()

lsst.pipe.tasks.functors.Functor._colsFromDict ( self,
colDict,
columnIndex = None )
protectedinherited
Converts dictionary column specficiation to a list of columns.

Definition at line 223 of file functors.py.

◆ _dropna()

lsst.pipe.tasks.functors.Functor._dropna ( self,
vals )
protectedinherited

Definition at line 350 of file functors.py.

◆ _func()

lsst.pipe.tasks.functors.Functor._func ( self,
df,
dropna = True )
protectedinherited

Reimplemented in lsst.pipe.tasks.functors.Color, lsst.pipe.tasks.functors.Column, lsst.pipe.tasks.functors.ComputePixelScale, lsst.pipe.tasks.functors.ConvertDetectorAngleToPositionAngle, lsst.pipe.tasks.functors.ConvertPixelSqToArcsecondsSq, lsst.pipe.tasks.functors.ConvertPixelToArcseconds, lsst.pipe.tasks.functors.CoordColumn, lsst.pipe.tasks.functors.CustomFunctor, lsst.pipe.tasks.functors.DeconvolvedMoments, lsst.pipe.tasks.functors.E1, lsst.pipe.tasks.functors.E2, lsst.pipe.tasks.functors.Ebv, lsst.pipe.tasks.functors.HsmFwhm, lsst.pipe.tasks.functors.HsmTraceSize, lsst.pipe.tasks.functors.HtmIndex20, lsst.pipe.tasks.functors.Index, lsst.pipe.tasks.functors.LocalDipoleDiffFlux, lsst.pipe.tasks.functors.LocalDipoleDiffFluxErr, lsst.pipe.tasks.functors.LocalDipoleMeanFlux, lsst.pipe.tasks.functors.LocalDipoleMeanFluxErr, lsst.pipe.tasks.functors.LocalNanojansky, lsst.pipe.tasks.functors.LocalNanojanskyErr, lsst.pipe.tasks.functors.Mag, lsst.pipe.tasks.functors.MagDiff, lsst.pipe.tasks.functors.MagErr, lsst.pipe.tasks.functors.MomentsG1Sky, lsst.pipe.tasks.functors.MomentsG2Sky, lsst.pipe.tasks.functors.MomentsIuuSky, lsst.pipe.tasks.functors.MomentsIuvSky, lsst.pipe.tasks.functors.MomentsIvvSky, lsst.pipe.tasks.functors.MomentsTraceSky, lsst.pipe.tasks.functors.MultibandSinglePrecisionFloatColumn, lsst.pipe.tasks.functors.NanoJansky, lsst.pipe.tasks.functors.NanoJanskyErr, lsst.pipe.tasks.functors.PositionAngleFromMoments, lsst.pipe.tasks.functors.PsfHsmTraceSizeDiff, lsst.pipe.tasks.functors.PsfSdssTraceSizeDiff, lsst.pipe.tasks.functors.RADecCovColumn, lsst.pipe.tasks.functors.RadiusFromQuadrupole, lsst.pipe.tasks.functors.ReferenceBand, lsst.pipe.tasks.functors.SdssTraceSize, lsst.pipe.tasks.functors.SemimajorAxisFromMoments, lsst.pipe.tasks.functors.SemiminorAxisFromMoments, and lsst.pipe.tasks.functors.SinglePrecisionFloatColumn.

Definition at line 296 of file functors.py.

◆ _get_columnIndex()

lsst.pipe.tasks.functors.Functor._get_columnIndex ( self,
data )
protectedinherited
Return columnIndex.

Definition at line 299 of file functors.py.

◆ _get_data()

lsst.pipe.tasks.functors.Functor._get_data ( self,
data )
protectedinherited
Retrieve DataFrame necessary for calculation.

The data argument can be a `~pandas.DataFrame`, a
`~lsst.daf.butler.DeferredDatasetHandle`, or
an `~lsst.pipe.base.InMemoryDatasetHandle`.

Returns a DataFrame upon which `self._func` can act.

Definition at line 307 of file functors.py.

◆ _get_data_columnLevelNames()

lsst.pipe.tasks.functors.Functor._get_data_columnLevelNames ( self,
data,
columnIndex = None )
protectedinherited
Gets the content of each of the column levels for a multilevel
table.

Definition at line 209 of file functors.py.

◆ _get_data_columnLevels()

lsst.pipe.tasks.functors.Functor._get_data_columnLevels ( self,
data,
columnIndex = None )
protectedinherited
Gets the names of the column index levels.

This should only be called in the context of a multilevel table.

Parameters
----------
data : various
    The data to be read, can be a
    `~lsst.daf.butler.DeferredDatasetHandle` or
    `~lsst.pipe.base.InMemoryDatasetHandle`.
columnIndex (optional): pandas `~pandas.Index` object
    If not passed, then it is read from the
    `~lsst.daf.butler.DeferredDatasetHandle`
    for `~lsst.pipe.base.InMemoryDatasetHandle`.

Definition at line 189 of file functors.py.

◆ _setLevels()

lsst.pipe.tasks.functors.Functor._setLevels ( self,
df )
protectedinherited

Definition at line 345 of file functors.py.

◆ columns()

◆ computeDeltaRaDec()

lsst.pipe.tasks.functors.LocalWcs.computeDeltaRaDec ( self,
x,
y,
cd11,
cd12,
cd21,
cd22 )
Compute the dRA, dDec from dx, dy.

Parameters
----------
x : `~pandas.Series`
    X pixel coordinate.
y : `~pandas.Series`
    Y pixel coordinate.
cd11 : `~pandas.Series`
    [1, 1] element of the local Wcs affine transform.
cd12 : `~pandas.Series`
    [1, 2] element of the local Wcs affine transform.
cd21 : `~pandas.Series`
    [2, 1] element of the local Wcs affine transform.
cd22 : `~pandas.Series`
    [2, 2] element of the local Wcs affine transform.

Returns
-------
raDecTuple : tuple
    RA and Dec conversion of x and y given the local Wcs.
    Returned units are in radians.

Notes
-----
If x and y are with respect to the CRVAL1, CRVAL2
then this will return the RA, Dec for that WCS.

Definition at line 1238 of file functors.py.

◆ computePositionAngle()

lsst.pipe.tasks.functors.LocalWcs.computePositionAngle ( self,
ra1,
dec1,
ra2,
dec2 )
Compute position angle (E of N) from (ra1, dec1) to (ra2, dec2).

Parameters
----------
ra1 : iterable [`float`]
    RA of the first coordinate [radian].
dec1 : iterable [`float`]
    Dec of the first coordinate [radian].
ra2 : iterable [`float`]
    RA of the second coordinate [radian].
dec2 : iterable [`float`]
    Dec of the second coordinate [radian].

Returns
-------
Position Angle: `~pandas.Series`
    radians E of N

Notes
-----
(ra1, dec1) -> (ra2, dec2) is interpreted as the shorter way around the sphere

For a separation of 0.0001 rad, the position angle is good to 0.0009 rad
all over the sphere.

Definition at line 1327 of file functors.py.

◆ computeSkySeparation()

lsst.pipe.tasks.functors.LocalWcs.computeSkySeparation ( self,
ra1,
dec1,
ra2,
dec2 )
Compute the local pixel scale conversion.

Parameters
----------
ra1 : `~pandas.Series`
    Ra of the first coordinate in radians.
dec1 : `~pandas.Series`
    Dec of the first coordinate in radians.
ra2 : `~pandas.Series`
    Ra of the second coordinate in radians.
dec2 : `~pandas.Series`
    Dec of the second coordinate in radians.

Returns
-------
dist : `~pandas.Series`
    Distance on the sphere in radians.

Definition at line 1269 of file functors.py.

◆ difference()

lsst.pipe.tasks.functors.Functor.difference ( self,
data1,
data2,
** kwargs )
inherited
Computes difference between functor called on two different
DataFrame/Handle objects.

Definition at line 365 of file functors.py.

◆ fail()

lsst.pipe.tasks.functors.Functor.fail ( self,
df )
inherited

Definition at line 371 of file functors.py.

◆ getPositionAngleFromDetectorAngle()

lsst.pipe.tasks.functors.LocalWcs.getPositionAngleFromDetectorAngle ( self,
theta,
cd11,
cd12,
cd21,
cd22 )
Compute position angle (E of N) from detector angle (+y of +x).

Parameters
----------
theta : `float`
    detector angle [radian]
cd11 : `float`
    [1, 1] element of the local Wcs affine transform.
cd12 : `float`
    [1, 2] element of the local Wcs affine transform.
cd21 : `float`
    [2, 1] element of the local Wcs affine transform.
cd22 : `float`
    [2, 2] element of the local Wcs affine transform.

Returns
-------
Position Angle: `~pandas.Series`
    Degrees E of N.

Definition at line 1368 of file functors.py.

◆ getSkySeparationFromPixel()

lsst.pipe.tasks.functors.LocalWcs.getSkySeparationFromPixel ( self,
x1,
y1,
x2,
y2,
cd11,
cd12,
cd21,
cd22 )
Compute the distance on the sphere from x2, y1 to x1, y1.

Parameters
----------
x1 : `~pandas.Series`
    X pixel coordinate.
y1 : `~pandas.Series`
    Y pixel coordinate.
x2 : `~pandas.Series`
    X pixel coordinate.
y2 : `~pandas.Series`
    Y pixel coordinate.
cd11 : `~pandas.Series`
    [1, 1] element of the local Wcs affine transform.
cd12 : `~pandas.Series`
    [1, 2] element of the local Wcs affine transform.
cd21 : `~pandas.Series`
    [2, 1] element of the local Wcs affine transform.
cd22 : `~pandas.Series`
    [2, 2] element of the local Wcs affine transform.

Returns
-------
Distance : `~pandas.Series`
    Arcseconds per pixel at the location of the local WC.

Definition at line 1295 of file functors.py.

◆ multilevelColumns()

lsst.pipe.tasks.functors.Functor.multilevelColumns ( self,
data,
columnIndex = None,
returnTuple = False )
inherited
Returns columns needed by functor from multilevel dataset.

To access tables with multilevel column structure, the
`~lsst.daf.butler.DeferredDatasetHandle` or
`~lsst.pipe.base.InMemoryDatasetHandle` needs to be passed
either a list of tuples or a dictionary.

Parameters
----------
data : various
    The data as either `~lsst.daf.butler.DeferredDatasetHandle`, or
    `~lsst.pipe.base.InMemoryDatasetHandle`.
columnIndex (optional): pandas `~pandas.Index` object
    Either passed or read in from
    `~lsst.daf.butler.DeferredDatasetHandle`.
`returnTuple` : `bool`
    If true, then return a list of tuples rather than the column
    dictionary specification.
    This is set to `True` by `CompositeFunctor` in order to be able to
    combine columns from the various component functors.

Reimplemented in lsst.pipe.tasks.functors.Color, and lsst.pipe.tasks.functors.CompositeFunctor.

Definition at line 242 of file functors.py.

◆ name()

◆ noDup()

lsst.pipe.tasks.functors.Functor.noDup ( self)
inherited
Do not explode by band if used on object table.

Definition at line 175 of file functors.py.

◆ shortname()

lsst.pipe.tasks.functors.Functor.shortname ( self)
inherited
Short name of functor (suitable for column name/dict key).

Reimplemented in lsst.pipe.tasks.functors.Color, and lsst.pipe.tasks.functors.MagDiff.

Definition at line 380 of file functors.py.

Member Data Documentation

◆ _defaultDataset

str lsst.pipe.tasks.functors.Functor._defaultDataset = 'ref'
staticprotectedinherited

Definition at line 164 of file functors.py.

◆ _defaultNoDup

bool lsst.pipe.tasks.functors.Functor._defaultNoDup = False
staticprotectedinherited

Definition at line 166 of file functors.py.

◆ _dfLevels

tuple lsst.pipe.tasks.functors.Functor._dfLevels = ('column',)
staticprotectedinherited

Definition at line 165 of file functors.py.

◆ _noDup

lsst.pipe.tasks.functors.Functor._noDup = noDup
protectedinherited

Definition at line 171 of file functors.py.

◆ colCD_1_1

lsst.pipe.tasks.functors.LocalWcs.colCD_1_1 = colCD_1_1

Definition at line 1232 of file functors.py.

◆ colCD_1_2

lsst.pipe.tasks.functors.LocalWcs.colCD_1_2 = colCD_1_2

Definition at line 1233 of file functors.py.

◆ colCD_2_1

lsst.pipe.tasks.functors.LocalWcs.colCD_2_1 = colCD_2_1

Definition at line 1234 of file functors.py.

◆ colCD_2_2

lsst.pipe.tasks.functors.LocalWcs.colCD_2_2 = colCD_2_2

Definition at line 1235 of file functors.py.

◆ dataset

str lsst.pipe.tasks.functors.Functor.dataset = dataset if dataset is not None else self._defaultDataset
inherited

Definition at line 170 of file functors.py.

◆ filt

lsst.pipe.tasks.functors.Functor.filt = filt
inherited

◆ log

lsst.pipe.tasks.functors.Functor.log = logging.getLogger(type(self).__name__)
inherited

Definition at line 172 of file functors.py.

◆ name


The documentation for this class was generated from the following file: