Software Carpentry at QM

h1. MAT2015 Software

*We will be running this session in the MAT G2 lab with the iMacs -- these should have the software we need already installed.*

If you'd prefer to use your own laptop instead of the iMac, you can, but you'll need to make sure the following software is installed on it beforehand. We won't have time during the session to sort out installation problems I'm afraid.

h2. Shortlist

h3. Day 1

* Bash (the particular Unix shell we’ll be using)

* Python 2.6+ (the scripting language used in the course)

* A text editor (for programming!)

h3. Day 2

* "Mercurial":http://mercurial.selenic.com/ and "EasyMercurial":http://easyhg.org (for version control)

* "Numpy":http://www.numpy.org/

* "SciPy":http://www.scipy.org/

* "Matplotlib":http://matplotlib.org/

h2. Installation on Linux

* Bash, Python and Firefox are all available using the appropriate package management tool in all major Linux distributions. Please check that the Python version is 2.something, (2.6 or higher, preferrably). If not, you may need to install a newer version “by hand” or upgrade your Linux installation.

* EasyMercurial can be downloaded as a .deb package (for Debian or Ubuntu installations) from the "EasyMercurial Download page":http://easyhg.org/download.html. Your package manager should automatically install any dependencies, including Mercurial itself. On Red Hat or other Linux distributions you will probably need to install Mercurial first using your package manager, then download the EasyMercurial source code package and compile and install it using the instructions in the included file README.txt: just run qmake and then make. The qmake tool is part of the qt-devel package, which you may need to install first.

* If you use Linux, you probably already have a favourite text editor. Emacs and Nano are popular choices, but there are many others.

h2. Installation on Windows

* You should install "MinGW and MSYS":http://www.mingw.org/. Check that you can run (from the Windows Start menu) MinGW -> MinGW Shell in order to open a Bash prompt.

* Python + SciPy + Numpy + Matplotlib:

** Install Python 2.7 using the MSI installer from python.org

** Install NumPy and SciPy packages from scipy.org

** Alternatively, you can either use one of these pre-packaged Python distributions, such as "EPD":http://www.enthought.com/products/epd_free.php or "Anaconda":https://store.continuum.io/cshop/academicanaconda

* Install the scikits.audiolab package from "this site":http://www.lfd.uci.edu/~gohlke/pythonlibs/#scikits.audiolab, and matplotlib from SourceForge.

* EasyMercurial can be downloaded from the "EasyMercurial Download page":http://easyhg.org/download.html (the Windows installer will also install Mercurial itself).

* You will need to edit the PATH environment variable to add Python and Mercurial. To do this, go to Control Panel -> System and Security -> System -> Advanced system settings -> Advanced and click the Environment Variables button; then edit the PATH user variable and copy and paste

<pre>

C:\Python27;C:\Program Files\EasyMercurial;C:\Program Files (x86)\EasyMercurial

</pre>

onto the end of it.

* You can use Wordpad or Notepad as text editors, or install another editor such as Sublime Text 2 or TextWrangler.

h2. Installation on Mac OSX

* OSX comes with Bash and Python;

* You can download "Mercurial":http://mercurial.selenic.com/ from the Mercurial web site and EasyMercurial from the "EasyMercurial Download page":http://easyhg.org/download.html;

* There are many text editors available for OSX, but TextEdit will suffice (make sure you are saving the New Documents in Plain Text - see TextEdit's preferences);

* SciPy+Numpy 

** use the following script: "ScipySuperpack":http://stronginference.com/ScipySuperpack

** *alternatively*, you can also use one of these pre-packaged Python distributions:

*** "Canopy":https://www.enthought.com/products/canopy/

*** "Anaconda":https://store.continuum.io/cshop/anaconda/

h2. Testing the installed software

We recommend that you try the following simple tests to ensure that everything is installed and working correctly before the course starts.

h3. Bash

At the prompt, type “whoami”. You should be told what your user name is on the computer you are using.

h3. Python

At the prompt, type “print 2+2″ and check that you agree with the result.

h3. Mercurial

At the Bash prompt, type “hg”. You should see a list of basic Mercurial commands.

h3. EasyMercurial

Create a directory (folder) somewhere on your computer.

Start EasyMercurial and create a repository in your new directory: Open -> File folder -> navigate to your directory  and click “OK”.

h3. Text editor

Create and save a file with some plain text in it.