Create MLST Scheme

The Create MLST Scheme tool can be used to create a scheme from scratch.

To run the Create MLST Scheme tool choose:

Toolbox | Microbial Genomics Module () | Databases () | MLST Typing () | Create MLST Scheme ()

As input, the tool requires a set of complete isolate genomes in the form of one or more sequence lists or sequences. At least one of these genomes must be annotated with coding region (CDS) annotations. If these are not available, the Find Prokaryotic Genes tool (see Find Prokaryotic Genes) or Annotate with DIAMOND (see Annotate with DIAMOND) can be used to predict and annotate the coding regions.

In the first wizard step shown in figure 15.1 the grouping of sequences into genomic units can be controlled. This is necessary when working with genomes that span several chromosomes or several contigs for the tool to consider these as one unit. The grouping can be controlled by the Assembly grouping field:

Each sequence is one assembly: Each individual sequence is considered a complete assembly of a genome.
Each input element is one assembly: Each input element, i.e. input sequence or input sequence list, is considered a complete assembly of a genome.
Group sequences by annotation type: Use annotations to group the assemblies and specify the annotation field with Assembly annotation type. Some tools, such as the Download Custom Microbial Reference Database, will automatically assign an Assembly ID that can be used for grouping. For a manual assignment of Assembly ID annotations, please see Using the Assembly ID annotation.

Image create_mlst_annotation_grouping
Figure 15.1: Grouping the input into assemblies.

After specifying the input, the second step is to set up the basic MLST Scheme creation parameters (figure 15.2).

The Create MLST Scheme tool works by extracting all annotated coding sequences (CDS) and clustering them into similar gene classes (loci). It is possible to specify whether we are interested in the genes that are present in some genomes (Whole genome - must be present in at least 10% of all genomes), most genomes (Core genome - must be present in at least 90% of the genomes), or a user-specified Minimum fraction.

Image create_mlst_scheme_step1
Figure 15.2: Basic options for creating a MLST scheme.

The best results are obtained by supplying genomes with proper CDS annotations. The Handle genes without annotations option controls how genomes without CDS annotations and how existing CDS may be overridden if a longer CDS from another genome exactly matches the genomic sequence.

Ignore: Only use the existing CDS annotations as a basis for the MLST scheme construction.
Search alleles before clustering: All of the input genomes are blasted (using DIAMOND) against the set of annotated genes, and any new genes will be added as alleles. This is a very slow, but thorough check.
Search alleles after clustering: After clustering the genes, all of the input genomes are blasted (using DIAMOND), but only against the longest protein in each cluster.

The Allele grouping parameters step (figure 15.3) specifies how the different genes (CDS annotations) are compared to each other. DIAMOND is used for this clustering. The following can be specified:

Image create_mlst_scheme_step2
Figure 15.3: The allele grouping (clustering) options.

Genetic code: specifies the genomic code to use for the input samples if Check codon positions is enabled.
Check codon positions: If this is enabled, coding sequences not starting with a start codon, not ending with a stop codon or containing internal stop codons will be discarded. This can be disabled, for example to allow the construction of MLST schemes with spliced genes where each exon is considered an allele.
Minimum identity: determines the minimum sequence identity before grouping protein sequences.
It is also possible to specify the sensitivity of the search (Standard search, Sensitive search, and More sensitive search) - increasing the sensitivity makes the search more thorough, but also much slower. The default for this parameter is Sensitive search.
Minimum gene length: is used to remove short genes from the resulting MLST scheme.

Note that after clustering, length outliers of a given cluster are removed by applying Tukey's fences with an interquartile range of 1.5, yet allowing for 5% length variation around the median. For example, for an allele cluster (locus) with allele lengths 51, 51, 51, 51, 53, the latter allele will not be removed although it falls outside the 1.5 IQR (both the first and third quartile are 51) since it is still within 5% of the median, for 48, 51, 51, 54, 63, only the former four will be included.

It is possible to decorate the alleles with information about virulence or resistance. The information can be extracted from either a ShortBRED Marker database or a Nucleotide database. These databases can be accessed using the Download Resistance Database tool (e.g. QMI-AR for resistance or VFDB for virulence) and can be provided as input to the Create MLST Scheme tool at this step (figure 15.4).

Image create_mlst_scheme_step3
Figure 15.4: The functional annotation parameters.

Browse the manual

Create MLST Scheme