batchGenerateCI2IFC: Generates multiple 2IFC classification images by participant...

View source: R/batchGenerateCI2IFC.R

batchGenerateCI2IFCR Documentation

Generates multiple 2IFC classification images by participant or condition

Description

Generate classification image for 2 images forced choice reverse correlation task.

Usage

batchGenerateCI2IFC(
  data,
  by,
  stimuli,
  responses,
  baseimage,
  rdata,
  save_as_png = TRUE,
  targetpath = "./cis",
  antiCI = FALSE,
  scaling = "autoscale",
  constant = 0.1,
  label = ""
)

Arguments

data

Data frame

by

String specifying column name that specifies the smallest unit (participant, condition) to subset the data on and calculate CIs for.

stimuli

String specifying column name in data frame that contains the stimulus numbers of the presented stimuli.

responses

String specifying column name in data frame that contains the responses coded 1 for original stimulus selected and -1 for inverted stimulus selected.

baseimage

String specifying which base image was used. Not the file name, but the key used in the list of base images at time of generating the stimuli.

rdata

String pointing to .RData file that was created when stimuli were generated. This file contains the contrast parameters of all generated stimuli.

save_as_png

Boolean stating whether to additionally save the CI as PNG image.

targetpath

Optional string specifying path to save PNGGs to (default: ./cis).

antiCI

Optional boolean specifying whether antiCI instead of CI should be computed.

scaling

Optional string specifying scaling method: none, constant, matched, independent, or autoscale (default).

constant

Optional number specifying the value used as constant scaling factor for the noise (only works for scaling='constant').

label

Optional string to insert in file names of PNGGs to make them easier to identify.

Details

This funcions saves the classification images by participant or condition as PNG to a folder and returns the CIs.

Value

List of classification image data structures (which are themselves lists of pixel matrix of classification noise only, scaled classification noise only, base image only and combined).


rdotsch/rcicr documentation built on Feb. 5, 2023, 10:15 p.m.