Reaper reference

reaper command line tool

The reaper command line tool extracts F0 measurements from an audio file. It was written by David Talkin and is a successor to the get_f0 command from the ESPS tools. Users of the Berkeley Phonetics Machine can install it with sudo bpm-update reaper command.

The reaper tool is not very heavily documented. To see the available options, run the command with no arguments:

 reaper

The available options will be listed. You can also consult the source repository for more information or to inspect the code.

A simple example that writes timestamped F0 measurements to an easy-to-read text file is:

 reaper -i myfile.wav -a -f myfile.f0

The -i parameter identifies the input file, and the -f parameter names the output file to be created. The -a option declares that the output file will be plaintext rather than an encoded binary format.

The output file contains a header of several lines before the data section starts. You can copy and adapt the following code to skip the header and read the data section into a Pandas dataframe:

 
# This assumes you have already done
# import pandas as pd
# import numpy as np

myfile = 'temp.f0'
with open(myfile, 'r') as f:
    '''Skip past header, then use read_csv() on open file buffer.'''
    line = f.readline()
    while not line.startswith('EST_Header_End'):
        line = f.readline()
    df = pd.read_csv(
        f,
        sep=' ',
        names=['sec', 'is_voiced', 'f0'],                        # Give useful names to the columns
        na_values={'f0': '-1.000000'},                           # Replace dummy reaper values with NaN
        dtype={'sec': np.float32, 'is_voiced': bool, 'f0': np.float32}
    )

Notice that column names are specified in the names parameter, and reaper's F0 non-measurement placeholder -1.000000 is replaced with NaN.