SDT (version 1.0.0)

plot.share: Plot Method for Objects of Class share

Description

S3 method to plot objects of the class share.

Usage

# S3 method for share
plot(x, target = NULL, reference = NULL, ...)

Arguments

x

A required object of the class share, obtained from calls to the functions internalization and simplex.

target

An optional character string giving the label of the target regulation that is used. The default value NULL corresponds to generic labeling. See ‘Details’.

reference

An optional character vector giving the labels of the reference system base regulations that are used. The default value NULL corresponds to generic labeling. See ‘Details’.

…

Further arguments to be passed are ignored in this function.

Value

If the arguments x, target, and reference are of required types, plot.share produces the plot and invisibly returns NULL.

Details

This plot method produces stacked bar plots of the internalization, externalization, or simplex structure shares of a target regulation with respect to a reference system. Generic or user-specified convenient labeling of the plot axes are provided.

The default value target = NULL corresponds to generic labeling, which is “intermediate regulation” in the case of the attribute value analysis = internalization, or “target regulation” in the case of analysis = simplex. If a character string is explicitly specified instead, this is used to label the \(x\)-axis of the bar plot. See also ‘Examples’.

The default value reference = NULL corresponds to generic labeling, which is “internalization share (dark)” and “externalization share (bright)” in the case of the attribute value analysis = internalization, or “base regulation 1 share (dark)”, “base regulation 2 share (medium)”, and “base regulation 3 share (bright)” in the case of analysis = simplex. If a character vector is explicitly specified instead, which must be of length \(2\) for analysis = internalization or of length \(3\) for analysis = simplex, this is used to label the \(y\)-axis of the bar plot. See also ‘Examples’.

References

Uenlue, A. and Dettweiler, U. (2015) Motivation internalization and simplex structure in self-determination theory. Psychological Reports, 117(3), 675--691. URL https://doi.org/10.2466/14.PR0.117c25z1.

See Also

The two main functions of the package, which create objects of the class share: internalization for motivation internalization analysis; simplex for motivation simplex structure analysis. print.share, the S3 method for printing objects of the class share. See also SDT-package for general information about this package.

Examples

# NOT RUN {
## attach dataset to search path (to use variable names)
attach(learning_motivation)

## internalization plot
(ijr <- internalization(introjected, intrinsic, external))
## with generic labels
plot(ijr)
## with user-specified convenient labels
plot(ijr, target = "introjected regulation",
     reference = c("intrinsic regulation", "external regulation"))

## simplex structure plot 1
(simstr2 <- simplex(target_regulation = external, base_regulation_1 = intrinsic,
                    base_regulation_2 = identified, base_regulation_3 = introjected))
## with generic labels
plot(simstr2)
## with user-specified convenient labels
plot(simstr2, target = "external regulation",
     reference = c("intrinsic regulation", "identified regulation", "introjected regulation"))

## simplex structure plot 2
## different target variable and reference system, conveniently labeled
plot(simplex(identified, intrinsic, introjected, external), target = "identified regulation",
     reference = c("intrinsic regulation", "introjected regulation", "external regulation"))
# }