tgplot: Plot TextGrid

In praatpicture: 'Praat Picture' Style Plots of Acoustic Data

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,
  end,
  tiers = 1,
  tfrom0 = TRUE,
  tierNames = TRUE,
  alignment = "central",
  edgeLabels = "keep",
  specialChar = FALSE,
  color = "black",
  highlight = NULL
)

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.
end	End 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.
edgeLabels	String specifying how to handle TextGrid labels in interval tiers that fall partially before start or partially after end. Default is 'keep', where labels are kept at the center of the interval. Other options are 'center', where labels are recentered to the visible part of the interval, or 'discard', where such labels are ignored.
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.
highlight	Named list giving parameters for differential highlighting of TextGrid intervals. This list should contain information about which intervals to highlight, using the tier and label. Further contains the argument color, and background (a string specifying a background color).

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')

praatpicture documentation built on June 8, 2025, 1:34 p.m.