Learn R Programming

userfriendlyscience (version 0.7.2)

# exceptionalScore: exceptionalScore

## Description

This function can be used to detect exceptionally high or low scores in a vector.

## Usage

```exceptionalScore(x, prob = 0.025, both = TRUE, silent = FALSE,
quantileCorrection = 1e-04, quantileType = 8)```

## Arguments

x

Vector in which to detect exceptional scores.

prob

Probability that a score is exceptionally positive or negative; i.e. scores with a quartile lower than `prob` or higher than 1-`prob` are considered exceptional (if both is TRUE, at least). So, note that a `prob` of .025 means that if both=TRUE, the most exceptional 5% of the values is marked as such.

both

Whether to consider values exceptional if they're below `prob` as well as above 1-`prob`, or whether to only consider values exceptional if they're below `prob` is `prob` is < .5, or above `prob` if `prob` > .5.

silent

Can be used to suppress messages.

quantileCorrection

By how much to correct the computed quantiles; this is used because when a distribution is very right-skewed, the lowest quantile is the lowest value, which is then also the mode; without subtracting a correction, almost all values would be marked as 'exceptional'.

quantileType

The algorithm used to compute the quantiles; see `quantile`.

## Value

A logical vector, indicating for each value in the supplied vector whether it is exceptional.

## Details

Note that of course, by definition, `prob` of `2*prob` percent of the values is exceptional, so it is usually not a wise idea to remove scores based on their 'exceptionalness'. Instead, use `exceptionalScores`, which calls this function, to see how often participants answered exceptionally, and remove them based on that.

`quantile`, `exceptionalScores`
``````# NOT RUN {