Analysis and Visualization of Circular Data

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) and functions for creating publication-ready tables and figures from the results. Future versions will include tools for circular fit and reliability analyses, as well as visualization enhancements.


CRAN_Status_Badge BuildStatus Coveragestatus Project Status: Active – The project has reached a stable, usablestate and is being activelydeveloped. lifecycle

The goal of circumplex is to provide a powerful, flexible, and user-friendly way to analyze and visualize circumplex data. It was created and is maintained by Jeffrey Girard; it was inspired by work from and was developed under advisement from Johannes Zimmermann and Aidan Wright. You can learn more about using this package through the vignette articles available on the package website or through ?circumplex.

Installation

# Install release version from CRAN
install.packages("circumplex")
 
# Install development version from GitHub
devtools::install_github("jmgirard/circumplex")

Usage

data("jz2017")
results <- ssm_analyze(
  .data = jz2017, 
  scales = c(PA, BC, DE, FG, HI, JK, LM, NO), 
  angles = c(90, 135, 180, 225, 270, 315, 360, 45), 
  measures = c(NARPD, ASPD)
)
ssm_table(results)

Correlation-based Structural Summary Statistics with 95% CIs

Profile

Elevation

X-Value

Y-Value

Amplitude

Displacement

Fit

NARPD

0.20 [0.17, 0.24]

-0.06 [-0.09, -0.03]

0.18 [0.15, 0.21]

0.19 [0.16, 0.22]

109.0 [99.2, 118.9]

0.957

ASPD

0.12 [0.09, 0.16]

-0.10 [-0.13, -0.06]

0.20 [0.17, 0.24]

0.23 [0.19, 0.26]

115.9 [107.4, 124.4]

0.964

ssm_plot(results)

Code of Conduct

This project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

References

Girard, J. M., Zimmermann, J., & Wright, A. G. C. (2018). New tools for circumplex data analysis and visualization in R. Meeting of the Society for Interpersonal Theory and Research. Montreal, Canada.

Zimmermann, J., & Wright, A. G. C. (2017). Beyond description in interpersonal construct validation: Methodological advances in the circumplex Structural Summary Approach. Assessment, 24(1), 3–23.

Wright, A. G. C., Pincus, A. L., Conroy, D. E., & Hilsenroth, M. J. (2009). Integrating methods to optimize circumplex description and comparison of groups. Journal of Personality Assessment, 91(4), 311–322.

News

circumplex 0.3.0

NEW FEATURES

  • Added the ssm_parameters() function to calculate SSM parameters (without confidence intervals) from a vector of scores.
  • Added the ssm_score() function to calculate SSM parameters by row.
  • Added support for older versions of R (3.3.x)

BUG FIXES

  • Fixed a bug in the normative data for IPIP-IPC that prevented standardization
  • Fixed a bug caused by changes in how random numbers are generated in R
  • Fixed several broken links by running package through new version of usethis
  • Fixed warnings related to documentation inherited from other packages

MINOR IMPROVEMENTS

  • Updated the Introduction to SSM vignette's figures
  • Replaced use of dplyr::funs() as this function is being deprecated

circumplex 0.2.1

NEW FEATURES

  • Added one normative data set to the IIS-32
  • Added open-access (i.e., full item text) to the IIS-32 and IIS-64

BUG FIXES

  • Updated the IIS-32 response anchors to range from 1 to 6 to match norms
  • Changed use of tibble functions to avoid problems when new version releases
  • Removed dependency on MASS package (until it is used by exported functions)

MINOR IMPROVEMENTS

  • Updated the IIS-32 item ordering and scoring to match the author's version

circumplex 0.2.0

NEW FEATURES

  • Added functions and documentation for numerous circumplex instruments
  • Added functions for ipsatizing and scoring item-level data
  • Added function for standardizing scale-level data using normative data

BUG FIXES

  • Changed OpenMP flags in Makevars to fix a compile problem on Debian machines
  • Fixed a bug related to calculating angular medians in the presence of NAs

MINOR IMPROVEMENTS

  • Changed the default to plot profiles with low fit (but with dashed borders)
  • Import and export functions from rlang tidy evaluation
  • Added unit testing of various functions to increase code coverage

DOCUMENTATION FIXES

  • Redesigned package website to be more attractive and clear
  • Updated SSM vignette to use standardization function

circumplex 0.1.2

NEW FEATURES

  • Profiles with low fit now have dashed borders when plotted

BUG FIXES

  • Fixed bug that prevented compilation on Solaris systems
  • Fixed bug that prevented CRAN checks on old R versions

DOCUMENTATION FIXES

  • Improved the formatting of vignette source code

circumplex 0.1.1

NEW FEATURES

DOCUMENTATION FIXES

  • Fixed documentation to meet CRAN standards

circumplex 0.1.0

NEW FEATURES

  • Submitted to CRAN

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("circumplex")

0.3.1 by Jeffrey Girard, 9 days ago


https://github.com/jmgirard/circumplex


Report a bug at https://github.com/jmgirard/circumplex/issues


Browse source code at https://github.com/cran/circumplex


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


Documentation:   PDF Manual  


GPL-3 license


Imports assertthat, boot, dplyr, ggforce, ggplot2, glue, htmlTable, magrittr, purrr, Rcpp, rlang, stats, tibble, tidyr

Suggests covr, kableExtra, knitr, rmarkdown, roxygen2, testthat

Linking to Rcpp, RcppArmadillo


See at CRAN