Skip to main content

extracTR

Introduction

extracTR is a tool for identifying and analyzing tandem repeats in genomic sequences. It works with raw sequencing data (FASTQ) or assembled genomes (FASTA), using k-mer based approaches to detect repetitive patterns efficiently.

Features

  • Efficient tandem repeat detection from raw sequencing data
  • Support for single-end and paired-end FASTQ files
  • Support for genome assemblies in FASTA format
  • Customizable parameters for fine-tuning repeat detection
  • Output in easy-to-analyze CSV format
  • Multi-threaded processing for improved performance

Requirements

  • Python 3.7 or later
  • Jellyfish 2.3.0 or later
  • Conda (for easy environment management)

Installation

We recommend installing extracTR in a separate Conda environment to manage dependencies effectively.

  1. Create a new Conda environment:
conda create -n extractr_env python=3.9
  1. Activate the environment:
conda activate extractr_env
  1. Install Jellyfish:
conda install -c bioconda jellyfish
  1. Install extracTR using pip:
pip install extracTR

To deactivate the environment when you're done:

conda deactivate

Usage

Before running extracTR, ensure that you have removed adapters from your sequencing reads and activated the Conda environment:

conda activate extractr_env

Basic usage:

For paired-end FASTQ files:

extracTR -1 reads_1.fastq -2 reads_2.fastq -o output_prefix -c 30

For single-end FASTQ file:

extracTR -1 reads.fastq -o output_prefix -c 30

For genome assembly in FASTA format:

extracTR -f genome.fasta -o output_prefix -c 30

Advanced usage with custom parameters:

extracTR -1 reads_1.fastq -2 reads_2.fastq -o output_prefix -t 64 -c 30 -k 25

Options:

  • -1, --fastq1: Input file with forward DNA sequences in FASTQ format
  • -2, --fastq2: Input file with reverse DNA sequences in FASTQ format (optional for paired-end data)
  • -f, --fasta: Input genome assembly in FASTA format
  • -o, --output: Prefix for output files
  • -t, --threads: Number of threads to use (default: 32)
  • -c, --coverage: Coverage to use for indexing (required)
  • -k, --k: K-mer size to use for indexing (default: 23)
  • --lu: Coverage cutoff for k-mers (default: 100 * coverage)

Note: You must provide either FASTQ file(s) or a FASTA file as input.

Output

extracTR generates the following output files:

  • {output_prefix}.csv: Main output file containing detected tandem repeats
  • {output_prefix}.sdat: Intermediate file with k-mer frequency data
  • Additional files for detailed analysis and debugging

Metadata

Release files for extracTR 0.2.20

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

Source distribution (sdist)

Source distribution for extracTR 0.2.20
File Size Uploaded Provenance
extracTR-0.2.20.tar.gz 15.7 kB Without provenance Details

Release files / extracTR-0.2.20.tar.gz

Download URL extracTR-0.2.20.tar.gz
Size 15.7 kB
Tags Source
SHA-256 checksum
How to use checksums
86d33014a9a4ef09f53413c1c341acbf50a9f27cd3128f38076aed1d5dd291e7
BLAKE2b-256 checksum
How to use checksums
f157fddd46329008879f65cf11d60d21de1c21a3ec80b886210fb14874491a68
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.19

Security for extracTR 0.2.20

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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