4.1 Installing

SPORCH has been tested on the following systems:

• Linux
• Max OS X

It will be tested on Cygwin once the required version of BOOST becomes available.

To compile SPORCH you need the following packages installed on your system:

• Boost, version 1.34 or greater (http://www.boost.org/)
• libsndfile (http://www.mega-nerd.com/libsndfile/)
• FFTW, version 3 (make sure shared libraries are available, http://www.fftw.org/)
• pkg-config (might be missing on Mac OS X, http://pkg-config.freedesktop.org/wiki/)

If you're compiling from an SVN checkout, you need to have Autoconf, Libtool and this installed:

• Autoconf Macro Archive (http://autoconf-archive.cryp.to/)

Then in the root source directory do all of the necessary aclocaling, autoconfing, automaking, and libtoolizing with `–add-missing' and `–force' options when they are needed. The sample db file is also not provided—you'll have to either copy it out of the last tarball or supply a dummy replacement (by typing touch db/db in the source directory).

Also, to build ps and pds documentation, you need Texinfo and:

• ImageMagick (http://www.imagemagick.org/)

To install:

     ‘cd path/to/sporch/src/root/directory’
     ‘./configure’
     ‘make’
     ‘make install’

To build ps documentation:

     ‘cd path/to/sporch/src/root/directory’
     ‘make ps’
     ‘make install-ps’

To build pdf documentation:

     ‘cd path/to/sporch/src/root/directory’
     ‘make pdf’
     ‘make install-pdf’

To uninstall everything:

     ‘cd path/to/sporch/src/root/directory’
     ‘make uninstall’

HTML documentation is installed in the share/doc/sporch directory by default and also requires Texinfo. Add ‘--without-docs’ to the ./configure command to disable building documentation. An Info file is also installed and can be accessed with the command info sporch or browsed through using Emacs.

The most useful options to add to the ./configure command are:

•           ‘--prefix=/my/install/directory’
  

•           ‘--without-docs’
  

•           ‘--enable-debug’
  

Lisp wrappers (and .asd files) are installed in the share/sporch directory. Wrappers for other languages will be provided at some point.

A sample database is also installed in share/sporch along with a few commented sample inst and conf configuration files. A sample orchestra definition file and a .sporch initialization file is also installed here. The program uses the sample database and orchestra definition file by default, so you can immediately test to see if the program works by typing:

     ‘sporch /path/to/my/sound.wav -lpeak -m0’

The sample database was compiled to take up little space. You probably don't want to use this for anything serious—there are missing samples, and the only tuning choice is 12-tone equal temperement (microtones tend to give much better results). The database was compiled using the University of Iowa Musical Instrument Sample library.