Software Carpentry at QM

h1. C4DM2013 Software

You should ensure the following software is installed on your laptop before you arrive at the [[c4dm2013|C4DM SWC 2013 bootcamp]], so that we can get started promptly with the tutorials.

h2. Shortlist

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

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

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

* A text editor (for programming!)

* You can also save time on the day by creating an account beforehand at the "SoundSoftware code site":http://code.soundsoftware.ac.uk.

For the second day of the bootcamp you'll need the following Python packages: 

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

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

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

* "Scikits Audiolab":https://pypi.python.org/pypi/scikits.audiolab/

If you run into any trouble, please send us an email: info@soundsoftware.ac.uk.

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.x, (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.

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

* Install NumPy and SciPy packages from scipy.org

* 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.

h3. 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);

h4. Python under OSX

The following instructions have been tested under OSX Lion (10.7). Please let us know if you run into any problem.  You’ll need to have both XCode and Homebrew installed:

* XCode: Please follow the instructions on this page to install XCode using the AppStore;

* Homebrew: Please follow the instructions in the Homebrew’s page.

* The easiest way to install SciPy, Numpy and Matplotlib is to use the following script: "ScipySuperpack":http://fonnesbeck.github.com/ScipySuperpack/

Audiolab depends on libsndfile, so you need to install it first. To install it run the following command on the Terminal:

<pre>

brew install libsndfile

</pre>

After this, you need to install Audiolab. To install Audiolab, you need to run the following commands on the Terminal (you might need to be sudo):

<pre>

easy_install pip

pip install scikits.audiolab

</pre>

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.

Then type “import sqlite3″ and verify that you don’t see an error message.

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.