Page tree
Skip to end of metadata
Go to start of metadata


Learning Objectives

Installing Prokka

Conda installation
conda create -n GVA-prokka -c conda-forge -c bioconda -c defaults prokka
conda activate GVA-prokka
Check for correct installation and get review command line options
prokka --version
prokka --listdb
prokka --help

Note the somewhat novel '--listdb' call. Since prokka is a program that works largely by comparing sequences to other sources, knowing what references it has access to is of equal importance as having the program working. In such situations the the program, and the associated databases may be updated independently.

expected output should be similar to

prokka 1.14.6

Looking for databases in: /work2/01821/ded/stampede2/miniconda3/envs/GVA-prokka/db

* Kingdoms: Archaea Bacteria Mitochondria Viruses

* Genera: Enterococcus Escherichia Staphylococcus


* CMs: Archaea Bacteria Viruses

help command should give list of options you are familiar with by now

Get Some Data

If you have already run the SPAdes tutorial for assembling full bacterial genomes from simulated reads, it is recommended that you use one or more of the set of assembled contigs.

The contigs.fa file corresponding to the "400_1500_3000" data set gives the highest quality assembly given the larger insert sizes and higher overall coverage.

mkdir $SCRATCH/GVA_Prokka
cd  $SCRATCH/GVA_Prokka
cp ../GVA_SPAdes_tutorial

Running Prokka

Using the prokka --help command, what options seem particularly useful or important to you?

Options important for controlling files and program speed.

location to store filesAs mentioned in other tutorials, not all programs can create new directories. Generally any that offer option
base file name to use for new filesprefix/base names will always come at the front of new files, typically with more detailed extension information afterwords. This is also typically a clue that there will be multiple output files generated.


number of threads to use, controlling spedInterestingly, allows for a value of zero to be entered, allowing the program to identify how many processors potentially has access to, and then using them all.

Options important for determining what predictions will be made.



Provide a protein fasta file or genbank file to search against firstThis is more useful when you know your strain to be closely related to an existing strain


Higher values produce fewer matchesThis may be something you interact recursively with depending if you feel you have large regions of the genome that remain unannotated (unlikely) or you have lots of small fragments of genes. Likely left as default unless experiencing these issues. May also be solved by providing additional databases.


fraction of protein that must match to be annotatedAnother control point for how many annotations you will receive

For our example, we will leave proteins, evalue and covereage all at their defaults making our command rather simple. 

Try to determine yourself before comparing against 1 reasonable solution
mkdir gene_annotations
prokka --outdir gene_annotations --prefix mygenome contigs.fa

Evaluating output

Next steps and optional exercises 

  • No labels