The default configuration is stored in
canto.yaml in the top level
directory. Any installation specific settings can be added to
canto_deploy.yaml, and will override the defaults. The
will be created automatically by the
canto_start start script when it is run
The configuration files are YAML format.
A one word name for the site. default: Canto
A longer description of the site. e.g. The SlugBase community annotation tool
The destination database name. This is used whenever we need to refer to the destination of the annotations while curating.
The URL of the database that this instance is installed for. e.g.
The subtitle to use on the front greeting page.
A path (relative to
root/static) of the logo to put in the header.
Canto has two modes: single or multi organism. Single organism mode is activated by setting an "instance organism". That organism will be assumed throughout the interface. Only genes from that single organism can be annotated and the user will not be shown the organism name.
In multi organism mode, genes from any number of organisms can be annotated in each session. In this mode after uploading a list of gene identifiers, the user will be shown the organism name as well as the names, synonyms and products. The organism is shown so the user can confirm that the identifier they gave matched the gene from the right organism. Generally an external gene adaptor should be configured using the instance_organism setting in the multi-organism case.
instance_organism: taxonid: 4896
The link for the main Canto web site.
The software version, automatically updated each release.
The version of the schema. This is incremented when the schema changes in an incompatible way.
Configuration for the Catalyst authentication code. This shouldn't need changing.
Configuration for the admin view pages.
The maximum number of lines of results to show in a table on an object page.
If 1, allow editing of the expression of alleles and show the expression as a column in the genotype table on the genotype management page.
If 1, show the organism in a selector on the genotype management pages and only show genes and genotypes for the selected organism.
If 0, hide the list of genes and actions on the left hand side of the genotype management page.
If 1, allow notes/comments on diploids and multi-locus genotypes.
If 0, a wildtype allele is allowed only if there is another non-wildtype or non-wildtype expression allele from the same gene.
If 1, allow diploids to be created and used in genotypes.
Data needed to initialise a Canto instance.
Descriptions of table in the database used by the interface. This information is used for rendering the view and object pages.
A list of report names to show on the front page.
Configuration for exporting.
Configuration for loading data.
The template database to use when creating a new Canto instance.
The template database to use when creating a new curation session.
The name of the directory used for the ontology Lucene index. This index is used to do autocompeletion in the interface.
URLs of external services.
Names of classes used to implement database query and storage. This allows the implementations to be swapped from the defaults.
Used to look up gene identifier, name, synonyms and products. The default is to use the internal Canto database ("track").
Short name (codes) and long names of evidence types. Any evidence type configured with the option "with_gene" set to true will cause the interface to ask for a gene for later storage in the "with/from" column of a GAF file.
evidence_types: IMP: name: Inferred from Mutant Phenotype IDA: name: Inferred from Direct Assay IGI: name: Inferred from Genetic Interaction with_gene: 1 Microscopy: ~
In this case "Microscopy" is treated as an evidence code and an evience description.
List of possible annotation type and their configuration details.
See Configuring annotation types for details.
The names of the types that are enabled in this Canto instance. If not set
all annotation types from
available_annotation_type_list will be enabled.
The identifier for this annotation type, used internally and in URLs.
One of: "ontology" or "interaction", used to select which Perl package should be used for rendering and storing these annotation type.
The path to the extra configuration file needed while testing.
The keys under
help_text identify a page in Canto and under the key is one
or both of
url. The help text and link is rendered by the
inline_help.mhtml template. If a
url is given, the text under
title attribute of a link with that URL. Without a
url a help link
(a "?" icon) will be shown and the
inline text will be displayed in a pop-up
This email address is shown anytime a contact address is needed. See the
Each external link configuration has three possible parameters:
name- The text to use as the title of the link.
icon- An image from the
root/static/images/logosto use as the
<img>in the link.
url- The URL to the appropriate page on an external site. This string can contain text to substitute in the form
@@key@@. On the gene page, the key can be
primary_identifier(the gene systematic ID) or
primary_name(the gene name). On the publication page the key should be
uniquenamewhich will substitute the PubMed ID into the URL.
sysid_link- This external link will be used to hyperlink the primary identifier on the gene page as well as being shown in the external links section on the right of the page.
There are two possible types of external link on the gene pages:
generic- These links will be shown on all gene pages.
organism- These links are specific to the given organism. The keys under the
organismsection will be the full organism name (ie "Genus species").
The external links are implemented in the
Configuring annotation types
The possible annotation type are set with the
available_annotation_type_list configuration. It should be set to a
list of maps. An example is provided in the
canto.yaml but can be
overridden in the instance specific
canto_deploy.yaml you can add an optional
enabled_annotation_type_list. If set only the listed types will be enabled.
For example this would enable just two annotation types:
enabled_annotation_type_list: - molecular_function - cellular_component
enabled_annotation_type_list exists so that one
available_annotation_type_list configuration in
canto.yaml can be used in
several Canto instances. It is optional. If not set, all available types are
Each annotation type in
available_annotation_type_list has the following
A short internal name or key for this type. (Required)
This setting selects which code to use for the interface for this type. There
are currently two possibilities:
The long name to display in the user for this type. eg. for
molecular_function PomBase displays
GO molecular function. (Required)
A shorter name for this type. eg
molecular function (Optional)
A very short name for this type. eg
F for GO molecular function. (Optional)
Currently used only for types from GO (
biological_process), the abbreviation is used from
exporting annotation to GAF files. Required only if GO ontologies are enabled.
Possible evidence codes for this annotation type. Each evidence code must
appear in the
evidence_types list. (Required)
Evidence codes that are only available for logged in admin user. This
list is added to the
A few comma separated high level or broad term names for use in help text. eg. for molecular function: "transporter, transferase activity" (Required only for ontology annotation types)
Comma separated specific term name examples. eg. "adenylate cyclase activity or biotin transporter activity" (Required only for ontology annotation types)
Short help to be soon initially to users when they begin an annotation of this type. (Required)
A longer help text shown when the user clicks "more ..." under the help_text. (Optional)
A path in the documentation directory (
root/docs/) to link to for detailed
help about this type of annotation.
Help text to show once the user finishes annotating a paper, after "Submit to curators". (Optional)
A list of taxon IDs for the organisms that are treated as host species
in pathogen-host mode. All the list taxon IDs need to match organisms
in the organism table. The organisms are loaded using
canto_add.pl --organism. See the Canto setup documentation
If this list has any elements, Canto will start in pathogen-host
mode and the internal config setting
pathogen_host_mode will be
automatically set to 1. Also
host_organisms will be set to
a list the Organism objects.
multi_organism_mode is also set to
Note that when
pathogen_host_mode is enabled, every organism that is in the organism table but not in
host_organism_taxonids will be assumed to be a pathogen organism.
This list contains the configuration for each allele type
The allele type name to show in the display. This is also the key when looking up configuration details so it must be unique.
The type name to use when writing the export file. See Exporting data from Canto for more.
If true, show the description input box in the allele edit dialog.
If true, an allele of this type can't be created without a description.
If true, alleles of this types must have a name.
If true, show the checkboxes for changing the allele expression.
If true, an allele of this type can't be created without setting an expression level.
This template is used when an allele name can be automatically generated for a given type. For example, if the user selects "wild type" in the allele editing dialog, this template when set the name to something like "cdc2+". The string "@@gene_display_name@@" will be replaced with the current gene's name or systematic ID.