MAT2015 Software » History » Version 2

Chris Cannam, 2015-03-18 08:00 PM

1 1 Chris Cannam
h1. MAT2015 Software
2 1 Chris Cannam
3 1 Chris Cannam
*We will be running this session in the MAT G2 lab with the iMacs -- these should have the software we need already installed.*
4 1 Chris Cannam
5 1 Chris Cannam
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.
6 1 Chris Cannam
7 1 Chris Cannam
h2. Shortlist
8 1 Chris Cannam
9 1 Chris Cannam
h3. Day 1
10 1 Chris Cannam
11 1 Chris Cannam
* Bash (the particular Unix shell we’ll be using)
12 1 Chris Cannam
* Python 2.6+ (the scripting language used in the course)
13 1 Chris Cannam
* A text editor (for programming!)
14 1 Chris Cannam
15 1 Chris Cannam
h3. Day 2
16 1 Chris Cannam
17 1 Chris Cannam
* "Mercurial":http://mercurial.selenic.com/ and "EasyMercurial":http://easyhg.org (for version control)
18 1 Chris Cannam
* "Numpy":http://www.numpy.org/
19 1 Chris Cannam
* "SciPy":http://www.scipy.org/
20 1 Chris Cannam
* "Matplotlib":http://matplotlib.org/
21 1 Chris Cannam
22 1 Chris Cannam
h2. Installation on Linux
23 1 Chris Cannam
24 1 Chris Cannam
* 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.
25 1 Chris Cannam
* 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.
26 1 Chris Cannam
* If you use Linux, you probably already have a favourite text editor. Emacs and Nano are popular choices, but there are many others.
27 1 Chris Cannam
28 1 Chris Cannam
h2. Installation on Windows
29 1 Chris Cannam
30 1 Chris Cannam
* 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.
31 1 Chris Cannam
32 1 Chris Cannam
* Python + SciPy + Numpy + Matplotlib:
33 1 Chris Cannam
** Install Python 2.7 using the MSI installer from python.org
34 1 Chris Cannam
** Install NumPy and SciPy packages from scipy.org
35 2 Chris Cannam
** *alternatively*, you can also use one of these pre-packaged Python distributions:
36 2 Chris Cannam
*** "Canopy":https://www.enthought.com/products/canopy/
37 2 Chris Cannam
*** "Anaconda":https://store.continuum.io/cshop/anaconda/
38 1 Chris Cannam
* Install the scikits.audiolab package from "this site":http://www.lfd.uci.edu/~gohlke/pythonlibs/#scikits.audiolab, and matplotlib from SourceForge.
39 1 Chris Cannam
* EasyMercurial can be downloaded from the "EasyMercurial Download page":http://easyhg.org/download.html (the Windows installer will also install Mercurial itself).
40 1 Chris Cannam
* 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
41 1 Chris Cannam
<pre>
42 1 Chris Cannam
C:\Python27;C:\Program Files\EasyMercurial;C:\Program Files (x86)\EasyMercurial
43 1 Chris Cannam
</pre>
44 1 Chris Cannam
onto the end of it.
45 1 Chris Cannam
* You can use Wordpad or Notepad as text editors, or install another editor such as Sublime Text 2 or TextWrangler.
46 1 Chris Cannam
47 1 Chris Cannam
h2. Installation on Mac OSX
48 1 Chris Cannam
49 1 Chris Cannam
* OSX comes with Bash and Python;
50 1 Chris Cannam
* 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;
51 1 Chris Cannam
* 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);
52 1 Chris Cannam
53 1 Chris Cannam
* SciPy+Numpy 
54 1 Chris Cannam
** use the following script: "ScipySuperpack":http://stronginference.com/ScipySuperpack
55 1 Chris Cannam
** *alternatively*, you can also use one of these pre-packaged Python distributions:
56 1 Chris Cannam
*** "Canopy":https://www.enthought.com/products/canopy/
57 1 Chris Cannam
*** "Anaconda":https://store.continuum.io/cshop/anaconda/
58 1 Chris Cannam
59 1 Chris Cannam
h2. Testing the installed software
60 1 Chris Cannam
61 1 Chris Cannam
We recommend that you try the following simple tests to ensure that everything is installed and working correctly before the course starts.
62 1 Chris Cannam
63 1 Chris Cannam
h3. Bash
64 1 Chris Cannam
65 1 Chris Cannam
At the prompt, type “whoami”. You should be told what your user name is on the computer you are using.
66 1 Chris Cannam
67 1 Chris Cannam
h3. Python
68 1 Chris Cannam
69 1 Chris Cannam
At the prompt, type “print 2+2″ and check that you agree with the result.
70 1 Chris Cannam
71 1 Chris Cannam
h3. Mercurial
72 1 Chris Cannam
73 1 Chris Cannam
At the Bash prompt, type “hg”. You should see a list of basic Mercurial commands.
74 1 Chris Cannam
75 1 Chris Cannam
h3. EasyMercurial
76 1 Chris Cannam
77 1 Chris Cannam
Create a directory (folder) somewhere on your computer.
78 1 Chris Cannam
79 1 Chris Cannam
Start EasyMercurial and create a repository in your new directory: Open -> File folder -> navigate to your directory  and click “OK”.
80 1 Chris Cannam
81 1 Chris Cannam
h3. Text editor
82 1 Chris Cannam
83 1 Chris Cannam
Create and save a file with some plain text in it.