ANIclustermap - GitLite

KO | EN

gitlite — search

#hacktoberfest #go #rust #linux #nodejs #java #awesome #cli #kubernetes #awesome-list #vue #pytorch #mcp #openai

ANIclustermap

(★ 94)

A tool for drawing ANI clustermap between all-vs-all microbial genomes

File Explorer

Download Latest Version (.zip)

- - ci.yml
  - publish_to_pypi.yml
- - minimal_dataset.zip
  - normal_dataset.zip
  - small_dataset.zip
- example_run.sh
- - 01_ANIclustermap.png
  - 02_ANIclustermap.png
  - 03_ANIclustermap.png
  - 04_ANIclustermap.png
  - 05_ANIclustermap.png
- - ANIclustermap.png
  - ANIclustermap_annotation.png
- - ANIclustermap.png
  - ANIclustermap_annotation.png
- - ANIclustermap.png
  - ANIclustermap_annotation.png
- - __init__.py
  - __main__.py
  - cluster.py
  - const.py
  - logger.py
  - main.py
  - plot.py
  - tree.py
  - utils.py
- __init__.py
- conftest.py
- test_aniclustermap.py
.gitignore
.pre-commit-config.yaml
CITATION.cff
LICENSE
pyproject.toml
README.md
requirements-dev.lock
requirements.lock

# Installation Guide

1. Get the code

git clone https://github.com/moshi4/ANIclustermap

Downloads the entire project code from GitHub to your computer.

cd ANIclustermap

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Python 3 Python is required to use pip.

pip install aniclustermap

Installs the package published on PyPI directly — no need to clone the source.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install aniclustermap

Installs the package published on PyPI directly — no need to clone the source.

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ANIclustermap

