Skip to main content

Blast-Besties

Rapid discovery of reciprocal best blast pairs from BLAST output files.

Table of contents

Install Blast-Besties

There are 3 options available for installing Blast-Besties locally:

  1. Install from PyPi.
pip install blastbesties
  1. Pip install latest development version directly from this git repository.
pip install git+https://github.com/Adamtaranto/blast-besties.git
  1. Clone from this repository and install as a local Python package if you want to edit the code.
git clone https://github.com/Adamtaranto/blast-besties.git && cd blast-besties && pip install -e ".[tests]"

Example usage

Run BLASTp for each protein set AvsB and BvsA. Require vaild alignments to cover 90% of the query sequence and with an e-value of < 0.001.

blastp -qcov_hsp_perc 90 -query A_prot.fa -subject B_prot.fa -out AvB.tab -evalue 0.001 -outfmt 6 -use_sw_tback
blastp -qcov_hsp_perc 90 -query B_prot.fa -subject A_prot.fa -out BvA.tab -evalue 0.001 -outfmt 6 -use_sw_tback

Report reciprocal best match pairs where each hit meets criteria e-value <= 0.001, hit-length >= 40, bitscore >= 100.

blastbesties -e 0.001 -l 40 -s 100 -a AvB.tab -b BvA.tab -o pairs.tab

To run in interactive mode use --tui to open the terminal user interface.

blastbesties --tui

Input requirements

  • Takes two BLAST output files as input. SetA vs SetB, and SetB vs SetA.
  • BLAST output format 6 (tabular)
  • Hits must be sorted by query name then descending match quality - this is default BLAST behaviour.

Standard options

Usage: blastbesties [-h] [--version] -a BLASTAVB -b BLASTBVA [-l MINLEN] [-e EVAL] [-s BITSCORE] [-o OUTFILE] [-d OUTDIR] [--loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [--tui]

Finds reciprocal best BLAST pairs from BLAST output format 6 (tabular). Where hits are sorted by query name then descending match quality.

options:
  -h, --help            show this help message and exit
  --version             Show program's version number and exit.
  -a BLASTAVB, --blastAvB BLASTAVB
                        BLAST tab result file for fastaA query against fastaB subject.
  -b BLASTBVA, --blastBvA BLASTBVA
                        BLAST tab result file for fastaB query against fastaA subject.
  -l MINLEN, --minLen MINLEN
                        Minimum length of hit to consider valid. Defaults to 1.
  -e EVAL, --eVal EVAL  Maximum e-value to consider valid pair. Defaults to 0.001.
  -s BITSCORE, --bitScore BITSCORE
                        Minimum bitscore to consider valid pair. Defaults to 1.0.
  -o OUTFILE, --outFile OUTFILE
                        Write reciprocal BLAST pairs to this file.
  -d OUTDIR, --outDir OUTDIR
                        Directory for new sequence files to be written to.
  --loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}
                        Set logging level. Defaults to INFO.
  --tui                 Open Textual UI.

License

Software provided under MIT license.

Metadata

Release files for blastbesties 1.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 blastbesties 1.2.0
File Size Uploaded Provenance Actions
blastbesties-1.2.0.tar.gz 7.9 kB With provenance Details for blastbesties-1.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 16.7 kB

Release files / blastbesties-1.2.0.tar.gz

Download URL blastbesties-1.2.0.tar.gz
Size 7.9 kB
Tags Source
SHA-256 checksum
How to use checksums
5d66264863667a505309e87e33bc186d40b98ff68c96c93c0273a68a8197757c
BLAKE2b-256 checksum
How to use checksums
8fedab1021d721e42727a4058f05cf6e250d173d450311d16f3095ea972c1050
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.1.1 CPython/3.12.7

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2024.

Transparency log

Release files / blastbesties-1.2.0-py3-none-any.whl

Download URL blastbesties-1.2.0-py3-none-any.whl
Size 8.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fe4297b22f5c2e39f2eefe57ad891931bc91f7927e6b6fec391ed18377dd85d6
BLAKE2b-256 checksum
How to use checksums
a2632855b9d27fd66e137efe57bd73431edf9facb8d734a7995b27bc0ad1186b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.1.1 CPython/3.12.7

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2024.

Transparency log

Security for blastbesties 1.2.0

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for blastbesties-1.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2024.

Transparency log

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