batchGenerateCI2IFC: 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, saveasjpeg = TRUE, targetpath = "./cis", antiCI = FALSE, scaling = "autoscale", constant = 0.1, label = "")

Arguments

data

Data frame

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.

saveasjpeg

Boolean stating whether to additionally save the CI as jpeg image

targetpath

Optional string specifying path to save jpegs 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 jepgs to make them easier to identify

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)

Details

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