# scRepertoire <!-- badges: start --> [](https://bioconductor.org/checkResults/release/bioc-LATEST/scRepertoire) [](https://github.com/ncborcherding/scRepertoire/actions/workflows/R-CMD-check.yaml) [](https://app.codecov.io/gh/ncborcherding/scRepertoire?branch=master) [](https://www.borch.dev/uploads/screpertoire/) <!-- badges: end --> ## A toolkit for single-cell immune profiling <img align="right" src="https://www.borch.dev/uploads/screpertoire/reference/figures/screpertoire_hex.png" width="305" height="352"> ### Introduction Single-cell sequencing is an emerging technology in the field of immunology and oncology that allows researchers to couple RNA quantification and other modalities, like immune cell receptor profiling at the level of an individual cell. A number of workflows and software packages have been created to process and analyze single-cell transcriptomic data. These packages allow users to take the vast dimensionality of the data generated in single-cell-based experiments and distill the data into novel insights. Unlike the transcriptomic field, there is a lack of options for software that allow for single-cell immune receptor profiling. Enabling users to easily combine RNA and immune profiling, the scRepertoire framework supports use of 10x, AIRR, BD, MiXCR, Omniscope, TRUST4, and WAT3R single-cell clonal formats and interaction with popular R-based single-cell data pipelines. ### Applying Deep Learning to VDJ data scRepertoire is compatible and integrated with the R packages [Trex](https://github.com/ncborcherding/Trex) for deep-learning-based autoencoding of the T cell receptor and [Ibex](https://github.com/ncborcherding/Ibex) for the B cell receptor. ## Working with scRepertoire scRepertoire has a comprehensive [website](https://www.borch.dev/uploads/screpertoire/) for detailed tutorials and function information. ## Installation ### Installation of Master Branch ```R devtools::install_github("ncborcherding/scRepertoire") ``` ### Installing from Bioconductor The current version of scRepertoire is also available in the development version of Bioconductor. Important to note, the version is listed as 1.99.1 on [Bioconductor](https://bioconductor.org/packages/3.19/bioc/html/scRepertoire.html) per their version guidelines. ```R BiocManager::install(version='devel') BiocManager::install("scRepertoire") ``` ### Legacy Version 1 If you are looking for version 1 of scRepertoire - there is a static version available below: ```R devtools::install_github("ncborcherding/scRepertoire@v1") ``` ## Getting Data Unfortunately, Github limits the size of individual files. In order to access the seurat object paired with scRepertoire please download the .rda from [here](https://drive.google.com/file/d/1_YuRraDyg8UgF3oasjF0-jgPnwox-B24/view?usp=share_link). ## Please Cite Feel free to use, edit, modify scRepertoire, but if you do, please cite the [manuscript](https://f1000research.com/articles/9-47/v1). If you are building your own tool based on scRepertoire, reach out, I am happy to help and make things compatible. ## Bug Reports/New Features #### If you run into any issues or bugs please submit a [GitHub issue](https://github.com/ncborcherding/scRepertoire/issues) with details of the issue. - If possible please include a [reproducible example](https://reprex.tidyverse.org/). Alternatively, an example with the internal **scRep_example** and **contig_list** would be extremely helpful. #### Any requests for new features or enhancements can also be submitted as [GitHub issues](https://github.com/ncborcherding/scRepertoire/issues). #### [Pull Requests](https://github.com/ncborcherding/scRepertoire/pulls) are welcome for bug fixes, new features, or enhancements. ### Please Cite Feel free to use, edit, modify scRepertoire, but if you do, please cite the [manuscript](https://f1000research.com/articles/9-47/v1). If you are building your own tool based on scRepertoire, reach out, I am happy to help and make things compatible. ## Contact Questions, comments, suggestions, please feel free to contact Nick Borcherding via this repository, [email](mailto:ncborch@gmail.com), or using [twitter](https://twitter.com/theHumanBorch).