Skip to content

lilab-bcb/cumulus_feature_barcoding

Repository files navigation

Cumulus Tool on Feature Barcoding

A fast C++ tool to extract feature-count matrix from sequence reads in FASTQ files. We uses isal-l for decompressing and Heng Li's kseq library for read parsing. It is used by Cumulus for feature-count matrix generation of cell hashing, nucleus hashing, CITE-Seq and Perturb-seq protocols, using either 10x Genomics V2 or V3 chemistry.

Installation

The installation has been tested on Debian and Ubuntu Linux.

  1. Install dependency packages:
sudo apt install build-essential git libisal2 libisal-dev libdeflate0 libdeflate-dev

Important: Make sure to install libisal2 and libisal-dev version 2.30.0 or later.

  1. Check out this repository via Git:
git clone https://github.com/lilab-bcb/cumulus_feature_barcoding.git
  1. Enter the directory and compile:
cd cumulus_feature_barcoding
make all
  1. Now you'll have an executable named generate_count_matrix_ADTs inside your folder. Type
./generate_count_matrix_ADTs

to see its usage.

Compile on Mac OS

  1. Homebrew installation
brew install isa-l
brew install libdeflate
  1. Compile
cd cumulus_feature_barcoding
make all

Usage