Metadata-Version: 2.4
Name: mdeq
Version: 2026.4.21
Summary: mdeq: mutation disequilibrium analysis tools.
Keywords: biology,genomics,statistics,phylogeny,evolution,bioinformatics
Author-email: Katherine Caley <katherine.caley@anu.edu.au>, Gavin Huttley <Gavin.Huttley@anu.edu.au>
Requires-Python: >=3.11,<=3.14
Description-Content-Type: text/markdown
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
License-File: LICENSE
Requires-Dist: cogent3>=2025.7.10a5
Requires-Dist: scinexus
Requires-Dist: click
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: scitrack
Requires-Dist: rich
Requires-Dist: trogon
Requires-Dist: cogapp ; extra == "dev"
Requires-Dist: docformatter ; extra == "dev"
Requires-Dist: mdeq[test] ; extra == "dev"
Requires-Dist: ruff==0.15.8 ; extra == "dev"
Requires-Dist: pytest ; extra == "test"
Requires-Dist: pytest-cov ; extra == "test"
Requires-Dist: pytest-xdist ; extra == "test"
Requires-Dist: nox ; extra == "test"
Provides-Extra: dev
Provides-Extra: test

[![Coverage Status](https://coveralls.io/repos/github/HuttleyLab/MutationDiseq/badge.svg)](https://coveralls.io/github/HuttleyLab/MutationDiseq)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
[![DOI](https://zenodo.org/badge/351654591.svg)](https://doi.org/10.5281/zenodo.16829613)

# mdeq: a tool for analysing mutation disequilibrium

A preprint is available [here](https://www.biorxiv.org/content/10.1101/2025.08.22.671660v1). Associated analyses are [here](https://github.com/HuttleyLab/MutationDiseqAnalysis).

## 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](https://github.com/HuttleyLab/MutationDiseqAnalysis) to get an Ubuntu VM with this library, accupy and other useful dependencies.

## The available commands

<!-- [[[cog
import cog
from mdeq import main
from click.testing import CliRunner
runner = CliRunner()
result = runner.invoke(main, ["--help"])
help = result.output.replace("Usage: main", "Usage: mdeq")
cog.out(
    "```\n{}\n```".format(help)
)
]]] -->
```
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.

```
<!-- [[[end]]] -->

