LightCurve

Light curve object.

This object is used to plot the light curve of a source. It is initialized with a source_catalogs object, which is a CatalogSet object. The source_catalogs object is used to extract the source information from the catalogs.

To change the plot parameters, modify the plt_params attribute.

__init__(catalogset=None)[source]

Initialize the LightCurve object.

Parameters:: source_catalogs (CatalogSet) – The source catalogs to use for the light curve.

Methods

plot(self, ra=None, dec=None, filter=None, matching_radius_arcsec=5.0, ra_key='X_WORLD', dec_key='Y_WORLD', flux_key='MAGSKY_AUTO', fluxerr_key='MAGERR_AUTO', zperr_key='ZPERR_AUTO', depth_key='UL5SKY_AUTO', plot_all_in_one_figure=True, apply_offset=True, overplot_stamp=False, verbose=True, title=None)

Plot light curve for the closest source to (ra, dec).

Parameters:

ra (float) – Sky position in degrees.
dec (float) – Sky position in degrees.
matching_radius_arcsec (float) – Search radius for the source match.
flux_key (str) – Column name for flux.
fluxerr_key (str) – Column name for flux error.
color_key (str) – Column name for color.
shape_key (str) – Column name for marker shape. Options: ‘filter’, ‘telname’, ‘observatory’, or None.
apply_filter_offsets (bool) – If True, apply filter offsets.

Returns:

fig (matplotlib.figure.Figure) – Figure object.
ax (matplotlib.axes.Axes) – Axes object.
tbl (astropy.table.Table) – Table of data.

extract_source_info(self, ra, dec, ra_key='X_WORLD', dec_key='Y_WORLD', flux_key=None, fluxerr_key=None, zperr_key=None, depth_key=None, matching_radius_arcsec=5.0, verbose=True)

Extract source information from the merged catalog.

Each row of the returned table will be a per-exposure record with the metadata and photometry.

Parameters:

ra (float) – Sky position in degrees.
dec (float) – Sky position in degrees.
ra_key (str) – Column name for right ascension. Default is ‘X_WORLD’.
dec_key (str) – Column name for declination. Default is ‘Y_WORLD’.
flux_key (str or sequence of str) – Photometry value columns you want to carry over (e.g., ‘MAGSKY_APER_1’). Accepts a single key or a list/tuple of keys.
fluxerr_key (str or sequence of str) – Corresponding error columns (e.g., ‘MAGERR_APER_1’). Must be same length as flux_keys.
matching_radius_arcsec (float) – Search radius for the source match.
fit_filter_key (str or None) – Placeholder for future use (ignored).

Returns:

One row per exposure/catalog with metadata + requested photometry. Returns None if no source is found.

Return type:

astropy.table.Table or None