![Python3](https://img.shields.io/badge/Language-Python3-steelblue)
![OS](https://img.shields.io/badge/OS-Mac_|_Linux-steelblue)
![License](https://img.shields.io/badge/License-MIT-steelblue)
[![Latest PyPI version](https://img.shields.io/pypi/v/aniclustermap.svg)](https://pypi.python.org/pypi/aniclustermap)
[![Bioconda](https://img.shields.io/conda/vn/bioconda/aniclustermap.svg?color=green)](https://anaconda.org/bioconda/aniclustermap)

## Overview

ANIclustermap is easy-to-use tool for drawing ANI(Average Nucleotide Identity) clustermap between all-vs-all microbial genomes.
ANI between all-vs-all genomes are calculated by [fastANI](https://github.com/ParBLiSS/FastANI)
(or [skani](https://github.com/bluenote-1577/skani)) and clustermap is drawn using seaborn.

![ANIclustermap.png](https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/normal_dataset/ANIclustermap.png)  
Fig1. ANI clustermap between all-vs-all 33 genomes.

![ANIclustermap.png](https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/small_dataset/ANIclustermap_annotation.png)  
Fig2. ANI clustermap between all-vs-all 18 genomes. If no similarity detected by fastANI, filled in gray.

## Installation

`Python 3.9 or later` is required for installation.
[fastANI](https://github.com/ParBLiSS/FastANI) or [skani](https://github.com/bluenote-1577/skani) is required to calculate ANI.

**Install bioconda package:**

conda install -c conda-forge -c bioconda aniclustermap

**Install PyPI stable package:**

pip install aniclustermap

## Workflow

Description of ANIclustermap's automated workflow.

1. Calculate ANI between all-vs-all microbial genomes by fastANI (or skani).  
   If no similarity detected by fastANI, NA is output. In that case, NA is replaced by 0.0.  
   If previous result available at the time of re-run, reuse previous result.
2. Clustering ANI matrix by scipy UPGMA method.  
3. Using clustered matrix, draw ANI clustermap by seaborn.

## Usage

### Basic Command

ANIclustermap -i [Genome fasta directory] -o [output directory]

### Options

$ ANIclustermap --help
                                                                                                                          
    Usage: ANIclustermap [OPTIONS]                                                                                       
                                                                                                                          
    Draw ANI(Average Nucleotide Identity) clustermap                                                                     
                                                                                                                          
    ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────╮
    │ *  --indir             -i        Input genome fasta directory (*.fa|*.fna[.gz]|*.fasta) [required]   │
    │ *  --outdir            -o        Output directory [required]                                         │
    │    --mode                        ANI calculation tool (fastani|skani) [default: fastani]             │
    │    --thread_num        -t        Thread number parameter [default: MaxThread - 1]                    │
    │    --overwrite                   Overwrite previous ANI calculation result                           │
    │    --fig_width                   Figure width [default: 10]                                          │
    │    --fig_height                  Figure height [default: 10]                                         │
    │    --dendrogram_ratio            Dendrogram ratio to figsize [default: 0.15]                         │
    │    --cmap_colors                 cmap interpolation colors parameter [default: lime,yellow,red]      │
    │    --cmap_gamma                  cmap gamma parameter [default: 1.0]                                 │
    │    --cmap_ranges                 Range values (e.g. 80,90,95,100) for discrete cmap                  │
    │    --cbar_pos                    Colorbar position [default: 0.02, 0.85, 0.04, 0.15]                 │
    │    --annotation                  Show ANI value annotation                                           │
    │    --annotation_fmt              Annotation value format [default: .3g]                              │
    │    --quiet                       No print log on screen                                              │
    │    --version           -v        Print version information                                           │
    │    --help              -h        Show this message and exit.                                         │
    ╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯

### Example Command

7 genomes minimal dataset. Click [here](https://github.com/moshi4/ANIclustermap/raw/main/example/input/minimal_dataset.zip) to download dataset.

ANIclustermap -i ./minimal_dataset/ -o ./ANIclustermap_result

## Output Contents

ANIclustermap outputs 3 types of result files.

- **`ANIclustermap.[png|svg]`**  ([example1](https://github.com/moshi4/ANIclustermap/blob/main/example/output/05_normal_dataset/ANIclustermap.png), [example2](https://github.com/moshi4/ANIclustermap/blob/main/example/output/06_normal_dataset_annotation/ANIclustermap.png))  
  ANI clustermap result figure.

- **`ANIclustermap_matrix.tsv`** ([example](https://github.com/moshi4/ANIclustermap/blob/main/example/output/05_normal_dataset/ANIclustermap_matrix.tsv))  
  Clustered all-vs-all ANI matrix.

- **`ANIclustermap_dendrogram.nwk`** ([example](https://github.com/moshi4/ANIclustermap/blob/main/example/output/05_normal_dataset/ANIclustermap_dendrogram.nwk))  
  Newick format clustering dendrogram.

## Gallery

Example gallery of 33 genomes normal dataset.  
If you want to try it for yourself, click [here](https://github.com/moshi4/ANIclustermap/raw/main/example/input/normal_dataset.zip) to donwload dataset.

**Normal parameter:**

ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result01 \
                  --fig_width 15

![ANIclustermap.png](https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/01_ANIclustermap.png)

**Change cmap_gamma parameter:**

ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result02 \
                  --fig_width 15 --cmap_gamma 0.5

![ANIclustermap.png](https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/02_ANIclustermap.png)

**Change cmap_colors(=white,orange,red) paramter:**

ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result03 \
                  --fig_width 15 --cmap_colors white,orange,red

![ANIclustermap.png](https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/03_ANIclustermap.png)

**Change cmap_ranges paramter:**

ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result04 \
                  --fig_width 15 --cmap_ranges 80,85,90,92.5,95,97.5,100

> See [this issue](https://github.com/moshi4/ANIclustermap/issues/1) for more details.

![ANIclustermap.png](https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/04_ANIclustermap.png)

**Add ANI value annotation parameter:**

ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result05 \
                  --fig_width 20 --fig_height 15 --annotation

![ANIclustermap.png](https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/05_ANIclustermap.png)