PraatSimplifier is a Python tool designed to simplify the extraction of formant values from audio files using Praat through the Parselmouth library. This tool allows users to extract formant data from multiple audio files and export the results to a .csv file for further analysis.
- Extract Formants: Extract formant values from audio files in a specified directory.
- Flexible Timestamps: Define the timestamps to sample per audio file.
- Customizable Formants: Specify the number of formants to extract.
- CSV Export: Export the extracted formant data to a CSV file for easy analysis.
- Plot Formants: Plot the sound files and export them in a .png image file.
- Mono converter: Save all sounds to mono.
- Sound Amplitude plotting: Plot the amplitude of a file.
- More features to be released!
Ensure you have Python installed, and then install the required libraries by running requirements.txt in the terminal.
pip install -r requirements.txt
Clone this repository to your local machine and access it from the command line:
git clone https://github.com/IParraMartin/PraatSimplifier.git
cd PraatSimplifier
To produce a formant plot and extract the data in a .csv file, you can use the code below in the terminal or command line:
python praat_simplifier.py \
--in_dir path/to/sound/files \
--out_dir path/to/output/directory \
--get_formants True \
--n_timestamps 10 \
--n_formants 3 \
--export_formants_file True\
--save_formant_plot True \
--dpi 300
To save all the sounds from a directory to mono, you can use:
--in_dir path/to/sound/files \
--out_dir path/to/output/directory \
--save_to_mono True
To plot the sound amplitude of a sound file use:
--sound_dir path/to/sound/file \
--out_dir path/to/output/directory \
--plot_sound_amplitude True \
--start_time 0.0 \
--end_time 0.5 \
--save_amplitude_plot True
Some users may need to use python3 instead of python to run the script above. The plotting tool has been limited to a maximum of 9 plots. This was a measure to prevent a lack of visibility of the data in the plots. To make several plots you will have to make independent processes (e.g., for 18 sounds, make 2 files and run the scripts independently).
Alternatively, you can integrate PraatSimplifier into your Python code:
from PraatSimplifier import PraatSimplifier
simplifier = PraatSimplifier(sounds_dir, out_dir)
formant_data = simplifier.get_formants(n_timestamps=100, n_formants=5)
simplifier.export_formants()
Make sure to install all the dependencies before running the tool.
Contributions are welcome! Feel free to open an issue or submit a pull request.