Analysis and Visualization of Circular Data
Overview
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.
Minor improvements and fixes
- The package's tests now pass on CRAN's macOS x86_64 flavors. The check of
ssm_sem_syntax()'s single-group output against a stored copy compared cosine and sine loadings printed at 17 significant digits, and that platform's math library rounds one of them a single unit in the last place differently. The comparison now ignores differences beyond 12 significant digits and nothing else.ssm_sem_syntax()'s output is unchanged. - The package's tests now pass on Linux arm64. Two checks of
ssm_draws()compared amplitudes computed by the package's C++ code against the same amplitudes computed in R, and required the two to agree to the last bit. They do on every other platform, but on that one they can differ by one unit in the last place. The checks now require agreement to 12 significant digits. No result reported byssm_draws()has changed.
Show all changes in 2.0.1Hide the rest of the changes in 2.0.1
- The package's tests now pass on Linux arm64 in a third place. One check priced a deliberately ill-conditioned matrix and required
axes_reliability()'s internal accuracy check to report a number for it. Whether a number can be computed at that matrix depends on the platform's linear algebra library: on Linux arm64 the inversion gives up, which the check treated as a defect. It now accepts either outcome and requires what is true on both — that the fit is refused, and that the accuracy check says so.axes_reliability()refuses that matrix on every platform, as it did before, and no result it reports has changed. - The figures in the pre-rendered vignettes (Introduction to SSM Analysis, Intermediate SSM Analysis, Advanced Circumplex Visualization, Evaluating Circumplex Structure, SEM-Based SSM Analysis, Growth Models on SSM Parameters, and Axes Reliability) are rendered at twice the previous resolution. They had been rendered at 72 dpi and stretched to the article width on the package website, so they looked soft on high-resolution screens.
From NEWS.md in the release
Install
Health
- OK13 OK2026-09-08
- ERROR11 OK, 2 ERROR2026-09-04
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
Show 4 earlier changesHide 4 earlier changes
- WARNING12 OK, 1 WARNING2026-06-08
- OK14 OK2026-04-22
- ERROR13 OK, 1 ERROR2026-04-18
- OK14 OK2026-03-10
Documentation
- Help pages
- 74 (18 internal)includes a package overview page
- Examples that run
- 85%50 run in a plain check (1 of them under a condition) · 9 only when donttest examples are enabled (R CMD check --as-cran)
- Exported functions with examples
- 93%
- Documented parameters
- 91%
- Return-value docs
- 93%
- Help pages citing references
- 11%
Downloads
Repository
- PRs merged (all time)
- 99%
- Median days to close, 50 most recently updated closed issues
- 1
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
16 development-tooling and community-health practices detected across 8 families in the upstream repository
Checks run against github.com/jmgirard/circumplex on 2026-10-21.
The R CMD check workflow runs on Linux
GitHub Pages site last deployed 2026-10-21 · The repository has a site deploy workflow
pkgdown site last built 2026-10-21
Show all practicesHide 4 practices
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2026-07-02Seen in the repository: CLAUDE.mdNamed in .Rbuildignore: .claude, CLAUDE.mdPull request it wrote: opened by a project memberCommits: at least 336 crediting it in the message
- Claude Opus 4.847 commits · Jul 2026
- Claude Fable 541 commits · Jul 2026
- Claude Sonnet 512 commits · Jul 2026
Some of these counts are a minimum, because the search stopped before the oldest commits.
Dependencies
Installing circumplex adds 48 packages (25 with compiled code, 45 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, bslib 5.6 MB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 2.0.1Latest
- 2.0.02026-09-02 · diff ↗ ·
added 24 exports
CoordCircumplex, GeomSsmArc, GeomSsmPath, GeomSsmPoint, angle_unwrap, axes_reliability, coord_circumplex, cpm_fit, cpm_simulate, fit_structure, geom_ssm_arc, geom_ssm_path, geom_ssm_point, ggcircumplex, scale_x_circumplex, ssm_analyze_long, ssm_ci_accuracy, ssm_draws, ssm_parameters_id, ssm_plot_trajectory, ssm_sem, ssm_sem_parameters, ssm_sem_syntax, theme_circumplex - 1.2.02026-07-02 · diff ↗
- 1.1.02026-05-24 · diff ↗
- RR 4.6.0 released · 2026-04-24
- 1.0.22025-09-23 · diff ↗
- 1.0.1
- RR 4.5.0 released · 2025-04-11
- 1.0.02024-10-28 · diff ↗ ·
removed 11 exports
%>%, :=, .data, as_label, as_name, enquo, enquos, ssm_append, ssm_plot, ssm_plot_scores, standardizeadded 5 exports
PANO, norm_standardize, ssm_plot_circle, ssm_plot_contrast, ssm_plot_curve - RR 4.4.0 released · 2024-04-24
- 0.3.10
- RR 4.3.0 released · 2023-04-21
- 0.3.9
- RR 4.2.0 released · 2022-04-22
- 0.3.82021-05-28 · diff ↗
- RR 4.1.0 released · 2021-05-18
Show 19 earlier eventsHide 19 earlier events
- 0.3.72021-05-17 · diff ↗
- 0.3.62020-04-30 · diff ↗
- RR 4.0.0 released · 2020-04-24
- 0.3.52020-01-10 · diff ↗
- unarchivedReturned to CRAN2019-12-05
- 0.3.42019-12-05 · diff ↗ ·
removed 7 exports
enexpr, enexprs, ensym, ensyms, quo, quo_name, quosadded 2 exports
as_label, as_name - archivedRemoved from CRAN2019-11-28check errors were not corrected in time Results out by 2pi
- 0.3.32019-09-26 · diff ↗
- 0.3.22019-08-21 · diff ↗
- 0.3.12019-05-15 · diff ↗
- unarchivedReturned to CRAN2019-04-26
- 0.3.0
- RR 3.6.0 released · 2019-04-26
- archivedRemoved from CRAN2019-04-22check errors were not corrected despite reminders
- 0.2.12018-11-29 · diff ↗
- 0.2.02018-10-26 · diff ↗ ·
added 24 exports
.data, anchors, enexpr, enexprs, enquo, enquos, ensym, ensyms, expr, instrument, instruments, ipsatize, items, mutate, norms, quo, quo_name, quos, scales, score, select, standardize, sym, syms - 0.1.22018-08-06 · diff ↗
- 0.1.12018-07-31
- RR 3.5.0 released · 2018-04-23
Package metadata
- First published
- 2018-07-31
- Total releases
- 22 / 8 yrs
- License
- GPL-3 OSI
- Minimum R
- ≥ 4.1
- Bundled data
- 44 KB / 19 files
- Download size
- 9.4 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("circumplex")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-25, which the citation names so these numbers can be found later. More on citing and the projects behind them.