yasim-sctcr 0.1.0

yasim_sctcr -- Yet Another SIMulator for Single-Cell T-Cell Receptor Sequencing (scTCR-Seq)

yasim_sctcr -- Yet Another SIMulator for Single-Cell T-Cell Receptor Sequencing (scTCR-Seq)

Markdown compatibility guide This file is written in Myst-flavored Markdown, and may show errors on the default landing page of PYPI or Git Hostings. You can correctly preview it on generated Sphinx documentation or Visual Studio Code with ExecutableBookProject.myst-highlight plugin.

---

Introduction

Single-Cel T-Cell Receptor (TCR) Sequencing (scTCR-Seq) is an important method in studying the diversity and dynamics of T-cell populations in organisms. However, since number of publically available scTCR-Seq datasets are limited, researchers often needs to reconstruct TCR contigs from scRNA-Seq data, and a benchmark of such tools is required.

This software provides an easy way to simulated Next-Generation Sequencing (NGS)-based scTCR-Seq using Illumina sequencer simulator. With realistic TCR contig constructed from statistics of 1.08 million human TCR V/J CDR3 sequences from hUARdb, it supports simulation of TCR contigs from arbitrary cell number, sequencing depth, read length with Paired/Single End support. It also supports mixing scTCR-Seq data with simulated scRNA-Seq data, which allows calculation of both precision and sensitivity.

Installation

Using the Pre-Built Version from PYPI

You need a working Python interpreter (CPython implementation) >= 3.7 (recommended 3.8) and the latest pip to install this software from PYPI. Command:

pip install yasim-sctcr==0.1.0

You are recommended to use this application inside a virtual environment like venv, virtualenv, pipenv, conda, or poetry.

Build from Source

Before building from the source, get a copy of the latest source code from https://github.com/WanluLiuLab/yasim using Git:

git clone https://github.com/WanluLiuLab/yasim-sctcr

Or, if you prefer to use GNU Wget.

wget -o yasim-master.zip https://github.com/WanluLiuLab/yasim-sctcr/archive/refs/heads/master.zip
unzip yasim-master.zip

You need Python interpreter (CPython implementation) >= 3.7, latest PYPA build, and setuptools to build this software. You are recommended to build the software in a virtual environment provided by virtualenv, etc.

Build and install the simulator using:

cd yasim-sctcr
python3 -m build
pip install dist/yasim-sctcr-0.1.0-py3-none-any.whl

Apart from above instructions, you should also install ART which is a general-purpose NGS DNA-Seq simulator and is available from Conda and APT. Tested versions are 2.5.8 (June 6, 2016).