ch.moralsPlotDprimeBetaFits: A function to plot the dPrime and Beta by OverlapRound for...

ch.moralsPlotDprimeBetaFitsR Documentation

A function to plot the dPrime and Beta by OverlapRound for the Morals data.

Description

This function plots the dPrime and Beta by OverlapRound for the Morals data.

Usage

ch.moralsPlotDprimeBetaFits(
  data,
  overlapRoundCol,
  correctCol,
  correctVals,
  targetPresentCol,
  targetPresentVals,
  addCorrection = TRUE,
  minNperOverlap = 0,
  minUniqueOverlaps = 3,
  cex1 = 1.25,
  cex.topTile = 1.25,
  printR2 = T,
  topTitle = NULL,
  filename = NULL,
  ...
)

Arguments

data

the morals dataframe after running through ch.moralsDataPrep().

overlapRoundCol

a string that specifies the name of the column in "data" that contains the overlap round column.

correctCol

a string the specifies the column name in "data" that contains the variable whether the participant's response was correct.

correctVals

a vector of two values that specifies the "correct" value (index 1) and the "incorrect" value (index 2). e.g, c("yes", "no")

targetPresentCol

a string that specifies the name of the column in "data" that contains the whether or not the target was presented.

targetPresentVals

a vector of two values that specifies the "target present" value (index 1) and the "target absent" value (index 2). e.g, c("yes", "no")

addCorrection

a boolean that specifies whether you want a .5 correction to be added the total hits, FAs, misses, and CRs. This corrects for 0 and 1 values for FA and Hits. DEFAULT = T.

minNperOverlap

an integer that specifies the minimum number of trials necessary to include an overlap bin in the graph. DEFAULT = 0.

minUniqueOverlaps

An integer specifying the minimum number of unique overlap bins necessary for the program to calculate the dPrime function. DEFAULT = 3.

cex1

sets the default font size. DEFAULT = 1.25.

cex.topTile

sets the default font size of the title at the top of the page. DEFAULT = 1.25.

printR2

a boolean that determines whether to print the r square on the graph. DEFAULT = FALSE.

topTitle

a string that will be the title at the top of the page. DEFAULT = NULL.

filename

the filename (pdf) to save the output of the graph. DEFAULT = NULL (no graph saved)

Value

a list containing the lm fit for the dPrime by OverlapRound (dPrimeFit) and the lm fit for the beta by OverlapRound (betaFit).

Examples

ch.moralsPlotDprimeBetaFits (data=moralsData,"overlapRound", "correct", c(1,0), "targetPresent", c(TRUE,FALSE), filename = "myplot.pdf")

ccpluncw/ccpl_R_chMorals documentation built on Feb. 4, 2024, 3:30 p.m.