ScanNeo2

What is ScanNeo2

Scanneo2 is a snakemake workflow for the prediction of neoantigens from multiple sources. In its current state, this includes canonical-splicing, exitron-splicing, gene fusion, indels and snvs.

Getting Started

In principle, Scanneo2 aims to resolve its dependencies automatically and requires only snakemake and snakedeploy.

Prerequisites

Before installing and using ScanNeo2, make sure you have the following software installed:

1. Mamba: An open-source package manager. Mamba should be installed independently by the user.

Installation

To get started with ScanNeo2, follow the steps below:

1. Create and activate a new environment with Mamba using the environment file from the ScanNeo2 repository:

   mamba env create --file https://raw.githubusercontent.com/ylab-hi/ScanNeo2/main/environment.yml
   mamba activate scanneo2

   Note: ScanNeo2 requires Snakemake >= 8.x.x is not compatible with Snakemake <= 8.x.x. If ScanNeo2 is configured to use the exitron module, apptainer (formerly singularity) needs to be installed. For that, the environment_apptainer.yml can be used. However, most HPC servers provide their own module installation (which should be preferred)

2. Deploy ScanNeo2:

mkdir -p /path/to/your/working/directory/
cd /path/to/your/working/directory/
git clone --recurse-submodules https://github.com/ylab-hi/ScanNeo2.git
cd ScanNeo2

3. (Optional) Install HLA-HD

   ScanNeo2 employs HLA-HD for HLA Class II genotyping which is required when ScanNeo2 has been configured to predict class II neoantigens. Due to license reasons it has to be installed manually (download request). Please follow the instructions on the official website. ScanNeo2 has been tested using HLA-HD v1.7.0

3. Configure ScanNeo2 by editing the config/config.yml file. Make sure to adjust parameters to suit your needs and data.

Running the Workflow

To run the workflow, use the following command:

cd /path/to/your/working/directory/
snakemake --cores all --software-deployment-method conda 

As mentioned above, when exitron detection is activated the singularity option --software-deployment-method apptainer has to be used as well.

snakemake --cores all --software-deployment-method conda apptainer 

In addition, custom configfiles can be configured using --configfile <path/to/configfile>. In principle, this merely overwrites the default config, and should include all key/value pairs of the valid config file.

For more detailed instructions and explanations on how to use ScanNeo2, please consult the wiki.

Docker Support

For added convenience, we also provide a ready-to-use Docker Container for ScanNeo2. This container encapsulates the environment required to run ScanNeo2, making it even easier to get started.

Test data

In additon, we provided test data in .tests/integration with configuration and resulting file that can be used to test the installation

System requirements

We recommend to run ScanNeo on a system with at least 64GB

Conclusion

ScanNeo2 provides an accessible, efficient method for predicting neoantigens. Its comprehensive support for multiple sources of neoantigens, along with its ease of installation and use, make it a powerful tool for researchers in the field. Please don't hesitate to reach out with any questions or feedback - we're always looking to improve ScanNeo2.

Citation

@article{Schafer2023Nov,
	author = {Sch{\ifmmode\ddot{a}\else\"{a}\fi}fer, Richard A. and Guo, Qingxiang and Yang, Rendong},
	title = {{ScanNeo2: a comprehensive workflow for neoantigen detection and immunogenicity prediction from diverse genomic and transcriptomic alterations}},
	journal = {Bioinformatics},
	volume = {39},
	number = {11},
	pages = {btad659},
	year = {2023},
	month = nov,
	issn = {1367-4811},
	publisher = {Oxford Academic},
	doi = {10.1093/bioinformatics/btad659}
}

License

ScanNeo2 is licensed under MIT License.

Contact

If you have any issues or queries about ScanNeo2, please raise an issue on GitHub.