IsolatedStarAssociationTask¶
IsolatedStarAssociationTask matches unresolved star sources from the sourceTable_visit datasets into a pure (but not complete) catalog of isolated stars.
The output datasets are a catalog of isolated stars (dataset isolated_star_cat) and the associated sources with configured columns from the input catalogs (dataset isolated_star_sources).
Processing summary¶
IsolatedStarAssociationTask reads in all the visit-level source table parquet catalogs in a given tract and matches (associates) the sources together.
In particular:
- All
sourceTable_visitcatalogs overlapping a given tract are used as inputs. The configuration variableextra_columnscan be used to specify which columns from the inputs are persisted (in addition to the default flux column, input row number, and source id). - Unflagged, unresolved stars above a configured signal-to-noise are selected from each input catalog.
- The input stars are associated within a configured
match_radiusarcseconds. This association is done band-by-band (with the order configured byband_order), and then each band is matched such that all sources are associated with a unique list of stars which cover all the bands in the tract. - The star catalog is matched against itself, and groups of stars that match neighbor(s) within
isolation_radiusarcseconds are removed from the final isolated star catalog (isolated_star_cat). - All individual sources are associated with the isolated star catalog within
match_radius, to create theisolated_star_sources. - The data are collated such that each isolated star has an index to the
isolated_star_sourcestable for quick access of all the individual sources for that star.
Python API summary¶
from lsst.pipe.tasks.isolatedStarAssociation import IsolatedStarAssociationTask
-
class
IsolatedStarAssociationTask Associate sources into isolated star catalogs
...
-
attribute
config Access configuration fields and retargetable subtasks.
See also
See the IsolatedStarAssociationTask API reference for complete details.
Retargetable subtasks¶
source_selector¶
- Default
'science'- Field type
- Single-selection
RegistryField - Choices
'science'lsst.meas.algorithms.sourceSelector.ScienceSourceSelectorTask'references'lsst.meas.algorithms.sourceSelector.ReferenceSourceSelectorTask'objectSize'lsst.meas.algorithms.objectSizeStarSelector.ObjectSizeStarSelectorTask'flagged'lsst.meas.algorithms.flaggedSourceSelector.FlaggedSourceSelectorTask'astrometry'lsst.meas.algorithms.astrometrySourceSelector.AstrometrySourceSelectorTask'matcher'lsst.meas.algorithms.matcherSourceSelector.MatcherSourceSelectorTask'diaCatalog'lsst.ip.diffim.diaCatalogSourceSelector.DiaCatalogSourceSelectorTask
How to select sources. Under normal usage this should not be changed.
Configuration fields¶
band_order¶
Ordered list of bands to use for matching/storage. Any bands not listed will not be matched.
connections¶
- Data type
lsst.pipe.base.config.Connections- Field type
ConfigField
Configurations describing the connections of the PipelineTask to datatypes
extra_columns¶
- Default
['x', 'y', 'apFlux_17_0_instFlux', 'apFlux_17_0_instFluxErr', 'apFlux_17_0_flag', 'localBackground_instFlux', 'localBackground_flag']- Field type
strListField
Extra names of columns to read and persist (beyond instFlux and error).
inst_flux_field¶
Full name of instFlux field to use for s/n selection and persistence. The associated flag will be implicity included in bad_flags. Note that this is expected to end in
instFlux.isolation_radius¶
Isolation radius (arcseconds). Any stars with average centroids within this radius of another star will be rejected from the final catalog. This radius should be at least 2x match_radius.
physical_filter_column¶
Name of column with physical filter name
saveLogOutput¶
Flag to enable/disable saving of log output for a task, enabled by default.