popu is an R data frame that is computed by comp_popu from the current frequency information (contained in freq). Each individual is represented as a row; columns represent the individual's condition (TRUE or FALSE), a corresponding decision (also encoded as TRUE = positive or FALSE = negative), and its classification (i.e., its case or cell combination, in SDT terms), as true positive (hit hi), false negative (miss mi), false positive (false alarm fa), or true negative (correct rejection cr).

popu

Format

An object of class NULL of length 0.

Value

A data frame popu

containing N rows (individual cases) and 3 columns ("Truth", "Decision", "SDT") encoded as ordered factors (with 2, 2, and 4 levels, respectively).

Details

#' popu is initialized to NULL and needs to be computed by calling comp_popu with current parameter settings.

By default, comp_popu uses the current information contained in txt to define text labels.

A visualization of the current population popu is provided by plot_icons.

See also

the corresponding generating function comp_popu; read_popu interprets a data frame as a riskyr scenario; num for basic numeric parameters; freq for current frequency information; txt for current text settings.

Examples

popu <- comp_popu()  # => initializes popu with current values of freq and txt
dim(popu)            # => N x 3
#> [1] 1000    3
head(popu)           # => shows head of data frame
#>   True condition  Outcome Cases
#> 1        present positive    TP
#> 2        present positive    TP
#> 3        present positive    TP
#> 4        present positive    TP
#> 5        present positive    TP
#> 6        present positive    TP