@@ -20,7 +20,7 @@ Fig2. ANI clustermap between all-vs-all 18 genomes. If no similarity detected by
20
20
21
21
## Installation
22
22
23
- ` Python 3.8 or later ` is required for installation.
23
+ ` Python 3.9 or later ` is required for installation.
24
24
[ fastANI] ( https://github.com/ParBLiSS/FastANI ) or [ skani] ( https://github.com/bluenote-1577/skani ) is required to calculate ANI.
25
25
26
26
** Install bioconda package:**
@@ -38,7 +38,7 @@ Description of ANIclustermap's automated workflow.
38
38
1 . Calculate ANI between all-vs-all microbial genomes by fastANI (or skani).
39
39
If no similarity detected by fastANI, NA is output. In that case, NA is replaced by 0.0.
40
40
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.
42
42
3 . Using clustered matrix, draw ANI clustermap by seaborn.
43
43
44
44
## Usage
@@ -50,37 +50,40 @@ Description of ANIclustermap's automated workflow.
50
50
### Options
51
51
52
52
$ 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
+ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯
74
77
75
78
### Example Command
76
79
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.
78
81
79
82
ANIclustermap -i ./minimal_dataset/ -o ./ANIclustermap_result
80
83
81
84
## Output Contents
82
85
83
- ANIclustermap outputs 3 types of files.
86
+ ANIclustermap outputs 3 types of result files.
84
87
85
88
- ** ` 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 ) )
86
89
ANI clustermap result figure.
@@ -94,32 +97,32 @@ ANIclustermap outputs 3 types of files.
94
97
## Gallery
95
98
96
99
Example 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.
98
101
99
102
** Normal parameter:**
100
103
101
- ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result \
104
+ ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result01 \
102
105
--fig_width 15
103
106
104
107
![ ANIclustermap.png] ( https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/01_ANIclustermap.png )
105
108
106
109
** Change cmap_gamma parameter:**
107
110
108
- ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result \
111
+ ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result02 \
109
112
--fig_width 15 --cmap_gamma 0.5
110
113
111
114
![ ANIclustermap.png] ( https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/02_ANIclustermap.png )
112
115
113
116
** Change cmap_colors(=white,orange,red) paramter:**
114
117
115
- ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result \
118
+ ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result03 \
116
119
--fig_width 15 --cmap_colors white,orange,red
117
120
118
121
![ ANIclustermap.png] ( https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/03_ANIclustermap.png )
119
122
120
123
** Change cmap_ranges paramter:**
121
124
122
- ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result \
125
+ ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result04 \
123
126
--fig_width 15 --cmap_ranges 80,85,90,92.5,95,97.5,100
124
127
125
128
> 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
128
131
129
132
** Add ANI value annotation parameter:**
130
133
131
- ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result \
134
+ ANIclustermap -i ./normal_dataset -o ./ANIclustermap_result05 \
132
135
--fig_width 20 --fig_height 15 --annotation
133
136
134
137
![ ANIclustermap.png] ( https://raw.githubusercontent.com/moshi4/ANIclustermap/main/images/gallery/05_ANIclustermap.png )
0 commit comments