Hierarchical track selector
TL;DR: control track grouping, sorting, and collapse with hierarchical
settings under configuration. Add a metadata object to any track to gain
filterable columns in the faceted selector.
By default, tracks appear in the order defined in config.json. The following options control sorting and default collapse behavior.
-
hierarchical.sort.trackNames: sort track names alphabetically -
hierarchical.sort.categories: sort categories alphabetically (independent of track name sorting) -
hierarchical.defaultCollapsed.categoryNames: category names to collapse at startup. For nested categories, use a comma-joined path (e.g."Wiggle,Wiggle Rendering Styles") -
hierarchical.defaultCollapsed.topLevelCategories: collapse all top-level categories at startup -
hierarchical.defaultCollapsed.subCategories: collapse all sub-categories at startup
Example config.json with examples of these hierarchical settings:
{
"configuration": {
"hierarchical": {
"sort": {
"trackNames": true,
"categories": true
},
"defaultCollapsed": {
"categoryNames": ["VCF"],
"topLevelCategories": true,
"subCategories": true
}
}
}
}defaultCollapsed options only apply on initial startup. Afterwards the user's
preference is preserved in their session.
Typing in the filter box opens every category for as long as the query is active, so a match inside a collapsed category or a folder is still shown. Clearing the box restores whatever was collapsed before.
Folder categories (supertracks)
Categories can be displayed in "folder mode", which replaces the entire category with a compact folder row showing how many of its tracks are turned on. Clicking a folder opens a faceted track selector scoped to just the tracks in that category.
hierarchical.defaultFolderCategories: categories to display as folders at startup. Use the category name for top-level categories, or a comma-joined path for nested categories (e.g."Wiggle,Wiggle Rendering Styles")
Users can also switch any category between folder and normal mode at runtime via the category's context menu ("Show as folder" / "Show as list"). Top-level group rows (the config's own tracks, and each connection) can't become folders, since clicking a connection's row is what loads it.
Example config.json:
{
"configuration": {
"hierarchical": {
"defaultFolderCategories": ["Wiggle", "Alignments,Coverage"]
}
}
}Like defaultCollapsed, defaultFolderCategories only applies on initial
startup. Afterwards the user's preference is preserved in their session.
For plugin developers: the category ID used internally is
Tracks-{categoryPath} (the full comma-joined path), which is the value matched
against in the TrackSelector-folderDialog extension point.
See the hierarchical config schema docs for the full auto-generated reference, including each slot's type and default value.
Faceted track selector
The faceted track selector shows all tracks as a searchable, filterable table. Open it by clicking the filter icon in the top right of the "Available tracks" widget (or via a folder category's context menu).
Default columns shown for every track:
- Name
- Category (from
categoryin the track config) - Adapter (adapter type, e.g.
Gff3TabixAdapter) - Description
Columns that are empty for every track are hidden automatically.
Adding metadata columns
Any metadata object in a track config adds extra filterable columns, one per
top-level key:
{
"trackId": "my_track",
"name": "My Track",
"metadata": {
"origin": "public",
"tissue": "liver",
"date_added": "2024-02-20"
}
}The faceted selector gains origin, tissue, and date_added columns to filter or sort on.
The left-hand filter panel shows checkboxes for each distinct value in a column. You can combine filters across multiple columns, and use the search box at the top to further narrow results by name, category, or description.