Carpyncho client for Python

Python client for Carpyncho VVV dataset collection.
Build Status DOI Python 3 BSD-3 Documentation Status PyPI ascl:2005.007 Logo

This library access as a Pandas DataFrame all the data of the web version of Carpyncho


The entire source code of is hosted in GitHub


Carpyncho is under The BSD-3 License

The BSD 3-clause license allows you almost unlimited freedom with the software so long as you include the BSD copyright and license notice in it (found in Fulltext).


If you use Carpyncho in a scientific publication, we would appreciate citations to the following paper:

Cabral, J. B., Ramos, F., Gurovich, S., & Granitto, P. (2020). Automatic Catalog of RRLyrae from ∼ 14 million VVV Light Curves: How far can we go with traditional machine-learning?

Bibtex entry

       author = {{Cabral}, Juan B. and {Ramos}, Felipe and {Gurovich}, Sebasti{\'a}n and
         {Granitto}, Pablo},
        title = "{Automatic Catalog of RRLyrae from $\sim$ 14 million VVV Light Curves: How far can we go with traditional machine-learning?}",
      journal = {arXiv e-prints},
     keywords = {Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Solar and Stellar Astrophysics, Computer Science - Machine Learning, Statistics - Machine Learning},
         year = 2020,
        month = may,
          eid = {arXiv:2005.00220},
        pages = {arXiv:2005.00220},
archivePrefix = {arXiv},
       eprint = {2005.00220},
 primaryClass = {astro-ph.IM},
       adsurl = {},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}


This is the recommended way to install carpyncho.

Installing with pip

Make sure that the Python interpreter can load carpyncho code. The most convenient way to do this is to use virtualenv, virtualenvwrapper, and pip.

After setting up and activating the virtualenv, run the following command:

$ pip install carpyncho

That should be it all.

Installing the development version

If you’d like to be able to update your carpyncho code occasionally with the latest bug fixes and improvements, follow these instructions:

Make sure that you have Git installed and that you can run its commands from a shell. (Enter git help at a shell prompt to test this.)

Check out carpyncho main development branch like so:

$ git clone carpyncho

This will create a directory carpyncho in your current directory.

Then you can proceed to install with the commands

$ cd carpyncho
$ pip install -e .


The full documentation of the project are available in


For bugs or question please contact

Juan B. Cabral:

Indices and tables