Skip to main content

Gaia science performance simulation toolkit

Project description

PyGaia

Python toolkit for Gaia science performance simulation and astrometric catalogue data manipulation.

Description

PyGaia provides python modules for the simulation of Gaia data and their uncertainties, as well modules for the manipulation of the Gaia catalogue data. In particular transformations between astrometric observables and phase space variables are provided as well as transformations between sky coordinate systems. Only (very) basic functionality is provided. Full blown simulations of Gaia data in all their gory detail requires the Java tools developed by the Gaia Data Processing and Analysis Consortium (DPAC) in particular its Coordination Unit 2 (CU2).

This toolkit is basically an implementation of the performance models for Gaia which are publicly available at: http://www.cosmos.esa.int/web/gaia/science-performance. In addition much of the material in chapter 4 of the book Astrometry for Astrophysics: Methods, Models, and Applications (2012, van Altena et al.) is implemented.

  • The code in this package is not intended for accurate astrometry applications, such as predicting in detail astrometric paths of stars on the sky.
  • Epoch transformation is provided, including the transformation of the astrometric covariance matrix to different epochs.

Astropy astrometry modules versus pygaia.astrometry

It is recommended to use the Astropy facilities for handling astrometric data, including transformations from (Cartesian) phase space coordinates to astrometric observables and vice versa. See the astropy.coordinates package. Compared to the pygaia.astrometry package this gives you more functionality, the use of units, and much better maintained code.

The only functionality not (yet) provided in Astropy is the propagation of the covariance matrix of the astrometric observables to to a different epoch. This is implemented in the class pygaia.astrometry.coordinates.EpochPropagation. Epoch propagation as such is implemented in Astropy as the apply_space_motion() function of the SkyCoord class.

Documentation

All classes and methods/functions are documented so use the python help() function to find out more.

Installation

To install from source.

git clone https://github.com/agabrown/PyGaia.git
cd PyGaia
python -m pip install .

From PyPI:

pip install pygaia

Dependencies

This package is intended for Python3.

The following python packages are required:

For the plotting tools:

Acknowledgements

PyGaia is based on the effort by Jos de Bruijne to create and maintain the Gaia Science Performance pages (with support from David Katz, Paola Sartoretti, Francesca De Angeli, Dafydd Evans, Marco Riello, and Josep Manel Carrasco), and benefits from the suggestions and contributions by Morgan Fouesneau, Tom Callingham, John Helly, Javier Olivares, Henry Leung, Johannes Sahlmann.

The photometric uncertainties code in PyGaia is based on the tool provided by Gaia DPAC (https://www.cosmos.esa.int/web/gaia/dr3-software-tools) to reproduce (E)DR3 Gaia photometric uncertainties described in the GAIA-C5-TN-UB-JMC-031 technical note using data in Riello et al (2021).

Attribution

Please acknowledge the Gaia Project Scientist Support Team and the Gaia Data Processing and Analysis Consortium (DPAC) if you used this code in your research.

License

Copyright (c) 2012-2024 Anthony Brown, Leiden University, Gaia Data Processing and Analysis Consortium

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pygaia-3.2.2.tar.gz (3.7 MB view details)

Uploaded Source

Built Distribution

pygaia-3.2.2-py3-none-any.whl (41.5 kB view details)

Uploaded Python 3

File details

Details for the file pygaia-3.2.2.tar.gz.

File metadata

  • Download URL: pygaia-3.2.2.tar.gz
  • Upload date:
  • Size: 3.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for pygaia-3.2.2.tar.gz
Algorithm Hash digest
SHA256 f98584907dfd535665110179ebe5750f5400993f5a911613b45725bc03371ae1
MD5 08486b3aabd11b185e27e2fdfcc6e38e
BLAKE2b-256 08bc7dd0711f88ae40a22ebe415d0450f99fdb48b3c9ac2808a792e90f65bc8c

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygaia-3.2.2.tar.gz:

Publisher: python-publish.yml on agabrown/PyGaia

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pygaia-3.2.2-py3-none-any.whl.

File metadata

  • Download URL: pygaia-3.2.2-py3-none-any.whl
  • Upload date:
  • Size: 41.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for pygaia-3.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d0c8ac616c4e20e7c01fce5a72c7b8cec84c0927b3e21bf4c7034000baae544b
MD5 e940964fbb9d64b25a9cd1af021ae98f
BLAKE2b-256 e05cfe93464d634f0aae444d6cde93878164e0320cf41b9f3bb38ecb5a675477

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygaia-3.2.2-py3-none-any.whl:

Publisher: python-publish.yml on agabrown/PyGaia

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page