92af4b0363b70062f69a5730648b20bd8e52a317 braney Mon Aug 31 13:34:03 2026 -0700 Drop bed from searchIndex and searchTrix, and deprecate pslSequence instead of deleting it This is the reverse of the earlier passes. Instead of asking what a type list is missing, it asks which declared type nothing supports. searchIndex and searchTrix both declared bed. Neither works on a SQL bed table. The trackDb read for searchIndex is at bigBedFind.c:270 and it then needs a bbi file, from bigDataUrl or from the table's fileName, which a plain bed table does not have. searchTrix has two readers: bigBedFind.c:312 reads it from trackDb on the bigBed path, while hgFind.c:2393 reads it from hgFindSpec, which is how a SQL track gets trix search. Native usage agrees, with zero bed tracks for either setting. searchIndex also gains bigPsl, bigGenePred and bigBarChart, and searchTrix gains bigGenePred, all of which have real usage. pslSequence was deleted outright in 0e4e0c0af65. It is obsolete, but deleting the row was the wrong way to say so. 118 psl and 6 bigPsl native tracks set it, and so do three public-hub bigPsl tracks. hubCheck takes its vocabulary from this page, so with no row those hub authors would be told the setting "is not recognized. Check for typos", with a spelling suggestion, which is the wrong advice for a setting they took from our own documentation. The row is back at level-deprecated, which makes hubCheck say "is deprecated" instead, the way it already does for canPack, useScore, metadata and noInherit. Verified by running hubCheck against both spellings of the page. The library blurb is restored too, rewritten to say the setting is obsolete and to map its three values onto baseColorDefault, which replaced it in 8d32ba75938 in 2006. chainMinScore is deliberately left alone. It was proposed for deletion on the grounds that nothing reads it. Nothing does, but our own automation writes it: asmHubChainNetTrackDb.pl:101 and chainNetCompositeTrackDb.pl:186 emit "chainMinScore 5000" into the chainNet composite stanza, and findScores.pl converts -minScore into it. 40,920 native bed stanzas and 16 chain tracks carry it today. It records the minScore the chains were built with. Removing its documentation would leave those stanzas with an undocumented setting. changes.html gains a row for the type lists corrected across all three of these commits, and its existing pslSequence row is rewritten: it said the setting was removed, which is no longer what happened. Since the earlier commit has not shipped to the RR, no reader ever saw the "Removed" wording. trackDbSettings.yaml and .json are regenerated, and now hold 263 settings. refs #37908 diff --git src/hg/htdocs/goldenPath/help/trackDb/trackDbSettings.json src/hg/htdocs/goldenPath/help/trackDb/trackDbSettings.json index cc5c25ea2c7..4cd7823d864 100644 --- src/hg/htdocs/goldenPath/help/trackDb/trackDbSettings.json +++ src/hg/htdocs/goldenPath/help/trackDb/trackDbSettings.json @@ -1,4003 +1,4020 @@ { "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