PHI-Canto v1777
Community curation
Questions? Contact curators...
PHI-Canto Documentation

Curating phenotypes

Introduction

A phenotype is any observable characteristic or trait of an organism that results from the interactions between its genotype and the environment. PHI-Canto supports annotation of single- and multi-allele phenotypes on pathogen genotypes, host genotypes and metagenotypes (pathogen and host genotype), using terms from PHIPO (the Pathogen-Host Interaction Phenotype Ontology) and additional useful details such as evidence and experimental conditions.

When using PHIPO terms – or terms from any ontology – always pay careful attention to the term definitions. They are usually more detailed, and often more informative, than the term names alone. For each annotation, ensure that the definition of the selected term accurately describes the experiment you are trying to capture, and that the results shown in the paper fit all parts of the term definition.

If you want to browse terms in PHIPO, you can use any of the term browsers linked to from PHIPO's page on the OBO Foundry (for example, OntoBee or OLS). The OBO Foundry also provides downloads of PHIPO in OWL and OBO formats.

Starting a phenotype annotation

Single-species phenotypes

Genotype Management workflow

Using the Pathogen Genotype Management or Host Genotype Management pages, you can make phenotype annotations to a genotype of a single species. These genotypes can be either single-allele or multi-allele:

You can begin a phenotype annotation after creating a genotype (following the instructions in Creating alleles and genotypes). After the genotype is created, you should see a menu appear with a list of actions. Select ‘Start a pathogen/host phenotype annotation’, then continue by following the steps in ‘The phenotype curation process’ section (see below).

Single allele workflow

If you only need to annotate the phenotype of a single allele, you can select a gene from the list of genes on the curation summary page, then select ‘Single allele phenotype’ from the list of curation types:

After selecting the option, a pop-up will appear where you can enter allele details:

After selecting ‘OK’, you will begin the phenotype curation process for the allele you have created (see ‘The phenotype curation process’ below).

Pathogen-host interaction phenotypes

To annotate a phenotype on a pathogen-host interaction (a metagenotype), go to the Metagenotype Management page and select either ‘Annotate pathogen-host interaction phenotype’ or ‘Annotate gene-for-gene phenotype’ from the list of actions next to the relevant metagenotype.

Note that you must first have created a metagenotype; see Creating alleles and genotypes for instructions.

Curating pathogen effectors

If you are curating a pathogen effector within a pathogen–host interaction, it is essential that you also make a GO Biological Process annotation on the pathogen gene involved in the interaction, using the GO term "effector-mediated modulation of host process by symbiont" (GO:0140418) or one of its child terms. This will allow the data to be displayed correctly in PHI-base.

Where the molecular function of the effector is known, you will also need to annotate a GO Molecular Function on the pathogen gene. This molecular function annotation must have a 'part_of' annotation extension that links to GO:0140418 or any of its child terms. See the instructions for Gene Ontology Annotation for further guidance on making GO annotations.

The phenotype curation process

Selecting a PHIPO term

PHIPO consists of two branches: a single-species branch, which includes phenotypes associated with either pathogen or host species in isolation; and a pathogen-host interaction branch, which includes phenotypes associated with the outcomes of pathogen-host interactions. Pathogen genotypes can be annotated with single-species phenotype terms, such as 'sexual spores absent' and 'decreased hyphal growth', as well as chemistry phenotypes, such as 'resistance to voriconazole', 'sensitive to voriconazole', and 'normal growth on voriconazole'. Host genotypes can also be annotated with single-species terms, such as 'presence of effector-independent host hypersensitive response'. Metagenotypes can be annotated with pathogen-host interaction phenotype terms, such as 'absence of pathogen growth on host surface' and 'stunted host growth during pathogen colonization'. Note that some terms in the pathogen-host branch describe changes in the pathogen, while other terms describe changes in the host.

To find a PHIPO term, type text into the search box. When suggestions from the autocomplete feature appear, choose one and proceed.

If your initial search does not find any suitable terms, try again with a broader term (e.g. ‘reproductive phenotype’). Selecting a term takes you to a page where you can read the definition to confirm that it is applicable. More specific ‘child’ terms will be shown (where available), and you can select one of these more specific terms in an iterative process.

PHIPO terms are organized in a hierarchical structure, and annotations with PHIPO should be as specific as possible to describe the data from your experiment. You can request a new term if the most specific term available does not adequately describe your disease. Select the ‘Suggest a new child term’ link and fill in the form that is shown:

