lsst.meas.base g212a7c68fe+5f4fc2ea00
Loading...
Searching...
No Matches
Public Member Functions | Public Attributes | Static Public Attributes | Protected Member Functions | Static Protected Attributes | List of all members
lsst.meas.base.diaCalculation.DiaObjectCalculationTask Class Reference
Inheritance diagram for lsst.meas.base.diaCalculation.DiaObjectCalculationTask:
lsst.meas.base.catalogCalculation.CatalogCalculationTask

Public Member Functions

 __init__ (self, plugMetadata=None, **kwargs)
 
 initializePlugins (self)
 
 run (self, diaObjectCat, diaSourceCat, updatedDiaObjectIds, filterNames)
 
 callCompute (self, diaObjectCat, diaSourceCat, updatedDiaObjectIds, filterNames)
 

Public Attributes

 plugMetadata
 
 plugins
 
 outputCols
 
 executionDict
 
 log
 

Static Public Attributes

 ConfigClass = DiaObjectCalculationConfig
 

Protected Member Functions

 _validatePluginCols (self, plug)
 
 _initialize_dia_object (self, objId)
 

Static Protected Attributes

str _DefaultName = "diaObjectCalculation"
 

Detailed Description

Run plugins which operate on a catalog of DIA sources.

This task facilitates running plugins which will operate on a source
catalog. These plugins may do things such as classifying an object based
on source record entries inserted during a measurement task.

This task differs from CatalogCaculationTask in the following ways:

-No multi mode is available for plugins. All plugins are assumed to run
 in single mode.

-Input and output catalog types are assumed to be `pandas.DataFrames` with
 columns following those used in the Apdb.

-No schema argument is passed to the plugins. Each plugin specifies
 output columns and required inputs.

Parameters
----------
plugMetaData : `lsst.daf.base.PropertyList` or `None`
    Will be modified in-place to contain metadata about the plugins being
    run. If `None`, an empty `~lsst.daf.base.PropertyList` will be
    created.
**kwargs
    Additional arguments passed to the superclass constructor.

Notes
-----
Plugins may either take an entire catalog to work on at a time, or work on
individual records.

Definition at line 172 of file diaCalculation.py.

Constructor & Destructor Documentation

◆ __init__()

lsst.meas.base.diaCalculation.DiaObjectCalculationTask.__init__ ( self,
plugMetadata = None,
** kwargs )

Reimplemented from lsst.meas.base.catalogCalculation.CatalogCalculationTask.

Definition at line 207 of file diaCalculation.py.

Member Function Documentation

◆ _initialize_dia_object()

lsst.meas.base.diaCalculation.DiaObjectCalculationTask._initialize_dia_object ( self,
objId )
protected
Create a new DiaObject with values required to be initialized by the
Apdb.

Parameters
----------
objid : `int`
    ``diaObjectId`` value for the of the new DiaObject.

Returns
-------
diaObject : `dict`
    Newly created DiaObject with keys:

    ``diaObjectId``
        Unique DiaObjectId (`int`).
    ``pmParallaxNdata``
        Number of data points used for parallax calculation (`int`).
    ``nearbyObj1``
        Id of the a nearbyObject in the Object table (`int`).
    ``nearbyObj2``
        Id of the a nearbyObject in the Object table (`int`).
    ``nearbyObj3``
        Id of the a nearbyObject in the Object table (`int`).
    ``?_psfFluxNdata``
        Number of data points used to calculate point source flux
        summary statistics in each bandpass (`int`).

Definition at line 476 of file diaCalculation.py.

◆ _validatePluginCols()

lsst.meas.base.diaCalculation.DiaObjectCalculationTask._validatePluginCols ( self,
plug )
protected
Assert that output columns are not duplicated and input columns
exist for dependent plugins.

Parameters
----------
plug : `lsst.ap.association.DiaCalculationPlugin`
    Plugin to test for output collisions and input needs.

Definition at line 247 of file diaCalculation.py.

◆ callCompute()

lsst.meas.base.diaCalculation.DiaObjectCalculationTask.callCompute ( self,
diaObjectCat,
diaSourceCat,
updatedDiaObjectIds,
filterNames )
Run each of the plugins on the catalog.

