Setting up a Genome Explorer repository

From GenomeView Manual
Revision as of 01:09, 16 November 2013 by Thomas Admin (talk | contribs) (→‎Setting up the configuration file)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

GenomeView allows you to set up a custom repository of genomes that will be loaded as primary view in the Genome Explorer


  1. Set up a repository file
  2. Set up configuration file
  3. Make launch URL

Repository file format

The repository file is a tab-delimited file where each column has a special meaning. These should be one row per session, i.e. per data set.

  1. repository identifier
  2. display name for session, should be reasonably short and informative people
  3. display image for session, this should be a URL
  4. description text for individual session, this can be html code.
  5. url to the session file.

An example row could be:

fusobac Fusobacterium nucleatum animalis Fusobacterium nucleatum animalis is from a colon sample. This strain was sequenced at Baylor College of Medicine.

Setting up the configuration file

In order to work with the new repository file, you need to create a config file that specifies where GenomeView has to look for it.

The key options you need to set are:

# Make sure the Genome Explorer is enabled
# Point GenomeView to your repository
# Provide display names for the repository identifier you used in the first column
external:repository:labels=<repository identifier>:<repository display name>

For each repository identifier you also need to fill out the description field:

external:repository:description:<repository identifier>=<long HTML formatted description>

For example:

external:repository:labels=fusobac:Fusobacterium Repository
external:repository:description:fusobac=Welcome to the Fusobacterium GenomeView portal. Blah blah blah...

Setting up launch URL

The final step is to start GenomeView with this configuration file. Suppose you make the config file available at, then the launch URL would be: