rate.statistics: Complete Signal detection analysis for one group

Description Usage Arguments Details Value Examples

View source: R/rate.statistics.R

Description

Calculates rate statistics, signal detection statistics - d' and c, and auc. Produces plots for visualisation.

Usage

1
2
rate.statistics(hits = hits, miss = miss, CorRej = CorRej,
  falarm = falarm, x = NULL, rm.intermid = TRUE)

Arguments

hits

column containing total hits per person

miss

column containing total misses per person

CorRej

column containing total correct rejections per person

falarm

column containing total dalse alarms per person

x

Data frame - Must be in summary form (i.e. each row is a participant with columns: total hits per person, total false alarms per person, total correct rejections and total misses)

rm.intermid

TRUE/FALSE (default = TRUE) removes the intermediate columns created for the calculation of the Hit rate and False Alarm rate, which are created for the recalculation of Hit rates and False alarm rates that are equal to 1 or 0

Details

Calculates the hit rate, false alarm rate, Miss rate and Correct rejection rate, as well as the d'Prime and Bias (c). Recalculates Hit Rates and False Alarm Rates that are 1 or 0 to allow d'Prime and Bias calculation. Prints the D'Prime, Bias (mean and SD), an ROC curve and a AUC calculation (AUC calculation depends on auc). The defaults of the functions are set to the dataset created by sdt.data. If function is run without any imput, it will use sdt.data's DEFAULT inputs to generate a dataset. If you have generated a data set through sdt.data then the only requirement is to specify the dataset i.e. rate.statistics(x=DATA).

Value

statistics

A simple table containing the average d'prime and bias as well as their sd

boxes

Boxplots depicting the distribution of the d'prime and bias

Density

The density distributions for signal and noise

ROC

An ROC curve for both groups, including a dot for the position of the criterion

AUC

Area under the curve

data

Data frame with transformations and calculations

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
    rate.statistics()

    data <- sdt.data(50,50,0.35,0.11)
    result <- rate.statistics(x=data,rm.intermid = TRUE)
    result$ROC
## Not run: 
    rate.statistics(hits = HIT, miss = Miss, CorRej = CR,
                falarm = FA, sdt = my.dataset, rm.intermid = FALSE)

## End(Not run)

gretat/sdt.rmcs documentation built on May 17, 2019, 8:36 a.m.