HMMs

Overview

Profile hidden Markov models (HMM) are used in Virtool to discover potential novel viruses using the NuVs workflow.

In order to use the NuVs workflow to predict novel viruses, you must first install HMM profiles and annotations. Together these data allow NuVs to identify and annotate sequences assembled from your sample that might comprise part of a novel viral genome.

Install Official Data

  1. Navigate to the HMMs view in the main navigation bar.

    You should see something like this if no HMM data have already been installed:

    No HMM data found

  2. Click Install Official to start the installation.

    It could take some time to download and install the data.

    Installing Official HMM Data

  3. Wait for the installation to complete.

    When the installation is complete, the HMM data will load and you will see a list of annotations and use the NuVs workflow.

    Installed Official HMM Data

Explore Annotations

  1. After HMM data has been installed, go to HMM in the main navigation bar.

    Browse HMMs

  2. Use the search bar to find HMMs by annotative name (eg. RNA replicase).

  3. Click on an HMM item to view its details.

    The fields in the HMM detail view describe the profile and the protein sequences that were used for its creation.

    Browse HMMs

    FieldDescription
    ClusterA unique integer identifier for the cluster
    Best DefinitionsThe three most common protein definitions found in the cluster member protein annotations.
    LengthThe length of the motif identified in the profile.
    Mean Entropy
    Total Entropy
    Cluster MembersA list of the proteins included in the cluster used to construct the profile HMM.
    FamiliesThe taxonomic families represented in the cluster and their cluster member counts. Cluster members without families are tagged None.

Purge HMM Data

It is possible to delete all HMM data from the disk and database. This is used primary during testing and development.

You will be able to reinstall the HMM data once the deletion process is complete.

  1. Go to HMM in the main navigation bar.

    HMM List View

  2. Click on Settings in the left sidebar.

    Purge in Settings

  3. Click Purge to purge the HMM data.

    You will be redirected to the HMM list view. The installation message will now be shown again because all HMM data has been deleted.

    No HMM Data Found