adam_core.observations package¶

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

Bases: Table

detection_id¶: A column for storing large strings (over 2³¹ bytes long). Large string data is stored in variable-length chunks.

group_by_object() → Iterator[Associations][source]¶

Group the associations by object ID. Any null object IDs will be returned last.

Returns:: associations – Associations grouped by object ID.
Return type:: Iterator[~adam_core.observations.associations.Associations]

link_to_detections(detections: PointSourceDetections) → Linkage[Associations, PointSourceDetections][source]¶

Link the associations to a table of detections.

Parameters:: detections (~adam_core.observations.detections.PointSourceDetections) – Table of detections to link to.

object_id¶: A column for storing large strings (over 2³¹ bytes long). Large string data is stored in variable-length chunks.

schema: ClassVar[pa.Schema] = detection_id: large_string not null object_id: large_string¶

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

Bases: Table

Exposures is a table of data about exposures that provide point source observations.

depth_5sigma¶: A column for storing 64-bit floating point numbers.

duration¶: A column for storing 64-bit floating point numbers.

filter¶: A column for storing large strings (over 2³¹ bytes long). Large string data is stored in variable-length chunks.

group_by_observatory_code() → Iterator[tuple[str, Exposures]][source]¶: Groups the exposures by observatory code.

id¶: A column for storing large strings (over 2³¹ bytes long). Large string data is stored in variable-length chunks.

midpoint() → Timestamp[source]¶: Returns the midpoint of the exposure.

observatory_code¶: A column for storing large strings (over 2³¹ bytes long). Large string data is stored in variable-length chunks.

observers(frame: Literal['ecliptic', 'equatorial', 'itrf93'] = 'ecliptic', origin: OriginCodes = OriginCodes.SUN) → Observers[source]¶: Return the observer location at each exposure midpoint.

schema: ClassVar[pa.Schema] = id: large_string not null start_time: struct<days: int64, nanos: int64> child 0, days: int64 child 1, nanos: int64 duration: double not null filter: large_string not null observatory_code: large_string not null seeing: double depth_5sigma: double¶

seeing¶: A column for storing 64-bit floating point numbers.

start_time¶

A column which represents an embedded quivr table.

Parameters:

table_type – The type of the table to embed.
nullable – Whether the column can contain null values.
metadata – A dictionary of metadata to attach to the column.

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

Bases: Table

PointSourceDetections is a table of data about point source detections.

dec¶: A column for storing 64-bit floating point numbers.

dec_sigma¶: A column for storing 64-bit floating point numbers.

exposure_id¶: A column for storing large strings (over 2³¹ bytes long). Large string data is stored in variable-length chunks.

group_by_exposure() → Iterator[PointSourceDetections][source]¶: Returns an iterator of PointSourceDetections, each grouped by exposure_id.

group_by_healpixel(nside: int, nest: bool = True) → Iterator[tuple[int, PointSourceDetections]][source]¶: Returns an iterator of PointSourceDetections, each grouped by healpixel.

healpixels(nside: int, nest: bool = True) → ndarray[tuple[Any, ...], dtype[int64]][source]¶: Returns an array of healpixels for each observation.

id¶: A column for storing large strings (over 2³¹ bytes long). Large string data is stored in variable-length chunks.

link_to_exposures(exposures: Exposures) → Linkage[PointSourceDetections, Exposures][source]¶: Links the detections to the exposures.

mag¶: A column for storing 64-bit floating point numbers.

mag_sigma¶: A column for storing 64-bit floating point numbers.

ra¶: A column for storing 64-bit floating point numbers.

ra_sigma¶: A column for storing 64-bit floating point numbers.

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 ra_sigma: double dec: double not null dec_sigma: double mag: double mag_sigma: double¶

time¶

A column which represents an embedded quivr table.

Parameters:

table_type – The type of the table to embed.
nullable – Whether the column can contain null values.
metadata – A dictionary of metadata to attach to the column.

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

Bases: Table

filter¶: A column for storing large strings (over 2³¹ bytes long). Large string data is stored in variable-length chunks.

mag¶: A column for storing 64-bit floating point numbers.

mag_sigma¶: A column for storing 64-bit floating point numbers.

schema: ClassVar[pa.Schema] = time: struct<days: int64, nanos: int64> child 0, days: int64 child 1, nanos: int64 mag: double mag_sigma: double filter: large_string¶

time¶

A column which represents an embedded quivr table.

Parameters:

table_type – The type of the table to embed.
nullable – Whether the column can contain null values.
metadata – A dictionary of metadata to attach to the column.

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

Bases: Table

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

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

associations() → Associations[source]¶

Return the associations in the source catalog.

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

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

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

catalog_id¶: ID of the source catalog

coordinates() → SphericalCoordinates[source]¶

Return the astrometry in the source catalog as SphericalCoordinates.

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

dec¶: Declination in degrees (J2000)

dec_sigma¶: 1-sigma uncertainty in Declination in arcseconds

detections() → PointSourceDetections[source]¶

Return the detections in the source catalog.

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

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

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

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

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

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

exposures() → Exposures[source]¶

Return the unique exposures in the source catalog.

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

filter¶: The filter in which the source was detected

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

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

id¶: A unique identifier for the source

mag¶: Magnitude of the source in AB magnitudes

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

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

observatory_code¶: The MPC observatory code

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

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

photometry() → Photometry[source]¶

Return the photometry in the source catalog.

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

ra¶: Right Ascension in degrees (J2000)

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

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

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¶

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.

adam_core.observations package¶

Submodules¶