Skip to main content

Toolkit to access and manipulate Gaia catalogue tables hosted at ESA's Gaia Archive Core Systems (GACS)

Project description

pygacs
======

**Python toolkit to manipulate Gaia catalogue tables hosted at ESA's Gaia Archive Core Systems (GACS)**

pygacs provides python modules for the access and manipulation (e.g. crossmatch) of
tables in GACS. It employs the TAP command line access tools described
in the 'Help' section of the GACS web pages (`<http://gaia.esac.esa.int/archive/>`_).

Both public and authenticated access have been
implemented.

Please see pygacsExample_publicAccess.py for a demo on how public tables can easily be queried using ADQL.

To fully use pygacs, in particular to upload a table for
crossmatch operations, you will need to be a registered user of GACS
and call the example script pygacsExample.py with your access credentials.



Documentation
-------------

All classes and methods/functions include basic documentation.


Installation notes
------------------

This package was developed in a python 2.7 environment.

The following python packages are required:

* `numpy <http://www.numpy.org/>`_
* `astropy <http://www.astropy.org/>`_
* `xmltodict <https://pypi-hypernode.com/pypi/xmltodict/>`_

Optional (for plotting in the example script):

* `matplotlib <http://matplotlib.org/>`_
* `pylab <http://matplotlib.org/pylab/>`_


How to run the example script
-----------

You may use pip for installation:

> pip install pygacs

Or get the source files, e.g.:

> git clone https://github.com/johannes-sahlmann/pygacs

Install pygacs:

> cd pygacs

> python setup.py install --user

To run the example script, do:

> cd examples/

For public access:
> ./pygacsExample_publicAccess.py

For authenticated access:
> ./pygacsExample.py --help
> ./pygacsExample.py yourGacsUserName yourGacsPassword





Attribution
-----------

Please acknowledge the ESA Science Archives Team and the Gaia Data
Processing and Analysis Consortium (DPAC) if you used this code in your
research.

License
-------

Copyright (c) 2015 Johannes Sahlmann, Gaia Data Processing and Analysis Consortium

pygacs is open source and free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your option)
any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see `<http://www.gnu.org/licenses/>`_.


Changelog
---------

.. :changelog:

0.0 (September 2015)
++++++++++++++++++

- Creation.

Project details


Download files

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

Source Distributions

pygacs-0.2.4.zip (25.9 kB view details)

Uploaded Source

pygacs-0.2.4.tar.gz (17.1 kB view details)

Uploaded Source

File details

Details for the file pygacs-0.2.4.zip.

File metadata

  • Download URL: pygacs-0.2.4.zip
  • Upload date:
  • Size: 25.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pygacs-0.2.4.zip
Algorithm Hash digest
SHA256 b4a8aaa99d20bfe15eeaedcab5e608810f8f3c77b5544d40a694f2e494ad334d
MD5 9abdee9072906db52f01dd2e5eaeae7f
BLAKE2b-256 930d9484280410dd3f53582f8fbdfe531f80772d27aceb9193a0deea8f33decd

See more details on using hashes here.

Provenance

File details

Details for the file pygacs-0.2.4.tar.gz.

File metadata

  • Download URL: pygacs-0.2.4.tar.gz
  • Upload date:
  • Size: 17.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pygacs-0.2.4.tar.gz
Algorithm Hash digest
SHA256 40b43cb039a384fdf4fbd87cf0c8106c33cb7fd6c8d0662c899879502658aca7
MD5 266cf6d76690c8ac8f109e9324ac0b36
BLAKE2b-256 5811c41d36067e9f527a5556c00a34c4afcefcb027e05486657cc9b736281003

See more details on using hashes here.

Provenance

Supported by

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