Package: circumplex 2.0.1.9000

circumplex: Analysis and Visualization of Circular Data

Circumplex models, which organize constructs in a circle around two underlying dimensions, are popular for studying interpersonal functioning, mood/affect, and vocational preferences/environments. This package provides tools for analyzing and visualizing circular data, including scoring functions for relevant instruments and a generalization of the bootstrapped structural summary method from Zimmermann & Wright (2017) <doi:10.1177/1073191115621795> and functions for creating publication-ready tables and figures from the results.

Authors:Jeffrey Girard [aut, cre], Johannes Zimmermann [aut], Aidan Wright [aut]

circumplex_2.0.1.9000.tar.gz
circumplex_2.0.1.9000.zip(r-4.7-x86_64)circumplex_2.0.1.9000.zip(r-4.7-arm64)circumplex_2.0.1.9000.zip(r-4.6-x86_64)circumplex_2.0.1.9000.zip(r-4.6-arm64)circumplex_2.0.1.9000.zip(r-4.5-x86_64)
circumplex_2.0.1.9000.tgz(r-4.6-x86_64)circumplex_2.0.1.9000.tgz(r-4.6-arm64)circumplex_2.0.1.9000.tgz(r-4.5-x86_64)circumplex_2.0.1.9000.tgz(r-4.5-arm64)
circumplex_2.0.1.9000.tar.gz(r-4.7-arm64)circumplex_2.0.1.9000.tar.gz(r-4.7-x86_64)circumplex_2.0.1.9000.tar.gz(r-4.6-arm64)circumplex_2.0.1.9000.tar.gz(r-4.6-x86_64)
circumplex_2.0.1.9000.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
circumplex/json (API)

