README.md
In agricolamz/phonfieldwork: Linguistic Phonetic Fieldwork Tools

phonfieldwork

phonfieldwork is a package for phonetic fieldwork research and experiments. This package makes it easier to:

create a html/pptx presentation from stimuli-translation list,
rename soundfiles according to the list of stimuli,
concatenate multiple soundfiles and create a Praat TextGrid which interval labels are the original names of the sound
extract sounds according to annotation
extract annotation from multiple linguistic formats (Praat .TextGrid, ELAN .eaf, EXMARaLDA .exb, Audacity .txt and subtitles .srt)
visualise oscilograms, spectrograms and annotations
create an html viewer like this, ethical problems of this kind of viewer in linguistic research are covered in the vignette vignette("ethical_research_with_phonfieldwork").

For more details see tutorial.

The main goal of the phonfieldwork package is to make the full research workflow, from data collection to data extraction and data representation, easier for people that are not familiar with programming. However, most of the phonfieldwork functionality can be found in other software and packages:

stimuli presentation creation could be done with any programming language and probably without them
automatic file renaming and automatic merging could be done with any programming language
Praat .TextGrid manipulation is possible with Praat, R packages rPraat and textgRid, Python package 'pympi'
ELAN .eaf manipulation is possible with ELAN, R package FRelan and Python package pympi
import and export between Praat .TextGrid, ELAN .eaf, and 'EXMARaLDA .exb is possible with R package act
cutting sounds according to annotation is possible with Praat and the R packagetuneR
spectrogram visualisation is possible with multiple R packages signal, tuneR, seewave, phonTools, monitor, warbleR, soundgen and many others

Install from CRAN:

install.packages("phonfieldwork")

Get the development version from GitHub:

install.packages("remotes")
remotes::install_github("ropensci/phonfieldwork")

Load the library:

library(phonfieldwork)

In order to work with some rmarkdown functions you will need to install pandoc, see vignette("pandoc") for the details.

You can get the latest information about how to cite the package using the citation() function:

citation("phonfieldwork")
>
> To cite package ‘phonfieldwork’ in publications use:
>   
>   Moroz G (2020). _Phonetic fieldwork and experiments with phonfieldwork package_.
> <https://CRAN.R-project.org/package=phonfieldwork>.
> 
> A BibTeX entry for LaTeX users is
> 
> @Manual{,
>   title = {Phonetic fieldwork and experiments with phonfieldwork package},
>   author = {George Moroz},
>   year = {2020},
>   url = {https://CRAN.R-project.org/package=phonfieldwork},
> }