Python Tutorial Skeleton

h1. Reusable software and reproducibility in music informatics research

h2. Tutorial at ISMIR 2012

* 8 Oct 2012

* 14:30

h2. Introduction

The need to develop and reuse software to process data is almost universal in music informatics research. Many methods, including most of those published at ISMIR, are developed in tandem with software implementations, and some of them are too complex or too fundamentally software-based to be reproduced readily from a published paper alone. For this reason, it is helpful for sustainable research to have software and data published along with papers. In practice, non-publication of code and data is still the norm and research software is commonly lost in the years following publication of the associated methods.  

During this tutorial we will discuss common barriers to publication of software and data, and will present a practical hands-on session in which attendees will explore tools and methods to help them overcome these barriers. The tutorial will rapidly cover the use of version control software, code hosting facilities, aspects of testing and provenance, and software licensing for publication. Worked examples will be drawn from the music and audio fields, and hands-on help will be provided by experienced researcher-developers from the Centre for Digital Music, Luís Figueira and Steve Welburn. This tutorial will be of immediate practical interest to researchers within the music informatics community, and will also be highly relevant to research supervisors and research group leaders with an interest in policy and guidance.

h2. Pre-Tutorial Preparation

Part of the tutorial will be a live example related to software practice in a research environment. This will be a straightforward example using an audio analysis method for music processing.

*Tutorial attendees are invited to code along.* Thus, in order to make the most of the tutorial, attendees are advised to bring *a laptop* and to install the following software before the day of the session.

If you run into any problems installing any of the software from the list below, we will be in the tutorial room from 14:00.

h3. Software Requirements

In order to take better advantage of the tutorial, we suggest that tutorial attendees install the following software beforehand:

* "Python":http://python.org/download/releases/2.7.3/ (version 2.7 or 2.6 -- not python 3)

* The "Nose":https://nose.readthedocs.org/en/latest/ unit-test framework

* "NumPy":http://numpy.scipy.org/

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

* "IPython":http://ipython.org/ (desirable, but not mandatory)

* "EasyMercurial":http://easyhg.org

h3. Pre-prepared Repository

We've made a Mercurial repository containing some basic code and audio files that are going to be used during the tutorial. It is highly recommended that you clone this to your laptop.

The clone URL is @https://code.soundsoftware.ac.uk/hg/python-tutorial-skeleton@

You can open this using EasyMercurial (see "this video":http://vimeo.com/29779278 for an example of how to open a remote URL), or clone it using the @hg@ command-line tool.