Overview¶
After you've run your samples through Bactopia, you are probably going to want to investigate them some more, or conduct some comparative analyses. That's where Bactopia Tools come into play!
Bactopia Tools are a set of pre-defined workflows such as pan-genome contruction, serotyping, and phylogenies. A main benefit of using Bactopia Tools, is they make use of the predictable output structure of Bactopia to automate analyses. This saves you valuable time by allowing you to make further use of the many output files to extend your analyses.
Available Bactopia Tools¶
There are currently 60 Bactopia Tools that you can make use of. Below are a list of available Bactopia Tools, grouped as Subworkflows and Modules.
Subworkflows (10)¶
Subworkflows string together tools to create an complete pipeline.
| Subworkflow | Description |
|---|---|
| ariba | Gene identification through local assemblies |
| bakta | Rapid annotation of bacterial genomes and plasmids |
| eggnog | Functional annotation of proteins using orthologous groups and phylogenies |
| gtdb | Identify marker genes and assign taxonomic classifications |
| mashtree | Quickly create a tree using Mash distances |
| merlin | MinmER assisted species-specific bactopia tool seLectIoN |
| pangenome | Pangenome analysis with optional core-genome phylogeny |
| scrubber | Scrub human reads from FASTQ files |
| snippy | Rapid variant calling from Illumina sequence reads with optional core-SNP phylogeny |
| staphtyper | Determine the agr, spa and SCCmec types for Staphylococcus aureus genomes |
Modules (50)¶
Modules are workflows consisting of only one tool.
| Module | Description |
|---|---|
| abricate | Mass screening of contigs for antimicrobial and virulence genes |
| abritamr | A NATA accredited tool for reporting the presence of antimicrobial resistance genes |
| agrvate | Rapid identification of Staphylococcus aureus agr locus type and agr operon variants. |
| amrfinderplus | Identify antimicrobial resistance in genes or proteins |
| blastn | Search against nucleotide BLAST databases using nucleotide queries |
| blastp | Search against protein BLAST databases using protein queries |
| blastx | Search against protein BLAST databases using translated nucleotide queries |
| bracken | Estimate taxonomic abundance of samples from Kraken2 results |
| btyper3 | Taxonomic classification of Bacillus cereus group isolates |
| busco | Assembly completeness based on evolutionarily informed expectations |
| checkm | Assess the assembly quality of your samples |
| ectyper | In-silico prediction of Escherichia coli serotype |
| emmtyper | emm-typing of Streptococcus pyogenes assemblies |
| fastani | fast alignment-free computation of whole-genome Average Nucleotide Identity (ANI) |
| gamma | Identification, classification, and annotation of translated gene matches |
| genotyphi | Salmonella Typhi genotyping with Mykrobe outputs |
| hicap | Identify cap locus serotype and structure in your Haemophilus influenzae assemblies |
| hpsuissero | Serotype prediction of Haemophilus parasuis assemblies |
| ismapper | Identify insertion sites positions in bacterial genomes |
| kleborate | Screening Klebsiella genome assemblies for MLST, sub-species, and other related genes of interest |
| kraken2 | Taxonomic classifications of sequence reads |
| legsta | Typing of Legionella pneumophila assemblies |
| lissero | Serogroup typing prediction for Listeria monocytogenes |
| mashdist | Calculate Mash distances between sequences |
| mcroni | Sequence variation in mcr-1 genes (mobilized colistin resistance) |
| meningotype | Serotyping of Neisseria meningitidis |
| midas | Estimate species abundances from FASTQ files |
| mlst | Automatic MLST calling from assembled contigs |
| mobsuite | Reconstruct and annotate plasmids in bacterial assemblies |
| mykrobe | Antimicrobial resistance detection for specific species |
| ngmaster | Multi-antigen sequence typing for Neisseria gonorrhoeae |
| pasty | in silico serogrouping of Pseudomonas aeruginosa isolates |
| pbptyper | Penicillin Binding Protein (PBP) typer for Streptococcus pneumoniae |
| phispy | Predict prophages in bacterial genomes |
| plasmidfinder | Plasmid identification from assemblies |
| pneumocat | Assign capsular type to Streptococcus pneumoniae from sequence reads |
| quast | A module for assessing the quality of assembled contigs |
| rgi | Predict antibiotic resistance from assemblies |
| seqsero2 | Salmonella serotype prediction from reads or assemblies |
| seroba | Serotyping of Streptococcus pneumoniae from sequence reads |
| shigatyper | Shigella serotype from Illumina or Oxford Nanopore reads |
| shigeifinder | Shigella and EIEC serotyping from assemblies |
| sistr | Serovar prediction of Salmonella assemblies |
| spatyper | Computational method for finding spa types in Staphylococcus aureus |
| ssuissero | Serotype prediction of Streptococcus suis assemblies |
| staphopiasccmec | Primer based SCCmec typing of Staphylococcus aureus genomes |
| stecfinder | Serotype of Shigatoxin producing E. coli using Illumina reads or assemblies |
| tblastn | Search against translated nucleotide BLAST databases using protein queries |
| tblastx | Search against translated nucleotide databases using a translated nucleotide query |
| tbprofiler | Detect resistance and lineages of Mycobacterium tuberculosis genomes |
Common Inputs¶
With the exceptions of the summary tool, each Bactopia Tool will use the following
input parameters:
--bactopia STR Directory containing Bactopia analysis results for all samples.
--exclude STR A text file containing sample names to exclude from the
analysis. The expected format is a single sample per line.
--include STR A text file containing sample names to include in the
analysis. The expected format is a single sample per line.
--bactopia¶
This parameter tells each tool where to find your Bactopia outputs from your project. Using this path, the tool will identify the required inputs and begin analysis. What this means is there is no need for you to wrangle up input files for comparative analyses.
--exclude¶
What --exclude allows is for you to give a text file with a list of samples to
exclude from further analyses. While you can produce this list yourself, the
summary tool will produce a list of samples that do not pass certain thresholds.
These thresholds are based on read lengths, sequence quality, coverage and assembly
quality. You can adjust these thresholds to meet your needs.
--include¶
Similarly, --include allows you to give a text file with a list of samples to be
included in the analysis. This allows you to target your analyses on a specific subset
of samples. An example of this may be to use the fastani tool to determine samples
with >95% ANI to a reference, then create a pan-genome with the pangenome tool using
only the subset of samples.
nf-core/modules Availabilty¶
Good news! All Bactopia Tools are also available through nf-core/modules, a repository of ready to use Nextflow DSL2 modules. This means you can leverage nf-core tools to rapidly string together your own workflows.
Many of the above Bactopia Tools were submitted to nf-core/modules as part of Bactopia V2. The nf-core Team is a fun group to work with so expect many more Bactopia Tools to find their way to nf-core/modules!
Thank you modules team!
Suggest A Tool¶
Do you have an idea or suggestion for an analysis that should be added to the set of Bactopia Tools? If so, please feel free to submit it to Bactopia GitHub Issues!