Integrating non-Gosling visualizations

You may want to visualize a non-Gosling visualization within a Gosling visualization, such as showing a lineage tree along with multiple sequences.

In Gosling, you can do this by using DummyTrack as a placeholder to create space for your non-Gosling visualization. Your non-Gosling visualization can then be overlaid on top of the DummyTrack using JS API functions to get the position of the placeholder.

caution

DummyTrack can only be used with a linear layout at the moment.

DummyTrack demo in the Editor

Here's a DummyTrack specification example

"tracks": [
    {
      "type": "dummy-track",
      "title": "Placeholder",
      "id": "my_track",
      "height": 200,
      "width": 300,
      "style": {"background": "#e6e6e6", "textFontSize": 8, "textFontWeight": "normal"}
    }
],

DummyTrack properties:

property	type	description
type	string	Required. Must be "dummy-track". Used to specify the dummy track
zoomLimits	array	Unused property for DummyTrack
width	number	Specify the track width in pixels.
title	string	Text that gets shown on the DummyTrack
style	DummyTrackStyle	Defines how the track is styled
static	boolean	Must be "true". Whether to disable Zooming and Panning, Default: false.
overlayOnPreviousTrack	boolean
orientation	string	One of "horizontal", "vertical". Specify the orientation.
layout	string	Must be "linear". Only linear layout are supported at this time
id	string	Assigned to uid in a HiGlass view config, used for API and caching.
height	number	Specify the track height in pixels.
assembly	string	Must be "unknown". No assemblies can be associated with a dummy track

DummyTrack has a style property which can take an object with the following properties:

property	type	description
textStrokeWidth	number	Specify the stroke width of the title.
textStroke	string	Specify the stroke color of title.
textFontWeight	string	One of "bold", "normal". Specify the font weight of the title.
textFontSize	number	Specify the font size of the title
outline	string	Color of the outline of the track
background	string	Background color of the track