sensR (version 1.2.2)

rescale: Transform or rescale between Pc, Pd and d-prime for sensory discrimination protocols

Description

Transforms or rescales estimates and optionally standard errors between the three levels at which a sensory difference is measured: Pc (proportion of correct answers), Pd (proportion of discriminators) and d-prime. rescale is the main function and only one of Pc, Pd or d-prime should be given as argument --- values for the remaining two scales will be computed. A number of auxiliary functions are also provided: [object Object],[object Object],[object Object],[object Object],[object Object]

Usage

rescale(Pc, Pd, d.prime, std.err, 
        method = c("duotrio", "threeAFC", "twoAFC", "triangle"))

psyfun(d.prime, method = c("duotrio", "threeAFC", "twoAFC", "triangle"))

psyinv(Pc, method = c("duotrio", "threeAFC", "twoAFC", "triangle"))

psyderiv(d.prime, method = c("duotrio", "threeAFC", "twoAFC", "triangle"))

pc2pd(Pc, Pguess)

pd2pc(Pd, Pguess)

Arguments

Pc

the proportion of correct answers; a numerical vector between 0 and 1

Pd

the proportion of discriminators; a numerical vector between 0 and 1

d.prime

the sensory difference on the d-prime scale; a non-negative numerical vector.

std.err

optional numerical vector of standard errors of the same length as the either of Pc, Pd or d.prime. Negative values are not allowed, but values may be NA

method

the sensory discrimination protocol for which the results should apply

Pguess

the guessing probability implied by the protocol; a numeric scalar between 0 and 1

Value

• For rescale an object of class rescale with elements
• coefficients
  a data.frame with values of Pc, Pd and d.prime corresponding to the input
• std.err
  if standard errors are given trough the std.err argument a data.frame of the same size and shape as coefficients with standard errors. Otherwise missing.
• method
  the sensory discrimination protocol for which the results apply
• For psyfun, psyinv, psyderiv, pc2pd and pd2pc a numerical vector of the same length as the first argument with appropriate contents.

Details

The rescale function is based on the fact that once the protocol and one of Pc, Pd and d-prime is known, the other two can be computed. The same applies to the standard errors of these parameters. Standard errors are optional, but if they are supplied, the length of the std.err argument has to match the length of Pc, Pd or d.prime whichever is given. A print method is implemented for rescale objects.

Examples

## suppose 15 out of 20 are observed in a duo-trio experiment, then
## the estimated probability of correct a answer is
(Pc <- 15/20)
## The standard error of this estimate is
(se.Pc <- sqrt(Pc * (1 - Pc) / 20))
## The corresponding estimate of proportion of discriminators (Pd) and
## d-prime with associated standard errors are:
rescale(Pc = Pc, std.err = se.Pc, method = "duotrio")

## Can also do
rescale(Pd = c(.6,.7), std.err = c(.2, NA))
psyfun(2, method = "triangle")
psyinv(0.8, method = "twoAFC")
psyderiv(2, method = "duotrio")
pc2pd(0.7, 1/2)
pd2pc(0.3, 1/3)