COST250 Reference System

COST250 Speaker Recognition Reference System

4. Installation

The following is an instruction for how to install the COST250 Reference System on a unix system. You need to install a Tcl/Tk interpreter (unless you have it already) and the Reference System itself. To run the calibration test you also need a subset of Polycost. If you don't have Polycost you may download the required subset and install it temporarily.

4.1 Tcl/Tk

First of all you need to download and install Tcl/Tk version 8.0 or later unless you have it already. The free Tcl/Tk Core can be downloaded here. You can check if you have it already by typing tclsh at the command prompt. If you get a %-prompt, type the Tcl command
```
     puts $tcl_version
```
to print the current version.
After installing Tcl/Tk, make sure that the Tcl shell interpreter tclsh is in your current search path.

4.2 The Reference System

Download the COST250 Reference System from the web or copy it from the COST250 final report CDROM. Read the copyright notice for terms of copying and usage.
You are now ready to unpack and install the Reference System. Create a directory cost250/refsys and copy the distributed file into it. Unpack the file:
```
     mkdir -p cost250/refsys
     cd cost250/refsys
     mv /whereeveritis/refsys-v1.0.tar.gz .
     gunzip refsys-v1.0.tar.gz
     tar xvf refsys-v1.0.tar
```
All files of the distribution will unfold in a directory v1.0 (referred to as $version in the following).
Now you may need to edit refsys/$version/makefile to fit your particular environment. First, edit the definition of INSTALL_BINDIR to where you want binary executables to be installed. This directory should be included in your system search path. Second, edit the definition of INSTALL_LIBDIR to indicate where you want libraries to be installed. Read the following before chosing a directory:
Later during this installation you will create a Tcl package called cost250. Tcl can find this package automatically in one of the following ways (the first alternative is strongly recommended):
- You set INSTALL_LIBDIR to one of the directories that Tcl searches for existing packages. To find out what this directory is, do the following:
```
tclsh                (starts a Tcl shell and gives you a % prompt)
puts $tcl_pkgPath    (a tcl command)
```
  which will print one or more directories for you. Choose one of them. If you choose your directory like this, other users on your system will automatically be able to use the Tcl package.
- You set INSTALL_LIBDIR to any directory you like. You must then tell Tcl where to find this directory by setting the environment variable TCLLIBPATH. You must remember to set this environment variable every time you run the Reference System.
On this page of the Tcl manual you can read more details about how Tcl searches for packages.
Then you may again need to edit refsys/$version/makefile, this time to fit your particular compiler. The makefile will try to find out what flavour of unix you have by calling the unix command uname. This command will return a string like Linux, HP-UX, SunOS or IRIX. The makefile has one section for each of those targets, with default definitions of CC and CCFLAGS. You may want to tailor the definition to fit your environment, or you may have to add a new target if your unix is not one of the above.
Build libraries, tools and packages:
```
     cd refsys/$version
     make all
     make install
```
The makefile has been tested with GNU make only. Type 'make info' to print a menu with available targets in the makefile.
'Make install' have now (hopefully :-) built and installed the following:
- Binary executables gencb, vqtest, lpccep, concat and alw2lin into /usr/local/bin or equivalent directory, as defined by INSTALL_BINDIR in the makefile.
- A Tcl package cost250 into /usr/local/lib/cost250$version/. or equivalent.
If all steps were successful, the installation is now complete. You may remove intermediate files created by make by running:
```
     make distclean
```
Should you wish to remove the installed files, run:
```
     make deinstall
```
This will delete the installed binaries and the Tcl package.

4.3 A Polycost Subset

To run the calibration test in the following section you need a subset of Polycost. If you don't have Polycost stored on a disc, you may want to download the required subset and install it temporarily. This is how to do that:

You may want to check if you already have the 105 necessary files: here is a list of them.
Download the 7.5 MB file minipoly.tar.gz (unix) or minipoly.zip (Windows) and put it in the directory where you unpacked the Reference System (or any other directory of your choice). The total size of the files is around 12 MB, so this is how much free disc space you will need on the disk before installing them (actually, with the method described below you will need twice that since the tar-file will exist at the same time as the sample files until you delete the tar-file). This is how to unpack the file:
```
     cd cost250/refsys/$version
     gunzip minipoly.tar.gz
     tar xvf minipoly.tar
     rm minipoly.tar         ...be nice to your system administrator ;-)
```
The files will unfold in a directory data/polycost.
If you chose to install the Polycost files in another directory than that with the Reference System (as shown above) you need to do one of two things: Either edit the database path in file work/runtest.tcl (change the value for variable datadir) or create a link to your database directory:
```
    cd cost250/refsys/$version
    mkdir data
    ln -s /usr/data/orWhatEver data/polycost
```

Note that the files used in the calibration test do not include any of the files with known bugs. You may therefore copy them directly from the version 1.0 CD-ROMs.