Toolkit to access and manipulate Gaia catalogue tables hosted at ESA's Gaia Archive Core Systems (GACS)
**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 of
tables in GACS, e.g. basic query on a single table or crossmatch between two tables. It employs the TAP command line access tools described
in the 'Help' section of the GACS web pages (`<http://archives.esac.esa.int/gaia/>`_).
Both public and authenticated access have been
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.
Basic example usage
# import module
import pygacs.public.publicAccessTools as pgp
# define ADQL query
queryString = '''SELECT * FROM gaiadr1.tgas_source WHERE parallax >
# define local file to store query result in a VO table
outputFileName = path + 'ADQL_query_result.vot';
# execute query
# read result into astropy table
T = Table.read(outputFileName,format='votable')
All classes and methods/functions include basic documentation.
This package was developed in a python 2.7 environment, but was also
successfully tested using python 3.5.
The following python packages are required:
* `numpy <http://www.numpy.org/>`_
* `astropy <http://www.astropy.org/>`_
* `xmltodict <https://pypi.python.org/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
> cd pygacs
> python setup.py install --user
To run the example script, do:
> cd examples/
For public access:
For authenticated access:
> ./pygacsExample.py --help
> ./pygacsExample.py yourGacsUserName yourGacsPassword
Please acknowledge the ESA Science Archives Team and the Gaia Data
Processing and Analysis Consortium (DPAC) if you used this code in your
Copyright (c) 2015-2016 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/>`_.
0.0 (September 2015)
0.2.5 (March 2016)
- Added compatibility with python3.5
- Added public access functionality
0.2.6 (August 2016)
- Updated archive URL
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.