lsst.meas.algorithms gf82c78fb6f+5b4928dc2e
Loading...
Searching...
No Matches
Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes | List of all members
lsst.meas.algorithms.brightStarStamps.BrightStarStamps Class Reference
Inheritance diagram for lsst.meas.algorithms.brightStarStamps.BrightStarStamps:
lsst.meas.algorithms.stamps.Stamps lsst.meas.algorithms.stamps.StampsBase

Public Member Functions

def __init__ (self, starStamps, innerRadius=None, outerRadius=None, nb90Rots=None, metadata=None, use_mask=True, use_variance=False, use_archive=False)
 
def initAndNormalize (cls, starStamps, innerRadius, outerRadius, nb90Rots=None, metadata=None, use_mask=True, use_variance=False, use_archive=False, imCenter=None, discardNanFluxObjects=True, statsControl=afwMath.StatisticsControl(), statsFlag=afwMath.stringToStatisticsProperty("MEAN"), badMaskPlanes=('BAD', 'SAT', 'NO_DATA'))
 
def readFits (cls, filename)
 
def readFitsWithOptions (cls, filename, options)
 
def append (self, item, innerRadius=None, outerRadius=None)
 
def extend (self, bss)
 
def getMagnitudes (self)
 
def getGaiaIds (self)
 
def getAnnularFluxes (self)
 
def selectByMag (self, magMin=None, magMax=None)
 

Public Attributes

 normalized
 
 nb90Rots
 

Protected Member Functions

def _refresh_metadata (self)
 
def _checkRadius (self, innerRadius, outerRadius)
 
def _checkNormalization (self, normalize, innerRadius, outerRadius)
 

Protected Attributes

 _outerRadius
 

Detailed Description

Collection of bright star stamps and associated metadata.

Parameters
----------
starStamps : `collections.abc.Sequence` [`BrightStarStamp`]
    Sequence of star stamps. Cannot contain both normalized and
    unnormalized stamps.
innerRadius : `int`, optional
    Inner radius value, in pixels. This and ``outerRadius`` define the
    annulus used to compute the ``"annularFlux"`` values within each
    ``starStamp``. Must be provided if ``normalize`` is True.
outerRadius : `int`, optional
    Outer radius value, in pixels. This and ``innerRadius`` define the
    annulus used to compute the ``"annularFlux"`` values within each
    ``starStamp``. Must be provided if ``normalize`` is True.
nb90Rots : `int`, optional
    Number of 90 degree rotations required to compensate for detector
    orientation.
metadata : `lsst.daf.base.PropertyList`, optional
    Metadata associated with the bright stars.
use_mask : `bool`
    If `True` read and write mask data. Default `True`.
use_variance : `bool`
    If ``True`` read and write variance data. Default ``False``.
use_archive : `bool`
    If ``True`` read and write an Archive that contains a Persistable
    associated with each stamp. In the case of bright stars, this is
    usually a ``TransformPoint2ToPoint2``, used to warp each stamp
    to the same pixel grid before stacking.

Raises
------
ValueError
    Raised if one of the star stamps provided does not contain the
    required keys.
AttributeError
    Raised if there is a mix-and-match of normalized and unnormalized
    stamps, stamps normalized with different annulus definitions, or if
    stamps are to be normalized but annular radii were not provided.


Notes
-----
A butler can be used to read only a part of the stamps, specified by a
bbox:

>>> starSubregions = butler.get("brightStarStamps", dataId, parameters={'bbox': bbox})

Definition at line 151 of file brightStarStamps.py.

Constructor & Destructor Documentation

◆ __init__()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps.__init__ (   self,
  starStamps,
  innerRadius = None,
  outerRadius = None,
  nb90Rots = None,
  metadata = None,
  use_mask = True,
  use_variance = False,
  use_archive = False 
)

Reimplemented from lsst.meas.algorithms.stamps.StampsBase.

Definition at line 201 of file brightStarStamps.py.

Member Function Documentation

◆ _checkNormalization()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps._checkNormalization (   self,
  normalize,
  innerRadius,
  outerRadius 
)
protected
Ensure there is no mixing of normalized and unnormalized stars, and
that, if requested, normalization can be performed.

Definition at line 468 of file brightStarStamps.py.

◆ _checkRadius()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps._checkRadius (   self,
  innerRadius,
  outerRadius 
)
protected
Ensure provided annulus radius is consistent with that already
present in the instance, or with arguments passed on at initialization.

Definition at line 459 of file brightStarStamps.py.

◆ _refresh_metadata()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps._refresh_metadata (   self)
protected
Refresh the metadata. Should be called before writing this object
out.

Reimplemented from lsst.meas.algorithms.stamps.Stamps.

Definition at line 312 of file brightStarStamps.py.

◆ append()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps.append (   self,
  item,
  innerRadius = None,
  outerRadius = None 
)
Add an additional bright star stamp.

Parameters
----------
item : `BrightStarStamp`
    Bright star stamp to append.
innerRadius : `int`, optional
    Inner radius value, in pixels. This and ``outerRadius`` define the
    annulus used to compute the ``"annularFlux"`` values within each
    ``BrightStarStamp``.
outerRadius : `int`, optional
    Outer radius value, in pixels. This and ``innerRadius`` define the
    annulus used to compute the ``"annularFlux"`` values within each
    ``BrightStarStamp``.

Reimplemented from lsst.meas.algorithms.stamps.Stamps.

Definition at line 364 of file brightStarStamps.py.

◆ extend()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps.extend (   self,
  bss 
)
Extend BrightStarStamps instance by appending elements from another
instance.

Parameters
----------
bss : `BrightStarStamps`
    Other instance to concatenate.

