<commit_before>*********
Downloads
*********



Installing Topographica
-----------------------

Topographica is platform-independent, and all instructions below
apply to Linux, UNIX, Mac, or Windows, unless otherwise specified.
In Windows, to get a command prompt, you can use the Run command
from the Start menu and enter cmd; on other systems you can start a
Terminal or similar application.

The instructions below explain how to install Topographica `using pip`_
(for most users), `using virtualenv`_ (if you don't have pip access
or want a separate working environment, e.g. just to try out
Topographica), or `using git`_ (if you want the latest version, or need to
track our files using revision control).

First install Python
~~~~~~~~~~~~~~~~~~~~

Topographica is written in Python, which is available for nearly all
operating systems and is usually already installed (try running
``python --version`` from the command prompt). If Python version 2.6 or
later is not installed, you can download the latest version for your
system from `python.org`_. Note that we do not yet support Python3,
so if only python3 is installed you will need to install python2 as
well (e.g. Python 2.7).

If Python isn't already installed, it may be convenient to get it
from one of the integrated scientific Python distributions like
`Python(X,Y)`_, `EPD`_, or `Anaconda CE`_. These distributions are
particularly useful for Windows and Mac users, who might not
otherwise have a C compiler (necessary for good performance in
Topographica) and optimized math and matrix libraries. On any
system, the integrated distributions also provide a lot of useful
related packages, including most of Topographica's dependencies.

Install via pip
~~~~~~~~~~~~~~~

The typical way to install the most recently released version of<commit_msg>Added Ubuntu installation recipe<commit_after>*********
Downloads
*********



Installing Topographica
-----------------------

Topographica is platform-independent, and all instructions below
apply to Linux, UNIX, Mac, or Windows, unless otherwise specified.
In Windows, to get a command prompt, you can use the Run command
from the Start menu and enter cmd; on other systems you can start a
Terminal or similar application.

The instructions below explain how to install Topographica `using pip`_
(for most users), `using virtualenv`_ (if you don't have pip access
or want a separate working environment, e.g. just to try out
Topographica), or `using git`_ (if you want the latest version, or need to
track our files using revision control).

First install Python
~~~~~~~~~~~~~~~~~~~~

Topographica is written in Python, which is available for nearly all
operating systems and is usually already installed (try running
``python --version`` from the command prompt). If Python version 2.6 or
later is not installed, you can download the latest version for your
system from `python.org`_. Note that we do not yet support Python3,
so if only python3 is installed you will need to install python2 as
well (e.g. Python 2.7).

If Python isn't already installed, it may be convenient to get it
from one of the integrated scientific Python distributions like
`Python(X,Y)`_, `EPD`_, or `Anaconda CE`_. These distributions are
particularly useful for Windows and Mac users, who might not
otherwise have a C compiler (necessary for good performance in
Topographica) and optimized math and matrix libraries. On any
system, the integrated distributions also provide a lot of useful
related packages, including most of Topographica's dependencies.

Quick recipe for Ubuntu Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If you're installing on Ubuntu Linux 12.04, all you need to do is:

#. ``sudo apt-get update``
#. ``sudo apt-get install python-pip python-tk python-imaging-tk python-numpy``
#. ``sudo apt-get install ipython python-gmpy python-matplotlib python-scipy``
#. ``sudo pip install topographica``

Step 3 is optional, but highly recommended.  The remaining sections
below explain the general cross-platform procedure, but if you have
problems on any particular platform, you might consider using an
Ubuntu 12.04 virtual machine to try out Topographica so that you can
use the simple recipe above.  Similar approaches should work on other
platforms, but we don't currently have a list of the precise steps in
each case.

Install via pip
~~~~~~~~~~~~~~~

The typical way to install the most recently released version of
{'fraction_non_alphanumeric': 0.087663804789878, 'fraction_numerical': 0.005196565747853593, 'mean_word_length': 4.639490445859873, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4084621', 'n_tokens_mistral': 1128, 'n_tokens_neox': 1060, 'n_words': 641}