User:Stevethefiddle/Sample Data Export
- Accessed by:
Controls
Show Help File:
- No: Does not show the help screens. To run Sample Data Export this option must be selected.
- Overview: Displays a help screen including a brief overview and descriptions of the first 3 controls.
- File Format: Displays a help screen including a brief description of the file output options.
- Header Text: Displays a help screen including a brief description of the file header options.
- Output Files: Displays a help screen about setting the file output location.
- Save Help File: Saves all four help screens in a single text file.
Limit output to first:....samples
- The number of samples processed will be the number of samples in the selection, up to a maximum of the number entered here.
- Sample Data Export is limited internally to an absolute maximum of 1 million samples.
- Processing a large number of samples can create extremely large output files that may be difficult to open. For HTML output it is advisable to limit the number of samples to a maximum of a few hundred to avoid creating an excessively large html file.
- The track sample rate indicates the number of samples per second and the number of samples in a selection may be viewed in the Selection Toolbar.
Measurement scale:
Sample values may be displayed on a linear scale +/- 1 (as in the Audacity audio track Waveform view) or on a dB scale relative to full scale (as in the Waveform (dB) view).
File data format:
Following any header information:
- Sample List (txt): produces a plain text file with a list of sample values.
- Indexed List (txt): produces a plain text file with an indexed list of sample values: sample number followed by sample value.
- Time Indexed (txt): produces a plain text file with the time (relative to the start of the selection) followed by sample value
- Data (csv): produces a CSV file that contains the sample values separated by commas. This may be suitable for importing into spreadsheet applications for further analysis.
- Web Page (html): produces an HTML 5 document that contains all of the header information and a table of sample data with sample number, time, linear and dB values. Browsers that are not HTML 5 compliant may not display the page correctly.
Include header information:
- None: Prints only the optional header text (leave blank for none) followed by the sample data.
- Minimal: Prints a minimal header that contains:
- The sample rate.
- Units (linear or dB).
- Optional header text (leave blank for none).
- Standard: In addition to the minimal header information, the following is also included:
- File name.
- Number of samples.
- Duration (seconds).
- Mono/Stereo.
- All: In addition to the standard header information, the following is also included:
- peak amplitude linear and dB.
- Unweighted rms level (dB).
- DC offset.
Optional header text:
This is provided for adding notes to the output file. In text files, use ~~% to start a new line, in HTML files use
.
Channel layout for stereo:
CHANNEL LAYOUT: for text/csv output, stereo tracks may be printed alternate left/right samples or all of left channel then all of right channel.
Show messages:
File name:
Output folder:
OUTPUT FILES.
The default output folder is the "home folder": /home/steve To select a different output folder, enter the full path name. The output folder must exist.
By default, files will not be overwritten. If you select multiple tracks, they will be saved to separate files with a number appended to the name. If you set "Allow files to be overwritten" to "Yes", only the last file for multiple tracks will be retained.
A notification message is displayed on completion indicating the name and location of the file.
If the plug-in is used in a Chain (Audacity 2.0.1 or later) it may be useful to disable messages.
For text/csv output the file header is shown in the debug window.
