userfriendlyscience (version 0.7.2)

determinantStructure: Determinant Structure specification

Description

These functions can be used to specify a determinant structure: a hierarchical structure of determinants that can then be conveniently plotted and analysed, for example using detStructCIBER.

These functions are made to be used together; see the example and the forthcoming article for more information.

Usage

determinantStructure(name, selection = NULL, ...)

determinantVar(name, selection = NULL, ...)

subdeterminants(name, selection = NULL, ...)

subdeterminantProducts(name, selection = NULL, ...)

# S3 method for determinantStructure print(x, ...) # S3 method for determinantStructure plot(x, useDiagrammeR = FALSE, ...)

Arguments

name

The name of the variable that is specified.

selection

A regular expression to use to select the variables in a dataframe that are considered items that together form this variable. For determinantStructure, a list can be provided that also contains a named regular expression with the name 'behaviorRegEx', which specifies the name of the behavior to which this determinant structure pertains.

x

The determinantStructure object to print or plot.

useDiagrammeR

Whether to simply use print(plot(x)) (if FALSE) or whether to use ToDiagrammeRGraph, tweak it a bit, by setting global graph attributes, and then using render_graph (if TRUE).

Any additional arguments are other determinant structure building functions. These are used to construct the determinant structure 'tree'.

Value

A determinantStructure object, which is a data.tree object.

Details

This family of functions will be explained more in detail in a forthcoming paper.

plot and print methods plot and print a determinantStructure object.

References

(Forthcoming)

See Also

detStructAddVarLabels, detStructAddVarNames, detStructComputeProducts, detStructComputeScales, detStructCIBER

Examples

# NOT RUN {
determinantStructure('using R',
                     list('using R',
                          behaviorRegEx = 'some RegEx'),
                     determinantVar("Intention",
                                    "another RegEx",
                                    determinantVar("Attitude",
                                                   "third RegEX",
                                                   subdeterminants("Likelihood",
                                                                   "4th RegEx"),
                                                  subdeterminants("Evaluation",
                                                                  "5th RegEx"),
                                                  subdeterminantProducts("attProduct",
                                                                         c("4th RegEx",
                                                                           "5th RegEx"))),
                                    determinantVar("perceivedNorm",
                                                   "6th RegEx",
                                                   subdeterminants("Approval",
                                                                   "7th RegEx"),
                                                   subdeterminants("Motivation to comply",
                                                                   "8th RegEx"),
                                                   subdeterminantProducts("normProduct",
                                                                          c("7th RegEx",
                                                                            "8th RegEx"))),
                                              determinantVar("pbc",
                                                             "9th RegEx",
                                                             subdeterminants("Control beliefs",
                                                                             "10th RegEx"))));
# }