export_textgrid: Export a transcript object to a 'Praat' .TextGrid file

In act: Aligned Corpus Toolkit

Export a transcript object to a 'Praat' .TextGrid file

Description

Advice: In most situations it is more convenient to use act::corpus_export for exporting annotation files.

Usage

export_textgrid(
  t,
  outputPath = NULL,
  filterTierNames = NULL,
  filterSectionStartsec = NULL,
  filterSectionEndsec = NULL
)

Arguments

t	Transcript object; transcript to be saved.
outputPath	Character string; path where .TextGrid will be saved.
filterTierNames	Vector of character strings; names of tiers to be included. If left unspecified, all tiers will be exported.
filterSectionStartsec	Double; start of selection in seconds.
filterSectionEndsec	Double; end of selection in seconds.

Details

The .TextGrid file will be written to the file specified in outputPath. If outputPath is left empty, the function will return the contents of the .TextGrid itself.

Value

Contents of the .TextGrid file (only if outputPath is left empty)

See Also

corpus_export, export_eaf, export_exb, export_printtranscript, export_rpraat, export_srt

Examples

library(act)

# Get the transcript you want to export
t <- examplecorpus@transcripts[[1]]

# Create temporary file path
path <- tempfile(pattern = t@name, tmpdir = tempdir(),
                 fileext = ".TextGrid")

# It makes more sense, however, to you define a destination folder
# that is easier to access on your computer:
## Not run: 
path <- file.path("PATH_TO_AN_EXISTING_FOLDER_ON_YOUR_COMPUTER",
                    paste(t@name, ".TextGrid", sep=""))

## End(Not run)

# Export
act::export_textgrid(t=t, outputPath=path)

act documentation built on June 7, 2023, 6:16 p.m.