e4b0792c7b643c95e039c56849f958b3b5a94f65 max Mon Jan 11 07:08:43 2021 -0800 another small bigBed.html change, no redmine yet diff --git src/hg/htdocs/goldenPath/help/bigBed.html src/hg/htdocs/goldenPath/help/bigBed.html index 310686a..4f2f3f4 100755 --- src/hg/htdocs/goldenPath/help/bigBed.html +++ src/hg/htdocs/goldenPath/help/bigBed.html @@ -211,51 +211,52 @@ Paste the URL itself into the Custom Tracks entry form or construct a track line that points to your bigBed file (<em>Step 7</em>, above).</li> <li> Create the custom track on the human assembly hg19 (Feb. 2009), and view it in the Genome Browser (<em>Step 8</em>, above). Note that the original BED file contains data on chromosome 21 only.</li> </ol> <a name=Ex3></a> <h3>Example #3: Create a bigBed file with extra (custom) fields</h3> <p> BigBed files can store extra fields in addition to the <a href="../../FAQ/FAQformat.html#format1">predefined BED fields</a>. In this example, you will create your own bigBed file from a fully featured existing BED file that -contains the standard BED fields up to and including the <em>color</em> field (field 9), plus two +contains the standard BED fields up to and including the <em>color</em> field called <em>itemRgb</em> +(field 9), plus two additional non-standard fields (two alternate names for each item in the file). +The standard BED column itemRgb contains an R,G,B color value (e.g. "255,0,0"). The resulting bigBed file will have nine standard BED columns and two additional non-standard user-defined columns. -The standard column 9 is called the itemRgb field, it contains an R,G,B color value (e.g. 255,0,0). </p> +<p> If you add extra fields to your bigBed file, you must include an AutoSql format (<em>.as</em>) file describing the fields. In this file, all fields (standard and non-standard) are described with a short internal name and also a human-readable description. For more information on AutoSql, see <a href="http://www.linuxjournal.com/article/5949" target="_blank">Kent and Brumbaugh, 2002</a>, as well as examples of <em>.as</em> files in <a href="http://genome-source.soe.ucsc.edu/gitlist/kent.git/tree/master/src/hg/lib" target="_blank">this directory</a>. - -<p> -The bedToBigBed program is run with the arguments <code>-type=bed9+2</code> and also +Then, the bedToBigBed program is run with the arguments <code>-type=bed9+2</code> and also <code>-as=bedExample2.as</code> to help correctly interpret all the columns in the data. </p> +<p> This example also demonstrates how to create an extra search index on the name field, and the first of the extra fields to be used for track item search. The searchIndex setting requires the input BED data to be case-sensitive sorted (<code>sort -k1,1 -k2,2n</code>), where newer versions of the tool bedToBigBed (available <a href="http://hgdownload.soe.ucsc.edu/admin/exe/">here</a>) are enhanced to catch improper input.</p> <ol> <li> Save the BED file <a href="examples/bedExample2.bed"><em>bedExample2.bed</em></a> to your computer (<em>Steps 1</em> and <em>2</em> in <em>Creating a bigBed track</em>, above).</li> <li> Save the file <a href="hg18.chrom.sizes"><em>hg18.chrom.sizes</em></a> to your computer. This file contains the chrom.sizes for the human (hg18) assembly (<em>Step 4</em>, above).</li> <li> Save the AutoSql file <a href="examples/bedExample2.as"><em>bedExample2.as</em></a> to your computer. This file contains descriptions of the BED fields, and is required when the BED file