stdpipe.catalogs module

Module containing the routines for handling various online catalogues.

stdpipe.catalogs.augment_cat_bands(cat, catalog=None, verbose=False)[source]

Augment catalog with additional photometric bands via magnitude conversions.

Parameters:
catastropy.table.Table

Input catalog to augment. Modified in-place.

catalogstr, optional

Catalog type: ‘ps1’, ‘atlas’, ‘gaiadr2’, ‘skymapper’, ‘apass’, ‘gaiadr3syn’, ‘sdss’. If None, auto-detect from columns.

verbosebool or callable, optional

Logging control.

Returns:
catastropy.table.Table

The input catalog with additional magnitude columns.

stdpipe.catalogs.get_cat_vizier(ra0, dec0, sr0, catalog='ps1', limit=-1, filters={}, extra=[], get_distance=False, augment_bands=True, verbose=False)[source]

Download any catalogue from Vizier.

The catalogue may be any Vizier identifier. For a number of popular catalogues, additional photometric bands are computed from analytical conversion formulae:

  • ps1 — Pan-STARRS DR1, augmented with Johnson-Cousins B, V, R, I

  • gaiadr2 — Gaia DR2, augmented with Johnson-Cousins B, V, R, I, Pan-STARRS and SDSS

  • gaiaedr3 — Gaia eDR3

  • gaiadr3syn — Gaia DR3 synthetic photometry from XP spectra

  • skymapper — SkyMapper DR1.1

  • vsx — AAVSO Variable Stars Index

  • apass — AAVSO APASS DR9

  • sdss — SDSS DR16

  • atlas — ATLAS-RefCat2, augmented with Johnson-Cousins B, V, R, I

  • usnob1 — USNO-B1

  • gsc — Guide Star Catalogue 2.2

Parameters:
ra0float

Right Ascension of the field center in degrees.

dec0float

Declination of the field center in degrees.

sr0float

Field radius in degrees.

catalogstr, optional

Any Vizier catalogue identifier or a short name from the list above.

limitint, optional

Maximum number of rows to return (-1 for unlimited).

filtersdict, optional

Column filters applied server-side. Keys are column names; values are Vizier filter expressions.

extralist of str, optional

Additional column names to include beyond the defaults.

get_distancebool, optional

If True, include a _r column with angular distance from field center.

augment_bandsbool, optional

If True (default), augment photometry with derived bands where supported.

verbosebool or callable, optional

Whether to show verbose messages. May be boolean or a print-like callable.

Returns:
astropy.table.Table or None

Catalogue as returned by Vizier, with additional columns for supported catalogues, or None if the query fails.

stdpipe.catalogs.xmatch_objects(obj, catalog='ps1', sr=0.0008333333333333334, col_ra='ra', col_dec='dec', augment_bands=True)[source]

Cross-match object list with a Vizier catalogue using the CDS XMatch service.

Parameters:
objastropy.table.Table

Table of objects to cross-match.

catalogstr, optional

Any Vizier catalogue identifier or a short name recognized by get_cat_vizier().

srfloat, optional

Cross-matching radius in degrees.

col_rastr, optional

Column name in obj containing Right Ascension values.

col_decstr, optional

Column name in obj containing Declination values.

augment_bandsbool, optional

If True (default), augment photometry with derived bands where supported.

Returns:
astropy.table.Table

Table of matched objects augmented with columns from the Vizier catalogue.

stdpipe.catalogs.xmatch_skybot(obj, sr=0.002777777777777778, time=None, col_ra='ra', col_dec='dec', col_id='id')[source]

Cross-match object list with Solar System object positions using SkyBoT.

Queries SkyBoT for all Solar System objects in a cone covering the input field at the specified time, then cross-matches them against the input list within sr.

Parameters:
objastropy.table.Table

Table of objects to cross-match.

srfloat, optional

Cross-matching radius in degrees.

timeastropy.time.Time or datetime or str

Observation time.

col_rastr, optional

Column name in obj containing Right Ascension values.

col_decstr, optional

Column name in obj containing Declination values.

col_idstr, optional

Column name in obj containing unique object identifiers.

Returns:
astropy.table.Table or None

Table of matched Solar System objects with a col_id column referencing the matched input objects, or None if no matches are found.

stdpipe.catalogs.xmatch_ned(obj, sr=0.0008333333333333334, col_ra='ra', col_dec='dec', col_id='id')[source]

Cross-match object list with NED database entries.

Note

Queries NED one object at a time, so this is slow for large lists.

Parameters:
objastropy.table.Table

Table of objects to cross-match.

srfloat, optional

Cross-matching radius in degrees.

col_rastr, optional

Column name in obj containing Right Ascension values.

col_decstr, optional

Column name in obj containing Declination values.

col_idstr, optional

Column name in obj containing unique object identifiers.

Returns:
astropy.table.Table or list

Table of NED objects with an id column referencing the matched input objects, or an empty list if no matches are found.