KirstLab / asc_seurat

GNU General Public License v3.0
23 stars 9 forks source link

License: GPL v3 readthedocs DOI

Asc-Seurat

Analytical single-cell Seurat-based web application


See the documentation »

Report Bug · Request Feature

About Asc-Seurat

Asc-Seurat (Analytical single-cell Seurat-based web application) is a web application based on Shiny. Pronounced as “ask Seurat”, it provides a click-based, easy-to-install, and easy-to-use interface that allows the execution of all steps necessary for scRNA-seq analysis. It integrates many of the capabilities of the Seurat and Dynverse and also allows an instantaneous functional annotation of genes of interest using BioMart.

Asc-Seurat workflow overview.

Prerequisites

To install Asc-Seurat, you need to have Docker installed on your machine. Docker needs to be properly installed and configured in the user's machine. Check the installation instructions provided by Docker at https://docs.docker.com/engine/install.

Release notes

:warning: WARNING
Please be aware that Asc-Seurat uses multiple R packages and that many of those are in continuous development. While the docker version of Asc-Seurat is stable, it may become outdated as the packages on wich it relies on are updated. Here you can find a list of the packages used by Asc-Seurat and their versions.

Installation

Download Asc-Seurat's docker image.

    # Download the docker image:
    docker pull kirstlab/asc_seurat

Quickstart

# Starts Asc-Seurat on MacOS or Linux
docker run -v $(pwd):/app/user_work -v /var/run/docker.sock:/var/run/docker.sock -d --name Asc_Seurat --rm -p 3838:3838 kirstlab/asc_seurat

# Starts Asc-Seurat using Windows CMD
docker run -v %cd%:/app/user_work -v /var/run/docker.sock:/var/run/docker.sock -d --name Asc_Seurat --rm -p 3838:3838 kirstlab/asc_seurat

# Starts Asc-Seurat using Windows Powershell
docker run -v ${PWD}:/app/user_work -v /var/run/docker.sock:/var/run/docker.sock -d --name Asc_Seurat --rm -p 3838:3838 kirstlab/asc_seurat

:heavy_check_mark: Then, open your preferred web browser and paste the address http://localhost:3838/

Usage

Please, visit https://asc-seurat.readthedocs.io/en/latest/ for a complete documentation.

Reference

Pereira WJ, Almeida FM, Balmant KM, Rodriguez DC, Triozzi PM, Schmidt HW, Dervinis C, Pappas Jr. GJ, Kirst M. Asc‑Seurat: analytical single‑cell Seurat‑based web application. BMC Bioinformatics 22, 556 (2021).

Pereira WJ, Almeida FM, Balmant KM, Rodriguez DC, Triozzi PM, Schmidt HW, Dervinis C, Pappas Jr. GJ, Kirst M. Asc-Seurat – Analytical single-cell Seurat-based web application. biorxiv, 2021.

License

Distributed under the GNU General Public License v3.0. See LICENSE for more information.