plot_timecourse: Plot 1-D timecourse data.

View source: R/plot_timecourse.R

plot_timecourseR Documentation

Plot 1-D timecourse data.

Description

Typically event-related potentials/fields, but could also be timecourses from frequency analyses for single frequencies. Averages over all submitted electrodes. Output is a ggplot2 object.

Usage

plot_timecourse(data, ...)

## S3 method for class 'data.frame'
plot_timecourse(
  data,
  electrode = NULL,
  time_lim = NULL,
  add_CI = FALSE,
  baseline = NULL,
  colour = NULL,
  color = NULL,
  mapping = NULL,
  ...
)

## S3 method for class 'eeg_evoked'
plot_timecourse(
  data,
  electrode = NULL,
  time_lim = NULL,
  add_CI = FALSE,
  baseline = NULL,
  colour = NULL,
  color = NULL,
  mapping = NULL,
  ...
)

## S3 method for class 'eeg_ICA'
plot_timecourse(
  data,
  component = NULL,
  time_lim = NULL,
  add_CI = FALSE,
  baseline = NULL,
  colour = NULL,
  color = NULL,
  mapping = NULL,
  ...
)

## S3 method for class 'eeg_epochs'
plot_timecourse(
  data,
  electrode = NULL,
  time_lim = NULL,
  add_CI = FALSE,
  baseline = NULL,
  colour = NULL,
  color = NULL,
  mapping = NULL,
  ...
)

## S3 method for class 'eeg_group'
plot_timecourse(
  data,
  electrode = NULL,
  time_lim = NULL,
  add_CI = FALSE,
  baseline = NULL,
  colour = NULL,
  color = NULL,
  mapping = NULL,
  ...
)

## S3 method for class 'eeg_tfr'
plot_timecourse(
  data,
  electrode = NULL,
  time_lim = NULL,
  add_CI = FALSE,
  baseline = NULL,
  colour = NULL,
  color = NULL,
  mapping = NULL,
  freq_range = NULL,
  type = "divide",
  ...
)

Arguments

data

EEG dataset. Should have multiple timepoints.

...

Other arguments passed to methods.

electrode

Electrode(s) to plot.

time_lim

Character vector. Numbers in whatever time unit is used specifying beginning and end of time-range to plot. e.g. c(-.1, .3)

add_CI

Add confidence intervals to the graph. Defaults to 95 percent between-subject CIs.

baseline

Character vector. Times to use as a baseline. Takes the mean over the specified period and subtracts. e.g. c(-.1,0)

colour

Variable to colour lines by. If no variable is passed, only one line is drawn.

color

Alias for colour.

mapping

A ggplot2 aes() mapping.

component

name or number of ICA component to plot

freq_range

Choose a specific frequency range to plot

type

Type of baseline correction to use for eeg_tfr objects

Value

Returns a ggplot2 plot object

Methods (by class)

  • data.frame: Plot a data.frame timecourse

  • eeg_evoked: plot eeg_evoked timecourses

  • eeg_ICA: Plot individual components from eeg_ICA components

  • eeg_epochs: Plot timecourses from eeg_epochs objects.

  • eeg_group: Plot timecourses from eeg_group objects.

  • eeg_tfr: Plot timecourses from eeg_tfr objects.

Author(s)

Matt Craddock, matt@mattcraddock.com

Examples

plot_timecourse(demo_epochs, "A29")
plot_timecourse(demo_epochs, "A29", add_CI = TRUE)

neuroconductor/eegUtils documentation built on Feb. 3, 2023, 5:33 p.m.