{"Package":"CHOIRBM","Title":"Plots the CHOIR Body Map","Version":"0.0.2","Authors@R":"\nc(person(given = \"Eric\",\nfamily = \"Cramer\",\nrole = c(\"aut\", \"cre\"),\nemail = \"emcramer@stanford.edu\",\ncomment = c(ORCID = \"0000-0003-2085-3679\")),\nperson(given = \"Stanford University School of Medicine\",\nrole = c(\"cph\", \"fnd\")))","Description":"Collection of utility functions for visualizing\nbody map data collected with the Collaborative Health Outcomes\nInformation Registry.","License":"MIT + file LICENSE","URL":"https://github.com/emcramer/CHOIRBM","BugReports":"https://github.com/emcramer/CHOIRBM/issues","Depends":"R (>= 3.5.0)","Imports":"ggplot2, rlang, stringr","Suggests":"knitr, rmarkdown, testthat (>= 2.0.0)","VignetteBuilder":"knitr","Config/testthat/edition":"2","Encoding":"UTF-8","LazyData":"true","RoxygenNote":"7.1.1","NeedsCompilation":"no","Packaged":"2021-02-11 22:15:35 UTC; crame","Author":"Eric Cramer [aut, cre] (),\nStanford University School of Medicine [cph, fnd]","Maintainer":"Eric Cramer ","Repository":"CRAN","Date/Publication":"2021-02-15 16:50:11 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/CHOIRBM_0.0.2.tar.gz","jsonAuthors":[{"name":"Eric Cramer","email":"emcramer@stanford.edu","maintainer":true},{"name":"Stanford University School of Medicine ","email":null,"maintainer":false}],"readme":"\n\n\n# CHOIRBM\n\n\n\n\nCHOIRBM is a collection of plotting utilities for the [Collaborative\nHealth Outcomes Information Registry’s](https://choir.stanford.edu) Body\nMap (CBM). The CBM is an instrument for assessing the distribution of a\npatient’s pain, and has been validated in a paper published in [*Pain\nReports* (Scherrer et al\n2021)](https://doi.org/10.1097/pr9.0000000000000880). The package is\nbuilt on top of the popular R plotting package `ggplot2`, and returns\nplots as ggplot objects.\n\nSample of the CBM in clinical use:\n

\n\n## Installation\n\n~~You can install the released version of CHOIRBM from\n[CRAN](https://CRAN.R-project.org) with:~~ (Not on CRAN…yet)\n\n``` r\ninstall.packages(\"CHOIRBM\")\n```\n\nOr install from GitHub with:\n\n``` r\ndevtools::install_github(\"emcramer/CHOIRBM\")\nremotes::install_github(\"emcramer/CHOIRBM\")\n```\n\n## Examples\n\n### Plotting the Male CBM\n\nThis is a basic example which shows you how to plot the front and back\nparts of the male CHOIR Body Map:\n\n``` r\nlibrary(CHOIRBM)\n\n# generate some random example data\nset.seed(123)\nids <- as.character(c(seq.int(101, 136, 1), seq.int(201, 238, 1)))\nvalues <- data.frame(\n id = ids\n , value = runif(length(ids))\n , ucolors = rainbow(length(ids))\n , group = ifelse(as.numeric(ids) < 200, \"Front\", \"Back\")\n)\n\n# plot the data on the front of the CHOIR body map\nplot_male_choirbm(values, \"value\")\n```\n\n

\n\n``` r\n# plot each segment of the bodymap as a different color\nplot_male_choirbm(values, \"ucolors\")\n```\n\n

\n\n### Plotting the female CBM\n\nAnd an additional example with the female CHOIR Body Map:\n\n``` r\nlibrary(CHOIRBM)\n\n# generate some random example data\nexdata <- gen_example_data()\n\n# plot the data on the front of the CHOIR body map\nplot_female_choirbm(exdata, \"value\")\n```\n\n

\n\nCheck the vignettes for more examples such as plotting individual\npatients, highlighting specific segments, and changing color schemes.\n\n## Citations:\n\n> Scherrer, Kristen Hymel; Ziadni, Maisa S; Kong, Jiang-Tia; Sturgeon,\n> John A; Salmasi, Vafia; Hong, Juliette; Cramer, Eric; Chen, Abby L;\n> Pacht, Teresa; Olson, Garrick; Darnall, Beth D; Kao, Ming-Chih;\n> Mackey, Sean. Development and validation of the Collaborative Health\n> Outcomes Information Registry body map, PAIN Reports: January/February\n> 2021 - Volume 6 - Issue 1 - p e880 doi:\n> [10.1097/PR9.0000000000000880](https://doi.org/10.1097/pr9.0000000000000880)","jobInfo":{"package":"CHOIRBM","version":"0.0.2","parsingStatus":"success","parserVersion":1,"parsedAt":"2021-02-15T18:29:48+0000"}}

Description

Arguments

See Also