{"id":497,"date":"2017-03-17T10:28:34","date_gmt":"2017-03-17T17:28:34","guid":{"rendered":"http:\/\/genome.ucsc.edu\/blog\/?p=497"},"modified":"2021-10-30T22:15:08","modified_gmt":"2021-10-30T22:15:08","slug":"how-portable-is-your-track-hub-use-hubcheck-to-find-out","status":"publish","type":"post","link":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/2017\/03\/17\/how-portable-is-your-track-hub-use-hubcheck-to-find-out\/","title":{"rendered":"How portable is your track hub? Use hubCheck to find out!"},"content":{"rendered":"<p><a href=\"https:\/\/genome.ucsc.edu\/goldenPath\/help\/hgTrackHubHelp.html\"><span style=\"font-weight: 400;\">Track and assembly hubs<\/span><\/a><span style=\"font-weight: 400;\"> are collections of data that are hosted on your servers and can be displayed using the UCSC Genome Browser and other genome browsers supporting the UCSC track hub format. Track hubs allow for the visualization of data on assemblies that we already host (such as the human or mouse genomes), while assembly hubs can be used to create genome browsers for any genome assembly of your choosing. <\/span><\/p>\n<p><span style=\"font-weight: 400;\">Hubs depend on a number of different plain text configuration files. The most important are the trackDb.txt files for each assembly in your hub. These files contain the track configuration settings, also known as \u201ctrackDb settings\u201d, that control how the track displays in the Genome Browser as well as the display of the item detail pages. You can see the trackDb settings available for hubs on the <\/span><a href=\"https:\/\/genome.ucsc.edu\/goldenPath\/help\/trackDb\/trackDbHub.html\"><span style=\"font-weight: 400;\">Hub Track Database Definition<\/span><\/a><span style=\"font-weight: 400;\"> page.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">As the track hub format has grown in popularity, other genome browsers, including <\/span><a href=\"http:\/\/www.ensembl.org\/\"><span style=\"font-weight: 400;\">Ensembl<\/span><\/a><span style=\"font-weight: 400;\">, <\/span><a href=\"https:\/\/www.biodalliance.org\/\"><span style=\"font-weight: 400;\">Biodalliance<\/span><\/a><span style=\"font-weight: 400;\">, and the <\/span><a href=\"http:\/\/epigenomegateway.wustl.edu\/\"><span style=\"font-weight: 400;\">WashU Epigenome Browser<\/span><\/a><span style=\"font-weight: 400;\">, have implemented support for the UCSC track hub format. The Ensembl genome browser currently boasts fairly comprehensive support of the UCSC track hub format. In addition to supporting track hubs on their site, the Ensembl team has also created a <\/span><a href=\"https:\/\/trackhubregistry.org\/\"><span style=\"font-weight: 400;\">Track Hub Registry<\/span><\/a><span style=\"font-weight: 400;\"> that pulls hubs listed on our <\/span><a href=\"https:\/\/genome.ucsc.edu\/cgi-bin\/hgHubConnect\"><span style=\"font-weight: 400;\">Public Hubs<\/span><\/a><span style=\"font-weight: 400;\"> page into a centralized database alongside those hubs submitted to their registry. In an attempt to make the adoption of our track hub format easier, we talked to the other genome browsers about what settings were core to a track hub being, well, a track hub. We sort the list of hundreds of settings into various support levels, which include:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Required &#8211; needed to display a hub across the different browsers. <\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Base &#8211; non-required settings that are likely to be supported by other genome browsers<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Full &#8211; all other trackDb settings fully supported in the UCSC Genome Browser<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">New &#8211; settings introduced since the last versioned release, may change between now and the next versioned release<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Deprecated &#8211; settings that may currently work, but could cease to work in the future as they are not being actively developed<\/span><\/li>\n<\/ul>\n<p>We periodically increment the trackDb version number as major updates and changes are made to the settings. The latest change &#8212; version 2 &#8212; included settings related to the release of several \u201cbig*\u201d file types, such as bigGenePred, bigPsl, bigChain, bigMaf, and CRAM. It also included moving several settings (html, priority, colorByStrand, autoScale, spectrum) from the \u201cfull\u201d level to the \u201cbase\u201d level to indicate that they are supported at other genome browsers (at this time primarily Ensembl).<\/p>\n<p><span style=\"font-weight: 400;\">During the initial versioning process, we improved the \u201chubCheck\u201d utility to check the support of the trackDb settings used in your hub against our master list of trackDb settings, by version and support level. The hubCheck tool can be utilised in a variety of different ways; principally it checks if your hub works, but it can also list your hub\u2019s settings and their support levels (required, deprecated, base, full and new) as well as check the support of your settings against any genome browser. &nbsp;For example, to test compatibility with Ensembl (which supports the \u2018base\u2019 level of hub settings), use the command:<\/span><\/p>\n<blockquote><p><span style=\"font-weight: 400;\">hubCheck -checkSettings -level=base http:\/\/genome.ucsc.edu\/goldenPath\/help\/examples\/hubDirectory\/hub.txt<\/span><\/p><\/blockquote>\n<p><span style=\"font-weight: 400;\">You can see more examples of how you might use hubCheck to check the compatibility of your hub with other genome browsers in our <\/span><a href=\"https:\/\/genome.ucsc.edu\/goldenPath\/help\/hgTrackHubHelp.html#Compatibility\"><span style=\"font-weight: 400;\">help documentation<\/span><\/a><span style=\"font-weight: 400;\">. To acquire hubCheck, you can click Downloads from the top blue menu bar and then select Utilities and navigate to the <\/span><a href=\"http:\/\/hgdownload.soe.ucsc.edu\/admin\/exe\/\"><span style=\"font-weight: 400;\">utilities directory<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">If you have questions about creating or validating your track and assembly hubs, please feel free to <\/span><a href=\"https:\/\/genome.ucsc.edu\/contacts.html\"><span style=\"font-weight: 400;\">contact us<\/span><\/a><span style=\"font-weight: 400;\">!<\/span><\/p>\n<p><span style=\"font-weight: 400;\">For more information on hubs in the UCSC Genome Browser, please see the following pages:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/genome.ucsc.edu\/goldenPath\/help\/hgTrackHubHelp.html\"><span style=\"font-weight: 400;\">Track Hub User Guide<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/genome.ucsc.edu\/goldenPath\/help\/trackDb\/trackDbHub.html\"><span style=\"font-weight: 400;\">Hub Track Database Definition<\/span><\/a><\/li>\n<\/ul>\n<p>For more information on hubs in other genome browsers, see their help pages here:<\/p>\n<ul>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/www.biodalliance.org\/config.html\"><span style=\"font-weight: 400;\">Biodalliance<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"http:\/\/www.ensembl.org\/info\/website\/trackhub_support.html\"><span style=\"font-weight: 400;\">Ensembl<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"http:\/\/wiki.wubrowse.org\/Displaying_track_hubs_from_UCSC_Genome_Browser\"><span style=\"font-weight: 400;\">WashU Epigenome Browser<\/span><\/a><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Questions about other genome browsers support for hubs should be directed to their mailing lists. <\/span><\/p>\n<hr>\n<p>If after reading this blog post you have any public questions, please email <a href=\"mailto:genome@soe.ucsc.edu\" target=\"_blank\" rel=\"noopener\">genome@soe.ucsc.edu<\/a>. All messages sent to that address are archived on a <a href=\"https:\/\/groups.google.com\/a\/soe.ucsc.edu\/forum\/#!forum\/genome\">publicly accessible forum<\/a>. If your question includes sensitive data, you may send it instead to&nbsp;<a href=\"mailto:genome-www@soe.ucsc.edu\" target=\"_blank\" rel=\"noopener\">genome-www@soe.ucsc.edu<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Track and assembly hubs are collections of data that are hosted on your servers and can be displayed using the UCSC Genome Browser and other genome browsers supporting the UCSC track hub format. Track hubs allow for the visualization of data on assemblies that we already host (such as the human or mouse genomes), while [&hellip;]<\/p>\n","protected":false},"author":17,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-497","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/wp-json\/wp\/v2\/posts\/497","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/wp-json\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/wp-json\/wp\/v2\/comments?post=497"}],"version-history":[{"count":5,"href":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/wp-json\/wp\/v2\/posts\/497\/revisions"}],"predecessor-version":[{"id":1044,"href":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/wp-json\/wp\/v2\/posts\/497\/revisions\/1044"}],"wp:attachment":[{"href":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/wp-json\/wp\/v2\/media?parent=497"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/wp-json\/wp\/v2\/categories?post=497"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/genome-blog.gi.ucsc.edu\/blog\/wp-json\/wp\/v2\/tags?post=497"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}