inspect_bfactor_log: Validate vectors of logarithmic Bayes factors

In ptfonseca/inspector: Validation of Arguments and Objects in User-Defined Functions

Description

inspect_bfactor_log checks if an object is a numeric vector of valid logarithmic Bayes factor values. This can be useful to validate inputs, intermediate calculations or outputs in user-defined functions.

Usage

inspect_bfactor_log(x, allow_nas = TRUE, warning_nas = TRUE)

Arguments

x	An arbitrary object.
allow_nas	Logical value. If TRUE then NA and NaN values in x are allowed. If FALSE, execution is stopped and an error message is thrown in case there are NA or NaN values in x.
warning_nas	Logical value. If TRUE then the presence of NA or NaN values in x generates a warning message. NA and NaN values pass silently otherwise (if allow_nas is TRUE).

Details

inspect_bfactor_log conducts a series of tests to check if x is a numeric vector of valid logarithmic Bayes factor values. Namely, inspect_bfactor_log checks if:

• x is NULL or empty.

• x is an atomic vector.

• x is numeric.

• x has NA or NaN values.

Value

inspect_bfactor_log does not return any output. There are three possible outcomes:

• The call is silent if:

  • x is a numeric vector of valid logarithmic Bayes factor values and there are no NA or NaN values in x.

  • x is a numeric vector of valid logarithmic Bayes factor values, there are some NA or NaN values in x, allow_nas is set to TRUE and warning_nas is set to FALSE.

• An informative warning message is given if x is a numeric vector of valid logarithmic Bayes factor values, there are some NA or NaN values in x and both allow_nas and warning_nas are set to TRUE.

• An informative error message is thrown and the execution is stopped if:

  • x is not a numeric vector of valid logarithmic Bayes factor values.

  • x is a numeric vector of valid logarithmic Bayes factor values, there are some NA or NaN values in x and allow_nas is set to FALSE.

See Also

• inspect_bfactor to check if an object is a numeric vector of valid Bayes factor values.

• bfactor_log_interpret for the interpretation of the logarithms of Bayes factors.

• inspect_bfactor_scale to check if an object is a Bayes factor interpretation scale.

• inspect_log_base to check if an object is an eligible logarithmic base.

Examples

# Calls that pass silently:
x1 <- c(0, 0.5, 1, 10, 50, 100)
x2 <- c(NA, 0.5, 1, 10, 50, 100)
inspect_bfactor_log(x1)
inspect_bfactor_log(x2, warning_nas = FALSE)
inspect_bfactor_log(x2, allow_nas = TRUE, warning_nas = FALSE)

# Call that throws an informative warning message:
y <- c(0.1, 0.2, NA, 0.4, 0.5)
try(inspect_bfactor_log(y))
try(inspect_bfactor_log(y, warning_nas = TRUE))
try(inspect_bfactor_log(y, allow_nas = TRUE, warning_nas = TRUE))

# Calls that throw informative error messages:
mylist <- list(
  NULL, TRUE, factor(.5), matrix(0.5),
  "0.5", list(0.5), numeric(0), NA, NaN
)
try(inspect_bfactor_log(mylist[[1]]))
try(inspect_bfactor_log(mylist[[2]]))
try(inspect_bfactor_log(mylist[[3]]))
try(inspect_bfactor_log(mylist[[4]]))
try(inspect_bfactor_log(mylist[[5]]))
try(inspect_bfactor_log(mylist[[6]]))
try(inspect_bfactor_log(mylist[[7]]))
try(inspect_bfactor_log(mylist[[8]]))
try(inspect_bfactor_log(mylist[[9]]))

ptfonseca/inspector documentation built on June 23, 2021, 8:21 p.m.