circumplex

Analysis and Visualization of Circular Data


Keywords
circular, circumplex, data-analysis, ggplot2, interpersonal, psychology, r, r-package, rcpparmadillo, rstats, tidyverse
License
GPL-3.0

Documentation

circumplex

CRAN_Status_Badge Project Status: Active – The project has reached a stable, usable state and is being actively developed. lifecycle Codecov test coverage R-CMD-check

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),
  measures_labels = c("Narcissistic PD", "Antisocial PD")
)
summary(results)
#> Call:
#> 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), measures_labels = c("Narcissistic PD", 
#>         "Antisocial PD"))
#> 
#> Statistical Basis:    Correlation Scores 
#> Bootstrap Resamples:  2000 
#> Confidence Level:     0.95 
#> Listwise Deletion:    TRUE 
#> Scale Displacements:  90 135 180 225 270 315 360 45 
#> 
#> Profile [Narcissistic PD]:
#>                Estimate   Lower CI   Upper CI
#> Elevation         0.202      0.169      0.238
#> X-Value          -0.062     -0.094     -0.029
#> Y-Value           0.179      0.145      0.213
#> Amplitude         0.189      0.154      0.227
#> Displacement    108.967     98.633    118.537
#> Model Fit         0.957                      
#> 
#> Profile [Antisocial PD]:
#>                Estimate   Lower CI   Upper CI
#> Elevation         0.124      0.087      0.158
#> X-Value          -0.099     -0.133     -0.064
#> Y-Value           0.203      0.170      0.239
#> Amplitude         0.226      0.191      0.264
#> Displacement    115.927    107.327    124.188
#> Model Fit         0.964
ssm_table(results, xy = FALSE)
Correlation-based Structural Summary Statistics with 95% CIs
Profile Elevation Amplitude Displacement Fit
Narcissistic PD 0.20 (0.17, 0.24) 0.19 (0.15, 0.23) 109.0 (98.6, 118.5) 0.957
Antisocial PD 0.12 (0.09, 0.16) 0.23 (0.19, 0.26) 115.9 (107.3, 124.2) 0.964
ssm_plot(results)

Code of Conduct

Please note that the ‘circumplex’ 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.