read5

Wrapper to read fast5, slow5, blow5 and pod5 files.

https://github.com/rnajena/read5

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.4%) to scientific vocabulary

Keywords

blow5 fast5 ont oxford-nanopore oxford-nanopore-data pod5 raw-data slow5
Last synced: 6 months ago · JSON representation ·

Repository

Wrapper to read fast5, slow5, blow5 and pod5 files.

Basic Info
Statistics
  • Stars: 13
  • Watchers: 1
  • Forks: 1
  • Open Issues: 1
  • Releases: 20
Topics
blow5 fast5 ont oxford-nanopore oxford-nanopore-data pod5 raw-data slow5
Created almost 3 years ago · Last pushed 11 months ago
Metadata Files
Readme License Citation

README.md

Alt text

  • Read5 is a python wrapper to read fast5, slow5/blow5 and pod5 files using the same overloaded functions from different APIs. PyPI - Python Version
  • Read5_ont is a python wrapper to read fast5 and pod5 files using the same overloaded functions from different APIs. PyPI - Python Version

License: GPL v3

PyPI PyPI - Downloads PyPI - Status

Anaconda-Server Badge Conda Conda package Conda package

DOI

Twitter Follow


Table of Content

  1. Installation
  2. Usage
  3. Full Documentation ___ ## Installation

Pypi/pip

bash pip install read5

Conda

Pod5 is now available via conda (19.07.2023).

bash conda create -n read5 -c jannessp read5 conda activate read5


Usage

Click here to see a full documentation about the classes and function.

my_file can be a fast5, slow5, blow5 or pod5 file. The wrapper detects the file format depending on the file extension.

Small example:

```python from read5 import read # or from read5.Reader import read

r5 = read(myfile) # file with one of these extensions: .fast5, .slow5, .blow5, .pod5 for readid in r5: signal = r5.getSignal(readid) # returns raw integer values stored in the file pAsignal = r5.getpASignal(readid) # returns pA signal normsignal = r5.getZNormSignal(readid) # returns normalized read signal: normsignal = (signal - median(signal)) / mad(signal) polyAstdSignal = r5.getPolyAStandardizedSignal(readid, polyAstart, polyAend) # returns polyA standardized read signal # default polyAMean : float = 108.901413, polyAStdev : float = 2.676522, this can be changed using the parameters channel = r5.getChannelNumber(readid) sampleid = r5.getSampleID(readid) runid = r5.getRunID(readid) # ...

readid_list = r5.getReads() ```

File Reader Classes

If you want to use the file readers you can import the corresponding class like this:

python from read5.Fast5Reader import Fast5Reader # contains the Fast5 Reader class from read5.Slow5Reader import Slow5Reader # contains the Slow5 Reader class - !not available in read5_ont! from read5.Pod5Reader import Pod5Reader # contains the Pod5 Reader class

Abstract File Reader Class

python from read5.AbstractFileReader import AbstractFileReader

Possible Exceptions

python from read5.Exceptions import UnknownFileFormatException, UnknownNormalizationMode

  • UnknownFileFormatException: is raised, when the file extension does not match one of '.fast5', '.slow5', '.blow5', '.pod5'
  • UnknownNormalizationMode: is raised, when an unknown mode is provided for the signal normalization function

Full Documentation

Created with pdoc3. Can be found here.

Owner

  • Name: RNA Bioinformatics and Highthroughput Analysis Jena
  • Login: rnajena
  • Kind: user
  • Location: Jena

Citation (CITATION.cff)

cff-version: 1.2.1
message: "If you use this software, please cite it as below."
authors:
  - family-names: "Spangenberg"
    given-names: "Jannes"
    orcid: "https://orcid.org/0000-0002-6126-411X"
title: "Read5"
version: 1.2.6
date-released: 2023-07-11
identifiers:
  - type: doi
    value: 10.5281/zenodo.10785021

GitHub Events

Total
  • Release event: 2
  • Watch event: 3
  • Push event: 7
  • Create event: 1
Last Year
  • Release event: 2
  • Watch event: 3
  • Push event: 7
  • Create event: 1

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 52 last-month
  • Total dependent packages: 1
  • Total dependent repositories: 0
  • Total versions: 12
  • Total maintainers: 1
pypi.org: read5

Wrapper to read fast5 and pod5 files.

  • Versions: 12
  • Dependent Packages: 1
  • Dependent Repositories: 0
  • Downloads: 52 Last month
Rankings
Dependent packages count: 7.5%
Downloads: 16.3%
Stargazers count: 21.7%
Average: 29.1%
Forks count: 30.2%
Dependent repos count: 69.8%
Maintainers (1)
Last synced: 6 months ago

Dependencies

setup.py pypi