tgplot {praatpicture}

Plot TextGrid

Description

Function for plotting TextGrids called by praatpicture. Instead of using this function directly, just use praatpicture('my_sound_file', frames='TextGrid').

Usage

tgplot(
  tg,
  t,
  sr,
  start,
  tiers = 1,
  tfrom0 = TRUE,
  tierNames = TRUE,
  alignment = "central",
  specialChar = FALSE,
  color = "black"
)

Arguments

tg

TextGrid object loaded using rPraat::tg.read

t

Numeric vector giving times corresponding to the signal.

sr

Integer giving the sampling rate of the signal.

start

Start time (in seconds) of desired plotted area.

tiers

Vector of number or strings giving either numeric identifiers of TextGrid tiers to plot or the names of TextGrid tiers to plot. Default is 1, which plots just the first tier.

tfrom0

Logical; should time on the x-axis run from 0 or from the original time? Default is TRUE.

tierNames

Logical; should TextGrid tier names be printed along the y-axis? Default is TRUE.

alignment

String giving the desired alignment of text in the TextGrids. Default is central; other options are left and right. Alternatively, a vector of strings if different alignments are needed.

specialChar

Logical; should Praat typesetting for special font types such as italic, bold, and small caps be converted into corresponding R-readable special font types. Default is FALSE, since special characters can create unfortunate text alignment artefacts. See https://www.fon.hum.uva.nl/praat/manual/Text_styles.html.

color

String or vector of strings giving the name of the color(s) to be used for the text in TextGrids. Default is 'black'. If a vector is provided, different colors are used for different tiers.

Value

No return values, called internally by praatpicture and sibling functions.

Examples

# Don't use directly
datapath <- system.file('extdata', package='praatpicture')
soundFile <- paste0(datapath, '/1.wav')
praatpicture(soundFile, frames='TextGrid')