Package: singlecellmultiomics
Single cell multi omicsSingle cell multi omics is a set of tools to deal with multiple measurements from the same cell. This package has been developed by thevan Oudenaarden group.Installationpip install singlecellmultiomicsFor creating a virtual environment lookhereUsagedemux.py:
This tool demultiplexes raw fastq files, adapters, molecule and cell information are removed from the fastq records and encoded into the read name including their base-calling qualities.
Additional stored inforation includes:Assigned and raw illumina indexLibraryDemultiplexing strategy used for demultiplexing (What kind of data the read is derived from)Assigned barcode indexThe next step is usually to trim and then map the demultiplexed reads.For RNA seq data aligned to a transcriptome the step after this is to run featureCounts.The mapped reads are encoded in a BAM file. This BAM file still contains the encoded data and this has to be decoded in order to get a useful BAM file.bamtagmultiome.pyRecodes the original read names and extracts all information previously encoded by the demultiplexer.Adds allele information. (A VCF file is required for this)Supports multiple protocols:
RNA:CELSEQ1, CELSEQ2, VASA (with 8 and 6bp UMI),
methylation digest sequencing:SC MSPJI ,lineage tracing:SCARTRACE,
DNA digest sequencing: NLAIII,
histone modification sequencing: scCHIC,
Single cell methylation : TAPs (in combination with any other supported protocol).Assigns reads to molecules to allow for deduplication, adds duplication BAM flagAssigns read groupsSplits libraries where multiple modalities are measuredEstimates consensus sequences of moleculesAll SAM tags used and written by this package are listed inTAGS.MDbamToCountTable.pyExtracts a count table from a bam file, look here for examples.libraryStatistics.pyAll statistics plots can be generated with a single script, look here for details.Examples:Demultiplex all fastq.gz files in the current directory using NLAIII barcodesdemux.py *.fastq.gz -use NLAIII384C8U3 --yDemultiplex only the specified sequencing index (GTTTGA), and everything 1 hamming distance away from GTTTGA  :demux.py -si GTTTGA *.gz --y --hdi 1API: Using SingleCellMultiOmics from pythonAll molecule and fragment information can be accessed using pythonDocumentation for the classes in available herescCHICFor every fragment in input.bam find scCHIC seq fragments and deduplicate these. Fragments with the same cell barcode, umi, library and strand and starting within a range of 5 bp from each other are assigned as duplicate. The mnase cut site location is expected to be between the first base (Usually an A) this A is part of the sequencing adapter, and the second base (Usually a T). The cut site location is recorded into the DS tag. When alleles are specified using -alleles, the molecule assignment is split up by allele, this means that if two fragments map to the same location and share the same umi, but contain SNPs which indicate differing alleles, the reads are not assigned to the same molecule. For every fragment the ligation sequence is recorded into the RZ tag.bamtagmultiome.py input.bam -method chic -o tagged.bamComplete scCHIC data processing instructions from FastQ to count table hereNlaIIIFor every fragment in input.bam find NLAIII seq fragments and deduplicate these. Fragments with the same cell barcode, umi, library and strand are assigned as duplicate. The NlaIII cut site location is recorded into the DS tag. When alleles are specified using -alleles, the molecule assignment is split up by allele, this means that if two fragments map to the same location and share the same UMI, but contain SNPs which indicate differing alleles, the reads are not assigned to the same molecule. For every fragment the sequenced part of the NlaIII cut site sequence is recorded into the RZ tag, this is usually CATG, but is allowed to be shifted 1 base to ATG. In the NlaIII protocol a reverse transcription (RT) is used, generally capturing more reverse transcription reactions will yield a more accurate molecule consensus sequence. For every fragment which support the molecule the reverse transcription reaction is recorded by storing the location of the random primer used for RT and the sequence of the random primer.bamtagmultiome.py input.bam -method nla -o tagged.bamComplete NlaIII data processing instructions from FastQ to count table herePlate visualisationShow relative abundance of reads and unique molecules across 384 well plate.bamPlateVisualisation.py tagged.bam -o ./plate_plotsCreates the folder ./plate_plots containingraw_reads_[LIBRARY_TYPE]_[LIBRARY_NAME].png # Distribution of total reads
usable_reads_[LIBRARY_TYPE]_[LIBRARY_NAME].png # Distribution of reads which can be assigned to a molecule
unique_reads_[LIBRARY_TYPE]_[LIBRARY_NAME].png # Distribution of unique readsAll statistics plots can be generated with a single script, look here for details.Create a contig by sample matrix and divide counts when reads are multimapping. (Used for counting transcriptome mapped reads)bamToCountTable.py -featureTags chrom -sampleTags SM --divideMultimapping --dedup ./tagged/STAR_mappedAligned.sortedByCoord.out.bam -o transcriptome_counts.csvObtain sample, chromosome, restrictionsite, read start, and read end from test.bam file:bamTabulator.py -featureTags SM,reference_name,DS,reference_start,reference_end test.bamList all available tags:bamTabulator.py test.bamYou can additionaly use any of the pysam read attributes