loadConstraints: Load constraints

View source: R/loading_functions.R

loadConstraintsR Documentation

Load constraints

Description

loadConstraints is a data loading function to create a constraints object. loadConstraints can read constraints from a data.frame or a .csv file. The contents must be in the expected format; see the vignette in vignette("constraints").

Usage

loadConstraints(object, pool, item_attrib, st_attrib = NULL, file = NULL)

Arguments

object

constraint specifications. Can be a data.frame or the file path of a .csv file. See the vignette for the expected format.

pool

an item_pool object. Use loadItemPool for this.

item_attrib

an item_attrib object. Use loadItemAttrib for this.

st_attrib

(optional) an st_attrib object. Use loadStAttrib for this.

file

(deprecated) use object argument instead.

Value

loadConstraints returns a constraints object. This object is used in Static and Shadow.

See Also

dataset_science, dataset_reading, dataset_fatigue, dataset_bayes for examples.

Examples

## Read from data.frame:
itempool_science    <- loadItemPool(itempool_science_data)
itemattrib_science  <- loadItemAttrib(itemattrib_science_data, itempool_science)
constraints_science <- loadConstraints(constraints_science_data,
  itempool_science, itemattrib_science)

## Read from file: write to tempdir() for illustration and clean afterwards
f <- file.path(tempdir(), "constraints_science.csv")
write.csv(constraints_science_data, f, row.names = FALSE)
constraints_science <- loadConstraints(f,
  itempool_science, itemattrib_science)
file.remove(f)

## TestDesign 1.1.0 - Deprecated arguments
## Not run: 
loadConstraints(object = "consts.csv", pool, item_attrib) # is equivalent to
loadConstraints(file   = "consts.csv", pool, item_attrib) # pre 1.1.0

## End(Not run)


TestDesign documentation built on Feb. 16, 2023, 7:19 p.m.