Select stars based on a reference catalog. More...

Inheritance diagram for lsst.meas.astrom.catalogStarSelector.CatalogStarSelectorTask:

Public Member Functions
def	selectStars (self, exposure, sourceCat, matches=None)
	Return a list of PSF candidates that represent likely stars. More...

Static Public Attributes
	ConfigClass = CatalogStarSelectorConfig

bool	usesMatches = True

Detailed Description

Select stars based on a reference catalog.

Description

Select stars using a match list: select sources where the matching reference object is unresolved, plus the source passes the following tests:

no flag from config.badFlags is set
psf flux >= config.fluxLim
psf flux <= config.fluxMax (not checked if fluxMax == 0)

Task initialisation

Invoking the Task

Like all star selectors, the main method is run. Unlike most star selectors, this one requires the matches argument (the usesMatches property is true).

Configuration parameters

See CatalogStarSelectorConfig

Debug variables

CatalogStarSelectorTask has a debug dictionary with the following keys:

display: bool; if True display debug information
pauseAtEnd: bool; if True wait after displaying everything and wait for user input

For example, put something like:

import lsstDebug
def DebugInfo(name):
    di = lsstDebug.getInfo(name)  # N.b. lsstDebug.Info(name) would call us recursively
    if name.endswith("catalogStarSelector"):
        di.display = True
    return di
lsstDebug.Info = DebugInfo

into your debug.py file and run your task with the --debug flag.

Definition at line 86 of file catalogStarSelector.py.

Member Function Documentation

◆ selectStars()

def lsst.meas.astrom.catalogStarSelector.CatalogStarSelectorTask.selectStars	(	self,
		exposure,
		sourceCat,
		matches = `None`
	)

Return a list of PSF candidates that represent likely stars.

A list of PSF candidates may be used by a PSF fitter to construct a PSF.

Parameters

[in]	exposure	the exposure containing the sources
[in]	sourceCat	catalog of sources that may be stars (an lsst.afw.table.SourceCatalog)
[in]	matches	a match vector as produced by meas_astrom; required (defaults to None to match the StarSelector API and improve error handling)

Returns

an lsst.pipe.base.Struct containing:

starCat catalog of selected stars (a subset of sourceCat)

Definition at line 147 of file catalogStarSelector.py.

Member Data Documentation

◆ ConfigClass

lsst.meas.astrom.catalogStarSelector.CatalogStarSelectorTask.ConfigClass = CatalogStarSelectorConfig

static

Definition at line 144 of file catalogStarSelector.py.

◆ usesMatches

bool lsst.meas.astrom.catalogStarSelector.CatalogStarSelectorTask.usesMatches = True