plot_nic: Plot an independent component with superimposed noise signal...

Description Usage Arguments Details Value Author(s) See Also Examples

View source: R/plot_nic.R

Description

The function takes an icac object as returned by function icac and plots an independent component with superimposed noise signal at a particular trial.

Usage

1
2
3
4
plot_nic(x, data, ic, trial, noise.sig, 
threshold = x$threshold, col = c("black", "blue"), 
main = NULL, xlab = NULL, ylab = NULL, xlim = NULL, 
ylim = NULL, cex = 0.7, trial.cn = "Trial", ...)

Arguments

x

An icac object as returned by the function of the same name.

data

The uncorrected data that was supplied to function icac.

ic

Numeric. An IC to plot.

trial

Numeric. A trial to plot.

noise.sig

Character. A noise signal. If missing, the first channel from x$channel will be taken.

threshold

Numeric. The threshold at which the correlation between an IC and a noise signal at a specific trial is deemed "significant". Defaults to x$threshold.

col

Vector. The colors to be used for plotting the noise signal (defaults to "black") and the IC if the correlation between the two reaches threshold (defaults to "blue").

xlim, ylim

x- and y-limits. These should be chosen to cover the range of values of the surface. Defaults to NULL.

xlab, ylab

Titles for the axes. Numbers will be coerced to character strings.

main

Main title. Defaults to NULL.

cex

A numerical value giving the amount by which plotting text and symbols should be magnified. Defaults to 0.7.

trial.cn

The quoted column name containing the trial information. Defaults to "Trial".

...

Further arguments to pass to plot, lines, mtext, and/or legend.

Details

When plotting a trial where the IC did not correlate above threshold with the noise signal, the correlation and the line representing the IC will be gray by default. Otherwise, it will respectively be "blue". Note that if the correlation between an IC and a noise signal is negative, the noise signal is multiplied by -1 to make both waves comparable, but the correlation printed above the plot remains unchanged.

Value

A plot of the noise signal and the IC with which it correlates above threshold at a certain trial.

Author(s)

Antoine Tremblay, Dalhousie University, trea26@gmail.com

See Also

fastICA; icac; mwd.thrsh; plot_avgba; plot_trba; plot_tric; summary.icac; topo_ic; update.icac.

Examples

1
# See vignette for examples.

icaOcularCorrection documentation built on May 29, 2017, 1:53 p.m.