mdeq: a tool for analysing mutation disequilibrium

A preprint is available here. Associated analyses are here.

Installation

$ pip install mdeq

Note accupy is an optional package for the most numerically accurate routines involving matrices (e.g. dot products). These routines are explicitly employed for computing the nabla related statistics and are used if this package is installed. Unfortunately it is not easily installed and (at the time of writing) is not under active development. Use the Docker container here to get an Ubuntu VM with this library, accupy and other useful dependencies.

The available commands

Usage: mdeq [OPTIONS] COMMAND [ARGS]...

  mdeq: mutation disequilibrium analysis tools.

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  tui              Open Textual TUI.
  prep             pre-process alignment data.
  make-adjacent    makes sqlitedb of adjacent alignment records.
  toe              test of existence of mutation equilibrium.
  teop             between branch equivalence of mutation process test
  aeop             between loci equivalence of mutation process test
  convergence      estimates convergence towards mutation equilibrium.
  make-controls    simulate negative and positive controls
  db-summary       displays summary information about a db
  extract-pvalues  extracts p-values from TOE sqlitedb results
  extract-nabla-c  extracts nabla-c from convergence sqlitedb results
  slide            generate window sized sub-alignments.