Package: yasim
YASIM -- Yet Another SIMulator for Alternative Splicing Events and Realistic Gene Expression ProfileMarkdown compatibility guideThis file is written inMyst-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 orVisual Studio CodewithExecutableBookProject.myst-highlightplugin.Badages:URLs:PYPI,GitHub,Documentation.With the development of Third-Generation Sequencing (TGS) and related technologies, accurate quantification of transcripts in the isoform level with precise detection of novel isoforms from Alternative Splicing (AS) events or relocation of Transposable Elements (TEs) had become possible. YASIM is the tool that simulates Next- or Third-Generation bulk RNA-Sequencing raw FASTQ reads with ground truth genome annotation and realistic gene expression profile (GEP). It can be used to benchmark tools that are claimed to be able to detect isoforms (e.g.,StringTie) or quantify reads on an isoform level (e.g.,featureCounts).YASIM serves different simulation purposes. For example, it can be used to simulate a count matrix from reference genome annotation or to simulate raw FASTQ reads from a user-provided count matrix. When combined with other tools, the user can also simulate reads from the genome with Single Nucleotide Polymorphism (SNP), Insertions & Deletions (InDels), Structural Variations (SVs), and other genomic variations.YASIM cannot generate machine noises for each sequencer, and third-party DNA- or RNA-Seq simulators (Referred to as Low-Level Read generators, LLRGs) are needed to convert cDNA sequences to reads with machine errors and quality information (Except PacBio Sequel/Sequel II model). This gives YASIM extreme flexibility over sequencer models. Till now, YASIM can simulate most Illumina NGS sequencers and most PacBio/ONT TGS sequencing platforms.YASIM is designed to be modularized, as some of the modules are general-purpose and can be used in other simulation tasks. Implemented in Python 3, YASIM follows Object-Oriented Programming (OOP) styles and can be easily extended. Theoretically, YASIM can run on any platform that supports Python3. However, most LLRG are POSIX-only (i.e., work on GNU/Linux, MacOS, and friends). So it is recommended to deploy this tool inside major GNU/Linux distributions like Ubuntu, Debian, CentOS, Fedora, etc. Using YASIM on Microsoft Windows Subsystem of Linux (WSL), version 1 or 2, isNOTrecommended -- It would lead to impaired performance and may cause other problems due to LLRG incompatibilities. Using YASIM on other platforms (e.g., Oracle Solaris) is neither tested nor recommended.InstallationUsing the Pre-Built Version from PYPIYou need a workingPythoninterpreter (CPython implementation) >= 3.7 (recommended 3.8) and the latestpipto install this software fromPYPI. Command:pipinstallyasim==3.2.0You are recommended to use this application inside a virtual environment likevenv,virtualenv,pipenv,conda, orpoetry.Build from SourceBefore building from the source, get a copy of the latest source code fromhttps://github.com/WanluLiuLab/yasimusingGit:gitclonehttps://github.com/WanluLiuLab/yasimOr, if you prefer to useGNU Wget.wget-oyasim-master.ziphttps://github.com/WanluLiuLab/yasim/archive/refs/heads/master.zip
unzipyasim-master.zipYou need Python interpreter (CPython implementation) >= 3.7, latest PYPAbuild, andsetuptoolsto build this software. You are recommended to build the software in a virtual environment provided byvirtualenv, etc.Build and install the simulator using:cdyasim
python3-mbuild
pipinstalldist/yasim-3.2.0-py3-none-any.whlInstallation of Third-Party ProgramsFor TGS LLRGs:PBSIM, which simulates PacBio RS C1 and C2 chemistries, with CCS support.PBSIM2, which simulates PacBio RS II P4C2, P5C3, and P6C4 chemistry, CLR only; ONT R9.4, R9.5, and R10.3 pore.PBSIM3, which simulates PacBio RS II and Sequel model, with CCS support.BadRead, which simulates arbitrary PacBio and ONT models.For NGS LLRGs:ART, which simulates various Illumina NGS platforms. Namely, GenomeAnalyzer I, GenomeAnalyzer II, HiSeq 1000, HiSeq 2000, HiSeq 2500, HiSeqX PCR free, HiSeqX TruSeq, MiniSeq TruSeq, MiSeq v3, NextSeq500 v2.DWGSIM, which simulates arbitrary Illumina models.You may refer to theLLRG tutorialfor detailed guidance on the utilization of these pieces of software.