***************
Getting started
***************

Requirements
============

PyCASSO requires python 2.7. You also need these to use the data access modules.

* numpy/scipy
* pyfits
* h5py

These are probaby available at you python package manager.
For example, in Mac OSX using macports, use these commands to
install python 2.7 and the dependencies, and then select this as
your default python installation.

.. code-block:: bash

	$ sudo port install python27 py27-h5py py27-numpy py27-scipy py27-pyfits
	$ sudo port select --set python python27
		
You will also need `PySTARLIGHT <https://bitbucket.org/astro_ufsc/pystarlight>`_.
The package is in the `python package index <https://pypi.python.org/pypi>`_, you may install it
using easy_install or pip (*NOTE*: be sure that pip and easy_install are using the same
python installation as you use for coding, or PySTARLIGHT will be installed at the wrong
directory):

.. code-block:: bash

	$ pip install PySTARLIGHT
	
or

.. code-block:: bash

	$ easy_install PySTARLIGHT

If you want to create your own datasets, you'll also need
`atpy <http://atpy.github.com/>`_. In macports, install it
using the command:

.. code-block:: bash

	$ sudo port install py27-atpy

Stable version
==============

The stable version of PyCASSO is `0.9.0 <https://bitbucket.org/astro_ufsc/pycasso/get/PyCASSO-0.9.0.tar.gz>`_.
Install using these commands:

.. code-block:: bash

    $ tar xvzf PyCASSO-X.X.X.tar.gz
    $ cd PyCASSO-X.X.X/
    $ python setup.py install	
    
Developer version
=================

Development version (may be broken):

.. code-block:: bash

    $ hg clone https://bitbucket.org/astro_ufsc/pycasso
   
which can then be installed with:

.. code-block:: bash

    $ cd pycasso
    $ python setup.py install