Field Recordings of Vervet Monkey Calls: Software Toolkit Manual (For Windows Users)


This document provides a brief guide to installing and using the data browsing software included in this publication. The current release includes a software toolkit created for Windows PC users. Updates, bug-fixes and ports to other platforms may become available from the LDC Vervet Monkey Corpus Homepage in the future.

Installing the Software

The ../data/software directory contains a file called ../data/software/VervetTools-setup.exe. This is a self-installing setup file for the data browsing tool for Windows. Double-clicking on the file icon will start the installation program. This installation process should be self-explanatory; follow the instructions on the screen. Once the installation is complete, you will find a new entry named All Programs -> LDC Vervet Tools 1.0 in your Start Menu. Please note that the setup program installs only the software and not the data on the DVD.

Uninstalling the Software

Go to Control Panel->Add or Remove Programs. Select LDC Vervet Tools 1.0 and click on the Change/Remove button.

Alternatively, select All Programs->LDC Vervet Tools 1.0->Uninstall LDC Vervet Tools 1.0 from your Start menu.

Exploring the Corpus

The Vervet Monkey Corpus Browser allows users to browse the contents of the corpus. To start this tool, choose All Programs->LDC Vervet Tools 1.0->Browse Vervet Corpus from your Start menu.

The first thing you should do is to set the location of the corpus. Click on the "Browse" button next to the "Corpus Directory" box, and select the location of the top directory of the corpus containing the subdirectory "data". This is normally the top directory of each DVD. For example, if one of the corpus DVDs is in the drive "D:", you should set "D:\" as the location of the corpus.

The browser consists of the following components:

Searching and Extracting Recordings

Once you click on the Search and Extract Recordings button, a new user interface for specifying search criteria will open. Specify any criteria for the search, and click on "Start". This will show a table showing all the instances of segments matching the search criteria.

From the table display, clicking on the "Extract Recordings" button will allow you to specify a directory, and will save the displayed segments as individual sound files in that directory.

Clicking on the "Save List As.." button will save the current table as a comma-separated value (csv) list file.

Viewing Annotations with TableTrans Annotation Tool

Clicking on the "See Annotations" button will start a version of the TableTrans annotation tool developed at the Linguistic Data Consortium. Another version of the TableTrans tool was used in the creation of the annotation files in the corpus.

(NOTE: if the TableTrans tool does not display the waveform, please close the tool, and reopen it by clicking on the "See Annotations" button again.)

Navigating in the annotation table is fairly straightforward. Use the arrow keys to move within the table, and type the F1 key or click on the play button on the upper-right corner of the waveform display to play the segment corresponding to the highlighted annotation.

To exit the TableTrans annotation tool, go to the File menu and pull down Quit. Answer "No" if the tool asks you if you want to save the "Current Annotations". Alternatively, simply click on the "Close" button on the upper-right corner of the tool.

The TableTrans annotation tool was developed using the Annotation Graph Toolkit (AGTK - Future version of the tool will be available from the AGTK website as well as the LDC Vervet Monkey Corpus Homepage.

Opening Sound Files with WaveSurfer

WaveSurfer is an Open Source tool for sound visualization and manipulation. It is a useful tool if users of this corpus would like to open a .WAV sound file in the corpus. A version of WaveSurfer is included in this toolkit, and it can be started by selecting the following from your Start Menu.

All Programs->LDC Vervet Tools 1.0->Start WaveSurfer

A user manual is available from the Help menu on WaveSurfer.

WaveSurfer is copyrighted by Kåre Sjölander and Jonas Beskow of the Centre for Speech Technology (CTT) at KTH in Stockholm, Sweden.