Bigtools

Bigtools is a library and associated tools for reading and writing bigwig and bigbed files.

The primary goals of the project are to be

• Performant
• Extensible
• Modern

Performant

Bigtools uses async/await internally to allow for efficient, multi-core computation when possible. In addition, tools are optimized for minimal memory usage. See Benchmarks for more details.

Extensible

Bigtools is designed to be as modular as possible. This, in addition to the safety and reliability of Rust, allows both flexibility and correctness as a library. In addition, its extremely easy to quickly create new tools or binaries. A number of binaries are available that parallel related existing binaries from UCSC, with drop-in compatibility for the most common flags.

Modern

Bigtools is written in Rust and published to crates.io, so binaries can be installed with cargo install bigtools or it can be used as a library by simply including it in your cargo.toml.

Library

See the bigtools 🦀 Documentation.

Example

use bigtools::bbiread::BigWigRead;

let mut reader = BigWigRead::open("test.bigWig").unwrap();
let chr1 = reader.get_interval("chr1", 0, 10000).unwrap();
for interval in chr1 {
    println!("{:?}", interval);
}

Binaries

The following binaries are available:

Renaming the bigtools binary to any of the subcommands (case-insensitive) allows you to run that subcommand directly.

The bigtools CLI binaries can be installed through crates.io (cargo install bigtools) or conda. Additionally, pre-built binaries can be downloaded through Github releases.

Python wrapper

Also included in this repo is a Python wrapper, pybigtools written using PyO3.

See the pybigtools 🐍 API Documentation.

The pybigtools package can be used as a dpendency either through pypi or conda.

Benchmarks

Benchmarks are included in the ./bench directory. They require python to run.

Multiple tools are compared against the comparable UCSC tools. For completeness, both single-threaded and multi-threaded (when available) benchmarks are included. Multiple different configuration options are benchmarked across multiple replicates, but a summar is available in the table below:

How to cite

This repository contains contains a CITATION.cff file with citation information. Github allows you to get a citation in either APA or BibTeX format; this is available in "Cite this repository" under About.