lsst.pipe.tasks  21.0.0-112-g6a16d5dc+dcb6b76d89
Public Member Functions | Public Attributes | Static Public Attributes | List of all members
lsst.pipe.tasks.maskStreaks.MaskStreaksTask Class Reference
Inheritance diagram for lsst.pipe.tasks.maskStreaks.MaskStreaksTask:

Public Member Functions

def find (self, maskedImage)
 
def run (self, maskedImage)
 

Public Attributes

 edges
 
 lines
 

Static Public Attributes

 ConfigClass = MaskStreaksConfig
 

Detailed Description

Find streaks or other straight lines in image data.

Nearby objects passing through the field of view of the telescope leave a
bright trail in images. This class uses the Kernel Hough Transform (KHT)
(Fernandes and Oliveira, 2007), implemented in `lsst.houghtransform`. The
procedure works by taking a binary image, either provided as put or produced
from the input data image, using a Canny filter to make an image of the
edges in the original image, then running the KHT on the edge image. The KHT
identifies clusters of non-zero points, breaks those clusters of points into
straight lines, keeps clusters with a size greater than the user-set
threshold, then performs a voting procedure to find the best-fit coordinates
of any straight lines. Given the results of the KHT algorithm, clusters of
lines are identified and grouped (generally these correspond to the two
edges of a strea) and a profile is fit to the streak in the original
(non-binary) image.

Definition at line 503 of file maskStreaks.py.

Member Function Documentation

◆ find()

def lsst.pipe.tasks.maskStreaks.MaskStreaksTask.find (   self,
  maskedImage 
)
Find streaks in a masked image

Parameters
----------
maskedImage : `lsst.afw.image.maskedImage`
    The image in which to search for streaks.

Returns
-------
result : `lsst.pipe.base.Struct`
    Result struct with components:

    - ``originalLines``: lines identified by kernel hough transform
    - ``lineClusters``:  lines grouped into clusters in rho-theta space
    - ``lines``: final result for lines after line-profile fit
    - ``mask``: 2-d boolean mask where detected lines are True

Definition at line 525 of file maskStreaks.py.

◆ run()

def lsst.pipe.tasks.maskStreaks.MaskStreaksTask.run (   self,
  maskedImage 
)
Find and mask streaks in a masked image.

Finds streaks in the image and modifies maskedImage in place by adding a
mask plane with any identified streaks.

Parameters
----------
maskedImage : `lsst.afw.image.maskedImage`
    The image in which to search for streaks. The mask detection plane
    corresponding to `config.detectedMaskPlane` must be set with the
    detected pixels.

Returns
-------
result : `lsst.pipe.base.Struct`
    Result struct with components:

    - ``originalLines``: lines identified by kernel hough transform
    - ``lineClusters``:  lines grouped into clusters in rho-theta space
    - ``lines``: final result for lines after line-profile fit

Definition at line 568 of file maskStreaks.py.

Member Data Documentation

◆ ConfigClass

lsst.pipe.tasks.maskStreaks.MaskStreaksTask.ConfigClass = MaskStreaksConfig
static

Definition at line 521 of file maskStreaks.py.

◆ edges

lsst.pipe.tasks.maskStreaks.MaskStreaksTask.edges

Definition at line 546 of file maskStreaks.py.

◆ lines

lsst.pipe.tasks.maskStreaks.MaskStreaksTask.lines

Definition at line 547 of file maskStreaks.py.


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