Reimplemented from lsst.meas.algorithms.stamps.Stamps.

Definition at line 390 of file brightStarStamps.py.

◆ getAnnularFluxes()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps.getAnnularFluxes (   self)
Retrieve normalization factors for each star.

These are computed by integrating the flux in annulus centered on the
bright star, far enough from center to be beyond most severe ghosts and
saturation. The inner and outer radii that define the annulus can be
recovered from the metadata.

Returns
-------
annularFluxes : `list` [`float`]

Definition at line 423 of file brightStarStamps.py.

◆ getGaiaIds()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps.getGaiaIds (   self)
Retrieve Gaia IDs for each star.

Returns
-------
gaiaIds : `list` [`int`]

Definition at line 414 of file brightStarStamps.py.

◆ getMagnitudes()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps.getMagnitudes (   self)
Retrieve Gaia G magnitudes for each star.

Returns
-------
gaiaGMags : `list` [`float`]

Definition at line 405 of file brightStarStamps.py.

◆ initAndNormalize()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps.initAndNormalize (   cls,
  starStamps,
  innerRadius,
  outerRadius,
  nb90Rots = None,
  metadata = None,
  use_mask = True,
  use_variance = False,
  use_archive = False,
  imCenter = None,
  discardNanFluxObjects = True,
  statsControl = afwMath.StatisticsControl(),
  statsFlag = afwMath.stringToStatisticsProperty("MEAN"),
  badMaskPlanes = ('BAD', 'SAT', 'NO_DATA') 
)
Normalize a set of bright star stamps and initialize a
BrightStarStamps instance.

Since the center of bright stars are saturated and/or heavily affected
by ghosts, we measure their flux in an annulus with a large enough
inner radius to avoid the most severe ghosts and contain enough
non-saturated pixels.

Parameters
----------
starStamps : `collections.abc.Sequence` [`BrightStarStamp`]
    Sequence of star stamps. Cannot contain both normalized and
    unnormalized stamps.
innerRadius : `int`
    Inner radius value, in pixels. This and ``outerRadius`` define the
    annulus used to compute the ``"annularFlux"`` values within each
    ``starStamp``.
outerRadius : `int`
    Outer radius value, in pixels. This and ``innerRadius`` define the
    annulus used to compute the ``"annularFlux"`` values within each
    ``starStamp``.
nb90Rots : `int`, optional
    Number of 90 degree rotations required to compensate for detector
    orientation.
metadata : `lsst.daf.base.PropertyList`, optional
    Metadata associated with the bright stars.
use_mask : `bool`
    If `True` read and write mask data. Default `True`.
use_variance : `bool`
    If ``True`` read and write variance data. Default ``False``.
use_archive : `bool`
    If ``True`` read and write an Archive that contains a Persistable
    associated with each stamp. In the case of bright stars, this is
    usually a ``TransformPoint2ToPoint2``, used to warp each stamp
    to the same pixel grid before stacking.
imCenter : `collections.abc.Sequence`, optional
    Center of the object, in pixels. If not provided, the center of the
    first stamp's pixel grid will be used.
discardNanFluxObjects : `bool`
    Whether objects with NaN annular flux should be discarded.
    If False, these objects will not be normalized.
statsControl : `lsst.afw.math.statistics.StatisticsControl`, optional
    StatisticsControl to be used when computing flux over all pixels
    within the annulus.
statsFlag : `lsst.afw.math.statistics.Property`, optional
    statsFlag to be passed on to ``afwMath.makeStatistics`` to compute
    annularFlux. Defaults to a simple MEAN.
badMaskPlanes : `collections.abc.Collection` [`str`]
    Collection of mask planes to ignore when computing annularFlux.

Raises
------
ValueError
    Raised if one of the star stamps provided does not contain the
    required keys.
AttributeError
    Raised if there is a mix-and-match of normalized and unnormalized
    stamps, stamps normalized with different annulus definitions, or if
    stamps are to be normalized but annular radii were not provided.

Definition at line 215 of file brightStarStamps.py.

◆ readFits()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps.readFits (   cls,
  filename 
)
Build an instance of this class from a file.

Parameters
----------
filename : `str`
    Name of the file to read

Reimplemented from lsst.meas.algorithms.stamps.Stamps.

Definition at line 332 of file brightStarStamps.py.

◆ readFitsWithOptions()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps.readFitsWithOptions (   cls,
  filename,
  options 
)
Build an instance of this class with options.

Parameters
----------
filename : `str`
    Name of the file to read
options : `PropertyList`
    Collection of metadata parameters

Reimplemented from lsst.meas.algorithms.stamps.Stamps.

Definition at line 343 of file brightStarStamps.py.

◆ selectByMag()

def lsst.meas.algorithms.brightStarStamps.BrightStarStamps.selectByMag (   self,
  magMin = None,
  magMax = None 
)
Return the subset of bright star stamps for objects with specified
magnitude cuts (in Gaia G).

Parameters
----------
magMin : `float`, optional
    Keep only stars fainter than this value.
magMax : `float`, optional
    Keep only stars brighter than this value.

Definition at line 437 of file brightStarStamps.py.

Member Data Documentation

◆ _outerRadius

lsst.meas.algorithms.brightStarStamps.BrightStarStamps._outerRadius
protected

Definition at line 207 of file brightStarStamps.py.

◆ nb90Rots

lsst.meas.algorithms.brightStarStamps.BrightStarStamps.nb90Rots

Definition at line 212 of file brightStarStamps.py.

◆ normalized

lsst.meas.algorithms.brightStarStamps.BrightStarStamps.normalized

Definition at line 209 of file brightStarStamps.py.


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