Files
simpeg/docs/api_installing.rst
T
2014-05-17 22:10:31 -07:00

78 lines
2.3 KiB
ReStructuredText

.. _api_installing:
Installation
************
Dependencies
============
- Python 2.7
- NumPy 1.8 (or greater)
- SciPy 0.13 (or greater)
- matplotlib 1.3 (or greater)
- Cython 0.20 (or greater)
Installing Python
=================
Python is available on all major operating systems, but if you are getting started with python
it is best to use a package manager such as
`Continuum Anaconda <https://store.continuum.io/cshop/anaconda/>`_ or
`Enthought Canopy <https://www.enthought.com/products/canopy/>`_.
You can download the package manager and use it to install the dependencies above.
Installing SimPEG
=================
SimPEG is not **yet** on pip.
Installing from Source
----------------------
First (you need git)::
git clone https://github.com/simpeg/simpeg
Second (from the root of the simpeg repository)::
python setup.py install
Useful Links
============
An enormous amount of information (including tutorials and examples) can be found on the official websites of the packages
* `Python Website <http://www.python.org/>`_
* `Numpy Website <http://www.numpy.org/>`_
* `SciPy Website <http://www.scipy.org/>`_
* `Matplotlib <http://matplotlib.org/>`_
Python for scientific computing
-------------------------------
* `Python for Scientists <https://sites.google.com/site/pythonforscientists/>`_ Links to commonly used packages, Matlab to Python comparison
* `Python Wiki <http://wiki.python.org/moin/NumericAndScientific>`_ Lists packages and resources for scientific computing in Python
Numpy and Matlab
----------------
* `NumPy for Matlab Users <http://wiki.scipy.org/NumPy_for_Matlab_Users>`_
* `Python vs Matlab <https://sites.google.com/site/pythonforscientists/python-vs-matlab>`_
Lessons in Python
-----------------
* `Software Carpentry <http://software-carpentry.org/v4/python/index.html>`_
* `Introduction to NumPy and Matplotlib <http://www.youtube.com/watch?v=3Fp1zn5ao2M>`_
Editing Python
--------------
There are numerous ways to edit and test Python (see `PythonWiki <http://wiki.python.org/moin/PythonEditors>`_ for an overview) and in our group at least the following options are being used:
* `Sublime <http://www.sublimetext.com/>`_
* `iPython Notebook <http://ipython.org/notebook.html>`_
* `iPython <http://ipython.org/>`_
* `Enthought Canopy <https://www.enthought.com/products/canopy/>`_