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.

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

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

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

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

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

# S3 method for determinantStructure
print(x, ...)

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.

...

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

x

The determinantStructure object to print or plot.

useDiagrammeR

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

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.

Author

Gjalt-Jorn Peters, gjalt-jorn@a-bc.eu

Examples

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"))));
#>                           levelName
#> 1  using R                         
#> 2   °--Intention                   
#> 3       ¦--Attitude                
#> 4       ¦   ¦--Likelihood          
#> 5       ¦   ¦--Evaluation          
#> 6       ¦   °--attProduct          
#> 7       ¦--perceivedNorm           
#> 8       ¦   ¦--Approval            
#> 9       ¦   ¦--Motivation to comply
#> 10      ¦   °--normProduct         
#> 11      °--pbc                     
#> 12          °--Control beliefs