Experimental evidence

After you choose a term, you will be prompted to select an experimental evidence code from a pulldown menu:

Experimental conditions

After selecting experimental evidence, you can optionally enter any experimental conditions. It is not necessary to record all of the experimental conditions, just those that are key to the experiment.

Conditions are aspects of the experimental setup that may be relevant to various different methods, and are independent of what cells, strain, organism, etc. are used. Examples include:

To add conditions, type text and select from the autocomplete options. Several conditions can be added for one experiment.

Condition terms previously used in the session appear below the text box and can be reused by selecting them:

It is also possible to add experimental conditions that do not appear in the autocomplete list. To do this, type your experimental condition, then either click inside the text box, or hit Enter or Tab on your keyboard. The condition should change to a tag:

PHI-Canto will display custom experimental conditions in red text, pending their review by an expert curator before they are added to the main list of experimental conditions.

Finalizing the annotation

Once you have entered all the data for your annotation, you will see a confirmation page that shows a preview of your annotation before it is created. For single-species phenotypes, the annotation preview will look like this:

For pathogen-host interaction phenotypes and gene-for-gene phenotypes, the preview will look like this:

Figure and table numbers

The confirmation page includes a text box for including the Figure or Table number related to the annotation. Please prefix figure numbers with 'Figure' and table numbers with 'Table'. Prefix supplementary figure and table numbers with an 'S', for example: 'Figure S1'.

Annotation comments

The confirmation page also has a text box where you can add additional information as a comment on each annotation. We recommend that comments include any details that do not fit the available evidence codes.

The data in the comments section will not be shown on the PHI-base website; the comments are intended to facilitate the checking of a session by the approval team (PHI-base and carefully selected species experts) prior to approval of the curated session.

Once you select ‘OK’ on this screen, your annotation will be saved. You can then either make further annotations, pause the session and come back to it later, or submit the completed curation session for approval.

Annotation extensions

You can add annotation extensions to provide additional specificity for PHIPO annotations (see below for specific examples). After you have selected an ontology term and evidence, the PHI-Canto interface will display a list of available extension types (if no extension types are available, this step is skipped, and you will go straight to the annotation summary page).

Select an extension type to show a pop-up where you can specify the required details for the extension. For example, an annotation to ‘abolished pathogen penetration into host’ can have any of these extensions:

You can add multiple extension types to one annotation, but be aware that this has the effect of saying that all the extensions apply to the annotation at once (usually meaning all extensions were present together at some point in time).

If the extensions did not occur together (for example, if different tissues were infected in two separate experiments, rather than both infected at once), then you should apply the extensions to separate annotations. You can use ‘Copy and edit’ on an annotation to speed up the process of adding individual extensions: finish the first annotation with one extension, copy-and-edit to create another annotation, then edit the extensions on the new annotation.

After adding an annotation extension, the extension name shown in annotation tables (and elsewhere) will be a more concise unique identifier.

When you edit or duplicate an annotation, you can also add more extensions, or remove existing extensions. Use the ‘Edit…’ button in the annotation editing pop-up to do this:

It is not possible to edit an existing extension; instead, you must delete the existing extension (by clicking the red cross next to the extension name), then add a new extension.

PHI-Canto supports the following extensions for phenotype annotations:

Pathogen or Host phenotype extensions

Pathogen-host interaction phenotype extensions

Gene-for-gene phenotype extensions

Editing, deleting and duplicating phenotypes

Edit: If you want to make changes to an annotation you have made, use the ‘Edit’ link next to the annotation in the table. In the pop-up edit the appropriate fields, then select ‘OK’.

Transfer: this link allows you to copy the phenotype annotation to one or more genotypes or metagenotypes in the session. Single species phenotypes can be transferred to other genotypes, and pathogen-host interaction phenotypes can be transferred to other metagenotypes. You can choose to include or exclude the annotation extensions of the original annotation on the new annotations.

Copy and edit: this link allows you to copy an annotation to another genotype or metagenotype, or to create a new annotation with minor edits on the same genotype or metagenotype. For example, you may want to indicate that you have observed a phenotype under more than one set of conditions, e.g. at both standard and high temperatures. The interface works the same way as editing an annotation, except that a new annotation is created, and the old annotation is retained without changes.

The ‘Copy and edit’ action differs from the ‘Transfer’ action in that you can edit the annotation before copying it.

Delete: The ‘Delete’ link deletes the annotation.