For catalog column names see the lsst.cat schema definitions for the
DiaObject and DiaSource tables (http://github.com/lsst/cat).

Parameters
----------
diaObjectCat : `pandas.DataFrame`
    DiaObjects to update values of and append new objects to. DataFrame
    should be indexed on "diaObjectId"
diaSourceCat : `pandas.DataFrame`
    DiaSources associated with the DiaObjects in diaObjectCat.
    DataFrame must be indexed on
    ["diaObjectId", "band", "diaSourceId"]`
updatedDiaObjectIds : `numpy.ndarray`
    Integer ids of the DiaObjects to update and create.
filterNames : `list` of `str`
    List of string names of filters to be being processed.

Returns
-------
returnStruct : `lsst.pipe.base.Struct`
    Struct containing:

    ``diaObjectCat``
        Full set of DiaObjects including both un-updated and
        updated/new DiaObjects (`pandas.DataFrame`).
    ``updatedDiaObjects``
        Catalog of DiaObjects  that were updated or created by this
        task (`pandas.DataFrame`).

Raises
------
KeyError
    Raises if `pandas.DataFrame` indexing is not properly set.

Reimplemented from lsst.meas.base.catalogCalculation.CatalogCalculationTask.

Definition at line 346 of file diaCalculation.py.

◆ initializePlugins()

lsst.meas.base.diaCalculation.DiaObjectCalculationTask.initializePlugins ( self)
Initialize the plugins according to the configuration.

Reimplemented from lsst.meas.base.catalogCalculation.CatalogCalculationTask.

Definition at line 217 of file diaCalculation.py.

◆ run()

lsst.meas.base.diaCalculation.DiaObjectCalculationTask.run ( self,
diaObjectCat,
diaSourceCat,
updatedDiaObjectIds,
filterNames )
The entry point for the DIA catalog calculation task.

Run method both updates the values in the diaObjectCat and appends
newly created DiaObjects to the catalog. For catalog column names
see the lsst.cat schema definitions for the DiaObject and DiaSource
tables (http://github.com/lsst/cat).

Parameters
----------
diaObjectCat : `pandas.DataFrame`
    DiaObjects to update values of and append new objects to. DataFrame
    should be indexed on "diaObjectId"
diaSourceCat : `pandas.DataFrame`
    DiaSources associated with the DiaObjects in diaObjectCat.
    DataFrame should be indexed on
    `["diaObjectId", "band", "diaSourceId"]`
updatedDiaObjectIds : `numpy.ndarray`
    Integer ids of the DiaObjects to update and create.
filterNames : `list` of `str`
    List of string names of filters to be being processed.

Returns
-------
returnStruct : `lsst.pipe.base.Struct`
    Struct containing:

    ``diaObjectCat``
        Full set of DiaObjects including both un-updated and
        updated/new DiaObjects (`pandas.DataFrame`).
    ``updatedDiaObjects``
        Catalog of DiaObjects  that were updated or created by this
        task (`pandas.DataFrame`).

Reimplemented from lsst.meas.base.catalogCalculation.CatalogCalculationTask.

Definition at line 278 of file diaCalculation.py.

Member Data Documentation

◆ _DefaultName

str lsst.meas.base.diaCalculation.DiaObjectCalculationTask._DefaultName = "diaObjectCalculation"
staticprotected

Definition at line 205 of file diaCalculation.py.

◆ ConfigClass

lsst.meas.base.diaCalculation.DiaObjectCalculationTask.ConfigClass = DiaObjectCalculationConfig
static

Definition at line 204 of file diaCalculation.py.

◆ executionDict

lsst.meas.base.diaCalculation.DiaObjectCalculationTask.executionDict

Definition at line 222 of file diaCalculation.py.

◆ log

lsst.meas.base.diaCalculation.DiaObjectCalculationTask.log

Definition at line 404 of file diaCalculation.py.

◆ outputCols

lsst.meas.base.diaCalculation.DiaObjectCalculationTask.outputCols

Definition at line 213 of file diaCalculation.py.

◆ plugins

lsst.meas.base.diaCalculation.DiaObjectCalculationTask.plugins

Definition at line 212 of file diaCalculation.py.

◆ plugMetadata

lsst.meas.base.diaCalculation.DiaObjectCalculationTask.plugMetadata

Definition at line 211 of file diaCalculation.py.


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