lsst.pipe.tasks.functors.Color Class Reference

Inheritance diagram for lsst.pipe.tasks.functors.Color:

Public Member Functions
	__init__ (self, col, filt2, filt1, **kwargs)
	filt (self)
	filt (self, filt)
	columns (self)
	multilevelColumns (self, parq, **kwargs)
	name (self)
	shortname (self)

Public Attributes
	col
	filt2
	filt1
	mag2
	mag1
	dataset

Protected Member Functions
	_func (self, df)

Static Protected Attributes
str	_defaultDataset = 'forced_src'
tuple	_dfLevels = ('band', 'column')
bool	_defaultNoDup = True

Detailed Description

Compute the color between two filters.

Computes color by initializing two different `Mag` functors based on the
``col`` and filters provided, and then returning the difference.

This is enabled by the `_func` method expecting a DataFrame with a
multilevel column index, with both ``'band'`` and ``'column'``, instead of
just ``'column'``, which is the `Functor` default.
This is controlled by the `_dfLevels` attribute.

Also of note, the default dataset for `Color` is ``forced_src'``, whereas
for `Mag` it is ``'meas'``.

Parameters
----------
col : str
    Name of the flux column from which to compute; same as would be passed
    to `~lsst.pipe.tasks.functors.Mag`.

filt2, filt1 : str
    Filters from which to compute magnitude difference.
    Color computed is ``Mag(filt2) - Mag(filt1)``.

Definition at line 906 of file functors.py.

Constructor & Destructor Documentation

__init__()

lsst.pipe.tasks.functors.Color.__init__	(		self,
			col,
			filt2,
			filt1,
		**	kwargs )

Reimplemented from lsst.pipe.tasks.functors.Functor.

Definition at line 934 of file functors.py.

    def __init__(self, col, filt2, filt1, **kwargs):
        self.col = fluxName(col)
        if filt2 == filt1:
            raise RuntimeError("Cannot compute Color for %s: %s - %s " % (col, filt2, filt1))
        self.filt2 = filt2
        self.filt1 = filt1
 
        self.mag2 = Mag(col, filt=filt2, **kwargs)
        self.mag1 = Mag(col, filt=filt1, **kwargs)
 
        super().__init__(**kwargs)
 

Member Function Documentation

_func()

lsst.pipe.tasks.functors.Color._func ( self, df )

protected

Reimplemented from lsst.pipe.tasks.functors.Functor.

Definition at line 954 of file functors.py.

    def _func(self, df):
        mag2 = self.mag2._func(df[self.filt2])
        mag1 = self.mag1._func(df[self.filt1])
        return mag2 - mag1
 

columns()

lsst.pipe.tasks.functors.Color.columns

(

self

)

Columns required to perform calculation.

Reimplemented from lsst.pipe.tasks.functors.Functor.

Definition at line 960 of file functors.py.

    def columns(self):
        return [self.mag1.col, self.mag2.col]
 

filt() [1/2]

lsst.pipe.tasks.functors.Color.filt

(

self

)

Reimplemented from lsst.pipe.tasks.functors.Functor.

Definition at line 947 of file functors.py.

    def filt(self):
        return None
 

filt() [2/2]

lsst.pipe.tasks.functors.Color.filt	(		self,
			filt )

Reimplemented from lsst.pipe.tasks.functors.Functor.

Definition at line 951 of file functors.py.

    def filt(self, filt):
        pass
 

multilevelColumns()

lsst.pipe.tasks.functors.Color.multilevelColumns	(		self,
			data,
		**	columnIndex )

Returns columns needed by functor from multilevel dataset.

To access tables with multilevel column structure, the
`~lsst.daf.butler.DeferredDatasetHandle` or
`~lsst.pipe.base.InMemoryDatasetHandle` needs to be passed
either a list of tuples or a dictionary.

Parameters
----------
data : various
    The data as either `~lsst.daf.butler.DeferredDatasetHandle`, or
    `~lsst.pipe.base.InMemoryDatasetHandle`.
columnIndex (optional): pandas `~pandas.Index` object
    Either passed or read in from
    `~lsst.daf.butler.DeferredDatasetHandle`.
`returnTuple` : `bool`
    If true, then return a list of tuples rather than the column
    dictionary specification.
    This is set to `True` by `CompositeFunctor` in order to be able to
    combine columns from the various component functors.

Reimplemented from lsst.pipe.tasks.functors.Functor.

Definition at line 963 of file functors.py.

    def multilevelColumns(self, parq, **kwargs):
        return [(self.dataset, self.filt1, self.col), (self.dataset, self.filt2, self.col)]
 

name()

lsst.pipe.tasks.functors.Color.name

(

self

)

Reimplemented from lsst.pipe.tasks.functors.Functor.

Definition at line 967 of file functors.py.

    def name(self):
        return f'{self.filt2} - {self.filt1} ({self.col})'
 

shortname()

lsst.pipe.tasks.functors.Color.shortname

(

self

)

Short name of functor (suitable for column name/dict key).

Reimplemented from lsst.pipe.tasks.functors.Functor.

Definition at line 971 of file functors.py.

    def shortname(self):
        return f"{self.col}_{self.filt2.replace('-', '')}m{self.filt1.replace('-', '')}"
 
 

Member Data Documentation

_defaultDataset

str lsst.pipe.tasks.functors.Color._defaultDataset = 'forced_src'

staticprotected

Definition at line 930 of file functors.py.

_defaultNoDup

bool lsst.pipe.tasks.functors.Color._defaultNoDup = True

staticprotected

Definition at line 932 of file functors.py.

_dfLevels

tuple lsst.pipe.tasks.functors.Color._dfLevels = ('band', 'column')

staticprotected

Definition at line 931 of file functors.py.

col

lsst.pipe.tasks.functors.Color.col

Definition at line 935 of file functors.py.

dataset

lsst.pipe.tasks.functors.Color.dataset

Definition at line 964 of file functors.py.

filt1

lsst.pipe.tasks.functors.Color.filt1

Definition at line 939 of file functors.py.

filt2

lsst.pipe.tasks.functors.Color.filt2

Definition at line 938 of file functors.py.

mag1

lsst.pipe.tasks.functors.Color.mag1

Definition at line 942 of file functors.py.

mag2

lsst.pipe.tasks.functors.Color.mag2

Definition at line 941 of file functors.py.

---

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

• /j/snowflake/release/lsstsw/stack/lsst-scipipe-9.0.0/Linux64/pipe_tasks/g8ffcb69f3d+818ab6c36e/python/lsst/pipe/tasks/functors.py