Software Carpentry at QM

h1. MAT Software Carpentry Feb 2013 - Links

_*updated 11 Feb 2012* -- new link to Introduction to Python repository; added repository for Audio in Python_

h2. Material used in the workshop

* *Introduction to Shell* -- "Tutorial script":/documents/73 -- "Crib sheet on Unix shell commands":/documents/74

* *Introduction to Python* -- "Tutorial script":/documents/71 -- "Repository with code":https://code.soundsoftware.ac.uk/projects/swc-python-intro

* *Audio in Python* -- "Repository with code (includes example of plotting in Python)":https://code.soundsoftware.ac.uk/projects/swc-python-audio

* *Version control* -- "Introductory slides":/documents/75 -- "Tutorial script":/projects/easyhg/wiki/SC2012BootcampPlan

* *Data management* -- "Slides":/documents/72

* *Testing* -- "Tutorial script":/projects/ssw-swc-2013/wiki/SWC2013TDD

* *What We Know* -- "Slides":/documents/70

h2. Assessed Exercise

* *Assessed Exercise* -- [[MATFeb2013AssessedExercise|Details]]

h2. Other material from us

* We offer "a number of one-page info sheets":http://soundsoftware.ac.uk/handouts-guides on topics related to this workshop

* There is an extended version of the unit testing example (without mistakes!) at http://www.youtube.com/watch?v=5kMU-2d3fqM

* This very site, "code.soundsoftware.ac.uk":http://code.soundsoftware.ac.uk, is a code hosting site for projects by UK-based audio and music researchers. If you're interested in audio and music, please do register and make use of it! Repository hosting uses Mercurial, and your projects can be public or private.

h2. Links about the software in the workshop

* We used "Python":http://python.org, "SciPy":http://www.scipy.org/, "Matplotlib":http://matplotlib.org, "Nose":https://nose.readthedocs.org/en/latest/, "scikits.audiolab":http://pypi.python.org/pypi/scikits.audiolab/, "Mercurial":http://mercurial.selenic.com/, "EasyMercurial":http://easyhg.org/

* The "SciPy Superpack":http://fonnesbeck.github.com/ScipySuperpack/ is a good way to get Python packages installed on OS/X

h2. Topical links

h3. Unix and shell

* "Mac OS X man pages online":https://developer.apple.com/library/mac/#documentation/darwin/reference/manpages/index.html

* "Software Carpentry lessons":http://software-carpentry.org/4_0/shell/index.html

* "ELE595 - Software Tools For Engineers":http://www.eecs.qmul.ac.uk/~simond/teaching/ele595/index.html -- Undergraduate module at QMUL. Weeks 5-10 covered Unix

* "Unix tutorial @ University of Surrey":http://www.ee.surrey.ac.uk/Teaching/Unix/

To use Unix commands on a Windows machine, you will need to install additional software (e.g. "MinGW":http://www.mingw.org/ or "Cygwin":http://www.cygwin.com/).

NB: Cygwin doesn't install nano, Python or Mercurial by default - they need to be selected in the setup.

The Windows command prompt and powershell provide similar facilities to the Unix shell, but with different commands and syntax! Of the two, the command prompt is very similar to the basic Unix tools we introduced, but Powershell is more powerful.

* Some Windows command prompt "tutorials":http://www.7tutorials.com/ode-command-prompt-most-powerful-and-least-used-windows-tool

* Official Microsoft "Windows Powershell Owners Manual":http://technet.microsoft.com/en-us/library/ee221100.aspx

If you own an android tablet or phone, then that is a Unix device. It doesn't come with a command prompt by default, but you can "install one":https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=en. NB: this may be dangerous for your device!

If you want to try a full Unix system, then "VirtualBox":http://www.virtualbox.org/ can be used to create a "virtual machine" - a fake computer that runs inside your normal session. You can then install a Linux distribution on that virtual machine.

h3. Python

Lots of code editors will do syntax highlighting for python.

 * "Spyder":http://packages.python.org/spyder/ -- "Matlab-like" interface

 * "PyCharm":http://www.jetbrains.com/pycharm/ -- cross-platform, 30 day free trial, ca. £25 for academic licence

 * Lots more "here":http://wiki.python.org/moin/IntegratedDevelopmentEnvironments

 * "Software Carpentry Python lessons":http://software-carpentry.org/4_0/python/index.html

h3. Version Control

On Windows, "TortoiseHg":http://tortoisehg.bitbucket.org/ provides an alternative interface to Mercurial - you can right-click files in Windows Explorer. It's more techy than EasyMercurial!

 * "Software Carpentry version control lessons":http://software-carpentry.org/4_0/vc/index.html

h3. Data Management

 * "Sound Data Management Training (SoDaMaT) project at QMUL":https://code.soundsoftware.ac.uk/projects/sodamat/wiki

 * "Digital Curation Centre":http://www.dcc.ac.uk/

 * "Vitae Informed Researcher booklet":http://www.vitae.ac.uk/researchers/169081/Researcher-booklets.html

 * "Software Carpentry on Data":http://software-carpentry.org/4_0/data/index.html