Description Usage Arguments Details Value Author(s) References See Also Examples

Computes the sample size for a difference or similarity test for a
sensory discrimination experiment using the binomial distribution.
`d.primeSS`

is a convenience function that calls
`discrimSS`

but has arguments in terms of d-prime rather than
pd, the expected proportion of discriminators.

1 2 3 4 5 6 7 8 9 10 11 12 | ```
discrimSS(pdA, pd0 = 0, target.power = 0.90, alpha = 0.05,
pGuess = 1/2, test = c("difference", "similarity"),
statistic = c("exact", "stable.exact", "both.exact",
"normal", "cont.normal"))
d.primeSS(d.primeA, d.prime0 = 0, target.power = 0.90, alpha = 0.05,
method = c("duotrio", "tetrad", "threeAFC", "twoAFC",
"triangle", "hexad", "twofive", "twofiveF"),
double = FALSE,
test = c("difference", "similarity"),
statistic = c("exact", "stable.exact", "both.exact",
"normal", "cont.normal"))
``` |

`pdA` |
the probability of discrimination for the model under the alternative hypothesis; scalar between zero and one |

`d.primeA` |
d-prime for the model under the alternative hypothesis; non-negative numerical scalar |

`pd0` |
the probability of discrimination under the null hypothesis; scalar between zero and one |

`d.prime0` |
d-prime under the null hypothesis; non-negative numerical scalar |

`target.power` |
the desired power for the test |

`alpha` |
the type I level of the test; scalar between zero and one |

`method` |
the discrimination protocol for which the sample size should be computed |

`double` |
should the 'double' variant of the discrimination protocol be used? Logical scalar. Currently not implemented for "twofive", "twofiveF", and "hexad". |

`pGuess` |
the guessing probability for the discrimination protocol, e.g. 1/2 for duo-trio and 2-AFC, 1/3 for triangle, tetrad and 3-AFC, 1/10 for two-out-of-five and hexad and 2/5 for two-out-of-five with forgiveness;; scalar between zero and one |

`test` |
the type of one-sided binomial test (direction of the alternative hypothesis): "difference" corresponds "greater" and "similarity" corresponds to "less" |

`statistic` |
options are explained in the Details section below |

For difference tests `pdA`

or `d.primeA`

(the sensory
difference under the alternative hypothesis) has to be larger than
`pd0`

or `d.prime0`

(the sensory difference under the null
hypothesis). The sample size of the standard one-tailed difference
test where the null hypothesis of "no difference" is obtained with
`pd0 = 0`

or `d.prime0 = 0`

.

For similarity tests it is required that `pd0`

> `pdA`

or
equivalently that `d.prime0`

> `d.primeA`

. Here, the
interval [0, `pdA`

] or [0, `d.primeA`

]
is the similarity region covering sensory differences for which we
would say that the products are similar.

The probability of a correct answer under the null hypothesis is
given by `pd0 + pGuess * (1 - pd0)`

. Similarly, the probability
of a correct answer under the alternative hypothesis is given by
`pdA + pGuess * (1 - pdA)`

.

The `statistic`

argument:

`"exact"`

is the conventional sample size for the exact binomial test: The smallest sample size that gives the desired power (`target.power`

) at the given significance level. Ususally slightly higher sample sizes will not have the desired power, however. This is due to the non-monotonic behavior of power as a function of sample size.`"stable.exact"`

is so-called stable exact sample size proposed by Ennis and Jesionka (2011) which has the property that no larger sample sizes has a power less than the`target.power`

.`"both.exact"`

returns both`exact`

and`stable.exact`

sample sizes`"normal"`

is the normal approximation to the exact binomial sample size without any continuity adjustment. This usually provides a sample size that is smaller than the sample size for the exact binomial test.`"cont.normal"`

is the continuity adjusted normal approximation to the sample size for the exact binomial test. This sample size is usually closer to the exact sample size than the unadjusted approximation and usually higher than the unadjusted approximation.

If the sample size based on the continuity adjusted normal approximation is larger than 10,000, the function returns the normal approximation and issues a warning.

The sample size; an integer.

Per Bruun Brockhoff and Rune Haubo B Christensen

Brockhoff, P.B. and Christensen, R.H.B (2010). Thurstonian models for sensory discrimination tests as generalized linear models. Food Quality and Preference, 21, pp. 330-338.

Ennis, J.M. and V. Jesionka (2011). The power of sensory discrimination methods revisited. Journal of Sensory Studies, 26, pp. 371-382.

`AnotA`

, `discrimPwr`

,
`samediff`

, `findcr`

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | ```
## Finding the smallest necessary sample size:
discrimSS(pdA = 0.5, pd0 = 0, target.power = 0.80, alpha = 0.05,
pGuess = 1/2, test = "difference", statistic = "exact")
## The stable-exact sample size is larger:
discrimSS(pdA = 0.5, pd0 = 0, target.power = 0.80, alpha = 0.05,
pGuess = 1/2, test = "difference", statistic = "stable.exact")
## Give identical results:
pd <- coef(rescale(d.prime = 1, method = "twoAFC"))$pd
discrimSS(pdA = pd, pd0 = 0, target.power = 0.90, alpha = 0.05,
pGuess = 1/2, test = "difference", statistic = "exact")
d.primeSS(1, target.power = 0.90, method = "twoAFC")
## A similarity example:
discrimSS(pdA = 0.1, pd0 = 0.2, target.power = 0.80, alpha = 0.05,
pGuess = 1/2, test = "similarity", statistic = "exact")
``` |

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.