= Easy Developer Setup on Windows Using Anaconda =

== Current Issues ==

* For now this is Windows only, though you may try other operating systems if you're happy to use the current versions of all packages.

* OpenMP is not included in the version of MinGW bundled with Anaconda.  Either turn OpenMP off when building (see below), or download your own version of MinGW for now.

== Step 1 - Install Anaconda ==

Download the latest Windows '''32-Bit''' Python '''2.7''' Installer from http://continuum.io/downloads and run it.

* The recommended destination folder is as good as any.  If you deviate from this then it's probably worthwhile to make sure the path is short and contains no spaces.

* At the Advanced Options screen, you need to consider whether or not you want to make Anaconda your default version of Python.  Developers who do not work on multiple Python projects can just accept the defaults here.

== Step 2 - Install Dependencies ==

Add the channel containing extra dependencies needed by !SasView:

{{{
conda config --add channels https://conda.binstar.org/PeterParker
}}}

If you are behind a proxy, you need to tell Conda about it.  Add the following to your .condarc file which is at {{{C:/Users/YourUserName/.condarc}}}:

{{{
# This example should work for the proxy at RAL:
proxy_servers:
    http: http://wwwcache.rl.ac.uk:8080
    https: http://wwwcache.rl.ac.uk:8080
}}}

Install all required !SasView dependencies:

{{{
conda install --yes pylint matplotlib scipy pyparsing html5lib wxpython reportlab lxml PIL setuptools numpy comtypes pywin32 py2exe pisa numpy sphinx unittest-xml-reporting mingw pip h5py
}}}
At least one additional package is required (compare the 64 bit Windows instructions).
{{{
conda install xhtml2pdf
pip install xhtml2pdf
}}}
The conda install above will fail to find 32 bit xhtml2pdf, but will install the dependencies it needs, xhtml2pdf needs pip install for its 32 bit version.
The bumps and periodictable Anaconda packages are not up to date. To install the latest versions, use pip as below, or checkout the repositories as outlined in Step 5.
{{{
pip install bumps periodictable
}}}
To force installation of a specific version of these packages (here bumps-0.7.5.7) use:
{{{
pip install bumps==0.7.5.7
}}}
Note: if attempting to upgrade older versions of bumps and/or periodictable, first ''uninstall'' any versions already installed.
{{{
pip uninstall bumps
pip uninstall periodictable
}}}
You ''may'' need to issue these commands more than once to ensure that all previous versions are cleaned out.
== Step 3 - Install Git (or optionally stay with SVN) ==

=== Git ===
Download: http://git-scm.com/download/win

When installing, it may be worthwhile to make sure "Use Git from the Windows Command Prompt" is selected, rather than "Use Git from Bash only".  This way you can use git from the same command line as you will use Anaconda.

Set up your credentials:

{{{
git config --global user.name "John Doe"
git config --global user.email johndoe@example.com
}}}

=== SVN ===
Download: http://sourceforge.net/projects/win32svn/files/latest/download

== Step 4 - Download the !SasView and !SasModels Source Code ==

The !SasView source code requires the sasmodels source directory to be in the same base directory for proper referencing. The dependencies also require the directories be named sasview and sasmodels.

{{{
# With Git:
git clone https://github.com/SasView/sasview.git sasview
git clone https://github.com/SasView/sasmodels.git sasmodels
# With SVN:
svn checkout https://github.com/SasView/sasview sasview
svn checkout https://github.com/SasView/sasmodels sasmodels
cd sasview
}}}

== Step 5 - Download the Optimiser Package & Periodic Table Package ==
Added by smk78

Follow this step to use the source code rather than installed packages for bumps and periodictable.

{{{
# With Git:
git clone https://github.com/bumps/bumps.git bumps
git clone https://github.com/pkienzle/periodictable.git periodictable
# With SVN:
svn checkout https://github.com/bumps/bumps.git bumps
svn checkout https://github.com/pkienzle/periodictable.git periodictable
}}}

== Step 6 - Check that the Right Version of Python is Being Used ==

Ask your console which versions of Python it can find:

{{{
where python
}}}

Hopefully, the first python installation in the list is the recently-installed Anaconda version.  If not, you have two options:

1. Whenever you call python on the command line from now on, use the fully resolved path, e.g.:
   {{{
   C:/PathToAnaconda/python
   }}}

2. Reorder your PATH/Path environment variables so that the Anaconda installation of Python appears BEFORE all the others.  Environment variables can be modified by pressing the windows key, typing "edit the system environment variables" and hitting Enter.  The built-in Windows way of doing this is not very nice.  An easier way to edit environment variables is by installing [http://www.rapidee.com/en/download RapidEE].

Some things to consider:

* Installations of !McStas might cause problems.  If the installation of Python that comes bundled with !McStas appears in the PATH before Anaconda, then the solution is the same as above.
* Installations of Mantid *should* play nice with Anaconda.  Let somebody know if it's causing a problem, though again, just make sure your PATH gives preferential treatment to Anaconda.
* If you have an old !SasView development environment set up, then you may have an installation of Python2.6 that doesn't play nice with Anaconda.  Uninstall it using the Control Panel and it should clear everything up.

== Step 7 - Install the Optimiser Package & Periodic Table Package ==
Added by smk78

Only follow this step if you chose to clone the bumps & periodictable repositories in Step 5 rather than pip install them in Step 2.

Navigate to the bumps folder:
{{{
python setup.py install
}}}

Navigate to the periodictable folder:
{{{
python setup.py clean
}}}

== Step 8 - Build !SasView ==

Navigate to the sasview-code folder. Optionally check that you have everything by:
{{{
python check_packages.py
}}}
Compile the code:
{{{
python setup.py disable_openmp build -cmingw32
}}}

This may end up failing with a large, obscure-looking "{{{...failed with exit status 1}}}" error, which when you scroll up actually ends up being "{{{The command line is too long.}}}"

If so, there are a couple of things you can try. First, make sure the {{{C:/AnacondaInstallDir/MinGW/bin}}} folder is at the beginning of your Path environment variable. If that doesn't cure the problem you will need to shorten folder path names (by actually renaming your working folders, or even by moving MinGW out of the Anaconda tree altogether - in which case remember to change your Path environment variable accordingly). Alternatively try adding the command switch -t t after the -cmingw32.

== Step 9 - Run !SasView from the Code == 

You should then be able to run !SasView “in-place” from the code, using:

{{{
python run.py
}}}

== Step 10 - Building the Help Docs ==
The process for building the help docs has been steadily evolving. The latest instructions might be found [http://trac.sasview.org/wiki/BuildDocs here]