aubiopitch

Langue: en

Version: 263622 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

aubiopitch --- a command line tool to extract pitch candidates from sound files.

SYNOPSIS

aubiopitch [options] -i soundfile

DESCRIPTION

aubiopitch attempts to extract fundamental frequency in sound files. When no pitch candidate is found, the output is 0. Five fundamental frequency extraction methods are available. Results can be printed in Hertz or in MIDI pitch.

A plotting module is available via the Gnuplot Python package.

OPTIONS

This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-i --input filein
input sound file
-m --mode pitch_detection_mode
pitch detection mode [default=mcomb] mcomb|yin|fcomb|schmitt
-u --units unitmode
output pitch in units [default=Hz] freq|midi|cent|bin
-B --bufsize=BUFSIZE
buffer size [default=1024]
-H --hopsize=HOPSIZE
overlap size [default=512]
-t --threshold=THRESHOLD
pitch threshold (for yin) [default=0.1]
-s --silence=SILENCE
silence threshold [default=-70]
-D --delay=DELAY
number of seconds to take back [default=0]
-S --smoothing=frames
temporal smoothing using a median filter of N frames [default=0]
-M --pitchmax=max
maximum pitch values to look for (Hz) [default=20000]
-l --pitchmin=min
minimum pitch values to look for (Hz) [default=20]
-n --note
NOT IMPLEMENTED output notes
-q --quiet
be quiet
-h --help
Show a summary of options.
-v --verbose
make lots of noise [default]

Plotting options

When the Python interface to Gnuplot is installed, the following additional options are available.

-p --plot
draw plot of the pitch track
-T --plottruth
draw plot of the ground truth pitch track
-x --xsize=SIZE
define horizontal plot size [default=1.]
-y --ysize=SIZE
define vertical plot size [default=1.]
-O --outplot=OUTPLOT
save plot to output.{ps,eps,png,svg} instead of displaying it

BUGS

For now the program has only been tested on audio signals sampled at 44.1 kHz.

SEE ALSO

aubioonset(1) aubiotrack(1) aubionotes(1) aubiocut(1)
 

AUTHOR

This manual page was written by Paul Brossier (piem@altern.org). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.