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)
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 CRANinstall.packages("circumplex")# Install development version from GitHubdevtools::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)
|
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
- Package website added using pkgdown
DOCUMENTATION FIXES
- Fixed documentation to meet CRAN standards
circumplex 0.1.0
NEW FEATURES
- Submitted to CRAN