lightcurvelynx.obstable.argus_obstable

The ArgusObsTable stores observation information from the Argus survey.

Classes

ArgusHealpixObsTable

An ObsTable for observations from the Argus survey in healpix format.

Module Contents

class ArgusHealpixObsTable(table, *, colmap=None, apply_saturation=True, saturation_mags=None, nside=None, **kwargs)

Bases: lightcurvelynx.obstable.obs_table.ObsTable

An ObsTable for observations from the Argus survey in healpix format.

Unlike other ObsTable classes, the ArgusHealpixObsTable does not consist of a table of pointings, but rather is organized at the healpix level. Each row corresponds to a healpix pixel and time.

Parameters:

• table (dict or pandas.core.frame.DataFrame) – The table with all the survey information.

• colmap (dict) – A mapping of standard column names to a list of possible names in the input table. Each value in the dictionary can be a string or a list of strings.

• saturation_mags (dict, optional) – A dictionary mapping filter names to their saturation thresholds in magnitudes. The filters provided must match those in the table. If not provided, Argus-specific defaults will be used.

• **kwargs (dict) –

  Additional keyword arguments to pass to the constructor. This includes overrides for survey parameters such as:

  • dark_electrons : The dark current for the camera in electrons per second per pixel.

  • gain: The gain for the camera in electrons per ADU.

  • pixel_scale: The pixel scale for the camera in arcseconds per pixel.

  • radius: The angular radius of the observations (in degrees).

  • read_noise: The readout noise for the camera in electrons per pixel.

property healpix_nside

Return the nside of the healpix pixels in the table.

property healpix_depth

Return the depth of the healpix pixels in the table.

abstractmethod set_detector_footprint(detector_footprint, wcs=None)

Set the detector footprint, so footprint filtering is done.

Parameters:

• detector_footprint (astropy.regions.SkyRegion, Astropy.regions.PixelRegion, or) – DetectorFootprint The footprint object for the instrument’s detector.

• wcs (astropy.wcs.WCS, optional) – The WCS for the footprint. Either this or pixel_scale must be provided if a footprint is provided as a Astropy region.

build_moc(max_depth=None, **kwargs)

Build a Multi-Order Coverage Map from the regions in the data set.

These are built directly from the healpix pixels.

Parameters:

• max_depth (int, optional) – The maximum depth of the MOC. Default is the depth of the healpix pixels in the table.

• **kwargs (dict) – Additional keyword arguments to pass to the MOC construction. Not currently used, but accepted for consistency with the ObsTable interface.

Returns:

The Multi-Order Coverage Map constructed from the data set.

Return type:

MOC

range_search(query_ra, query_dec, *, radius=None, t_min=None, t_max=None)

Return the indices of the pointings that fall within the field of view of the query point(s).

Note that radius is not used since everything is already stored at the healpix level, but it is accepted as a parameter for consistency with the ObsTable interface.

Parameters:

• query_ra (float or numpy.ndarray) – The query right ascension (in degrees).

• query_dec (float or numpy.ndarray) – The query declination (in degrees).

• radius (float or None, optional) – Not used in this implementation since the data is already organized at the healpix level.

• t_min (float, numpy.ndarray or None, optional) – The minimum time (in MJD) for the observations to consider. If None, no time filtering is applied.

• t_max (float, numpy.ndarray or None, optional) – The maximum time (in MJD) for the observations to consider. If None, no time filtering is applied.

Returns:

inds – Depending on the input, this is either a list of indices for a single query point or a list of arrays (of indices) for an array of query points.

Return type:

list[int] or list[numpy.ndarray]