Create a DCT object
dct_object(
version = as.character(utils::packageVersion("psyverse")),
id = NULL,
prefix = paste(sample(letters, 4), collapse = ""),
label = "",
date = as.character(Sys.Date()),
dct_version = "1",
ancestry = "",
retires = "",
definition = "",
measure_dev = "",
measure_code = "",
aspect_dev = "",
aspect_code = "",
comments = "",
rel = NULL
)
The version of the DCT specification format (normally the version
of the psyverse
package).
The Unique Construct Identifier (UCID); if not provided,
this is created using the prefix
.
The prefix to use to construct the Unique Construct Identifier
(UCID); ignored i id
is provided.
The human-readable label for the construct.
The date at which the construct was created.
The version of the DCT specification. This can optionally be used to manage consecutive DCT versions.
The DCT specification or specifications that this DCT was based on.
The DCT specification or specifications that this DCT renders
obsolete (note that this doesn't mean anything in itself; psyverse
does not
enforce this automatically, nor does PsyCoRe, without configuration).
The definition of the construct. This has to be comprehensive, detailed, accurate, and clearly delineate the relevant aspects of the human psychology.
Instructions for developing measurement instruments that measure this construct.
Instructions for coding measurement instruments (e.g. in
systematic reviews) as measurement instruments that measure this construct.
Note that explicitly defining boundary conditions often helps, for example by
explaining the features that coders should look for to distinguish this
construct from closely related constructs (ideally linking to those other
constructs using the dct:UCID
notations).
Instructions for eliciting construct content. Note that this is not sensible for all constructs; some may be defined at a very general level, rendering their content insufficiently specific to discuss or describe.
Instructions for coding construct content (i.e. aspects).
Note that explicitly defining boundary conditions often helps, for example by
explaining the features that coders should look for to distinguish this
construct from closely related constructs (ideally linking to those other
constructs using the dct:UCID
notations).
Any additional comments.
Relationships with other constructs.
The DCT object.
exampleDCT <-
psyverse::dct_object(
prefix = "exampleConstruct",
label = "An example construct",
definition = "The definition goes here",
measure_dev = "Here you can explain how to measure the construct"
);