Installation
------------
Pypi/pip
~~~~~~~~
.. code:: bash
pip install read5
Conda
~~~~~
Pod5 is now available via `conda <https://anaconda.org/jannessp/pod5>`__ (19.07.2023).
.. code:: bash
conda install mamba
mamba create -n read5 -c jannessp read5
conda activate read5
Alternatively you can create the environment using the
`conda.recipe/env.yml <conda.recipe/env.yml>`__ file.
.. code:: bash
conda install mamba
mamba env create -f conda.recipe/env.yml
conda activate read5
--------------
Usage
-----
`Click here to see a full documentation about the classes and
function. <https://jannessp.github.io/read5.github.io/>`__
*my_file* can be a fast5, slow5, blow5 or pod5 file. The wrapper detects
the file format depending on the file extension.
Small example:
~~~~~~~~~~~~~~
.. code:: python
from read5 import read # or from read5.Reader import read
r5 = read(my_file) # file with on of these extensions: .fast5, .slow5, .blow5, .pod5
for readid in r5:
signal = r5.getSignal(readid) # returns raw integer values stored in the file
pA_signal = r5.getpASignal(readid) # returns pA signal
norm_signal = r5.getZNormSignal(readid) # returns normalised read signal: norm_signal = (signal - median(signal)) / mad(signal)
polyAstdSignal = r5.getPolyAStandardizedSignal(readid, polyAstart, polyAend) # returns polyA standardized read signal
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:
.. code:: python
from read5.Fast5Reader import Fast5Reader # contains the Fast5 Reader class
from read5.Slow5Reader import Slow5Reader # contains the Slow5 Reader class
from read5.Pod5Reader import Pod5Reader # contains the Pod5 Reader class
Abstract File Reader Class
~~~~~~~~~~~~~~~~~~~~~~~~~~
.. code:: python
from read5.AbstractFileReader import AbstractFileReader
Possible Exceptions
~~~~~~~~~~~~~~~~~~~
.. code:: 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 <https://pdoc3.github.io/pdoc/>`__. Can be found
`here <https://jannessp.github.io/read5.github.io/>`__.
Raw data
{
"_id": null,
"home_page": "https://github.com/JannesSP/read5",
"name": "read5",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.8",
"maintainer_email": null,
"keywords": "read5, slow5, blow5, fast5, pod5, ONT, Oxford Nanopore Technologies, Nanopore, raw data, wrapper",
"author": "Jannes Spangenberg",
"author_email": "jannes.spangenberg@uni-jena.de",
"download_url": "https://files.pythonhosted.org/packages/82/8d/5d69f698f3bbb65e6c6741ad0e839702a98840a5e49e776d181cecc6b8d7/read5-1.2.5.tar.gz",
"platform": null,
"description": "Installation\n------------\n\nPypi/pip\n~~~~~~~~\n\n.. code:: bash\n\n pip install read5\n\nConda\n~~~~~\n\nPod5 is now available via `conda <https://anaconda.org/jannessp/pod5>`__ (19.07.2023).\n\n.. code:: bash\n\n conda install mamba\n mamba create -n read5 -c jannessp read5\n conda activate read5\n\nAlternatively you can create the environment using the\n`conda.recipe/env.yml <conda.recipe/env.yml>`__ file.\n\n.. code:: bash\n\n conda install mamba\n mamba env create -f conda.recipe/env.yml\n conda activate read5\n\n--------------\n\nUsage\n-----\n\n`Click here to see a full documentation about the classes and\nfunction. <https://jannessp.github.io/read5.github.io/>`__\n\n*my_file* can be a fast5, slow5, blow5 or pod5 file. The wrapper detects\nthe file format depending on the file extension.\n\nSmall example:\n~~~~~~~~~~~~~~\n\n.. code:: python\n\n from read5 import read # or from read5.Reader import read\n\n r5 = read(my_file) # file with on of these extensions: .fast5, .slow5, .blow5, .pod5\n for readid in r5:\n signal = r5.getSignal(readid) # returns raw integer values stored in the file\n pA_signal = r5.getpASignal(readid) # returns pA signal\n norm_signal = r5.getZNormSignal(readid) # returns normalised read signal: norm_signal = (signal - median(signal)) / mad(signal)\n polyAstdSignal = r5.getPolyAStandardizedSignal(readid, polyAstart, polyAend) # returns polyA standardized read signal\n channel = r5.getChannelNumber(readid)\n sampleid = r5.getSampleID(readid)\n runid = r5.getRunID(readid)\n\n readid_list = r5.getReads()\n\nFile Reader Classes\n~~~~~~~~~~~~~~~~~~~\n\nIf you want to use the file readers you can import the corresponding\nclass like this:\n\n.. code:: python\n\n from read5.Fast5Reader import Fast5Reader # contains the Fast5 Reader class\n from read5.Slow5Reader import Slow5Reader # contains the Slow5 Reader class\n from read5.Pod5Reader import Pod5Reader # contains the Pod5 Reader class\n\nAbstract File Reader Class\n~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n from read5.AbstractFileReader import AbstractFileReader\n\nPossible Exceptions\n~~~~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n from read5.Exceptions import UnknownFileFormatException, UnknownNormalizationMode\n\n- UnknownFileFormatException: is raised, when the file extension does\n not match one of [\u2018.fast5\u2019, \u2018.slow5\u2019, \u2018.blow5\u2019, \u2018pod5\u2019]\n- UnknownNormalizationMode: is raised, when an unknown mode is provided\n for the signal normalization function\n\nFull Documentation\n------------------\n\nCreated with `pdoc3 <https://pdoc3.github.io/pdoc/>`__. Can be found\n`here <https://jannessp.github.io/read5.github.io/>`__.\n",
"bugtrack_url": null,
"license": "GNU General Public License v3",
"summary": "Wrapper to read fast5, slow5, blow5 and pod5 files.",
"version": "1.2.5",
"project_urls": {
"Homepage": "https://github.com/JannesSP/read5"
},
"split_keywords": [
"read5",
" slow5",
" blow5",
" fast5",
" pod5",
" ont",
" oxford nanopore technologies",
" nanopore",
" raw data",
" wrapper"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "78691135c1e9fcb5ca6a7d0f8d9e3d43bfcc511c7ffda4f39c920c9d0e3c44c8",
"md5": "30522bf5a125fbd898f5df5565ff51b6",
"sha256": "40984491bb0b3799883930a9fa0821b7248c7a5810aaac6c1304512dc39b50fb"
},
"downloads": -1,
"filename": "read5-1.2.5-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "30522bf5a125fbd898f5df5565ff51b6",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": "<3.13,>=3.8",
"size": 26960,
"upload_time": "2024-11-27T09:43:14",
"upload_time_iso_8601": "2024-11-27T09:43:14.121148Z",
"url": "https://files.pythonhosted.org/packages/78/69/1135c1e9fcb5ca6a7d0f8d9e3d43bfcc511c7ffda4f39c920c9d0e3c44c8/read5-1.2.5-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "828d5d69f698f3bbb65e6c6741ad0e839702a98840a5e49e776d181cecc6b8d7",
"md5": "879246130558154ed99104df217d79bf",
"sha256": "b30c8681037ae0f5e4242583d68259f9e93c51cca5b16d9f27183e6e26bcf9bf"
},
"downloads": -1,
"filename": "read5-1.2.5.tar.gz",
"has_sig": false,
"md5_digest": "879246130558154ed99104df217d79bf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.8",
"size": 1545040,
"upload_time": "2024-11-27T09:43:19",
"upload_time_iso_8601": "2024-11-27T09:43:19.525167Z",
"url": "https://files.pythonhosted.org/packages/82/8d/5d69f698f3bbb65e6c6741ad0e839702a98840a5e49e776d181cecc6b8d7/read5-1.2.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-27 09:43:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "JannesSP",
"github_project": "read5",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "read5"
}
JSON
