R Shiny and web-based tool for comparison of annotations such as (i) cell type assignments, (ii) donor metadata (e.g., donor, sex, age), and (iii) cell metadata (e.g., anatomic location, QC metrics). Two primary use cases are (1) comparing user-defined clustering results and mapping results (e.g., after running MapMyCells) for the same set of cells and (2) comparing cell type names between different taxonomies on Allen Brain Map. Additionally, ACE includes a data set comparing cell type names and associated abudance changes between multiple published studies of Alzheimer's disease in dorsolateral prefrontal cortex (see visualizations far below).
Quick start: try the web-based version of ACE or read the ACE preprint on bioRxiv.
We recommend using the version of this tool hosted on shinyapps.io.
For power users, this tool can also be run locally in R Studio by following the steps below.
(You only need do this step once).
- Install R (ideally version 4.2.2)
- Install RStudio
- Download the files from this repo in a working directory
- Set up your R environment to align with the renv.lock file
We recommend using rig for R installation management along with renv for R environment management. After installing rig, you should be able to run these rig commands in a terminal from your working directory to tackle steps #1 and #4:
rig add 4.2.2
rig add rtools42
rig rstudio renv.lock
This should set up and then launch RStudio with the correct package configurations. (The first two lines of code only need to be run once).
- In RStudio, open the file
ui.Rand click the "Run App" button in the upper right corner of the screen - Explore!
The only difference between local and web versions is that the local version can point to locations on your local computer (which in most cases is unnecessary as these can be uploaded on the web version).
Please share any comments, suggestions, bugs, or any other thoughts using the button in the app, or by submitting an issue.
The license for this package is available on Github at: https://github.com/AllenInstitute/ACE/blob/master/LICENSE
We are actively updating this tool. Community involvement is encouraged through both issues and pull requests.
ACE is supported by the National Institute of Neurological Disorders and Stroke under Award Number U24NS133077 and by the National Institute On Aging under Award Number U19AG060909. The content is solely the responsibility of the authors and does not necessarily represent the official views of the National Institutes of Health.