Track Hub Support in Ensembl

Hosting

IMPORTANT: Please note that you cannot host your trackhub on Google Drive, Dropbox, or similar cloud services. This is because these services do not support loading of partial files (such as regions of BigWig data). We recommend using a conventional web server or FTP server, or a free hosting service specialising in scientific data such as Cyverse (full instructions for using Cyverse can be found in the UCSC track hub documentation, though the service is not limited to track hubs).

genomes.txt

This file should contain a list of the genomes in your hub, identified by their assembly ID (not by species, as we have multiple assemblies for some species). For human and mouse, please use either the standard Ensembl assembly name (GRCh38, GRCh38) or the UCSC synonym - we do not support using the GCA accession for these species because each patch version has a different accession.

Also, if you wish to use your hub with both Ensembl and UCSC you will need to use the UCSC assembly name in your hub, e.g.

genome hg38
trackDb hg38/trackDb.txt

Unfortunately we cannot support other assembly synonyms at the moment, as we have no mappings between these synonyms and the corresponding Ensembl IDs.

TrackDb.txt

Whilst we aim to support all the base features of track hubs, many of the other parameters are rarely used or apply only to UCSC's browser. Any options not mentioned in the lists below have not yet been addressed but may be supported in future releases.

Supported

The following parameters are supported by Ensembl - where there are differences, these are noted below.

General attributes

Required

  • track
  • type - valid settings are: bam, cram, bigBed, bigWig, vcfTabix, multiWig ('cram' is in addition to UCSC's supported formats)
  • shortLabel
  • longLabel
  • bigDataUrl

Optional

  • html
  • visibility - UCSC display settings are mapped as closely as possible to Ensembl styles, but there may be differences owing to options not being available
  • color - in addition to the standard RGB values, Ensembl will honour hexadecimal web colours (e.g. ff0099) and Unix named colours (e.g. slateblue).
  • altColor - experimental; currently only used on negative values
  • priority

Grouping tracks

Grouped tracks are drawn adjacent to one another but not as a single block, so you can drag'n'drop them individually. Composite tracks can be turned on and off as a group using the 'Select/Deselect All' option in the control panel.

We now support 'container multiWig', which superimposes a group of bigWig files into a single track. However owing to the way our code is written, you cannot turn off individual tracks within a multiWig, only the whole set at once.

  • parent
  • container
  • superTrack
  • compositeTrack
  • subGroup
  • dimensions - the first two dimensions are used to create a configuration matrix, with other dimensions available via a popup menu on each matrix cell

Format-specific attributes

BigBed

  • itemRgb
  • colorByStrand - see 'color' for supported colour types
  • spectrum - currently experimental, so suboptions may not be supported

BigWig

  • autoScale
  • viewLimits
  • maxHeightPixels

Not supported

The following options are specific to the UCSC browser and will be ignored by Ensembl:

  • allButtonPair
  • boxedCfg
  • centerLabelsDense
  • configurable
  • dragAndDrop - Ensembl supports drag-and-drop track reordering, both within the image and on the 'Track Order' page of the browser's configuration panel
  • exonArrows
  • exonArrowsDense
  • nextExonText
  • pennantIcon
  • thickDrawItem