adam_core.observations.source_catalog module¶

class adam_core.observations.source_catalog.SourceCatalog(table: Table, **kwargs: int | float | str)[source]¶

Bases: Table

id¶: A unique identifier for the source

exposure_id¶: An identifier for the exposure in which the source was detected

time¶: The time at which the source was detected. In most cases, this will be the midpoint of the exposure. For Rubin Observatory, each detection within an exposure will have a time that takes into account the motion of the shutter across the focal plane.

ra¶: Right Ascension in degrees (J2000)

dec¶: Declination in degrees (J2000)

ra_sigma¶: 1-sigma uncertainty in Right Ascension in arcseconds

dec_sigma¶: 1-sigma uncertainty in Declination in arcseconds

radec_corr¶: Correlation between Right Ascension and Declination (dimensionless)

mag¶: Magnitude of the source in AB magnitudes

mag_sigma¶: 1-sigma uncertainty in the magnitude of the source in AB magnitudes

fwhm¶: Full width at half maximum of the PSF in arcseconds

a¶: Semi-major axis of PSF ellipse in arcseconds

a_sigma¶: 1-sigma uncertainty in semi-major axis of PSF ellipse in arcseconds

b¶: Semi-minor axis of PSF ellipse in arcseconds

b_sigma¶: 1-sigma uncertainty in semi-minor axis of PSF ellipse in arcseconds

pa¶: Position angle of PSF ellipse in degrees (0 at the North Celestial Pole (NCP), increasing Eastward)

pa_sigma¶: 1-sigma uncertainty in position angle of PSF ellipse in degrees

observatory_code¶: The MPC observatory code

filter¶: The filter in which the source was detected

exposure_start_time¶: The start time of the exposure (typically corresponds to the moment the shutter opens)

exposure_duration¶: The exposure duration in seconds (typically corresponds to the amount of time the focal plane is exposed to light)

exposure_seeing¶: The FWHM assuming a Gaussian PSF in arcseconds for the exposure

exposure_depth_5sigma¶: The magnitude of a point-source that would be detected at 5-sigma

object_id¶: The ID of the solar system object associated with the source

catalog_id¶: ID of the source catalog

detections() → PointSourceDetections[source]¶

Return the detections in the source catalog.

Returns:: detections – The detections in the source catalog.
Return type:: PointSourceDetections

exposures() → Exposures[source]¶

Return the unique exposures in the source catalog.

Returns:: exposures – The unique exposures in the source catalog.
Return type:: Exposures

associations() → Associations[source]¶

Return the associations in the source catalog.

Returns:: associations – The unique associations in the source catalog.
Return type:: Associations

photometry() → Photometry[source]¶

Return the photometry in the source catalog.

Returns:: photometry – The photometry in the source catalog.
Return type:: Photometry

coordinates() → SphericalCoordinates[source]¶

Return the astrometry in the source catalog as SphericalCoordinates.

Returns:: coordinates – The astrometry in the source catalog.
Return type:: SphericalCoordinates

observers(exposure_midpoint: bool = False) → Observers[source]¶

Return the observers for each detection in the source catalog.

Parameters:: exposure_midpoint (bool) – If True, the observer locations are calculated at the midpoint of the exposures. If False, the observer locations are calculated at the time of the detections.
Returns:: observers – The observers in the source catalog.
Return type:: Observers

healpixels(nside: int = 16, nest: bool = True) → ndarray[tuple[Any, ...], dtype[int64]][source]¶

Return the healpixels for the source catalog.

Parameters:

nside (int) – The nside parameter for the healpix grid.
nest (bool) – If True, the healpix grid is in the nested format. If False, the healpix grid is in the ring format.

Returns:

healpixels – The healpixels for the source catalog.

Return type:

np.ndarray

schema: ClassVar[pa.Schema] = id: large_string not null exposure_id: large_string time: struct<days: int64, nanos: int64> child 0, days: int64 child 1, nanos: int64 ra: double not null dec: double not null ra_sigma: double dec_sigma: double radec_corr: double mag: double mag_sigma: double fwhm: double a: double a_sigma: double b: double b_sigma: double pa: double pa_sigma: double observatory_code: large_string not null filter: large_string exposure_start_time: struct<days: int64, nanos: int64> child 0, days: int64 child 1, nanos: int64 exposure_duration: double exposure_seeing: double exposure_depth_5sigma: double object_id: large_string catalog_id: large_string not null¶

table: pa.Table¶