43efb3af4a3efe8d5f5b8e8a4e8464337a75790c brianlee Thu May 16 14:54:20 2019 -0700 Updating interact help page to show interactUp and correct useScore=on and add image refs #23299 diff --git src/hg/htdocs/goldenPath/help/interact.html src/hg/htdocs/goldenPath/help/interact.html index f823d91..410e232 100755 --- src/hg/htdocs/goldenPath/help/interact.html +++ src/hg/htdocs/goldenPath/help/interact.html @@ -163,46 +163,51 @@

After the file loads in the Genome Browser, you should see four interactions displayed on chromosome 3. Two of the interactions have both interacting regions in the browser view, and two have a single region. One of these interacts across chromosomes (with a region on chromosome 20), and the other with a region outside of the browser window (indicated by rectangular connector). The darkness of the interaction indicates the strength of the interaction.

Example #3

In this example, you will create a bigInteract track out of an existing bigInteract format file, located on the UCSC Genome Browser http server. This file contains data for the hg19 assembly. +This example also contains the interactUp=true setting to flip the arcs of the interact display.

To create a custom track using this file:

  1. Construct a track line referencing the file and set the browser position to show region of interest in the file:
    
    -track type=bigInteract name="interact Example Three" description="A bigInteract file" useScore=true visibility=full bigDataUrl=http://genome.ucsc.edu/goldenPath/help/examples/interact/interactExample3.inter.bb
    +track type=bigInteract interactUp=true name="interact Example Three" description="A bigInteract file" useScore=on visibility=full bigDataUrl=http://genome.ucsc.edu/goldenPath/help/examples/interact/interactExample3.inter.bb
     browser position chr3:63,820,967-63,880,091
        
  2. Paste the track line into the custom track management page for the human assembly hg19.
  3. Click the "submit" button.

+
    + +

After the file loads in the Genome Browser, you should see a number of curved interactions, colored black.

Example #4

In this example, you will use an example BED file to create a bigInteract file, allowing the data to be remotely accessed and exist within a track hub. The track settings for bigInteract on a hub can be viewed here.

  1. Download the example file here.
  2. Download the fetchChromSizes and bedToBigBed programs from the @@ -215,31 +220,31 @@ data set" for any assembly). For example, the hg19.chrom.sizes file for the hg19 database is located at http://hgdownload.soe.ucsc.edu/goldenPath/hg19/bigZips/hg19.chrom.sizes.
  3. Save the autoSql file interact.as to your computer. If you want the column labels to reflect non-directional interactions, you can change the default variable names from 'source...' and 'target...' to 'region1...' and 'region2...'.
  4. Run bedToBigBed to create the bigInteract file:
    
     bedToBigBed -as=interact.as -type=bed5+13 interactExample4.inter.bed hg19.chrom.sizes interactExample4.inter.bb
        
  5. Move the newly constructed bigInteract file to a web accessible http, https, or ftp location.
  6. Construct a custom track line with a bigDataUrl parameter pointing to the newly created bigInteract file.
    
    -track type=bigInteract name="interact Example Four" description="A bigInteract file" useScore=true bigDataUrl=/interactExample4.inter.bb visibility=pack 
    +track type=bigInteract name="interact Example Four" description="A bigInteract file" useScore=on bigDataUrl=/interactExample4.inter.bb visibility=pack 
     browser position chr3:63,820,967-63,880,091
        
  7. To fully take advantage of creating a bigInteract file, create a Track Hub and use a stanza such as the following:
    
     track exampleInteractTrack
     type bigInteract
     visibility full
     shortLabel exInteract
     longLabel Example interact track
     spectrum on
     scoreMin 175
     maxHeightPixels 300:150:20
     bigDataUrl interactExample4.inter.bb