Package: pygacs
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 oftables in GACS, e.g. basic query on a single table or crossmatch between two tables. It employs the TAP command line access tools describedin the 'Help' section of the GACS web pages (`<http://archives.esac.esa.int/gaia/>`_).Both public and authenticated access have beenimplemented.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 forcrossmatch operations, you will need to be a registered user of GACSand call the example script pygacsExample.py with your access credentials.Basic example usage-------------# import moduleimport pygacs.public.publicAccessTools as pgp# define ADQL queryqueryString = '''SELECT * FROM gaiadr1.tgas_source WHERE parallax >100; '''# define local file to store query result in a VO tableoutputFileName = path + 'ADQL_query_result.vot';# execute querypgp.retrieveQueryResult(queryString,outputFileName);# read result into astropy tableT = Table.read(outputFileName,format='votable')Documentation-------------All classes and methods/functions include basic documentation.Installation notes------------------This package was developed in a python 2.7 environment, but was alsosuccessfully 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 pygacsOr get the source files, e.g.:> git clone https://github.com/johannes-sahlmann/pygacsInstall pygacs:> cd pygacs> python setup.py install --userTo run the example script, do:> cd examples/For public access:> ./pygacsExample_publicAccess.pyFor authenticated access:> ./pygacsExample.py --help> ./pygacsExample.py yourGacsUserName yourGacsPasswordAttribution-----------Please acknowledge the ESA Science Archives Team and the Gaia DataProcessing and Analysis Consortium (DPAC) if you used this code in yourresearch.License-------Copyright (c) 2015-2016 Johannes Sahlmann, Gaia Data Processing and Analysis Consortiumpygacs is open source and free software: you can redistribute it and/or modifyit under the terms of the GNU Lesser General Public License as published by theFree 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 ANYWARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR APARTICULAR PURPOSE.  See the GNU General Public License for more details.You should have received a copy of the GNU General Public License along withthis program. If not, see `<http://www.gnu.org/licenses/>`_.Changelog---------.. :changelog:0.0 (September 2015)++++++++++++++++++- Creation.0.2.5 (March 2016)++++++++++++++++++- Added compatibility with python3.5- Added public access functionality0.2.6 (August 2016)++++++++++++++++++- Updated archive URL