A R Shiny app of the transcriptome atlas of the maturing zebrafish telencephalon
The app provides a user-friendly approach to explore the single-cell data from the maturing zebrafish telencephalon across the 6dpf, 15dpf and adult ages (integrated and individual age-specific datasets). The general functionality of the app includes:
- Searchable browser for genes/features to be plotted as violin plots and feature plots.
- Dot plots of features (maximum number of features set to 60 as a sensible default linked to width of the plot)
- User choices to split the integrated dataset per age, download figures (png/pdf) and plot a subset of clusters of interest.
An overview of the tab which contains the integrated dataset (split per age) can be seen below:
The app, along with all dependencies have been containerized with Docker and is hosted in the following Docker Hub repository: https://hub.docker.com/r/uabbds/zebrafish_telencephalon_atlas_app
Overall, the user needs to 1. install Docker 2. follow the instructions below for deployment.
⚠️ NOTE for Windows users: please ensure you install Docker with admin privileges (Run as administratoroption) and have the WSL 2 Linux Kernel installed. See more directions on Docker for Windows in the docs. General familiarity with setting Docker resources is strongly encouraged - e.g.:.wslconfigfile and use of thedocker run -mflag to set memory limit (-m 6000m)
⚠️ NOTE for Mac users with M1 chip: rocker/rstudio images do not currently work with arm Macs/Macs with the M1 chip. This is a known issue from the rocker group and is expected to be solved in 2023. Macs without the M1 chips work perfectly fine.
To run the container, run the following command:
docker run -a STDOUT --rm --user shiny -p 3838:3838 -v ${PWD}:/var/log/shiny-server uabbds/zebrafish_telencephalon_atlas_app:latest
Open your browser, and go to the following localhost http://localhost:3838 . Loading times are variable on your computer (OS should follow recommended specs by Docker). Log statements have been added to the app to provide users with progress. Once the command above is executed, you may see the following:
[2023-07-26T20:27:51.241] [INFO] shiny-server - Shiny Server v1.5.21.1007 (Node.js v16.20.0)
[2023-07-26T20:27:51.243] [INFO] shiny-server - Using config file "/etc/shiny-server/shiny-server.conf"
[2023-07-26T20:27:51.292] [INFO] shiny-server - Starting listener on http://[::]:3838
[2023-07-26T20:28:10.208] [INFO] shiny-server - created bookmark state directory: /var/lib/shiny-server/bookmarks
[2023-07-26T20:28:10.209] [INFO] shiny-server - created user bookmark state directory: /var/lib/shiny-server/bookmarks/shiny
[2023-07-26T20:28:11.101] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:11 UTC) LOG: Loading packages.
...# truncated for example
[2023-07-26T20:28:16.850] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:16 UTC) LOG: All packages loaded.
[2023-07-26T20:28:16.874] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:16 UTC) LOG: Reading in integrated forebrain RDS.
[2023-07-26T20:28:18.541] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:18 UTC) LOG: Reading in dpf6 RDS.
[2023-07-26T20:28:19.389] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:19 UTC) LOG: Reading in dpf15 RDS.
[2023-07-26T20:28:20.159] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:20 UTC) LOG: Reading in adult RDS.
[2023-07-26T20:28:20.721] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:20 UTC) LOG: All RDS data has been loaded.
[2023-07-26T20:28:20.726] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:20 UTC) LOG: Reading in integrated forebrain cluster names.
[2023-07-26T20:28:21.089] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:21 UTC) LOG: Reading in dpf6 cluster names.
[2023-07-26T20:28:21.124] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:21 UTC) LOG: Reading in dpf15 cluster names.
[2023-07-26T20:28:21.131] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:21 UTC) LOG: Reading in adult cluster names.
[2023-07-26T20:28:21.138] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:21 UTC) LOG: All cluster names have been loaded.
[2023-07-26T20:28:21.138] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:21 UTC) LOG: Initializing UI.
[2023-07-26T20:28:21.139] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:21 UTC) LOG: UI Initialized.
[2023-07-26T20:28:21.139] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:21 UTC) LOG: Initializing Session.
[2023-07-26T20:28:21.139] [INFO] shiny-server - [/srv/shiny-server:17] (2023-07-26 20:28:21 UTC) LOG: Session Initialized.
Further, a copy of the log can also be found in the current working directory which should be mounted in the docker run command displayed above. If an issue is found, please inspect the log file (file with pattern shiny-server-shiny-*.log)
Shristi Pandey, Anna J. Moyer and Summer B. Thyme. (Genome Research, April, 2023). A single-cell transcriptome atlas of the maturing zebrafish telencephalon DOI: https://doi.org/10.1101/gr.277278.122