Help topics

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

Whilst Ensembl and the Track Hub Registry supports assembly synonyms, 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

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 at the moment they are not grouped together visually nor can they be overlaid using the 'container multiWig' option.

  • parent
  • 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