@@ -20,7 +20,7 @@ Fig2. ANI clustermap between all-vs-all 18 genomes. If no similarity detected by
2020
2121## Installation
2222
23- ` Python 3.8 or later ` is required for installation.
23+ ` Python 3.9 or later ` is required for installation.
2424[ fastANI] ( https://github.com/ParBLiSS/FastANI ) or [ skani] ( https://github.com/bluenote-1577/skani ) is required to calculate ANI.
2525
2626** Install bioconda package:**
@@ -38,7 +38,7 @@ Description of ANIclustermap's automated workflow.
38381 . Calculate ANI between all-vs-all microbial genomes by fastANI (or skani).
3939 If no similarity detected by fastANI, NA is output. In that case, NA is replaced by 0.0.
4040 If previous result available at the time of re-run, reuse previous result.
41- 2 . Clustering ANI matrix by scipy's UPGMA method.
41+ 2 . Clustering ANI matrix by scipy UPGMA method.
42423 . Using clustered matrix, draw ANI clustermap by seaborn.
4343
4444## Usage
@@ -50,37 +50,40 @@ Description of ANIclustermap's automated workflow.
5050### Options
5151
5252 $ ANIclustermap --help
53- usage: ANIclustermap -i [Genome fasta directory] -o [output directory]
54-
55- Draw ANI(Average Nucleotide Identity) clustermap
56-
57- optional arguments:
58- -i I, --indir I Input genome fasta directory (*.fa|*.fna[.gz]|*.fasta)
59- -o O, --outdir O Output directory
60- -m , --mode ANI calculation mode ('fastani'[default]|'skani')
61- -t , --thread_num Thread number parameter (Default: MaxThread - 1)
62- --overwrite Overwrite previous ANI calculation result (Default: OFF)
63- --fig_width Figure width (Default: 10)
64- --fig_height Figure height (Default: 10)
65- --dendrogram_ratio Dendrogram ratio to figsize (Default: 0.15)
66- --cmap_colors cmap interpolation colors parameter (Default: 'lime,yellow,red')
67- --cmap_gamma cmap gamma parameter (Default: 1.0)
68- --cmap_ranges Range values (e.g. 80,90,95,100) for discrete cmap (Default: None)
69- --cbar_pos Colorbar position (Default: (0.02, 0.8, 0.05, 0.18))
70- --annotation Show ANI value annotation (Default: OFF)
71- --annotation_fmt Annotation value format (Default: '.3g')
72- -v, --version Print version information
73- -h, --help Show this help message and exit
53+
54+ Usage: ANIclustermap [OPTIONS]
55+
56+ Draw ANI(Average Nucleotide Identity) clustermap
57+
58+ ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────╮
59+ │ * --indir -i Input genome fasta directory (*.fa|*.fna[.gz]|*.fasta) [required] │
60+ │ * --outdir -o Output directory [required] │
61+ │ --mode ANI calculation tool (fastani|skani) [default: fastani] │
62+ │ --thread_num -t Thread number parameter [default: MaxThread - 1] │
63+ │ --overwrite Overwrite previous ANI calculation result │
64+ │ --fig_width Figure width [default: 10] │
65+ │ --fig_height Figure height [default: 10] │
66+ │ --dendrogram_ratio Dendrogram ratio to figsize [default: 0.15] │
67+ │ --cmap_colors cmap interpolation colors parameter [default: lime,yellow,red] │
68+ │ --cmap_gamma cmap gamma parameter [default: 1.0] │
69+ │ --cmap_ranges Range values (e.g. 80,90,95,100) for discrete cmap │
70+ │ --cbar_pos Colorbar position [default: 0.02, 0.85, 0.04, 0.15] │
71+ │ --annotation Show ANI value annotation │
72+ │ --annotation_fmt Annotation value format [default: .3g] │
73+ │ --quiet No print log on screen │
74+ │ --version -v Print version information │
75+ │ --help -h Show this message and exit. │
76+ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯
7477
7578### Example Command
7679
77- 7 genomes minimal dataset. Click [ here] ( https://github.com/moshi4/ANIclustermap/wiki/dataset/ minimal_dataset.zip ) to download dataset (Size=3.6MB) .
80+ 7 genomes minimal dataset. Click [ here] ( https://github.com/moshi4/ANIclustermap/raw/main/example/input/ minimal_dataset.zip ) to download dataset.
7881
7982 ANIclustermap -i ./minimal_dataset/ -o ./ANIclustermap_result
8083
8184## Output Contents
8285
83- ANIclustermap outputs 3 types of files.
86+ ANIclustermap outputs 3 types of result files.
8487
8588- ** ` 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 ) )
8689 ANI clustermap result figure.
@@ -94,32 +97,32 @@ ANIclustermap outputs 3 types of files.
9497## Gallery
9598
9699Example gallery of 33 genomes normal dataset.
97- If you want to try it for yourself, click [ here] ( https://github.com/moshi4/ANIclustermap/wiki/dataset/ normal_dataset.zip ) to donwload dataset (Size=63.5MB) .
100+ 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.
98101
99102** Normal parameter:**
100103
101- ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result \
104+ ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result01 \
102105 --fig_width 15
103106
104107![ ANIclustermap.png] ( https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/01_ANIclustermap.png )
105108
106109** Change cmap_gamma parameter:**
107110
108- ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result \
111+ ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result02 \
109112 --fig_width 15 --cmap_gamma 0.5
110113
111114![ ANIclustermap.png] ( https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/02_ANIclustermap.png )
112115
113116** Change cmap_colors(=white,orange,red) paramter:**
114117
115- ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result \
118+ ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result03 \
116119 --fig_width 15 --cmap_colors white,orange,red
117120
118121![ ANIclustermap.png] ( https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/03_ANIclustermap.png )
119122
120123** Change cmap_ranges paramter:**
121124
122- ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result \
125+ ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result04 \
123126 --fig_width 15 --cmap_ranges 80,85,90,92.5,95,97.5,100
124127
125128> See [ this issue] ( https://github.com/moshi4/ANIclustermap/issues/1 ) for more details.
@@ -128,7 +131,7 @@ If you want to try it for yourself, click [here](https://github.com/moshi4/ANIcl
128131
129132** Add ANI value annotation parameter:**
130133
131- ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result \
134+ ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result05 \
132135 --fig_width 20 --fig_height 15 --annotation
133136
134137![ ANIclustermap.png] ( https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/05_ANIclustermap.png )
0 commit comments