Skip to contents

Instrument Functions

Functions for importing and examining circumplex instruments

instruments()
List all available instruments
scales()
Display the scales of a circumplex instrument
anchors()
Display the anchors of a circumplex instrument
items()
Display the items of a circumplex instrument
norms()
Display the norms for a circumplex instrument

Tidying Functions

Functions for preparing data for analysis

ipsatize()
Ipsatize circumplex items using deviation scoring across variables
score()
Score circumplex scales from item responses
norm_standardize()
Standardize circumplex scales using normative data
self_standardize()
Standardize circumplex scales using sample data

Primary SSM Functions

Functions for implementing the Structural Summary Method

ssm_analyze()
Perform analyses using the Structural Summary Method
ssm_analyze_long()
Perform SSM analyses on long-format repeated-measures data
ssm_table()
Create HTML table from SSM results or contrasts
ssm_parameters()
Calculate Structural Summary Method parameters for a set of scores
ssm_parameters_id()
Calculate SSM parameters for each person
summary(<circumplex_ssm_id>)
Summarize per-person SSM parameters at the group level
ssm_draws()
Summarize posterior draws as SSM parameters
ssm_score()
Calculate SSM parameters by row and add results as new columns

SEM-Based SSM Functions

Latent-variable (disattenuated) SSM via structural equation modeling

ssm_sem()
Perform SEM-based (latent-variable) SSM analyses
ssm_sem_parameters()
Calculate latent SSM parameters from a fitted lavaan measurement model
ssm_sem_syntax()
Generate lavaan syntax for a fixed-angle circumplex measurement model

Structure Evaluation Functions

Functions for evaluating circumplex structure and CI trustworthiness

cpm_fit()
Fit Browne's circular stochastic process model (circumplex fit statistics)
cpm_simulate()
Simulate data from a fitted circular process model
print(<circumplex_cpm>)
Print a circular process model fit
summary(<circumplex_cpm>)
Summarize a circular process model fit
plot(<circumplex_cpm>)
Plot a circular process model fit
fit_structure()
Evaluate circumplex structure (Acton & Revelle, 2004)
print(<circumplex_structure>)
Print circumplex-structure test results
summary(<circumplex_structure>)
Summarize circumplex-structure test results
plot(<circumplex_structure>)
Plot a circumplex-structure configuration
axes_reliability()
Reliability of the circumplex axes (Strack, Jacobs & Grosse Holtforth, 2013)
print(<circumplex_axes_reliability>)
Print circumplex axes-reliability results
summary(<circumplex_axes_reliability>)
Summarize circumplex axes-reliability results
ssm_ci_accuracy()
Assess the accuracy of SSM confidence intervals by simulation
summary(<circumplex_ci_accuracy>)
Summarize the accuracy of SSM confidence intervals
plot(<circumplex_ci_accuracy>)
Plot SSM CI accuracy across the amplitude ladder

Visualization - Complete Plots

Ready-made circumplex figures for a set of SSM results

ssm_plot_circle()
Create a Circular Plot of SSM Results
ssm_plot_curve()
Create a Curve Plot of SSM Results
ssm_plot_contrast()
Create a Difference Plot of SSM Contrast Results
ssm_plot_trajectory()
Create a Trajectory Plot of SSM Results Over Time

Visualization - Building Blocks

Composable ggplot2 components for building custom circumplex figures

ggcircumplex()
Create a circumplex plotting canvas
coord_circumplex()
Circumplex coordinate system
geom_ssm_point()
Draw SSM profile points in circumplex space
geom_ssm_arc()
Draw SSM confidence-region arcs in circumplex space
geom_ssm_path()
Draw a profile's movement across occasions in circumplex space
scale_x_circumplex()
Angle-labeled x-axis scale for circumplex plots
theme_circumplex()
Circumplex canvas theme

Secondary SSM Functions

Functions for customizing SSM results

html_render()
Format and render data frame as HTML table

Convenience Functions

Functions that make your life easier

angle_unwrap()
Unwrap a sequence of angles onto a continuous branch
octants()
Angular displacements for octant circumplex scales
poles()
Angular displacements for pole circumplex scales
quadrants()
Angular displacements for quadrant circumplex scales
PANO()
Two-letter abbreviations for octant circumplex scales

Example Data

aw2009
Standardized octant scores on hypothetical circumplex scales
jz2017
Raw octant scores on real circumplex scales with covariates
raw_iipsc
Raw item responses on real circumplex scales
simulated_items
Simulated item responses on octant circumplex scales