TAPESTREA : File formats

version: 0.1.x.x (tap tap)

home: http://taps.cs.princeton.edu


Taps reads and writes various types of files, many of which are specific to taps. Here are the valid file types.

Analysis

  • .wav :
    • Taps reads sound recordings in the form of .wav files, mono or stereo, with sample rate 44,100 Hz on Mac OS X and Windows, or 48,000 Hz on Linux.
    • Output sound files are also .wav, in stereo, at the same sample rate.
    • The working sample rate can also be specified on the command line, as explained here.

  • .pp :
    • Taps can optionally be run in preprocess mode, prior to the standard analysis. This mode generates data files that may in some cases be faster to analyze than the actual sound files.
    • When running in preprocess mode, taps writes .pp files containing information on the sinusoidal peaks in each frame of an associated sound file.
    • A .pp file can then be loaded in the analysis face instead of the original .wav file. This can sometimes make sinusoidal analysis faster, since the forward FFTs and peak finding steps have been precomputed.

  • .fft :
    • Also created during preprocessing, these contain FFT frames for the associated sound file, computed with TAPESTREA's default windowing, hop size, and zero padding.
    • These are loaded internally when a .pp file is loaded, so a user only needs to avoid deleting them unless the associated .pp file is also deleted.

Synthesis

  • .tap :
    • This type of file represents a taps template and is created when a template is saved from the user interface. It stores information on the template's name, ID, type, and internal data structures.
    • A .tap file can be loaded from the synthesis face to access the template it holds, often one saved from a prior sitting. ID checking mechanisms exist to prevent the same template from being loaded twice; instead, an already loaded template can be copied within the synthesis interface.
    • Example .tap files are here.

  • .xml :
    • A taps template can also be saved in XML format by ending the file name with a .xml extension. It stores all the information that is in the .tap file, but is easier to modify directly.
    • A .xml file can be loaded and saved from anywhere that a .tap file can be.
    • When a template is saved as .xml from the analysis face, source information and analysis parameters are also saved in the .xml file. TAPESTREA currently ignores this information, but it is still useful reference material and could also be used in an XML database. Similarly, users may add their own fields to a saved .xml file.
    • Example .xml files are in the distribution/examples.

  • .ck :
    • This represents a ChucK file, or the special "script template" in taps-talk. It contains ChucK code and can be created and modified from any text editor.
    • A .ck file is loaded from the synthesis interface to obtain a script template that can then be played from within taps.

  • .qz :
    • A .qz file contains a pitch or time quantization table. It can also be created and modified from any text editor.
    • Loading a .qz file from the synthesis face associates the pitch or time table with the currently selected template. If no template is selected, nothing is loaded. A template's pitch and time quantization tables can be changed on the fly simply by loading different .qz files. To remove quantization from the template, load an empty pitch or time quantization table.
    • Here are sample quantization files that show the expected format.

Search

  • .fli :
    • This represents a feature library or database, with pre-extracted feature values for a number of raw sounds or templates.
    • It can be created by a user and also modified by taps during run-time.



taps | soundlab | cs | music