2c66cf38bdd66fd2c5cb9a5a23de69ca2c24bec5 braney Mon Aug 31 13:14:15 2026 -0700 Add the track types that a code read confirms for nine trackDb settings This is the first part of the Tier B pass on the "For Types" lists. Tier B holds the settings that real tracks use on a type the docs never mention. Usage alone is not proof, because a setting can be set on a track and do nothing there, so each row here was confirmed by finding the code that reads the setting and showing that it serves the added type. The barChart family, barChartBars, barChartLabel, barChartMetric and barChartUnit, listed bigBarChart alone. cfgTypeFromTdb sends both barChart and bigBarChart to cfgBarChart, and barChartUi.c serves the pair, so barChart is added to all four. indelDoubleInsert listed bam. One blurb covers it and indelQueryInsert and indelPolyA. indelEnabled (hui.c:1586) takes a trackDb and never looks at the type, and linkedFeaturesDrawAt calls it at simpleTracks.c:4391, so the whole linked-features family reaches it and not only bamTrack.c. psl and bigPsl are added: they are the two types with real usage, 3494 and 2338 tracks, and the hub spec has listed all three settings under bigPsl for years, so the hub page and the library have disagreed about this. mouseOver and mouseOverField gain bigLolly, which lollyTrack.c reads at lines 384 and 377. motifPwmTable gains bigBed, read on the bigBed details path at hgc/bigBedClick.c:584. logoMaf gains wig, read off tg->tdb with no type gate at wigTrack.c:2029, in a file that serves plain wig as well as bigWig. trackDbSettings.yaml and .json are regenerated. refs #37908 diff --git src/hg/htdocs/goldenPath/help/trackDb/trackDbSettings.json src/hg/htdocs/goldenPath/help/trackDb/trackDbSettings.json index 5fdf7dfaee7..cc5c25ea2c7 100644 --- src/hg/htdocs/goldenPath/help/trackDb/trackDbSettings.json +++ src/hg/htdocs/goldenPath/help/trackDb/trackDbSettings.json @@ -1,3994 +1,4003 @@ { "version": "v3", "categories": [ "Common Settings", "Common Settings - less frequent", "bam - Compressed Alignment Track Settings", "bigBarChart", "bigBed - Item or Region Track Settings", "Item or Region Track Settings - less frequent", "bigChain - Pairwise Alignments", "bigGenePred - Gene Annotations", "bigInteract", "bigMaf - Multiple Alignments", "bigNarrowPeak - Peaks", "bigPsl - Pairwise Alignments", "bigWig - Signal Graphing Track Settings", "bigLolly - Lollipop charts", "hic - Hi-C contact matrices", "halSnake - Multiple Alignments", "vcfTabix - Variant Call Format Track Settings", "vcfPhasedTrio - Variant Call Format Track Settings", "superTrack - Folder Track Settings", "Composite Track Settings", "Composite - Subgroups Settings", "Composite - Views Settings", "Faceted Composite Settings", "Aggregate or Overlay Track Settings", "general hub file settings", "genomes file settings", "Miscellaneous Deprecated Settings" ], "settings": [ { "key": "track", "category": "Common Settings", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "required", "fmt": "track", "ex": "track myFirstTrack", "desc": "This is the name of the dataset and must be unique within the Genome Browser or dataHub." }, { "key": "type", "category": "Common Settings", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "required", "fmt": "type", "ex": "type bigBed 6 +", "desc": "Declares the format of the data and is used to determine display methods and options." }, { "key": "shortLabel", "category": "Common Settings", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "required", "fmt": "shortLabel", "ex": "shortLabel Human mRNAs", "desc": "Specifies the track's \"short label\", which is used in a number of places in the Browser to identify the track." }, { "key": "longLabel", "category": "Common Settings", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "required", "fmt": "longLabel", "ex": "longLabel Human mRNAs from GenBank", "desc": "Specifies the track's \"long label\", which is also used in numerous places in the Browser to identify a track." }, { "key": "bigDataUrl", "category": "Common Settings", "roles": [ "super", "composite", "view", "leaf" ], "types": [ "bigBarChart", "bigBed", "bigChain", "bigInteract", "bigLolly", "bigMaf", "bigPsl", "bigWig", "bam", "hic", "vcfTabix", "vcfPhasedTrio" ], "level": "required", "fmt": "bigDataUrl ", "ex": "bigDataUrl http://vizhub.wustl.edu/VizHub/hg19/biBrainH3K4me1.bb", "desc": "The location of a remote data file containing the bulk of the data for the track." }, { "key": "html", "category": "Common Settings", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "base", "fmt": "html", "ex": "html docs/myFirstTrack.html", "desc": "Use the html path/to/explain.html to specify the file that contains the complete description of a track in HTML format." }, { "key": "visibility", "category": "Common Settings", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "required", "fmt": "visibility", "ex": "visibility dense", "desc": "Visibility (i.e." }, { "key": "meta", "category": "Common Settings", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "full", "fmt": "meta", "ex": "", "desc": "Meta specifies the metadata tag for this track." }, { "key": "color", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "base", "fmt": "color ", "ex": "color 255,0,0", "desc": "Many track types allow the color of the data displayed in the image to be specified with this setting." }, { "key": "priority", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "base", "fmt": "priority ", "ex": "priority 50", "desc": "The priority is used to define the order of a track within its track group or data hub, as well as its default order within the Browser image." }, { "key": "canPack", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "deprecated", "fmt": "canPack ", "ex": "canPack on", "desc": "Deprecated." }, { "key": "configureByPopup", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "full", "fmt": "configureByPopup ", "ex": "configureByPopup off", "desc": "Most track displays that can be configured by a user can also be configured from directly within the Browser image through a right-click option that pops up..." }, { "key": "origAssembly", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "full", "fmt": "origAssembly ", "ex": "origAssembly hg18", "desc": "The original assembly version for which the dataset was generated." }, { "key": "altColor", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "full", "fmt": "altColor ", "ex": "altColor 0,0,255", "desc": "Many track types allow setting a color range that varies from color to altColor ." }, { "key": "boxedCfg", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "full", "fmt": "boxedCfg ", "ex": "boxedCfg on", "desc": "Configuration controls can be placed inside a box on the configuration page." }, { "key": "chromosomes", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "full", "fmt": "chromosomes ", "ex": "chromosomes chr1,chr7,chr18,chr19,chr22,chrX,chrM", "desc": "Some datasets do not contain data for all chromosomes of a genome." }, { "key": "darkerLabels", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "full", "fmt": "darkerLabels on", "ex": "", "desc": "If this setting is \"on\", the color of the left labels on the track display will have a somewhat darker color than the track display itself." }, { "key": "dataVersion", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "full", "fmt": "dataVersion ", "ex": "dataVersion May 2011 beta", "desc": "Many tracks undergo multiple revisions over time." }, { "key": "directUrl_for_hubs", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "full", "fmt": "directUrl ", "ex": "directUrl http://mygenes.org/cgi-bin/geneView/%s", "desc": "By default, items shown in the Browser image can be linked to a details page giving information about that item." }, { "key": "downloadUrl", "category": "Common Settings - less frequent", "roles": [ "super", "composite", "view", "leaf" ], "types": "all", "level": "full", "fmt": "downloadUrl