Package: circumplex 2.0.0

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.0.tar.gz
circumplex_2.0.0.zip(r-4.7-x86_64)circumplex_2.0.0.zip(r-4.6-x86_64)circumplex_2.0.0.zip(r-4.5-x86_64)
circumplex_2.0.0.tgz(r-4.6-x86_64)circumplex_2.0.0.tgz(r-4.6-arm64)circumplex_2.0.0.tgz(r-4.5-x86_64)circumplex_2.0.0.tgz(r-4.5-arm64)
circumplex_2.0.0.tar.gz(r-4.7-arm64)circumplex_2.0.0.tar.gz(r-4.7-x86_64)circumplex_2.0.0.tar.gz(r-4.6-arm64)circumplex_2.0.0.tar.gz(r-4.6-x86_64)
circumplex_2.0.0.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:
  • 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

On CRAN:

Conda:

circularcircumplexdata-analysisggplot2interpersonalpsychologyrcpparmadillotidyverseopenblascppopenmp

7.87 score 16 stars 64 scripts 532 downloads 46 exports 49 dependencies

Last updated from:ad13787153. Checks:4 ERROR, 9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-arm64ERROR444
linux-devel-x86_64OK437
source / vignettesOK402
linux-release-arm64ERROR431
linux-release-x86_64OK438
macos-release-arm64OK242
macos-release-x86_64ERROR449
macos-oldrel-arm64OK254
macos-oldrel-x86_64ERROR582
windows-devel-x86_64OK420
windows-release-x86_64OK417
windows-oldrel-x86_64OK402
wasm-releaseOK180

Exports:anchorsangle_unwrapaxes_reliabilitycoord_circumplexCoordCircumplexcpm_fitcpm_simulatefit_structuregeom_ssm_arcgeom_ssm_pathgeom_ssm_pointGeomSsmArcGeomSsmPathGeomSsmPointggcircumplexggsavehtml_renderinstrumentsipsatizeitemsnorm_standardizenormsoctantsPANOpolesquadrantsscale_x_circumplexscalesscoreself_standardizessm_analyzessm_analyze_longssm_ci_accuracyssm_drawsssm_parametersssm_parameters_idssm_plot_circlessm_plot_contrastssm_plot_curvessm_plot_trajectoryssm_scoressm_semssm_sem_parametersssm_sem_syntaxssm_tabletheme_circumplex

Dependencies:backportsbase64encbootbslibcachemcheckmateclicpp11digestevaluatefarverfastmapfontawesomefsggplot2gluegtablehighrhtmlTablehtmltoolshtmlwidgetsisobandjquerylibjsonliteknitrlabelinglifecyclemagrittrmemoisemimeR6rappdirsRColorBrewerRcppRcppArmadillorlangrmarkdownrstudioapiS7sassscalesstringistringrtinytexvctrsviridisLitewithrxfunyaml

Axes Reliability
1. What is axis reliability? | 2. A worked example | 3. Reading the components | 4. Caveats to keep in mind | 5. Wrap-up | References
Rendered fromaxes-reliability.Rmdusingknitr::rmarkdown

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

Advanced Circumplex Visualization
Beyond the built-in plots | The circular canvas | The coordinate system | Moving the center | Moving the amplitude axis | Placing SSM results in the circle | Restyling the canvas | Composing custom layers | Trajectories across occasions | The same change as movement on the circle | The angle axis for linear plots | Relationship to the built-in plots | References
Rendered fromadvanced-visualization.Rmdusingknitr::rmarkdown

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

Evaluating Circumplex Structure
1. Two questions to ask before interpreting an SSM analysis | 2. Does the instrument fit a circumplex? | Fitting the circular process model | Reading the fit indices | Comparing model variants | 3. Can you trust your confidence intervals? | What Zimmermann & Wright (2017) found | Simulating coverage for your own analysis | When to trust SSM parameters | 4. 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 | 5. Ipsatization and what it costs | 6. Wrap-up | References
Rendered fromevaluating-circumplex-structure.Rmdusingknitr::rmarkdown

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

Growth Models on SSM Parameters
1. The question growth modeling answers | 2. From repeated measures to a coordinate table | 3. One joint model, not three separate ones | 4. From fixed effects to $(a(t), d(t))$ with intervals | 5. Certification: when $d(t)$ intervals are not interpretable | 6. A caution about REML intervals at small samples | 7. The unwrap alternative: angle_unwrap() | 8. Caveats and upgrades | References
Rendered fromgrowth-ssm-analysis.Rmdusingknitr::rmarkdown

Last update: 2026-07-18
Started: 2026-07-17

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

Last update: 2026-07-18
Started: 2018-07-26

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

Last update: 2026-07-18
Started: 2018-07-26

Bayesian SSM Analysis
1. Why a Bayesian SSM? | 2. The cosine model as a linear regression | 3. Fitting the model with brms | 4. From posterior draws to SSM summaries | 5. The induced prior on amplitude | 6. Where to go next
Rendered frombayesian-ssm-analysis.Rmdusingknitr::rmarkdown

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

SEM-Based SSM Analysis
1. Why a latent SSM? | 2. The measurement model | 3. Estimating a latent profile | 4. Where the confidence intervals come from | 5. What the parameters mean now | 6. Two questions about group differences | 7. Invariance-gated latent contrasts | 8. When to trust it: limitations | 9. Relation to the literature | References
Rendered fromsem-based-ssm-analysis.Rmdusingknitr::rmarkdown

Last update: 2026-07-13
Started: 2026-07-08

Using Circumplex Instruments
1. Overview of Instrument-related Functions | 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 | 4. Wrap-up
Rendered fromusing-instruments.Rmdusingknitr::rmarkdown

Last update: 2026-05-24
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 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 item responses on octant circumplex scalessimulated_items
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
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.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
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