# Install 'circumplex' in R:
install.packages('circumplex', repos = c('https://jmgirard.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/jmgirard/circumplex/issues

Pkgdown/docs site:https://circumplex.jmgirard.com

Uses libs:
  • openblas– Optimized BLAS
  • c++– GNU Standard C++ Library v3
  • openmp– GCC OpenMP (GOMP) support library
Datasets:

On CRAN:

Conda:

circularcircumplexdata-analysisggplot2interpersonalpsychologyrcpparmadillotidyverseopenblascppopenmp

8.46 score 16 stars 86 scripts 738 downloads 52 exports 49 dependencies

Last updated from:f446582f9e. Checks:15 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-arm64OK267
linux-devel-x86_64OK331
source / vignettesOK338
linux-release-arm64OK261
linux-release-x86_64OK319
macos-release-arm64OK253
macos-release-x86_64OK517
macos-oldrel-arm64OK263
macos-oldrel-x86_64OK502
windows-devel-arm64OK384
windows-devel-x86_64OK402
windows-release-arm64OK407
windows-release-x86_64OK298
windows-oldrel-x86_64OK307
wasm-releaseOK184

Exports:anchorsangle_unwrapaxes_reliabilitycoord_circumplexCoordCircumplexcpm_fitcpm_simulatefit_structuregeom_ssm_arcgeom_ssm_ellipsegeom_ssm_pathgeom_ssm_pointGeomSsmArcGeomSsmEllipseGeomSsmPathGeomSsmPointggcircumplexggsavehtml_renderinstrumentsipsatizeitemsnorm_standardizenormsoctantsPANOpolesquadrantsscale_x_circumplexscalesscoreself_standardizessm_analyzessm_analyze_longssm_ci_accuracyssm_drawsssm_ellipse_datassm_growth_datassm_growth_formulassm_parametersssm_parameters_idssm_plot_circlessm_plot_contrastssm_plot_curvessm_plot_trajectoryssm_scoressm_semssm_sem_parametersssm_sem_syntaxssm_tablessm_trajectorytheme_circumplex

Dependencies:backportsbase64encbootbslibcachemcheckmateclicpp11digestevaluatefarverfastmapfontawesomefsggplot2gluegtablehighrhtmlTablehtmltoolshtmlwidgetsisobandjquerylibjsonliteknitrlabelinglifecyclemagrittrmemoisemimeR6rappdirsRColorBrewerRcppRcppArmadillorlangrmarkdownrstudioapiS7sassscalesstringistringrtinytexvctrsviridisLitewithrxfunyaml

Bayesian SSM Analysis
1. Overview | 2. Why a Bayesian SSM? | 3. The cosine model as a linear regression | 4. Fitting the model with brms | 5. From posterior draws to SSM summaries | 6. The induced prior on amplitude | Wrap-up

Last update: 2026-09-25
Started: 2026-07-17

Growth Models on SSM Parameters
1. Overview | 2. The question growth modeling answers | 3. From repeated measures to a long table | 4. One joint model, not three separate ones | 5. From fixed effects to $(a(t), d(t))$ with intervals | 6. Certification: when $d(t)$ intervals are not interpretable | 7. A caution about REML intervals at small samples | 8. The unwrap alternative: angle_unwrap() | 9. Caveats and upgrades | 10. The same model in nlme and brms | Wrap-up | References

Last update: 2026-09-25
Started: 2026-07-17

Latent Group Contrasts
1. Overview | 2. Two questions about group differences | 3. Invariance-gated latent contrasts | 4. When to trust it: limitations | 5. Relation to the literature | Wrap-up | References

Last update: 2026-09-25
Started: 2026-09-17

SEM-Based SSM Analysis
1. Overview | 2. Why a latent SSM? | 3. The measurement model | 4. Estimating a latent profile | 5. Where the confidence intervals come from | 6. What the parameters mean now | Wrap-up | References

Last update: 2026-09-25
Started: 2026-07-08

Advanced Circumplex Visualization
1. Overview | 2. The circular canvas | 3. The coordinate system | Moving the center | Moving the amplitude axis | 4. Placing SSM results in the circle | 5. Restyling the canvas | 6. Composing custom layers | 7. The latent circumplex from a CPM fit | Estimated angles as ticks on the rim | Measure points on the same rim | One measure with its amplitude and displacement | The fitted correlation function | A joint confidence ellipse from posterior draws | 8. Trajectories across occasions | The same change as movement on the circle | 9. The angle axis for linear plots | 10. Relationship to the built-in plots | Wrap-up | References

Last update: 2026-09-25
Started: 2026-07-03

Axes Reliability
1. Overview | 2. What is axis reliability? | 3. A worked example | 4. Reading the components | 5. Starting from a published correlation matrix | Wrap-up | References

Last update: 2026-09-21
Started: 2026-07-24

CPM Fits at a Boundary
1. Overview | 2. When a fit sits at a boundary | Wrap-up

Last update: 2026-09-21
Started: 2026-09-17

Evaluating Circumplex Structure
1. Overview | 2. Two questions to ask before interpreting an SSM analysis | 3. Does the instrument fit a circumplex? | Fitting the circular process model | Reading the fit indices | Comparing model variants | Wrap-up | References

Last update: 2026-09-21
Started: 2026-07-07

Axes Reliability Caveats
1. Overview | 2. The correction for the correlation metric | 3. Missing data | 4. Boundary fits | 5. Blockwise instruments | 6. The standard error of measurement | Wrap-up | References

Last update: 2026-09-17
Started: 2026-09-17

Confidence Interval Accuracy
1. Overview | 2. What Zimmermann & Wright (2017) found | 3. Simulating coverage for your own analysis | The full report | 4. When to trust SSM parameters | Wrap-up | References

Last update: 2026-09-17
Started: 2026-09-17

Intermediate SSM Analysis
1. Overview | 2. Generalizing the basic analyses | Generalizing to multiple means | Generalizing to multiple measures | Generalizing to multiple groups and multiple measures | 3. Contrast analyses | Contrasts between groups' means | Contrasts between measures in a group | Contrasts between groups' correlations | 4. Taxonomy of analysis types | 5. Working with SSM tables | Basic customizations of tables | 6. Working with SSM figures | Exporting figures as files | Wrap-up | References

Last update: 2026-09-17
Started: 2018-07-26

Structure Tests and Ipsatization
1. Overview | 2. Does the instrument have circumplex structure at all? | The five tests | Where the cutoffs come from | Reading the classifications | How this complements the CPM fit | 3. Ipsatization and what it costs | Wrap-up | References

Last update: 2026-09-17
Started: 2026-09-17

Introduction to SSM Analysis
1. Overview | 2. Background and Motivation | Circumplex models, scales, and data | The Structural Summary Method | Understanding the SSM parameters | 3. Example data: jz2017 | 4. Mean-based SSM Analysis | Conducting SSM for a group's mean scores | Visualizing the results with a table and figure | 5. Correlation-based SSM Analysis | Conducting SSM for a group's correlations with an external measure | Wrap-up | References

Last update: 2026-09-16
Started: 2018-07-26

Using Circumplex Instruments
1. Overview | 2. Loading and Examining Instrument Objects | Previewing the available instruments | Loading a specific instrument | Examining an instrument in-depth | 3. Instrument-related Tidying Functions | Ipsatizing item-level data | Scoring item-level data | Standardizing scale-level data | Wrap-up

Last update: 2026-09-16
Started: 2018-10-21

Readme and manuals

Help Manual

Help pageTopics
Display the anchors of a circumplex instrumentanchors
Unwrap a sequence of angles onto a continuous branchangle_unwrap
Standardized octant scores on hypothetical circumplex scalesaw2009
Reliability of the circumplex axes (Strack, Jacobs & Grosse Holtforth, 2013)axes_reliability
Circumplex coordinate systemcoord_circumplex
Fit Browne's circular stochastic process model (circumplex fit statistics)cpm_fit
Simulate data from a fitted circular process modelcpm_simulate
Evaluate circumplex structure (Acton & Revelle, 2004)fit_structure
Draw SSM confidence-region arcs in circumplex spacegeom_ssm_arc
Draw a joint confidence ellipse for SSM coordinates in circumplex spacegeom_ssm_ellipse
Draw a profile's movement across occasions in circumplex spacegeom_ssm_path
Draw SSM profile points in circumplex spacegeom_ssm_point
Create a circumplex plotting canvasggcircumplex
Format and render data frame as HTML tablehtml_render
List all available instrumentsinstruments
Ipsatize circumplex items using deviation scoring across variablesipsatize
Display the items of a circumplex instrumentitems
Raw octant scores on real circumplex scales with covariatesjz2017
Standardize circumplex scales using normative datanorm_standardize
Display the norms for a circumplex instrumentnorms
Angular displacements for octant circumplex scalesoctants
Two-letter abbreviations for octant circumplex scalesPANO
Plot SSM CI accuracy across the amplitude ladderplot.circumplex_ci_accuracy
Plot a circular process model fitplot.circumplex_cpm
Plot a circumplex-structure configurationplot.circumplex_structure
Angular displacements for pole circumplex scalespoles
Print circumplex axes-reliability resultsprint.circumplex_axes_reliability
Print a circular process model fitprint.circumplex_cpm
Print circumplex-structure test resultsprint.circumplex_structure
Angular displacements for quadrant circumplex scalesquadrants
Raw item responses on real circumplex scalesraw_iipsc
Angle-labeled x-axis scale for circumplex plotsscale_x_circumplex
Display the scales of a circumplex instrumentscales
Score circumplex scales from item responsesscore
Standardize circumplex scales using sample dataself_standardize
Simulated octant scores for growth modelssimulated_growth simulated_growth_origin
Simulated item responses on octant circumplex scalessimulated_items
Simulated octant scores at three occasionssimulated_occasions
Perform analyses using the Structural Summary Methodssm_analyze
Perform SSM analyses on long-format repeated-measures datassm_analyze_long
Assess the accuracy of SSM confidence intervals by simulationssm_ci_accuracy
Summarize posterior draws as SSM parametersssm_draws
Centre and covariance of the Cartesian SSM coordinates for an ellipse layerssm_ellipse_data ssm_ellipse_data.circumplex_ssm_draws ssm_ellipse_data.default
Build the long table for a growth model on SSM coordinatesssm_growth_data
The joint growth model on SSM coordinates as an engine's formulasprint.circumplex_growth_formula ssm_growth_formula
Calculate Structural Summary Method parameters for a set of scoresssm_parameters
Calculate SSM parameters for each personssm_parameters_id
Create a Circular Plot of SSM Resultsssm_plot_circle
Create a Difference Plot of SSM Contrast Resultsssm_plot_contrast
Create a Curve Plot of SSM Resultsssm_plot_curve
Create a Trajectory Plot of SSM Results Over Timessm_plot_trajectory ssm_plot_trajectory.circumplex_ssm ssm_plot_trajectory.circumplex_ssm_trajectory ssm_plot_trajectory.data.frame ssm_plot_trajectory.default
Calculate SSM parameters by row and add results as new columnsssm_score
Perform SEM-based (latent-variable) SSM analysesssm_sem
Calculate latent SSM parameters from a fitted lavaan measurement modelssm_sem_parameters
Generate lavaan syntax for a fixed-angle circumplex measurement modelssm_sem_syntax
Create HTML table from SSM results or contrastsssm_table
Trajectory of SSM parameters from a fitted growth modelprint.circumplex_ssm_trajectory rbind.circumplex_ssm_trajectory ssm_trajectory
Summarize circumplex axes-reliability resultssummary.circumplex_axes_reliability
Summarize the accuracy of SSM confidence intervalssummary.circumplex_ci_accuracy
Summarize a circular process model fitsummary.circumplex_cpm
Summarize per-person SSM parameters at the group levelsummary.circumplex_ssm_id
Summarize circumplex-structure test resultssummary.circumplex_structure
Circumplex canvas themetheme_circumplex