Skip to content

Latest commit

 

History

History
125 lines (58 loc) · 3.48 KB

README.md

File metadata and controls

125 lines (58 loc) · 3.48 KB
Raw

Overview

This pipline facilitates automatic processing of auditory data, especially the cloze data, where:

  1. responses are open ended
  2. responses are typically short (mostly a single word)
  3. latency of the production is valuable data

However, it could be used to process other kinds of data.

overview

Roughly speaking, this pipleline

  1. takes webm files with responses from PCIbex
  2. transforms it into wav files (wav2webm)
  3. gets onset data from Chronset
  4. gets automatic transcription from Google Cloud Speech-to-Text API
  5. combines the information + context/probe info of the experiment and output them as Praat TextGrids
  6. facilitate human inspection by (CheckAndEdit)

Output:

  1. csv files mapping audio file names onto transcription and onset
  2. TextGrid files with automatic transcription + onset, which could be used for correction in Praat
  • Get onset data from Chronset
  • Get trasncription from Google Cloud Speech-to-Text API

Note: This pipeline is built for OSX. Might need some modification for Windows and LINUX.

List of contents

  • transcribe.ipynb: the main script for transcription
  • webm2wav: transform webm files into wav files (using ffmpeg)
  • stereo2monaural.ipynb: make stereo wav files into monaural files that can be handled by Google Cloud Speech to Text
  • chronset_prep.ipynb: create Chronset-uploadable zip files
  • keywords.ipynb: create and manage keyword lists for cloze data
  • check_transcription.ipynb: post-hoc correction of automatic transcription before human inspection
  • CheckAndEdit: Praat script that open the wav files and textgrid files with the same name
  • analyze_textgrid.ipynb: create csv files from a set of textgrid files with onsets and transcriptions
  • temp_note.TextGrid: A template of textgrid files used in transcribe.ipynb

Preperation

Data

  • A directory containing webm files File names must end with: [item_condition][condition]_[participant_id] (e.g. exp_10a_tdlf.webm)
  • Optional: Experimental item info in the form of python dictionary ({filenames:info})

webm2wav

What this file does:

The output audio files of PCIbex are usually separated by participants, but it is not straightforward to convert files in different folders. (It is tedious to convert the webm files into wav files for each of the 100 participants.) The "webm2wav" file recursively convert all the webm wiles below a certain directory at once.

What you need:

  • ffmpeg
  • a bash script named "webm2wav"

What to do:

Enter the following line into your command line.

bash location_of_webm2wav input_file_directory output_file_directory
  • First argument: the path to "webm2wav" file
  • Second argument: the path to the directory which contaions all the webm files
  • Third argument: the path to the output directory

NOTE: All the wav files below the input directry will be generated directly in the output directory

transcribe.ipynb

This script generates NLP-powered transcriptions of audio files and ouput TextGrid files with transcriptions. See transcribe.ipynb for details.

CheckAndEdit

This Praat script:

  1. open TextGrid and wav files with the same name and present them together
  2. saves edits on the TextGrid

Simply enter the path to the wav files and textgrids to the box, and then the corresponding files are opened at once.

Be careful that the script overwrites the TextGrid file once you click on "continue"