dace_query.astrometry package

Submodules

dace_query.astrometry.astrometry module

dace_query.astrometry.astrometry.Astrometry: AstrometryClass = <dace_query.astrometry.astrometry.AstrometryClass object>

Astrometry instance

class dace_query.astrometry.astrometry.AstrometryClass(dace_instance: DaceClass | None = None)

Bases: object

The astrometry class. Use to retrieve data from the astrometry module.

An astrometry instance is already provided, to use it:

from dace_query.astrometry import Astrometry
get_gaia_timeseries(target: str, output_format: str | None = None) → dict[str, ndarray] | DataFrame | Table | dict

Get timeseries from Gaia astrometry for the specified target.

All available formats are defined in this section (see Output formats).

Parameters:

  • target (str) – The target name to retrieve astrometry data from

  • output_format (Optional[str]) – Type of data returns

Returns:

The desired data in the chosen output format

Return type:

dict[str, ndarray] or DataFrame or Table or dict

from dace_query.astrometry import Astrometry
target_to_search = 'your-target'
values = Astrometry.get_gaia_timeseries(target=target_to_search)
get_hipparcos_timeseries(id: str, output_format: str | None = None)

Get the timeseries for a target from the Hipparcos Intermediate Astrometric Data (IAD).

All available formats are defined in this section (see Output formats).

Parameters:

  • id (str) – Target name or identifier

  • output_format (Optional[str]) – The desired format for the result data.

Returns:

The desired data in the chosen output format

Return type:

dict[str, ndarray] or DataFrame or Table or dict

Column descriptions

  • IORB (-): Orbit number.

  • EPOCH (years): Observation epoch, given as Year - 1991.25.

  • PARF (-): Parallax factor.

  • CPSI (-): Cosine of Psi.

  • SPSI (-): Sine of Psi.

  • RES (mas): Abscissa residual.

  • SRES (mas): Formal error on abscissa residual.

  • HIP (-): Hipparcos identifier.

  • T_BJD (days): Epoch in Barycentric Julian Date (BJD).

  • S_MAS (mas): Absolute astrometric signal, RES + fitted model.

  • CTH (-): Cosine of the theta angle, following Gaia convention.

  • STH (-): Sine of the theta angle, following Gaia convention.

  • IAD_SOURCE (-): Indicates the source of the IAD, either “Brandt2021” or “JavaTool”.

Example

from dace.astrometry import Astrometry
Astrometry.get_hipparcos_timeseries("HIP 1000", output_format='pandas')
query_database(limit: int | None = 10000, filters: dict | None = None, sort: dict | None = None, output_format: str | None = None) → dict[str, ndarray] | DataFrame | Table | dict

Query the astrometry database to retrieve data in the chosen format.

Filters and sorting order can be applied to the query via named arguments (see Filtering and sorting).

All available formats are defined in this section (see Output formats).

Parameters:

  • limit (Optional[int]) – Maximum number of rows to return

  • filters (Optional[dict]) – Filters to apply to the query

  • sort (Optional[dict]) – Sort order to apply to the query

  • output_format (Optional[str]) – Type of data returns

Returns:

The desired data in the chosen output format

Return type:

dict[str, ndarray] or DataFrame or Table or dict

from dace_query.astrometry import Astrometry
values = Astrometry.query_database()
query_hipparcos_database(id: str, output_format: str | None = None)

Query hipparcos database to retrieve data from the main hipparcos catalog with the basic information about a target and its solution.

Parameters:

  • id (str) – Target name or identifier

  • output_format (Optional[str]) – The desired format for the result data.

Returns:

The desired data in the chosen output format

Return type:

dict[str, ndarray] or DataFrame or Table or dict

Column descriptions

  • hip (-): Hipparcos identifier.

  • mce (-): Main-catalogue entry.

  • nres (-): Number of residual records.

  • nc (-): Number of components.

  • isol_n (-): Solution type.

  • sce (-): Supplement-catalogue entry.

  • f2 (-): Goodness of fit.

  • f1 (-): Percentage of rejected observations.

  • hp (mag): Hp magnitude.

  • bmv (mag): B-V colour index.

  • varann (-): Reference to variability annex.

  • nob (-): Number of observations.

  • nr (-): Number of rejected observations.

  • radeg (deg.): Right Ascension.

  • dedeg (deg.): Declination.

  • plx (mas): Parallax.

  • pm_ra (mas/yr): Proper motion in Right Ascension.

  • pm_de (mas/yr): Proper motion in Declination.

  • e_ra (mas): Formal error on RAdeg.

  • e_de (mas): Formal error on DEdeg.

  • e_plx (mas): Formal error on Plx.

  • e_pmra (mas/yr): Formal error on pmRA.

  • e_pmde (mas/yr): Formal error on pmDE.

  • dpmra (mas/yr²): Acceleration in Right Ascension (7p, 9p).

  • dpmde (mas/yr²): Acceleration in Declination (7p, 9p).

  • e_dpmra (mas/yr²): Formal error on dpmRA (7p, 9p).

  • e_dpmde (mas/yr²): Formal error on dpmDE (7p, 9p).

  • ddpmra (mas/yr³): Acceleration change in Right Ascension (9p).

  • ddpmde (mas/yr³): Acceleration change in Declination (9p).

  • e_ddpmra (mas/yr³): Formal error on ddpmRA (9p).

  • e_ddpmde (mas/yr³): Formal error on ddpmDE (9p).

  • upsra (mas): VIM in Right Ascension (VIM).

  • upsde (mas): VIM in Declination (VIM).

  • e_upsra (mas): Formal error on upsRA (VIM).

  • e_upsde (mas): Formal error on upsDE (VIM).

  • var (mas): Cosmic dispersion added (stochastic).

  • gaia_gaiadr3_id (-): Gaia DR3 ID as matched by Gaia.

  • simbad_gaiadr3_id (-): Gaia DR3 ID as matched by SIMBAD.

  • gaiadr3_id_conflict (-): Indicates if there is a conflict in Gaia DR3 ID between sources.

  • iad_source (-): Indicates the source of the IAD, either “Brandt2021” or “JavaTool”.

Example

from dace.astrometry import Astrometry

# Query the Hipparcos database with a Hipparcos identifier
Astrometry.query_hipparcos_database('HIP 1000', output_format='pandas')

# Query the Hipparcos database with a Gaia DR3 identifier
Astrometry.query_hipparcos_database('Gaia DR3 2361372542600289664', output_format='pandas')

Module contents