Sample Data Export inAudacity

8/9/2019 Sample Data Export inAudacity

1/5

Sample Data Export

From Audacity Manual

Jump to: navigation, search

Sample Data Exportreads the values of successive samples from the selected audio and prints this data to

a plain text, CSV or HTML file. Further information may be added as a "header" at the top of the file.

Accessed by:Analyze> Sample Data Export...

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. The default number of samples is 100.

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. Very large TXT files can usually be opened succesfully in a word processing

application such as WordPad. For HTML output it may be advisable to limit the number of

samples to a maximum of a few hundred.

The track sample rate as indicated on the Track Control Panelindicates the number of

samples per second. If the track and project rates are the same, the number of samples in a

selection may be viewed in Selection Toolbarif you choose one of the selection formatsthat

includes samples.

Measurement scale:

dB:Sample values are displayed on a dB scale relative to full scale (as in the Waveform (dB) view)

Linear:Values are displayed on a linear scale +/- 1 (as in the Audacity audio track Waveform

view).

mple Data Export - Audacity Manual http://manual.audacityteam.org/o/man/sample_data_export.html

5 05/10/2014 19:14


2/5

File data format:

Data in your chosen format as listed below appears after any header informationwhich you included. Text

files where the output produces columns may not have perfectly lined-up columns due to formatting

limitations of text files.

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 numberfollowed 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 CSVformatted file. 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. Web browsers that are not

HTML 5 compliant may not display the page correctly.

Include header information:None:Prints only the sample data, preceded by any text you entered in the optional header textbox

(leave blank for none).

Minimal:Prints a minimal header that contains:

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 or 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

Irrespective of the header information chosen for the file, by default the Standard information above plus

the file name and folder is displayed in a confirmation messageon successful completion of the export.

Optional header text:

This is provided for adding notes to the output file. In text files, use ~~%to start a new line, or in HTML

files use
.

Channel layout for stereo:

The following examples are shown in "Indexed List" format (with index numbers preceding the sample

values), not the default "Sample List" format.

For TXT and CSV files, provides a layout choice for stereo tracks.

L-R on Same Line:Prints a list of alternate left channel sample followed by right channel sample.

For .CSV files this will produce a column of sample values for each channel:


5 05/10/2014 19:14


3/5

1 0.59528 1 0.59528

2 0.56063 2 0.56063

3 0.52377 3 0.52377

...

Alternate Lines:Prints a sample value from the left channel followed by a sample value from theright channel on the same line:

1 0.59528

1 0.59528

2 0.56063

2 0.56063

3 0.52377

3 0.52377

...

L Channel First:All the left channel samples are listed, followed by all of the right channel

samples. For .CSV files this will produce a row of values for each channel:

Left Channel.

1 0.59528

2 0.56063

3 0.52377

...

Right Channel.

1 0.59528

2 0.56063

3 0.52377

...

Show messages:

Yes: (default) Confirmation, error and warning messages will be shown after processing.

Errors Only: Only error messages will be shown after processing.

None: No messages will be shown after processing.

If you press theDebugbutton, you can view Standard information in a separate text window even if

confirmation messages are disabled.

It may be useful to disable confirmation messages if Sample Data Export is to be used in a Chain for batch

processing.

File name:


5 05/10/2014 19:14


4/5

The desired name of the output file. A file name extensionis not required as it will be added automatically.

Output folder:

The default output folder is the Home directory.

This is normally:

Microsoft Windows Vista and 7: \Users\

Microsoft Windows 2000, XP and 2003 : \Documents and Settings\

Mac OS X: /Users/

Linux: /home/

To select a different output folder, enter the full path name, for example D:\Samples Text Files. The output

folder must exist.

On Linux, the abbreviation ~/may be used for the home directory.

Allow files to be overwritten:

No:This is the default choice. If the selected file already exists the chosen file name will be

appended with a number. For example, if output.txtis the chosen name and that file already exists,

the chosen name will be changed to output1.txt. If that file also exists the name will be changed to

output2.txt, and so on until a unique name is found.

Yes:If the file name already exists, it will be overwritten without prompting.

If you select multiple tracks and Allow files to be overwrittenis set to No, they will be

saved to separate files with a number appended to the name. If you set Allow files to beoverwrittento Yes, only the last filefor multiple tracks will be retained.

Batch processing with Sample Data Export

Nyquist effect plug-ins are supported in Chains, butAnalyze(and Generate) plug-ins are not supported. So

to use Sample Data Export in a Chain it is necessary to convert it into anEff ectplug-in. To do this, the file

sample-data-export.nymust be edited.

The file sample-data-export.nycan be found in the Plug-Ins folder inside the Audacity installation folder.On Windows computers, this is usually under "Program Files". On Mac OS X, it is usually under

"Applications". On Linux, you can use various plug-in locations. To convert Sample Data Export into an

Effecttype plug-in, open the file in a plain text editor (such as Notepad on Windows) and change the third

line:

;type analyze

to:

;type process

Save the file in the same location and restart Audacity. Sample Data Export... will now appear underneaththe divider in the "Effect" menu rather than the "Analyze" menu, and will be available for use in a Chain.


5 05/10/2014 19:14


5/5

Links

|