Dependencies
------------

statsmodels 0.8 was tested with the following minimal version requirements.
However, some features require more recent versions.

python >= 2.6

    www.python.org

numpy >= 1.6.2

    www.numpy.org

scipy >= 0.11
    
    www.scipy.org

pandas >= 0.12

    pandas.pydata.org

patsy >= 0.2.1

    patsy.readthedocs.org

cython >= 0.24

    http://cython.org/

    Cython is required if you are building the source from github. However,
    if you have are building from source distribution archive then the 
    generated C files are included and Cython is not necessary. If you are 
    building for Python 3.4, then you must use Cython >= 0.24. Earlier
    versions may be ok for earlier versions of Python.

Optional Dependencies
---------------------

X-12-ARIMA or X-13ARIMA-SEATS

    http://www.census.gov/srd/www/x13as/

    If available, time-series analysis can be conducted using either
    X-12-ARIMA or the newer X-13ARIMA-SEATS. You should place the
    appropriate executable on your PATH or set the X12PATH or X13PATH
    environmental variable to take advantage.

matplotlib >= 1.3

    http://matplotlib.org/

    Matplotlib is needed for plotting functionality and running many of the
    examples.

sphinx >= 1.3

    http://sphinx.pocoo.org/

    Sphinx is used to build the documentation.

nose >= 1.3

    http://readthedocs.org/docs/nose/en/latest/

    Nose is needed to run the tests.

IPython >= 3.0

    Needed to build the docs.


Installing
----------

To get the latest release using pip

    pip install statsmodels --upgrade-strategy only-if-needed

The additional parameter pip --upgrade-strategy only-if-needed will ensure
that dependencies, e.g. NumPy or pandas, are not upgraded unless required.

Ubuntu/Debian
-------------

On Ubuntu you can get dependencies through:

    sudo apt-get install python python-dev python-setuptools python-numpy python-scipy
    pip install cython pandas

Alternatively, you can install from the NeuroDebian repository:

    http://neuro.debian.net


Installing from Source
----------------------

Download and extract the source distribution from PyPI or github

    http://pypi.python.org/pypi/statsmodels
    https://github.com/statsmodels/statsmodels/tags

Or clone the bleeding edge code from our repository on github at

    git clone git://github.com/statsmodels/statsmodels.git

In the statsmodels directory do (with proper permissions)

    python setup.py install

You will need a C compiler installed.

Installing from Source on Windows
---------------------------------

See http://www.statsmodels.org/devel/install.html#windows.


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

You may find more information about the project and installation in our
documentation

http://www.statsmodels.org/devel/install.html
