slow5

Crates.ioslow5
lib.rsslow5
version0.11.0
sourcesrc
created_at2022-03-22 03:19:17.099668
updated_at2023-09-04 04:55:58.59999
descriptionLibrary for interacting with slow5
homepagehttps://github.com/hasindu2008/slow5lib
repositoryhttps://github.com/bsaintjo/slow5-rs
max_upload_size
id554457
size3,878,500
Brandon Saint-John (bsaintjo)

documentation

https://docs.rs/slow5

README

slow5-rs

License Crates.io docs.rs Rust Stability codecov

A library for interacting with SLOW5/BLOW5 files in rust. Not official.

For more information checkout the main slow5lib repository.

Note: Library design is in flux and care should be taken in upgrading this crate.

Installation

Add the following to your Cargo.toml:

[dependencies]
slow5 = "0.11"

Git

If you'd like to download the git version, use the following command to download the repo

git clone --recursive https://github.com/bsaintjo/slow5-rs.git

Getting started

Reading signal from SLOW5 file

use slow5::{FileReader, RecordExt};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut slow5 = FileReader::open("examples/example.slow5").unwrap();
    for record in slow5.records() {
        for signal in record?.picoamps_signal_iter() {
            // Do stuff
        }
    }
    Ok(())
}

Writing a compressed BLOW5 file with attributes

use std::error::Error;
use slow5::{FileWriter, SignalCompression, Record};

fn main() -> Result<(), Box<dyn Error>> {
    let tmp_dir = std::env::temp_dir();
    let output = tmp_dir.join("test.blow5");
    let mut writer = FileWriter::options()
        .signal_compression(SignalCompression::StreamVByte)
        .attr("attribute", "value", 0)
        .create(output)?;
    let rec = Record::builder()
        .read_id("test_id")
        .read_group(0)
        .digitisation(4096.0)
        .offset(4.0)
        .range(12.0)
        .sampling_rate(4000.0)
        .raw_signal(&[0, 1, 2, 3])
        .build()?;
    writer.add_record(&rec)?;
    writer.close();
    Ok(())
}

More example code

For more example code, see the test code. Several examples from the original library have been ported to rust and can be found in the examples directory.

Feature flags

  • zstd: Enable zstd-based compression (enabled by default)
  • zlib-ng: Enable usage of high performance zlib-ng, adds cmake dependency
  • serde: Enable serde dependency (mainly for serializing Record)

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Commit count: 244

cargo fmt