Skip to main content

No project description provided

Project description

episodic

A complete pipeline for fitting and testing Fixed Local Clock (FLC) molecular clock models for episodic evolution.

PyPI - Version PyPI - Python Version


About

Episodic is a tool for fitting and testing Fixed Local Clock (FLC) molecular clock models for episodic evolution. The package is built on top of SNK, and provides a complete pipeline for fitting and testing models of episodic evolution using BEAST.

Episodic implements the ideas of Tay et al. (2022 and 2023) and detects episodic evolution through Bayesian inference of molecular clock models.

Given a multiple sequence alignment and a list of groups to test for episodic evolution, episodic will:

  • Configure BEAST analyses for strict, relaxed (UCGD) and stem fixed local clock models.
  • Configure marginal likelihood analyses for each clock model.
  • Run all the BEAST and marginal likelihood analyses.
  • Plot and summarise the results.
  • Compute and plot Bayes factors for the marginal likelihood analyses.
  • Produce maximum clade credibility (MCC) trees for each clock model.
  • Compute bayes factor on effect size for the FLC models (foreground vs background).
  • Run rank and quantile tests on the all the models.
  • Handel the execution of the pipeline on a HPC cluster.
  • Produce a report of the results (TBD).

Features

  • Complete pipeline - episodic provides a complete pipeline for fitting and testing FLC models of episodic evolution.
  • Flexible - episodic is built on top of SNK, and provides a flexible framework for fitting and testing FLC models of episodic evolution.
  • Easy to use - episodic is easy to use, and provides a simple interface for fitting and testing FLC models of episodic evolution.
  • robust - episodic is robust, and provides a robust framework for fitting and testing FLC models of episodic evolution.

Installation

pip install episodic

Outputs

Episodic will produce a range on log files, trees and plots. The following is a list of the main outputs.

  • BEAST log files - episodic will produce a BEAST log file for each clock model. These files can be analysed with Beastiary.

  • BEAST trees - episodic will produce a BEAST tree file for each clock model.

  • MCC trees - episodic will produce a MCC tree for each clock model.

  • MCC tree plots - episodic will produce a MCC tree plot for each clock model.

  • Marginal likelihoods - episodic will produce a marginal likelihood plot for each clock model.

  • Bayes factors on effect size - episodic will calculate a Bayes factors on effect size for each local clock model.

    Rate Column p_p p_odds pos_p pos_odds bf
    BA.2.86.rate 0.5034996111543162 1.0140971134481986 1.0 inf inf
  • Rank and quantile tests - episodic will produce a rank and quantile test plot for each clock model.

  • Clock rate plots - episodic will produce a rate plot for each clock model.

DAG

License

episodic is distributed under the terms of the MIT license.

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

episodic-0.2.1.tar.gz (21.9 kB view hashes)

Uploaded Source

Built Distribution

episodic-0.2.1-py3-none-any.whl (30.6 kB view hashes)

Uploaded Python 3

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