c54a66ee94ad1fe7272022742fbe022d82c15021 brianlee Thu Apr 28 16:51:26 2022 -0700 Fixing and adding links to new barChart examples on barChart.html diff --git src/hg/htdocs/goldenPath/help/barChart.html src/hg/htdocs/goldenPath/help/barChart.html index f334c64..e34b184 100755 --- src/hg/htdocs/goldenPath/help/barChart.html +++ src/hg/htdocs/goldenPath/help/barChart.html @@ -1,494 +1,501 @@ <!DOCTYPE html> <!--#set var="TITLE" value="barChart and bigBarChart Track Format" --> <!--#set var="ROOT" value="../.." --> <!-- Relative paths to support mirror sites with non-standard GB docs install --> <!--#include virtual="$ROOT/inc/gbPageStart.html" --> <h1>barChart and bigBarChart Track Format</h1> <p> <p> The barChart (and bigBarChart) track format displays a graph of category-specific values over genomic regions, similar to the <a href="../../cgi-bin/hgTracks?db=hg38&hideTracks=1>exGene=pack">GTEx Gene</a> track. This format is useful for displaying gene expression and other datasets where it is desirable to compare a set of variables over genomic regions.</p> <p> While a barChart track can effectively show datasets with single values for each variable (e.g. comparing individual samples), the format provides specific features to display studies comprised of a large set of samples for each variable (e.g. comparing tissues with multiple samples for each tissue). In this usage, the main genome browser display presents a graph of summary values (e.g. medians) for each variable, and the distribution of sample values across variables is shown via a boxplot graph shown on the details page for each region.</p> <p> The barChart format is available as a standalone plain text bed6+ format for use with smaller datasets as a custom track, and as a binary indexed format (bigBarChart) suitable for track hubs and custom tracks. The bigBarChart format provides more track customization features (i.e. schema customization, and label configuration support), and is recommended for users who can use command-line tools and have web-accessible data storage. If you do not have web-accessible data storage, please see the <a href="hgTrackHubHelp.html#Hosting"> Hosting</a> section of the Track Hub Help documentation. barChart format files are converted to bigBarChart files using the program <code>bedToBigBed</code>, run with the <code>-as</code> option to pull in a special <a href="http://www.linuxjournal.com/article/5949" target="_blank">autoSql</a> (<em>.as</em>) schema file defining the fields of the bigBarChart. </p> <p> Below is an example of the barChart format in 'full' visibility mode</p> <p class="text-center"> <img class="text-center" src="../../images/barChartFull.png" alt="BarChart example in full mode" width="883" height="143"> </p> <p> The 'squish' display mode draws one colored rectangle indicating the category (e.g. tissue) with highest value of the measured metric (e.g. gene expression) if it contributes more than 10% to the total expression, otherwise the chart is colored black. The following image shows the GTEx Genes track in 'squish' mode; the beige colored item (tissue) has the highest expression in the ACE2 gene and represents more than 10% of total expression. Click into the colored rectange for more information.</p> <p class="text-center"> <a href="../../cgi-bin/hgTracks?db=hg38&hideTracks=1&knownGene=pack>exGene=squish"> <img class="text-center" src="../../images/barChartSquish.png" alt="BarChart example in squish mode" width="883" height="143"> </a> </p> <a name=barChart></a> <h2>barChart format definition</h2> <p> The following autoSql definition illustrates the basic schema supporting barChart (and bigBarChart) tracks.</p> <pre><code>table bigBarChart "bigBarChart bar graph display" ( string chrom; "Reference sequence chromosome or scaffold" uint chromStart; "Start position in chromosome" uint chromEnd; "End position in chromosome" string name; "Name or ID of item" uint score; "Score (0-1000)" char[1] strand; "'+','-' or '.'. Indicates whether the query aligns to the + or - strand on the reference" string name2; "Alternate name of item" uint expCount; "Number of bar graphs in display, must be <= 100" float[expCount] expScores; "Comma separated list of category values." bigint _dataOffset; "Offset of sample data in data matrix file, for boxplot on details page, optional only for barChart format" int _dataLen; "Length of sample data row in data matrix file, optional only for barChart format" ) </code></pre> <a name="columnDefinition"></a> <h6>Column Explanations</h6> <p> The first 6 fields of the barChart format are the same as the first 6 fields of the standard <a href="../../FAQ/FAQformat#format1">BED</a> format. The name2 field provides an alternate item name, useful if you would like to associate multiple transcripts to a single gene locus, different variables to the same experiment type, etc. The expCount and expScores fields are used as in the <a href="../../FAQ/FAQformat#format6.5">Microarray</a> format; they define the number of categories and a value for each category (see example #1 below).<p> <p> The _dataOffset and _dataLen fields are used internally by the track to locate sample values for a region in an optional matrix file containing all sample values. These values are used to draw a boxplot of all sample data on the details page for the bar chart. When a matrix file is not supplied, these fields should be set to 0. (As a convenience, these fields are optional for barChart custom tracks). </p> <p> When creating bigBarChart files, we encourage you to customize the title and field descriptions of the prototype autoSql schema to better describe your data. In the example below, the name field of the track refers to a transcript, while the name2 field represents a gene: <pre><code> table xyzGeneExpression "XYZ gene expression barChart" ( string chrom; "Reference sequence chromosome or scaffold" uint chromStart; "Start position in chromosome" uint chromEnd; "End position in chromosome" string name; "Transcript name" uint score; "Score (0-1000), derived from total expScores (below)" char[1] strand; "+, -, or ., indicating orientation of the item" string name2; "Gene name" uint expCount; "Number of tissues" float[expCount] expScores; "Comma separated list of median expression in RPKM for each tissue." bigint _dataOffset; "Offset of sample data in data matrix file" int _dataLen; "Length of sample data row in data matrix file" ) </code></pre> Customing this file will make your data more easily interpreted by users, who will see the field descriptions when accessing the track data from the Table Browser, when viewing items on the Genome Browser details pages (via the "view table schema" link), and (for users who download files), from the -as option of the bigBedInfo tool. </p> <h2>Creating barChart and bigBarChart custom tracks</h2> <p> The steps for creating barChart tracks differ from the process for creating bigBarChart tracks. The steps also differ based on whether you have an input matrix file (generated perhaps from an RNA-Seq differential expression analysis pipeline) or not. If you have an expression matrix-like file, skip to <a href="#example3">Example #3</a>, otherwise follow example 1 below. </p> <a name="example1"></a> <h6>Example #1</h6> <p> In this example, you will create a barChart custom track using example bed6+3 data. <ol> <li>Paste the following track line into the <a href="../../cgi-bin/hgCustom?db=hg38">custom track management page</a> for the human assembly hg38. <pre><code> track type=barChart name="barChart Example One" description="A barChart file" barChartBars="adiposeSubcut breastMamTissue colonTransverse muscleSkeletal wholeBlood" visibility=pack browser position chr14:95,081,796-95,436,280 # chrom chromStart chromEnd string name score strand name2 expCount expScores _dataOffset _dataLen chr14 95086227 95158010 DICER1 999 - ENSG00000100697.10 5 2.94,11.60,38.00,6.69,4.89 chr14 95181939 95319906 CLMN 999 - ENSG00000165959.7 5 7.08,69.53,9.32,1.38,1.68 chr14 95417493 95475836 SYNE3 999 - ENSG00000176438.8 5 7.29,3.73,0.74,20.35,1.39 </code></pre></li> <li>Click the "submit" button.</li> </ol> </p> <p> After the file loads in the Genome Browser, you should see an automatically colored bar graph with 5 bars. Hovering the mouse over any of the individual bars will display the name of the particular bar ("wholeBlood", "adiposeSubcut", ...) as well as the value associated with that bar (10.94, 0.74, ...). The order of bar names in the barChartBars field of track line should exactly match the order of the values in the expScores field. </p> <a name="example2"></a> <h6>Example #2</h6> <p> In this example, you will create a bigBarChart track out of an existing bigBarChart format file, located on the UCSC Genome Browser http server. This file contains data for the hg38 assembly. </p> <p> To create a custom track using this file: <ol> <li>Construct a track line referencing the file: <pre><code> track type=bigBarChart name="bigBarChart Example One" description="A bigBarChart file" barChartBars="adiposeSubcut breastMamTissue colonTransverse muscleSkeletal wholeBlood" visibility=pack bigDataUrl=http://genome.ucsc.edu/goldenPath/help/examples/barChart/hg38.gtexTranscripts.bb browser position chr14:95,081,796-95,436,280 </code></pre></li> <li>Paste the track line into the <a href="../../cgi-bin/hgCustom?db=hg38">custom track management page</a> for the human assembly hg38. </li> <li>Click the "submit" button.</li> </ol> </p> <p> After the file loads in the Genome Browser, you should see an automatically colored bar graph with 5 bars. The same rules apply to bigBarChart custom tracks as barChart custom tracks in that the order of names in the barChartBars field should exactly match the order of values from the expScores field in the bigBarChart file. </p> <a name="example3"></a> <h6>Example #3</h6> <p> In this example, you will use the helper scripts expMatrixToBarchartBed and bedJoinTabOffset on example matrix and category files in order to generate a bed6+5 barChart format file, which can be loaded as a custom track into the Genome Browser. </p> <p> The matrix file is a tab-separated (must be tabs, not spaces) file of the following form, perhaps resulting from an RNA-Seq analysis pipeline. Please note that the first line must describe each column as in the example snippet below. <pre> transcript sample1 sample2 sample3 sample4 sample5 ... transcriptName value1 value2 value3 value4 value5 ... </pre> </p> <p> The categories file then provides more meta information about this matrix file. It is a two column, tab-separated file that maps the samples in the matrix file to a specific category: <pre> sample1 category1 sample2 category1 ... ... sampleA category2 sampleB category2 ... ... sampleX category3 sampleY category3 ... ... </pre> <p> Each column in the first line of the matrix file must be found in the categories file. </p> <p> We have provided an example <a href="examples/barChart/exampleSampleData.txt">category file</a> and <a href="examples/barChart/exampleMatrix.txt">matrix file</a> to follow along with the rest of this example. <p> To create a custom track in this form, follow the below steps: <ol> <li>Create a bed6+1 file to use as a map for the items in your matrix (does not need to be all-inclusive). This file, with example lines such as: <pre><code> chr14 95086227 95158010 ENSG00000100697.10 999 - DICER1 </code></pre> will be one of three input files to the helper script expMatrixToBarchartBed. For an example file to follow along with the rest of this example, you can download an example bed6+1 file <a href="examples/barChart/hg38.gtexTranscripts">here</a>.</li> <li>Download the helper programs <em>expMatrixToBarchartBed</em> and <em>bedJoinTabOffset</em> from the <a href="http://hgdownload.soe.ucsc.edu/admin/exe">utilities directory</a> appropriate for your operating system. </li> <li>Make sure the programs downloaded above are in your system's PATH variable. For example, if you downloaded the programs to your $HOME/Downloads directory, set your PATH variable accordingly: <pre><code> export PATH=$PATH:$HOME/Downloads </code></pre></li> <li>Now run <em>expMatrixToBarchartBed</em> (which in turn runs <em>bedJoinTabOffset</em>) like so: <pre><code> expMatrixToBarchartBed categoriesFile matrixFile bedInputFile outputBed </code></pre> The argument outputBed will be a bed6+5 file, with the expCount, expScores, _dataOffset, and _dataLen fields computed for you, for example: <pre><code> chr14 95086227 95158010 ENSG00000100697.10 999 - DICER1 5 10.94,11.60,8.00,6.69,4.89 93153 26789 </code></pre> <em>expMatrixToBarchartBed</em> will also output the order of the scores in the expScores field, which you can then copy and paste into the barChartBars field of the custom track line so the bars displayed in the browser match the right values: <pre> The columns and order of the groups are: #chr start end name score strand name2 expCount expScores;adiposeSubcut breastMamTissue colonTransverse muscleSkeletal wholeBlood _offset _lineLength </pre> If you have already pre-computed expCount and expScores, and just need offsets into your matrix file for a more descriptive details page, run only bedJoinTabOffset like so: <pre><code> bedJoinTabOffset matrixFile exampleBed6+3 outBed </code></pre></li> <li>Now that we have a bed6+5 format file that corresponds to the barChart format, we can construct a track line and prepend it to our bed6+5 file so the Genome Browser will recognize it: <pre><code> track type=barChart name="barChart Example" description="A barChart file" barChartBars="adiposeSubcut breastMamTissue colonTransverse muscleSkeletal wholeBlood" barChartMetric=median" visibility=pack </code></pre></li> <li>Use the upload button on the <a href="../../cgi-bin/hgCustom?db=hg38">custom track management page</a> for the human assembly hg38 to upload the file just created.</li> <li>Click the "submit" button.</li> </ol> <p> <em>expMatrixToBarchartBed</em> automatically computes the median values for all the samples in the matrix file, which is useful when your experiment contains data from 8000 samples (such as the GTEx data). Furthermore, <em>expMatrixToBarchartBed</em> can compute the mean value of all samples in a category of the matrix file (instead of the default median), in addition to allowing for a specific ordering of the expScores field. NOTE: Set the barChartMetric setting to 'mean' if you use this option of <em>expMatrixToBarchartBed</em>. For more information about <em>expMatrixToBarchartBed</em> or <em>bedJoinTabOffset</em>, run the program with no arguments to get a usage message. </p> <a name="example4"></a> <h6>Example #4</h6> <p> In this example, you will use the bed6+5 file created in Example 3 to create a bigBarChart file, allowing the data to be remotely accessed and exist within a track hub. The track settings for bigBarChart on a hub can be viewed <a href="./trackDb/trackDbHub.html#bigBarChart">here</a>. </p> <ol> <li>If not already completed, follow steps 1-4 from <a href="#example3">Example 3</a> above, or download the example bed6+5 file <a href="examples/barChart/hg38.gtexTranscripts.bed">here</a> </li> <li>Download the <em>fetchChromSizes</em> and <em>bedToBigBed</em> programs from the <a href="http://hgdownload.soe.ucsc.edu/admin/exe">utilities directory</a> appropriate to your operating system. <li>Use <em>fetchChromSizes</em> to create a <em>chrom.sizes</em> file for the UCSC database you are working with (hg38 for these examples). Alternatively, you can download the <em>chrom.sizes</em> file for any assembly hosted at UCSC from our <a href="http://hgdownload.soe.ucsc.edu/downloads.html">downloads</a> page (click on "Full data set" for any assembly). For example, the <em>hg38.chrom.sizes</em> file for the hg38 database is located at <a href="http://hgdownload.soe.ucsc.edu/goldenPath/hg38/bigZips/hg38.chrom.sizes" target="_blank">http://hgdownload.soe.ucsc.edu/goldenPath/hg38/bigZips/hg38.chrom.sizes</a>.</li> <li>Save the autoSql file <a href="examples/barChart/barChartBed.as">barChartBed.as</a> to your computer.</li> <li>Run bedToBigBed to create the bigBarChart file: <pre><code> bedToBigBed -as=barChartBed.as -type=bed6+5 inputBed hg38.chrom.sizes output.bigBed </code></pre></li> <li>Move the newly constructed bigBarChart file to a web accessible http, https, or ftp location.</li> <li>Construct a custom track line with a bigDataUrl parameter pointing to the newly created bigBarChart file. If the matrix and category files used to make the precursor barChart file are also moved to an http, https, or ftp location, we can point to them on the custom track line as well (all settings must be on the same line): <pre><code> track type=bigBarChart name="bigBarChart Example One" description="A bigBarChart file" barChartBars="adiposeSubcut breastMamTissue colonTransverse muscleSkeletal wholeBlood" barChartMetric=median barChartUnit=RPKM bigDataUrl=http://genome.ucsc.edu/goldenPath/help/examples/barChart/hg38.gtexTranscripts.bb barChartMatrixUrl=http://genome.ucsc.edu/goldenPath/help/examples/barChart/exampleMatrix.txt barChartSampleUrl=http://genome.ucsc.edu/goldenPath/help/examples/barChart/exampleSampleData.txt visibility=pack </code></pre> <li>To fully take advantage of creating a bigBarChart file and the barChartMatrixUrl and barChartSampleUrl supporting files, create a <a href="hgTrackHubHelp.html">Track Hub</a> and use a stanza such as the following: <pre><code> track exampleBarChartTrack type bigBarChart visibility full shortLabel exBarChart longLabel Simple example bar chart track barChartBars adiposeSubcut breastMamTissue colonTransverse muscleSkeletal wholeBlood barChartColors #FF6600 #33CCCC #CC9955 #AAAAFF #FF00BB barChartLabel Tissues barChartMetric median barChartUnit RPKM bigDataUrl http://genome.ucsc.edu/goldenPath/help/examples/barChart/hg38.gtexTranscripts.bb barChartMatrixUrl http://genome.ucsc.edu/goldenPath/help/examples/barChart/exampleMatrix.txt barChartSampleUrl http://genome.ucsc.edu/goldenPath/help/examples/barChart/exampleSampleData.txt </code></pre> Please note, the fields in your barChartBars line must match the terms in your categories file (exampleBarChartSamples.txt) in order for the boxplot display to show up on the details page for tracks. Below is an example image indicating the benefit of using these files in a hub, note the "View all data points for..." link that allows extracting data from the matrix file (exampleBarChartMatrix.txt) specific for this named item. <div class="text-center"> <img src="../../images/exampleBoxPlot.png" alt="Example boxPlot image" height="500" width="700"> </div> </ol> <h6 id="example5">Example #5</h6> <p> To help Track Hub Developers adjust the display of tracks we add two settings <a href="trackDb/trackDbHub.html#barChartBarMinWidth" target="_blank">barChartBarMinWidth</a> and <a href="trackDb/trackDbHub.html#barChartBarMinPadding" target="_blank">barChartBarMinPadding</a>. The first sets the minimum pixel width of the bars in the chart to a number of pixels, for example <code>barChartBarMinWidth 10</code>. The second sets the minimum pixel width between bars to a number of pixels, for example <code>barChartBarMinPadding 5</code>.</p> <p> Here are two example tracks using these settings on the same source data that can be loaded by going to the My Data, Custom Tracks page and pasting the below text to see how the display differs.</p> <pre> browser position chr14:95,081,796-95,436,280 track type=bigBarChart barChartBarMinPadding=5 name="ex barChartBarMinPadding" description="A bigBarChart file with barChartBarMinPadding" barChartBars="adiposeSubcut breastMamTissue colonTransverse muscleSkeletal wholeBlood" visibility=pack bigDataUrl=http://genome.ucsc.edu/goldenPath/help/examples/barChart/hg38.gtexTranscripts.bb track type=bigBarChart barChartBarMinWidth=20 name="ex barChartBarMinWidth" description="A bigBarChart file with barChartBarMinWidth" barChartBars="adiposeSubcut breastMamTissue colonTransverse muscleSkeletal wholeBlood" visibility=pack bigDataUrl=http://genome.ucsc.edu/goldenPath/help/examples/barChart/hg38.gtexTranscripts.bb </pre> <div class="text-center"> <img src="../../images/barChartPadWidth_1.png" alt="Example1 of barChartBarMinPadding and barChartBarMinWidth" width="700"> </div> <p> Both tracks have the same data, however, in the bottom track the <code>barChartBarMinWidth 20</code> setting triggers wider widths, and the top track has larger padding between bars from the setting <code>barChartBarMinPadding 5</code>. As described in the settings entries for <a href="trackDb/trackDbHub.html#barChartBarMinWidth" target="_blank">barChartBarMinWidth</a> and <a href="trackDb/trackDbHub.html#barChartBarMinPadding" target="_blank">barChartBarMinPadding</a> there is a dynamic calculation dependent on the current window size, the width of the item, and the number of bars for the item. So that when zooming in the appearance of the barCharts with these settings can be different, at different scales. For instance, in the first image, you can see how much impact barChartBarMinWidth has on the second track, as well as the barChartBarMinPadding in the top track. But as zoomed in, with the below image, the impact of both of these settings is less noticeable.</p> <div class="text-center"> <img src="../../images/barChartPadWidth_2.png" alt="Example2 of barChartBarMinPadding and barChartBarMinWidth" width="700"> </div> <h6 id="example6">Example #6</h6> <p> To help with the selection and exploration of large data sets the new settings <a href="trackDb/trackDbHub.html#barChartFacets" target="_blank">barChartFacets</a>, <a href="trackDb/trackDbHub.html#barChartStatsUrl" target="_blank">barChartStatsUrl</a>, and <a href="trackDb/trackDbHub.html#barChartMerge" target="_blank">barChartMerge</a> were introduced where on the details page checkboxes enable slicing data down to smaller collections based on metadata.</p> <p>The setting <code>barChartFacets <column1,column2,...columnN></code> turns on the faceted selection on the track details and configure page which is useful for selecting which bars out of a large number to display by clicking designated checkboxes. The setting <code>barChartStatsUrl <url></code> associates a table in tab-separated values with the barChart, with one line per bar. And the setting <code>barChartMerge on</code> enables a merge button inside of the faceted selections. It is particularly useful when there are many bars and many facets to condense a related group, such as tissue source.</p> <p> Below is an example track using these settings on source data for a -<a href="../cgi-bin/hgTracks?db=hg38&hideTracks=1&tabulaSapiensTissueCellType=pack&tabulaSapiens=show" +<a href="/cgi-bin/hgTracks?db=hg38&hideTracks=1&tabulaSapiensTissueCellType=pack&tabulaSapiens=show" target="_blank">Tabula Sapiens single cell RNA data from many tissues</a> track. This excerpt of settings from that track allows experimenting to see these settings in action, and to be loaded by going to the My Data, Custom Tracks page.</p> <pre> track type=bigBarChart name="ex Tabula Sapiens" description="A bigBarChart using Tabula Sapiens data to illustrate new Details pages" visibility=pack barChartCategoryUrl=http://hgdownload.soe.ucsc.edu/gbdb/hg38/bbi/tabulaSapiens/bw_edit_tissue_cell_type.categories barChartFacets=tissue,cell_class,cell_type barChartStatsUrl=http://hgdownload.soe.ucsc.edu/gbdb/hg38/bbi/tabulaSapiens/bw_edit_tissue_cell_type.facets barChartMerge=on bigDataUrl=http://hgdownload.soe.ucsc.edu/gbdb/hg38/bbi/tabulaSapiens/tissue_cell_type.bb </pre> <p> Once loaded, click into an item to see the details page, in this case for the gene ACE2 at the default position in hg38. On the details page, rather than a static bar chart image, there is a dynamic interactive selection screen with checkbox facets to narrow down -the display. Click the first two "merge" buttons next to +the display. Adding <code>barChartMerge on</code> enables the display of the "merge" +button, and <code>barChartFacets tissue,cell_class,cell_type</code> sources information in +<code>barChartStatsUrl ...tissue_cell_type.facets</code> to enable the facet options. +To interact with this example, click the first two "merge" buttons next to "tissue" and "cell_class."</p> <div class="text-center"> <img src="../../images/barChartFacets1.png" alt="Example1 of Facets on barCharts" width="700"> </div> <p> With those two merged selections, then click on the "Macrophage" option to see just this one cell type selection.</p> <div class="text-center"> <img src="../../images/barChartFacets2.png" alt="Example2git l of Facets on barCharts" width="700"> </div> <p> By then clicking the "unmerge" button next to "tissue" the single bar chart will expand with tissue clusters.</p> <div class="text-center"> <img src="../../images/barChartFacets3.png" alt="Example3 of Facets on barCharts" width="700"> </div> <p> -In these ways the new barChartFacets, barChartStatsUrl, and barChartMerge settings allow users +In these ways the new +<a href="trackDb/trackDbHub.html#barChartFacets" target="_blank">barChartFacets</a>, +<a href="trackDb/trackDbHub.html#barChartStatsUrl" target="_blank">barChartStatsUrl</a>, +and <a href="trackDb/trackDbHub.html#barChartMerge" target="_blank">barChartMerge</a> +settings allow users to explore the barChart data on the individual details page more closely. One can use the facets to further select certain types and also click the columns (val/count/cluster) to arrange by numerical value or alphabetical name.</p> <p> Also, if you click the "Return to Genome Browser" link, you will see only these selection bars are displayed.</p> <div class="text-center"> <img src="../../images/barChartFacets4.png" alt="Example4 of Facets on barCharts" width="700"> </div> <p> In this image after making the selections browsing ACE2 the "zoom out" button has been clicked to also view nearby genes where the expression of these tissue selections for the gene PIR is quite noticeably different.</p> <h2>Sharing your data with others</h2> <p> If you would like to share your barChart/bigBarChart data track with a colleague, learn how to create a URL by looking at Example 6 on <a href="customTrack.html#EXAMPLE6">this page</a>.</p> <h2>Extracting data from the bigBarChart format</h2> <p> Because bigBarChart files are an extension of bigBed files, which are indexed binary files, it can be difficult to extract data from them. UCSC has developed the following programs to assist in working with bigBed formats, available from the <a href="http://hgdownload.soe.ucsc.edu/admin/exe/">binary utilities directory</a>.</p> <ul> <li> <code>bigBedToBed</code> — converts a bigBed file to ASCII BED format.</li> <li> <code>bigBedSummary</code> — extracts summary information from a bigBed file.</li> <li> <code>bigBedInfo</code> — prints out information about a bigBed file. Use the -as option to see the file field descriptions.</li> </ul> <p> As with all UCSC Genome Browser programs, simply type the program name (with no parameters) at the command line to view the usage statement.</p> <h2>Troubleshooting</h2> <p> If you encounter an error when you run the <code>bedToBigBed</code> program, check your input file for data coordinates that extend past the end of the chromosome. If these are present, run the <code>bedClip</code> program (<a href="http://hgdownload.soe.ucsc.edu/admin/exe/">available here</a>) to remove the problematic row(s) in your input file before running the <code>bedToBigBed</code> program.</p> <!--#include virtual="$ROOT/inc/gbPageEnd.html" -->