@gmod/jbrowse

<!DOCTYPE html><html lang="en"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>biodb-to-json.pl · JBrowse</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="### biodb-to-json.pl"/><meta name="docsearch:language" content="en"/><meta property="og:title" content="biodb-to-json.pl · JBrowse"/><meta property="og:type" content="website"/><meta property="og:url" content="https://jbrowse.org/index.html"/><meta property="og:description" content="### biodb-to-json.pl"/><meta name="twitter:card" content="summary"/><link rel="shortcut icon" href="/img/favicon.ico"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css"/><link rel="alternate" type="application/atom+xml" href="https://jbrowse.org/blog/atom.xml" title="JBrowse Blog ATOM Feed"/><link rel="alternate" type="application/rss+xml" href="https://jbrowse.org/blog/feed.xml" title="JBrowse Blog RSS Feed"/><script type="text/javascript" src="https://buttons.github.io/buttons.js"></script><link rel="stylesheet" href="/css/main.css"/></head><body class="sideNavVisible separateOnPageNav"><div class="fixedHeaderContainer"><div class="headerWrapper wrapper"><header><a href="/"><h2 class="headerTitle">JBrowse</h2></a><div class="navigationWrapper navigationSlider"><nav class="slidingNav"><ul class="nav-site nav-site-internal"><li class=""><a href="/blog" target="_self">Blog</a></li><li class="siteNavGroupActive"><a href="/docs/installation.html" target="_self">Documentation</a></li><li class=""><a href="/en/demos.html" target="_self">Demos</a></li><li class=""><a href="/en/developers.html" target="_self">Developers</a></li><li class=""><a href="/en/contact.html" target="_self">Contact</a></li><li class=""><a href="/en/references.html" target="_self">References</a></li><li class=""><a href="/en/help.html" target="_self">Help</a></li></ul></nav></div></header></div></div><div class="navPusher"><div class="docMainWrapper wrapper"><div class="container docsNavContainer" id="docsNav"><nav class="toc"><div class="toggleNav"><section class="navWrapper wrapper"><div class="navBreadcrumb wrapper"><div class="navToggle" id="navToggler"></div><h2>›Command line</h2><div class="tocToggler" id="tocToggler"></div></div><div class="navGroups"><div class="navGroup"><h3 class="navGroupCategoryTitle">Tutorial</h3><ul><li class="navListItem"><a class="navItem" href="/docs/installation.html">Installation</a></li><li class="navListItem"><a class="navItem" href="/docs/tutorial.html">Indexed file formats tutorial</a></li><li class="navListItem"><a class="navItem" href="/docs/tutorial_classic.html">Classic quick-start guide</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle">Configuring tracks</h3><ul><li class="navListItem"><a class="navItem" href="/docs/reference_sequence.html">Reference sequence configuration</a></li><li class="navListItem"><a class="navItem" href="/docs/canvas_features.html">CanvasFeatures</a></li><li class="navListItem"><a class="navItem" href="/docs/html_features.html">HTMLFeatures</a></li><li class="navListItem"><a class="navItem" href="/docs/alignments.html">Alignments tracks</a></li><li class="navListItem"><a class="navItem" href="/docs/bigwig.html">Wiggle/BigWig Tracks</a></li><li class="navListItem"><a class="navItem" href="/docs/variants.html">VCF tracks</a></li><li class="navListItem"><a class="navItem" href="/docs/minimal.html">Minimal JBrowse configurations</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle">Advanced configuration</h3><ul><li class="navListItem"><a class="navItem" href="/docs/embedding.html">Embedding JBrowse</a></li><li class="navListItem"><a class="navItem" href="/docs/mouse_configs.html">Mouse clicks, menus, and popups</a></li><li class="navListItem"><a class="navItem" href="/docs/configuration_file_formats.html">Configuration File Formats</a></li><li class="navListItem"><a class="navItem" href="/docs/dataset_selector.html">Dataset Selector</a></li><li class="navListItem"><a class="navItem" href="/docs/track_selectors.html">Track Selectors</a></li><li class="navListItem"><a class="navItem" href="/docs/track_metadata.html">Track Metadata</a></li><li class="navListItem"><a class="navItem" href="/docs/global_options.html">Global configuration options</a></li><li class="navListItem"><a class="navItem" href="/docs/compression.html">Compressing JBrowse data</a></li><li class="navListItem"><a class="navItem" href="/docs/authentication.html">HTTP authentication for JBrowse</a></li><li class="navListItem"><a class="navItem" href="/docs/paired_reads.html">Paired read viewing</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle">Command line</h3><ul><li class="navListItem"><a class="navItem" href="/docs/flatfile-to-json.pl.html">flatfile-to-json.pl</a></li><li class="navListItem"><a class="navItem" href="/docs/remove-track.pl.html">remove-track.pl</a></li><li class="navListItem"><a class="navItem" href="/docs/ucsc-to-json.pl.html">ucsc-to-json.pl</a></li><li class="navListItem"><a class="navItem" href="/docs/generate-names.pl.html">generate-names.pl</a></li><li class="navListItem"><a class="navItem" href="/docs/prepare-refseqs.pl.html">prepare-refseqs.pl</a></li><li class="navListItem navListItemActive"><a class="navItem" href="/docs/biodb-to-json.pl.html">biodb-to-json.pl</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle">JBrowse Desktop</h3><ul><li class="navListItem"><a class="navItem" href="/docs/jbrowse_desktop.html">JBrowse Desktop</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle">FAQ</h3><ul><li class="navListItem"><a class="navItem" href="/docs/faq.html">JBrowse FAQ</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle">Other topics</h3><ul><li class="navListItem"><a class="navItem" href="/docs/url_strings.html">JBrowse URL parameters</a></li><li class="navListItem"><a class="navItem" href="/docs/image_tracks.html">Pre-rendered Image Tracks</a></li><li class="navListItem"><a class="navItem" href="/docs/feature_coverage.html">Feature Coverage Tracks</a></li><li class="navListItem"><a class="navItem" href="/docs/screenshots.html">Automating screenshots of JBrowse</a></li><li class="navListItem"><a class="navItem" href="/docs/events.html">JBrowse Subscribe/Publish events</a></li><li class="navListItem"><a class="navItem" href="/docs/perl_config.html">Sample configuration bash script</a></li><li class="navListItem"><a class="navItem" href="/docs/data_formats.html">JBrowse REST API and Data APIs</a></li><li class="navListItem"><a class="navItem" href="/docs/plugins.html">Installing and writing plugins</a></li><li class="navListItem"><a class="navItem" href="/docs/cors.html">Cross-origin resource sharing (CORS)</a></li><li class="navListItem"><a class="navItem" href="/docs/sparql.html">SPARQL configuration</a></li><li class="navListItem"><a class="navItem" href="/docs/data_export.html">Data export</a></li><li class="navListItem"><a class="navItem" href="/docs/usage_stats.html">Usage Statistics</a></li></ul></div></div></section></div><script> document.addEventListener('DOMContentLoaded', function() { createToggler('#navToggler', '#docsNav', 'docsSliderActive'); createToggler('#tocToggler', 'body', 'tocActive'); const headings = document.querySelector('.toc-headings'); headings && headings.addEventListener('click', function(event) { if (event.target.tagName === 'A') { document.body.classList.remove('tocActive'); } }, false); function createToggler(togglerSelector, targetSelector, className) { var toggler = document.querySelector(togglerSelector); var target = document.querySelector(targetSelector); toggler.onclick = function(event) { event.preventDefault(); target.classList.toggle(className); }; } }); </script></nav></div><div class="container mainContainer"><div class="wrapper"><div class="post"><header class="postHeader"><h1 class="postHeaderTitle">biodb-to-json.pl</h1></header><article><div><h3><a class="anchor" aria-hidden="true" id="biodb-to-jsonpl"></a><a href="#biodb-to-jsonpl" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>biodb-to-json.pl</h3> This script uses a <a href="/JBrowseDev/Current/Usage/ConfigFiles" title="wikilink">config file</a> to produce a set of feature tracks in JBrowse. It can be used to obtain information from any database with appropriate <a href="/Glossary#Database_Schema" title="wikilink">schema</a>, or from flat files. Because it can produce several feature tracks in a single execution, it is useful for large-scale feature data entry into JBrowse. Basic usage: <code>bin/biodb-to-json.pl --conf <config file> [options]</code> For a full list of the options supported by biodb-to-json.pl, run it with the --help option, like: <code>bin/biodb-to-json.pl --help</code> The <code>biodb-to-json.pl</code> and <code>prepare-refseqs.pl</code> can use a configuration file to connect to an existing <code>Bio::DB::*</code> database and batch-format its data for use by JBrowse <h2><a class="anchor" aria-hidden="true" id="important-note"></a><a href="#important-note" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Important note</h2> You should know that biodb-to-json.pl is not necessary for most common JBrowse use cases. The reasons that biodb-to-json.pl would be used is if: <ul> <li>you have an actual <code>BioDB::*</code> format like Chado</li> <li>you have plain flatfile formats like GFF but also want advanced pre-configured JSON</li> </ul> Note that the volvox sample data uses the second case. It loads from a GFF using <code>biodb-to-json.pl</code> but since there are many sort of advanced configurations, having those configuration pre-made in the <code>biodb-to-json.pl</code> config format helps <h2><a class="anchor" aria-hidden="true" id="alternative-to-biodb-to-jsonpl"></a><a href="#alternative-to-biodb-to-jsonpl" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Alternative to biodb-to-json.pl</h2> See <a href="perl_config">here</a> for an example of a simple shell script that uses <code>prepare-refseqs.pl</code> and <code>flatfile-to-json.pl</code> to to create a complete genome browser for Tomato. The basic syntax of the configuration file is JSON. Many of the configuration keys are quite similar to those used by <a href="http://gmod.org/wiki/GBrowse">GBrowse</a>. <h2><a class="anchor" aria-hidden="true" id="database-configuration"></a><a href="#database-configuration" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Database configuration</h2> The root level of the config file contains settings for the BioDB that is being used <table> <thead> <tr><th>key</th><th>value</th><th>type</th></tr> </thead> <tbody> <tr><td>description</td><td>Brief description of the data source</td><td>string</td></tr> <tr><td>db_adaptor</td><td>Perl class that implements Bio::DasI.Common ones include Bio::DB::SeqFeature::StoreBio::DB::GFFBio::DB::Das::Chado</td><td>string</td></tr> <tr><td>db_args</td><td>arguments to the constructor for the specified db_adaptor</td><td>dictionary of key-value pairs</td></tr> <tr><td>TRACK DEFAULTS</td><td>default track settings</td><td>track settings dictionary</td></tr> <tr><td>tracks</td><td>settings for all the tracks</td><td>array of track settings dictionaries</td></tr> </tbody> </table> <h2><a class="anchor" aria-hidden="true" id="track-settings"></a><a href="#track-settings" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Track settings</h2> The main part of the configuration file consists of the per-track settings: <table> <thead> <tr><th>key</th><th>value</th><th>type</th></tr> </thead> <tbody> <tr><td>track</td><td>track identifier used by the software.It's more convenient if this doesn't have any weird characters or spaces in it</td><td>string</td></tr> <tr><td>key</td><td>Human-readable label for the track</td><td>string</td></tr> <tr><td>feature</td><td>List of feature types to put into the track</td><td>array of strings</td></tr> <tr><td>autocomplete</td><td>If you want to be able to search for the features in this track, set this to one of the following strings:labelto search on the feature labelaliasto search on the feature aliasesallto search on both labels and aliases</td><td>string</td></tr> <tr><td>class</td><td>The CSS class for the feature. Look in the feature glyph list for the available options.</td><td>string</td></tr> <tr><td>category</td><td>The category this track is in, for grouping the tracks together</td><td>string</td></tr> <tr><td>urlTemplate</td><td>Template for a URL to visit if the user clicks on a feature in this track</td><td>string</td></tr> <tr><td>extraData</td><td>Extra per-feature information to send to the client; useful in the urlTemplate</td><td>dictionary of header -> perl sub</td></tr> <tr><td>subfeatureClasses</td><td>Specifies what CSS class to apply to what type of subfeature</td><td>dictionary of type -> CSS class</td></tr> <tr><td>arrowheadClass</td><td>CSS class for arrowheads</td><td>string</td></tr> <tr><td>clientConfig</td><td>settings to control the behavior of the client for this track, mainly zoom thresholds for when to display more information</td><td>dictionary</td></tr> </tbody> </table> <h2><a class="anchor" aria-hidden="true" id="example-biodb-to-jsonpl-config-for-volvox-sample-data"></a><a href="#example-biodb-to-jsonpl-config-for-volvox-sample-data" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Example biodb-to-json.pl config for volvox sample data</h2> <pre><code class="hljs"> { "tracks" : [ { "feature" : [ "remark" ], "autocomplete" : "all", "track" : "ExampleFeatures", "class" : "feature2", "category": "Miscellaneous", "key" : "HTMLFeatures - Example Features" }, { "feature" : [ "protein_coding_primary_transcript", "polypeptide" ], "track" : "NameTest", "class" : "feature2", "category": "Miscellaneous", "key" : "HTMLFeatures - Name test track has a really long track label" }, { "feature" : [ "SNP" ], "track" : "snps", "class" : "triangle hgred", "category": "Miscellaneous", "key" : "HTMLFeatures - SNPs" }, { "feature" : [ "polypeptide_domain" ], "track" : "Motifs", "class" : "feature3", "description" : 1, "key" : "HTMLFeatures - Example motifs", "category": "Miscellaneous", "style": { "label": "function(feature) { return feature.get('Name')+' (via JS callback)' }", "description": "function(feature) { return feature.get('Name')+': '+feature.get('Note'); }" } }, { "feature" : [ "match" ], "track" : "malformed_alignments", "class" : "feature4", "key" : "HTMLFeatures - Features with right-click menus", "shortDescription": "Features with customized right-click menus", "metadata": { "category": "Miscellaneous", "Description": "Features with extensively customized right-click menus, and with their colors set at random by a JavaScript callback." }, "hooks": { "modify": "function( track, feature, div ) { div.style.backgroundColor = ['green','blue','red','orange','purple'][Math.round(Math.random()*5)];}" }, "menuTemplate" : [ { "label" : "Item with submenu", # hello this is a comment "children" : [ { "label" : "Check gene on databases", "children" : [ { "label" : "Query trin for {name}", "iconClass" : "dijitIconBookmark", "action": "newWindow", "url" : "http://wiki.trin.org.au/{name}-{start}-{end}" }, { "label" : "Query example.com for {name}", "iconClass" : "dijitIconSearch", "url" : "http://example.com/{name}-{start}-{end}" } ] }, { "label" : "2nd child of demo" }, { "label" : "3rd child: this is a track" } ] }, { "label" : "Open example.com in an iframe popup", "title" : "The magnificent example.com (feature {name})", "iconClass" : "dijitIconDatabase", "action": "iframeDialog", "url" : "http://www.example.com?featurename={name}" }, { "label" : "Open popup with XHR HTML snippet (btw this is feature {name})", "title": "function(track,feature,div) { return 'Random XHR HTML '+Math.random()+' title!'; }", "iconClass" : "dijitIconDatabase", "action": "xhrDialog", "url" : "sample_data/test_snippet.html?featurename={name}:{start}-{end}" }, { "label" : "Popup with content snippet from a function (feature {name})", "title": "function(track,feature,div) { return 'Random content snippet '+Math.random()+' title!'; }", "iconClass" : "dijitIconDatabase", "action": "contentDialog", "content" : "function(track,feature,div) { return '<h2>'+feature.get('name')+'</h2>This is some test content!This message brought to you by the number "font-size: 300%\">'+Math.round(Math.random()*100)+'.';} " }, { "label" : "Popup with content snippet from string (feature {name})", "title": "{randomNumberTitle}", "iconClass" : "dijitIconDatabase", "action": "contentDialog", "content" : "<h2>{name}</h2>This is some test content about {name}, which goes from {start} to {end} on the {strand} strand." }, { "label" : "{randomNumberLabel}", "iconClass" : "dijitIconDatabase", "action": "{exampleFeatureClick}" } ] }, { "feature" : [ "gene" ], "track" : "Genes", "class" : "feature5", "category": "Transcripts", "key" : "CanvasFeatures - Protein-coding genes", "metadata" : { "ncbi_submission_model" : "Generic", "insdc_first_public" : "2018-05-15T00:00:00Z", "Link: ENA study page" : "http://www.ebi.ac.uk/ena/", "library_total_amount_of_reads" : "3349981", "insdc_secondary_accession" : "SRS12345678", "insdc_center_name" : "INSDC Sample", "ncbi_submission_package" : "Generic.1.0", "sample_name" : "GSM12345678", "ENA first public" : "2018-05-16", "organism" : "Volvox", "study" : "SRP12345678 a study of volvox", "Link: RNASeq-er analysis results" : "ftp://ftp.ebi.ac.uk/pub/databases/arrayexpress/", "library_size_approx" : "1-5mln", "insdc_last_update" : "2018-05-15T01:18:23.110Z", "insdc_status" : "live", "developmental_stage" : "stage 6- 330 min", "tissue" : "embryo", "mapping_quality_approx" : "under 50%", "source_name" : "Volvox 6- 330 min", "mapping_fraction_of_uniquely_mapped_reads" : "0.429", "ENA last update" : "2018-05-16", "description_title" : "Volvox_mRNA_rep_2_6" }, "trackType": "NeatCanvasFeatures/View/Track/NeatFeatures", "onClick" : { "action" : "defaultDialog", "label" : "<div style='font:normal 12px Univers,Helvetica,Arial,sans-serif'><div style='font-weight:bold'>Custom tooltip</div><div style='color:blue;'>Feature name: {name} Feature start: {start} Feature end: {end}</div></div>", "title": "{type} {name}" }, "menuTemplate": [ { "label" : "View details", }, { "label" : "Zoom this gene", }, { "label" : "Highlight this gene", }, { "label" : "Popup with content snippet from string (feature {name})", "title": "{randomNumberTitle}", "iconClass" : "dijitIconDatabase", "action": "contentDialog", "content" : "<h2>{name}</h2>This is some test content about {type} {name}, which goes from {start} to {end} on the {strand} strand." }], "fmtDetailValue_Name": "function(name,feature) { if(feature.get('type')=='gene') { return name + ' <a href=http://www.ncbi.nlm.nih.gov/gquery/?term='+name+'>[NCBI custom link]</a>'; } else { return name; } }", "fmtDetailField_Name": "function(name,feature) { if(feature.get('type')=='gene') { return 'Gene Name'; } else { return name; } }", "fmtDetailField_Load_id": "function(name,feature) { /* remove field from dialog box */ return null; }", "fmtMetaValue_Name": "function(name) { return name+' [Track with custom callbacks for About track popup]'; }", "fmtMetaField_Name": "function(name) { return 'Track Name'; }", "fmtMetaDescription_Name": "function(name) { return '[Custom description]'; }" }, { "feature" : [ "mRNA" ], "track" : "ReadingFrame", "trackType": "NeatHTMLFeatures/View/Track/NeatFeatures", "category" : "Transcripts", "class" : "cds", "phase": 1, "key" : "HTMLFeatures - mRNAs", "onClick": { "url": "http://www.ncbi.nlm.nih.gov/gquery/?term={name}", "label": "Search for {name} at NCBI\nFeature start {start}\nFeature end {end}", "title": "NCBI search box" } }, { "feature" : [ "CDS:bare_predicted", "mRNA:exonerate", "mRNA:predicted" ], "urlTemplate" : "http://www.ncbi.nlm.nih.gov/gquery/?term={name}-{start}-{end}", "track" : "CDS", "category" : "Transcripts", "class" : "cds", "key" : "CanvasFeatures - mixed mRNAs and CDSs", "trackType": "CanvasFeatures" }, { "track" : "Transcript", "description" : 1, "style": { "color": "#E32A3A", "description": "customdescription" }, "key" : "CanvasFeatures - transcripts", "trackType": "JBrowse/View/Track/CanvasFeatures", "feature" : [ "mRNA:exonerate" ], "category" : "Transcripts", "subfeatures" : true, "showNoteInAttributes": true, "onClick": "{exampleFeatureClick}" }, { "feature" : [ "BAC" ], "track" : "Clones", "class" : "exon", "description" : 1, "key" : "HTMLFeatures - Fingerprinted BACs", "category": "Miscellaneous" }, { "feature" : [ "EST_match:est" ], "track" : "EST", "class" : "est", "key" : "HTMLFeatures - ESTs", "category": "Miscellaneous" } ], "TRACK DEFAULTS" : { "autocomplete" : "all", "class" : "feature" }, "db_args" : { "-adaptor" : "memory", "-dir" : "docs/tutorial/data_files/volvox.gff3" }, "description" : "Volvox Example Database", "db_adaptor" : "Bio::DB::SeqFeature::Store" } </code></pre> This is the config file that is loaded for the volvox sample data. Note that additional tracks are also loaded via text files containing snippets in tracks.conf that are not included here. The pre-prepared snippets of tracks.conf configs and the biodb config represent contrasting ways of representing a pre-formatted instance configuration <h2><a class="anchor" aria-hidden="true" id="using-jbrowse-with-existing-databases"></a><a href="#using-jbrowse-with-existing-databases" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Using JBrowse with Existing Databases</h2> <h3><a class="anchor" aria-hidden="true" id="extract-data-and-reformat"></a><a href="#extract-data-and-reformat" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Extract data and reformat</h3> The JBrowse formatting tools <code>biodb-to-json.pl</code> and <code>prepare-refseq.pl</code> can extract data from existing databases that are supported by BioPerl <code>Bio::DB::*</code> adapters, such as GBrowse databases created by bp_seqfeature_load.pl, or Chado databases. Both tools accepts a configuration file in JSON format that contains the details about how to connect to a given database, and which data to extract from it, and which JBrowse feature tracks to create to display the data. For example, to extract data from a <a href="http://gmod.org/wiki/Chado">Chado</a> schema in PostgreSQL, one might start with a configuration like: <pre><code class="hljs"> { "description": "D. melanogaster (release 5.37)", "db_adaptor": "Bio::DB::Das::Chado", "db_args": { "-dsn": "dbi:Pg:dbname=fruitfly;host=localhost;port=5432", "-user": "yourusername", "-pass": "yourpassword" }, ... } </code></pre> In the database source name (dsn) argument, 'dbi:Pg' indicates that you are using PostgreSQL, and the dbname, host, and port were specified when the database was created with PostgreSQL's createdb command. The user and pass arguments were specified when the PostgreSQL user account was created with the createuser command. Collectively, these arguments identify the database and give the Bio::DB::Das::Chado object access to it. Other adaptors (Bio::DB::SeqFeature::Store, Bio:DB::GFF, etc.) will require similar information. <h4><a class="anchor" aria-hidden="true" id="example-configuration"></a><a href="#example-configuration" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Example Configuration</h4> Here is a sample configuration file, usable with <code>biodb-to-json.pl</code> and <code>prepare-refseqs.pl</code>, with each line explained. Note that, in order for this config file to work, it would be necessary to remove the grey comments (since JSON does not support them). Also, notice that the config file is divided into two parts, a header section that contains information about the database, and a body section that contains information about the feature tracks. <pre><code class="hljs css languages- javascript">{ //This is the header. It contains information about the database. // description: a brief textual description of the data source. "description": "D. melanogaster (release 5.37)", //db_adaptor: a perl module with methods for opening databases and extracting //information. This will normally be either Bio::DB::SeqFeature::Store, //Bio::DB::Das::Chado, or Bio::DB::GFF, but it can also be the name of any //other perl module that implements the Bio::SeqFeatureI interface. "db_adaptor": "Bio::DB::SeqFeature::Store", //db_args: arguments required to produce an instance of the db_adaptor. The //required arguments can be found by searching for the db_adaptor on the CPAN //website. "db_args": { //adaptor: With Bio::DB::SeqFeature::Store, a value of "memory" //for the adaptor indicates that the data is stored somewhere in //the file system. Alternatively, it might have been stored in a //database such as MySQL or BerkeleyDB. "-adaptor": "memory", //dir: given the "memory" argument for the adaptor, this is the //file system path to the location in memory where the data is //stored. Data will automatically be extracted from any *.gff //or *.gff3 files in this directory. "-dir": "/Users/stephen/Downloads/dmel_r5.37" }, //This is the body. It contains information about the feature tracks. //TRACK DEFAULTS: The default options for every track. "TRACK DEFAULTS": { //class: same as 'cssClass' in flatfile-to-json.pl. "class": "feature" }, //tracks: information about each individual track. "tracks": [ //Information about the first track. { //track: same as 'tracklabel' in flatfile-to-json.pl. "track": "gene", //key: same meaning as in flatfile-to-json.pl. "key": <span cl