Skip to main content

tests docs PyPI PyPIDownloadsTotal Licence: MIT IsoTools Logo

IsoTools

IsoTools is a python module for Long Read Transcriptome Sequencing (LRTS) analysis.

Key features:

  • Import of LRTS bam files (aligned full length transcripts).
  • Import of reference annotation in gff3/gtf format.
  • Computation of quality control metrics.
  • Annotation and classification of novel transcripts using the biologically motivated classification scheme SQANTI.
  • Evaluation of the coding potential of isoforms.
  • Definition of alternative splicing events based on segment graphs.
  • Detection of differential alternative splicing between samples and groups of samples.
  • Gene modelling based on structural and expression variability.
  • Support for proteogenomic approaches at the interface of transcriptomics and proteomics.
  • Various data visualizations.

Documentation

The documentation, including tutorials with real-world case studies and the complete API reference is available at readthedocs

Installation

Isotools is available from PyPI, and can be installed with the pip command:

python3 -m pip install isotools

Alternatively, to install from github, use the following command:

git clone https://github.com/HerwigLab/IsoTools2.git
cd isotools
python3 -m pip install .

Usage

This code block demonstrates the basic file import with IsoTools. It uses a small test data set contained in this repository, and should run within seconds. The paths are relative to the root of the repository. For more comprehensive real world examples see the tutorials.

from isotools import Transcriptome
import logging
logging.basicConfig(format='%(levelname)s:%(message)s', level=logging.INFO)
# import the reference annotation
transcriptome = Transcriptome.from_reference('tests/data/example.gff.gz')
# import the transcriptome data
for sa in ('CTL', 'VPA'):
    transcriptome.add_sample_from_bam(f'../tests/data/example_1_{sa}.bam', sample_name=sa, group=sa, platform='SequelII')
# save the imported file as pkl file (for faster import)
transcriptome.add_qc_metrics('../tests/data/example.fa')
transcriptome.save('../tests/data/example_1_isotools.pkl')

Citation and feedback

  • If you run into any issues, please use the github issues report feature.
  • For general feedback, please write us an email to yalan_bi@molgen.mpg.de and herwig@molgen.mpg.de.
  • If you use IsoTools in your publication, please cite the following paper in addition to this repository:
    • Lienhard, Matthias et al. “IsoTools: a flexible workflow for long-read transcriptome sequencing analysis.” Bioinformatics (Oxford, England) vol. 39,6 (2023): btad364. doi:10.1093/bioinformatics/btad364
    • Bi, Yalan et al. “IsoTools 2.0: Software for Comprehensive Analysis of Long-read Transcriptome Sequencing Data.” Journal of molecular biology, 169049. 26 Feb. 2025, doi:10.1016/j.jmb.2025.169049

Metadata

Release files for isotools 2.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for isotools 2.2.0
File Size Uploaded
isotools-2.2.0.tar.gz 135.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for isotools 2.2.0
File Interpreter ABI Platform
isotools-2.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 269.7 kB

Release files / isotools-2.2.0.tar.gz

Download URL isotools-2.2.0.tar.gz
Size 135.6 kB
Tags Source
SHA-256 checksum
How to use checksums
3569eab9ca9517a803073cea54c2790a5ab9ae422490ced606dcaac0e347ad99
BLAKE2b-256 checksum
How to use checksums
443a84e80659a30dcff724548f0097cb2b2997f0e43bc818340485aeaee8659d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release files / isotools-2.2.0-py3-none-any.whl

Download URL isotools-2.2.0-py3-none-any.whl
Size 134.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fb481294b011d513f7d211d3f935f631d331850997eba34e15f56094d9136e39
BLAKE2b-256 checksum
How to use checksums
e3405296d222ecbeb002030a1af443f2d24d5151e29c840343c1c20b7e7e7ba0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release history Release notifications | RSS feed

This release

2.2.0 This release

2 release files

2.1.6

2 release files

2.1.5

2 release files

2.1.4

2 release files

2.1.3

2 release files

2.1.2

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.7

2 release files

2.0.6

2 release files

2.0.5

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.2

2 release files

0.2.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page