Skip to main content

BuddySuite is a collection of command line utilities written in Python for working with biological data.

Project description

Build_Status Coverage_Status PyPi_version

BuddySuite


Description

The BuddySuite modules are ‘one-stop-shop’ command-line tools for common biological data file manipulations. Formats are detected automatically, conversions are seamless, and you can pipe into or out of the modules to build custom bioinformatics workflows, allowing you to spend more time analyzing your sequences, alignments, and phylogenetic trees, instead of wrangling them.

For example, the following command reads in three sequence files (all in different formats), pulls out records with RefSeq identifiers, calls MAFFT to generate an alignment, shifts gaps to force a codon alignment, calls RAxML to infer a phylogeny, and then roots the tree at its midpoint.

$: seqbuddy seqs1.gb seqs2.embl seqs3.fasta --pull_records "[XN]M" | alignbuddy --generate_alignment mafft | alignbuddy --enforce_triplets | phylobuddy --generate_tree raxmlHPC-SSE3 | phylobuddy --root

BuddySuite is a Python3 project, developed and extensively tested on Linux and Mac OS X. Full release versions are also tested on Windows before release, so should work as expected on Vista and above.

Getting started

The simplest way to get up and running is:

$: pip install buddysuite
$: buddysuite -setup

Further instructions are available in the installation guide.

There is also a Beginners’ Guide to show you the basics, as well as a more comprehensive Tutorial.

Each tool in the BuddySuite has been extensively documented in the wiki, complete with worked examples and explanations for all arguments/options.

Developers

All of the individual Buddy toolkits are located in the ‘buddysuite’ directory and the ‘develop’ branch is where all new features have been implemented. If you’re interested in contributing, please refer to the developer page for further information.

Citation

If you use BuddySuite in your work, we would greatly appreciate references to our manuscript:

@article{doi:10.1093/molbev/msx089,
author = {Bond, Stephen R. and Keat, Karl E. and Barreira, Sofia N. and Baxevanis, Andreas D.},
title = {BuddySuite: Command-Line Toolkits for Manipulating Sequences, Alignments, and Phylogenetic Trees},
journal = {Molecular Biology and Evolution},
volume = {34},
number = {6},
pages = {1543-1546},
year = {2017},
doi = {10.1093/molbev/msx089},
URL = { + http://dx.doi.org/10.1093/molbev/msx089},
eprint = {/oup/backfile/content_public/journal/mbe/34/6/10.1093_molbev_msx089/1/msx089.pdf}
}

Through a series of unfortunate events and a surprisingly unresponsive publishing company, the manuscript is behind a paywall… Thank goodness for pre-prints on bioRxiv !

DOI

Contact

Any comments you have would be really appreciated. Please feel free to add issues in the GitHub issue tracker or contact Steve Bond (lead developer) directly at biologyguy@gmail.com.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

buddysuite-1.4.0.tar.gz (152.1 kB view details)

Uploaded Source

File details

Details for the file buddysuite-1.4.0.tar.gz.

File metadata

  • Download URL: buddysuite-1.4.0.tar.gz
  • Upload date:
  • Size: 152.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.0 importlib_metadata/3.10.0 pkginfo/1.8.2 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.6.12

File hashes

Hashes for buddysuite-1.4.0.tar.gz
Algorithm Hash digest
SHA256 58437e18c02d07cc0b0c7ca74976478d80177ea6abe8e29f8c9877989eb763ce
MD5 0c6709850018b6705a9f95182fc409a7
BLAKE2b-256 0f81b8f62b2201cd45718a6450435da197a5fca0d31decbcb02521e21bddcb35

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page