You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .zenodo.json
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
"description": "<p>The pipeline</p>\n\n<p>bacannot, is a customisable, easy to use, pipeline that uses state-of-the-art software for comprehensively annotating prokaryotic genomes having only Docker and Nextflow as dependencies. It is able to annotate and detect virulence and resistance genes, plasmids, secondary metabolites, genomic islands, prophages, ICEs, KO, and more, while providing nice an beautiful interactive documents for results exploration.</p>",
3
3
"license": "other-open",
4
4
"title": "fmalmeida/bacannot: A generic but comprehensive bacterial annotation pipeline",
[](https://github.com/fmalmeida/bacannot/releases)
[](https://twitter.com/fmarquesalmeida)
[](https://gitpod.io/github.com/fmalmeida/bacannot)
13
14
@@ -47,8 +48,9 @@ Its main steps are:
47
48
| Annotation of virulence genes |[Victors](http://www.phidias.us/victors/) and [VFDB](http://www.mgc.ac.cn/VFs/main.htm)|
48
49
| Prophage sequences and genes annotation |[PHASTER](http://phast.wishartlab.com/), [Phigaro](https://github.com/bobeobibo/phigaro) and [PhySpy](https://github.com/linsalrob/PhiSpy)|
49
50
| Annotation of integrative and conjugative elements |[ICEberg](http://db-mml.sjtu.edu.cn/ICEberg/)|
51
+
| Annotation of bacterial integrons |[Integron Finder](https://github.com/gem-pasteur/Integron_Finder)|
50
52
| Focused detection of insertion sequences |[digIS](https://github.com/janka2012/digIS)|
51
-
|_In silico_ detection of plasmids |[Plasmidfinder](https://cge.cbs.dtu.dk/services/PlasmidFinder/) and [Platon](https://github.com/oschwengers/platon)|
53
+
|_In silico_ detection and typing of plasmids |[Plasmidfinder](https://cge.cbs.dtu.dk/services/PlasmidFinder/), [Platon](https://github.com/oschwengers/platon)and [MOB-typer](https://github.com/phac-nml/mob-suite)|
52
54
| Prediction and visualization of genomic islands |[IslandPath-DIMOB](https://github.com/brinkmanlab/islandpath) and [gff-toolbox](https://github.com/fmalmeida/gff-toolbox)|
53
55
| Custom annotation from formatted FASTA or NCBI protein IDs |[BLAST](https://blast.ncbi.nlm.nih.gov/Blast.cgi?PAGE_TYPE=BlastDocs)|
54
56
| Merge of annotation results |[bedtools](https://bedtools.readthedocs.io/en/latest/)|
@@ -86,18 +88,7 @@ These images have been kept separate to not create massive Docker image and to a
86
88
87
89
## Installation
88
90
89
-
1. If you don't have it already install [Docker](https://docs.docker.com/) in your computer.
90
-
* After installed, you need to download the required Docker images
91
-
92
-
```bash
93
-
docker pull fmalmeida/bacannot:v3.2_misc ;
94
-
docker pull fmalmeida/bacannot:v3.2_perlenv ;
95
-
docker pull fmalmeida/bacannot:v3.2_pyenv ;
96
-
docker pull fmalmeida/bacannot:v3.2_renv ;
97
-
docker pull fmalmeida/bacannot:jbrowse ;
98
-
```
99
-
100
-
🔥 Nextflow can also automatically handle images download on the fly when executed. If docker has exceeded its download limit rates, please try again in a few hours.
91
+
1. If you don't have it already install either [Docker](https://docs.docker.com/) or [Singularity](https://docs.sylabs.io/guides/3.5/user-guide/index.html) in your computer.
101
92
102
93
2. Install Nextflow (version 20.10 or higher):
103
94
@@ -111,48 +102,7 @@ These images have been kept separate to not create massive Docker image and to a
111
102
112
103
🔥 Users can get let the pipeline always updated with: `nextflow pull fmalmeida/bacannot`
113
104
114
-
### Downloading and updating databases
115
-
116
-
Bacannot databases are not inside the docker images anymore to avoid huge images and problems with connections and limit rates with dockerhub.
117
-
118
-
#### Pre-formatted
119
-
120
-
Users can directly download pre-formatted databases from Zenodo: https://doi.org/10.5281/zenodo.7615811
121
-
122
-
Useful for standardization and also overcoming known issues that may arise when formatting databases with `singularity` profile.
123
-
124
-
#### I want to generate a new formatted database
125
-
126
-
To download and format a copy of required bacannot databases users can execute the following:
127
-
128
-
```bash
129
-
# Download pipeline databases
130
-
nextflow run fmalmeida/bacannot --get_dbs --output bacannot_dbs -profile <docker/singularity>
131
-
```
132
-
133
-
This will produce a directory like this:
134
-
135
-
```bash
136
-
bacannot_dbs
137
-
├── amrfinder_db
138
-
├── antismash_db
139
-
├── argminer_db
140
-
├── card_db
141
-
├── iceberg_db
142
-
├── kofamscan_db
143
-
├── mlst_db
144
-
├── phast_db
145
-
├── phigaro_db
146
-
├── pipeline_info
147
-
├── plasmidfinder_db
148
-
├── platon_db
149
-
├── prokka_db
150
-
├── resfinder_db
151
-
├── vfdb_db
152
-
└── victors_db
153
-
```
154
-
155
-
> To update databases you can either download a new one to a new directory. Remove the database you want to get a new one from the root bacannot dir and use the same command above to save in the same directory (the pipeline will only try to download missing databases). Or, you can use the parameter `--force_update` to download everything again.
105
+
<ahref="https://bacannot.readthedocs.io/en/latest/installation"><strong>Please refer to the installation page, for a complete guide on required images and databases. »</strong></a>
156
106
157
107
## Quickstart
158
108
@@ -185,6 +135,17 @@ Create a configuration file in your working directory:
185
135
186
136
nextflow run fmalmeida/bacannot --get_config
187
137
138
+
##### Overwrite container versions with config
139
+
140
+
The pipeline uses pre-set docker and singularity configuration files to set all the containers and versions of images that should be used by each module in the pipeline.
141
+
142
+
Although not recommended, one can use these configuration files to change the version of specific tools if desired.
143
+
144
+
To download these configs one can:
145
+
146
+
nextflow run fmalmeida/bacannot --get_docker_config
147
+
nextflow run fmalmeida/bacannot --get_singularity_config
148
+
188
149
### Interactive graphical configuration and execution
189
150
190
151
#### Via NF tower launchpad (good for cloud env execution)
@@ -234,7 +195,11 @@ It will result in the following:
234
195
235
196
## Citation
236
197
237
-
To cite this tool please refer to our [Zenodo tag](https://doi.org/10.5281/zenodo.3627669).
198
+
In order to cite this pipeline, please refer to:
199
+
200
+
> Almeida FMd, Campos TAd and Pappas Jr GJ. Scalable and versatile container-based pipelines for de novo genome assembly and bacterial annotation. [version 1; peer review: awaiting peer review]. F1000Research 2023, 12:1205 (https://doi.org/10.12688/f1000research.139488.1)
201
+
202
+
Additionally, archived versions of the pipeline are also found in [Zenodo](https://doi.org/10.5281/zenodo.3627669).
238
203
239
204
This pipeline uses code and infrastructure developed and maintained by the [nf-core](https://nf-co.re) community, reused here under the [GPLv3](https://github.com/fmalmeida/bacannot/blob/master/LICENSE).
0 commit comments