Parselmouth – Praat in Python, the Pythonic way
Parselmouth is a Python library for the Praat software.
Though other attempts have been made at porting functionality from Praat to Python, Parselmouth is unique in its aim to provide a complete and Pythonic interface to the internal Praat code. While other projects either wrap Praat’s scripting language or reimplementing parts of Praat’s functionality in Python, Parselmouth directly accesses Praat’s C/C++ code (which means the algorithms and their output are exactly the same as in Praat) and provides efficient access to the program’s data, but also provides an interface that looks no different from any other Python library.
Please note that Parselmouth is currently in premature state and in active development. While the amount of functionality that is currently present is not huge, more will be added over the next few months. As such, feedback and possibly contributions are highly appreciated.
Drop by our Gitter chat room or post a message to our Google discussion group if you have any question, remarks, or requests!
Warning
Parselmouth 0.4.0 is the last version supporting Python 2. Python 2 has reached End Of Life on January 1, 2020, and is officially not supported anymore: see https://python3statement.org/. Please move to Python 3, to be able to keep using new Parselmouth functionality.
- Installation
- Examples
- API Reference
VERSION
PRAAT_VERSION
PRAAT_VERSION_DATE
PraatError
PraatFatal
PraatWarning
AmplitudeScaling
CC
Data
Formant
FormantUnit
Function
Harmonicity
Intensity
Interpolation
MFCC
Matrix
Pitch
PitchUnit
Sampled
SampledXY
SignalOutsideTimeDomain
Sound
SoundFileFormat
SpectralAnalysisWindowShape
Spectrogram
Spectrum
TextGrid
Thing
TimeFrameSampled
TimeFunction
ValueInterpolation
Vector
WindowShape
read()
call()
run()
run_file()
Citing Parselmouth
A manuscript introducing Parselmouth (and supplementary material) has been published in the Journal of Phonetics. Scientific work and publications can for now cite Parselmouth in the following way:
Jadoul, Y., Thompson, B., & de Boer, B. (2018). Introducing Parselmouth: A Python interface to Praat. Journal of Phonetics, 71, 1-15. https://doi.org/10.1016/j.wocn.2018.07.001
@article{parselmouth,
author = "Yannick Jadoul and Bill Thompson and Bart de Boer",
title = "Introducing {P}arselmouth: A {P}ython interface to {P}raat",
journal = "Journal of Phonetics",
volume = "71",
pages = "1--15",
year = "2018",
doi = "https://doi.org/10.1016/j.wocn.2018.07.001"
}
Since Parselmouth exposes existing Praat functionality and algorithm implementations, we suggest also citing Praat when using Parselmouth in scientific research:
Boersma, P., & Weenink, D. (2021). Praat: doing phonetics by computer [Computer program]. Version 6.1.38, retrieved 2 January 2021 from http://www.praat.org/
@misc{praat,
author = "Paul Boersma and David Weenink",
title = "{P}raat: doing phonetics by computer [{C}omputer program]",
howpublished = "Version 6.1.38, retrieved 2 January 2021 \url{http://www.praat.org/}",
year = "2021"
}