LightcurveSelector

class daschlab.lightcurves.LightcurveSelector(phot: Photometry, apply)[source]

Bases: PhotometrySelector

A helper object that supports Lightcurve filtering functionality.

Lightcurve selector objects are returned by lightcurve selection “action verbs” such as keep_only. Calling one of the methods on a selector instance will apply the associated action to the specified portion of the lightcurve data.

Methods Summary

sep_above([sep_limit, pos])

Act on rows whose positional separations from the source location are above the limit.

sep_below([sep_limit, pos])

Act on rows whose positional separations from the source location are below the limit.

Methods Documentation

sep_above(sep_limit: ~astropy.units.quantity.Quantity = <Quantity 20. arcsec>, pos: ~astropy.coordinates.sky_coordinate.SkyCoord | None = None, **kwargs) Lightcurve[source]

Act on rows whose positional separations from the source location are above the limit.

Parameters:
sep_limitoptional astropy.units.Quantity, default 20 arcsec

The separation limit. This should be an angular quantity.

posoptional astropy.coordinates.SkyCoord or None

The position relative to which the separation is computed. If unspecified, the lightcurve mean_pos() is used.

**kwargs

Parameters forwarded to the action.

Returns:
Usually, another Lightcurve

However, different actions may return different types. For instance, the count action will return an integer.

Notes

Nondetection rows do not have an associated position, and will never match this filter.

Examples

Create a lightcurve subset containing only detections beyond 10 arcsec from the mean source position:

from astropy import units as u

lc = sess.lightcurve(some_local_id)
near = lc.keep_only.sep_above(10 * u.arcsec)
sep_below(sep_limit: ~astropy.units.quantity.Quantity = <Quantity 20. arcsec>, pos: ~astropy.coordinates.sky_coordinate.SkyCoord | None = None, **kwargs) Lightcurve[source]

Act on rows whose positional separations from the source location are below the limit.

Parameters:
sep_limitoptional astropy.units.Quantity, default 20 arcsec

The separation limit. This should be an angular quantity.

posoptional astropy.coordinates.SkyCoord or None

The position relative to which the separation is computed. If unspecified, the lightcurve mean_pos() is used.

**kwargs

Parameters forwarded to the action.

Returns:
Usually, another Lightcurve

However, different actions may return different types. For instance, the count action will return an integer.

Notes

Nondetection rows do not have an associated position, and will never match this filter.

Examples

Create a lightcurve subset containing only detections within 10 arcsec of the mean source position:

from astropy import units as u

lc = sess.lightcurve(some_local_id)
near = lc.keep_only.sep_below(10 * u.arcsec)