Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pwwang/immunopipe-example

An example of immunopipe
https://github.com/pwwang/immunopipe-example

immunotherapy seurat single-cell-analysis single-cell-rna-seq tcr tcr-repertoire

Last synced: 14 days ago
JSON representation

An example of immunopipe

Awesome Lists containing this project

README 

        

# Example for [immunopipe](https://github.com/pwwang/immunopipe)



In this tutorial we will show you how to run the immunopipe pipeline on a small dataset of 6 patients from 3 groups: colitis (n=2), non-colitis(n=2) and control(n=2). The dataset is part of the data used in the publication below:



- [Luoma, Adrienne M., et al. "Molecular pathways of colon inflammation induced by cancer immunotherapy." Cell 182.3 (2020): 655-671.][1]



We are using a small subset of the data to make the tutorial run faster. The full dataset can be downloaded from Gene Expression Omnibus (GEO) [GSE144469](https://www.ncbi.nlm.nih.gov/geo/query/acc.cgi?acc=GSE144469).



## Download and prepare the data



The data can be downloaded and prepared by running the following commands:



```bash

# Clone the example repository

git clone https://github.com/pwwang/immunopipe-example.git



# Enter the example directory

cd immunopipe-example



# Download and prepare the data

bash prepare-data.sh

# The data from GSE144469 (https://www.ncbi.nlm.nih.gov/geo/query/acc.cgi?acc=GSE144469)

# will be downloaded and extracted into:

#

#   ./prepared-data/C1

#   ./prepared-data/C2

#   ...

#

```



You may also check other files in the `data/` directory, especially the `samples.txt` file, which contains the sample information for the dataset we prepared above.



## Prepare the configuration file



To run the pipeline, we need to prepare a configuration file (recommended) or pass the arguments directly via command line. Here we will use the configuration file. See also [Configurations](https://pwwang.github.io/immunopipe/configurations/) for more details.



As explained in the [Configurations](https://pwwang.github.io/immunopipe/configurations/) page, we can provide a configuration file with [a minimal set of configuration items](https://pwwang.github.io/immunopipe/configurations/#minimal-configurations) to get the pipeline running. The only required configuration item is the input file for the [`SampleInfo`](https://pwwang.github.io/immunopipe/processes/SampleInfo/) process. However, here we want to give the pipeline a different name and output directory to distinguish it from other runs with a different set of configurations.



The configuration file shall be in the [TOML](https://toml.io/en/) format. We can create a file named `ImmunopipeMinimal.config.toml` with the following content:



```toml

name = "ImmunopipeMinimal"

outdir = "minimal"



[SampleInfo.in]

infile = [ "data/samples.txt" ]

```



## Run the pipeline



The easiest way to run the pipeline is to run it with docker. We can use the following command to run the pipeline with the configuration file we just created:



```bash

docker run \

    --rm -w /workdir -v .:/workdir \

    justold/immunopipe:master \

    @ImmunopipeMinimal.config.toml

```



or with singularity:



```bash

singularity run \

    --pwd /workdir -B .:/workdir,/tmp -c -e --writable-tmpfs \

    docker://justold/immunopipe:master \

    @ImmunopipeMinimal.config.toml

```



or with apptainer:



```bash

apptainer run \

    --pwd /workdir -B .:/workdir,/tmp -c -e --unsquash --writable-tmpfs \

    docker://justold/immunopipe:master \

    @ImmunopipeMinimal.config.toml

```



> [!TIP]

> `docker`, `singularity` and `apptainer` commands map the current directory (`.`) to the `/workdir` directory in the container. To get the detailed directory structure in the container, please refer to the [The directory structure in the container](https://pwwang.github.io/immunopipe/installation/#the-directory-structure-in-the-container).



> [!TIP]

> If you want to install and run the pipeline without docker, please refer to the [Installation](https://pwwang.github.io/immunopipe/installation/) and [Running the pipeline](https://pwwang.github.io/immunopipe/running/) pages for more details.



> [!NOTE]

> You need at least 16G memory to run the example with minimal configuration.



## Check the results



With that "minimal" configuration file, only a subset of the processes will be run. See also [Enabling/Disabling processes](https://pwwang.github.io/immunopipe/configurations/#enablingdisabling-processes). The results will be saved in the `minimal` directory. You can also check the reports at `minimal/REPORTS/index.html` with a web browser.



You can also visit the following link to see the reports of the pipeline we just ran:



## Next steps



You may read through the `immunopipe` [documentation](https://pwwang.github.io/immunopipe/) to learn more about the pipeline and how to configure it. There is also a configuration file, named [`Immunopipe.config.toml`][2] in the example repository, with more processes enabled. Check out the following link for the reports that you run the pipeline with the dataset prepared above. You can also add more samples to the `data/samples.txt` file and modify the configuration file to run the pipeline with more comphrehensive analyses.



> [!NOTE]

> The results provided by this example configuration files are for demonstration purpose only. They are not intended to be used for any scientific analysis.



You may also want to try other routes of the pipeline with the prepared data. These routes are defined in:



- `ImmunopipeMinimalNoTCR.config.toml`: The configuration for minimal analyses without scTCR-seq data.

- `ImmunopipeMinimalSupervised.config.toml`: The configuration for minimal analyses with supervised clustering of T cells.

- `ImmunopipeNoTCR.config.toml`: The configuration for full analyses without scTCR-seq data.

- `ImmunopipeSupervised.config.toml`: The configuration for full analyses with supervised clustering of T cells.

- `ImmunopipeWSNoTCR.config.toml`: The configuration for full analyses without scTCR-seq data, but with selection of T cells.



Also check out the [gallery][3] for more real-world examples.



[1]: https://www.cell.com/cell/fulltext/S0092-8674(20)30688-7

[2]: https://github.com/pwwang/immunopipe-example/blob/master/Immunopipe.config.toml

[3]: https://pwwang.github.io/immunopipe/gallery/