.. _installation:
Installation
============
The preferred installation mechanism for ``msmbuilder`` is with ``conda``.
.. code-block:: bash
$ conda install -c omnia msmbuilder
If you don't have conda, or are new to scientific python, we recommend that
you download the `Anaconda scientific python distribution
`_.
From Source
-----------
MSMBuilder is a python package that heavily leans on other components of the
scientific python ecosystem. See ``devtools/conda-recipe/meta.yaml`` for a
complete and up-to-date list of build, run, and test dependencies. When you
are sure the dependencies are satisfied you can install from PyPI
.. code-block:: bash
$ pip install msmbuilder
or from source
.. code-block:: bash
$ git clone git@github.com:msmbuilder/msmbuilder
$ cd msmbuilder/
$ pip install .
$ # (or: python setup.py install)
Frequently Asked Questions
--------------------------
**Do I need Anaconda python? Can't I use the python that comes with my
operating like /usr/bin/python?**
You can have multiple ``python`` installations on your computer which do
not interact with one another at all. The system python interpreter is used
by your operating system for some of its own programs but is not the best
choice for data analysis or science.
We strongly recommend that you install Anaconda or Miniconda python
distribution and that you have the ``conda`` package manager available.
If you're interested in some of the details about packaging and scientific
python, see `this blog post by Travis Oliphant
`_.
.. vim: tw=75