b1dd32138ff6eb6a5ff7a9b55135abf3cd04bd69 dschmelt Mon Apr 29 16:56:28 2019 -0700 Various minor fixes for code review #23399, doc is still rough draft diff --git src/hg/htdocs/FAQ/FAQlink.html src/hg/htdocs/FAQ/FAQlink.html index 1d95dcb..6b77e79 100755 --- src/hg/htdocs/FAQ/FAQlink.html +++ src/hg/htdocs/FAQ/FAQlink.html @@ -1,167 +1,168 @@

Frequently Asked Questions: Linking to the Genome Browser

Topics

Linking to the Genome Browser from another software application
Linking to the browser at the position of a knownCanonical transcript +
Linking to the Browser at the position of a knownCanonical transcript associated with a gene symbol
The hgsid parameter
Creating a custom URL to view specific tracks
Changing Track Visibilites with URL
Adding Custom Tracks via URL
Connection to a Track Hub via URL

Linking to a specific position in the Genome Browser

You can make a link to a specific position in Genome Browser using a URL with the db= and position= parameters:

http://genome.ucsc.edu/cgi-bin/hgTracks?db=[db]&position=[position]

../cgi-bin/hgTracks?db=[db]&position=[position]

Where:

db - designates a specific assembly version. For example, to refer to the Feb. 2009 human release, you would use db=hg19. For a list of the db parameter values that correspond to UCSC assemblies, see the list of UCSC releases.
position - can be any search value valid for the genome specified. This often takes the form of position=chr1:35000-40000.

The following link is an example of a URL that declares assembly and position:

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg19&position=chr1:35000-40000

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg19&position=chr1:35000-40000

Linking to the browser on a particular gene symbol or displaying gene information

Linking to the Browser on a particular gene symbol or displaying gene information

Set the position parameter in the URL to the gene symbol and add the parameter singleSearch=knownCanonical. For example, this link will open the Genome Browser for the hg19 human assembly at the position of the knownCanonical transcript associated with GABRA3:

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg19&singleSearch=knownCanonical&position=GABRA3

The following URL connecting to 'hgGene' will open up the Genome Browser description page containing descriptions, expression, and links to associated information for the above gene. Note the use of the URL parameter hgg_gene=:

http://genome.ucsc.edu/cgi-bin/hgGene?db=hg19&hgg_gene=GABRA3

The hgsid parameter

What is the hgsid parameter? Should I include it in URLs when I make a link to the Genome Browser?

The hgsid parameter is a temporary, internally used parameter that stores information about what tracks the user last viewed, what position they were at, and what display settings they had enabled. This should not be used when constructing links to the Genome Browser and could unintentionally give someone access to private user data.

Creating a custom URL to view specific tracks

How can I create a custom URL to view a specific subset of tracks in the Genome Browser?

Each assembly in the Genome Browser will display using a default set of tracks unless you specifically modify the track set in your URL. The easiest way to construct your custom URL is by logging in to your Genome Browser account and creating a session:

Browse to the assembly of your choice (e.g. hg19).
Click the "hide all" button. All tracks should now be hidden.
Click the "My Data" pulldown in the blue navigation bar at the top of the screen to access Sessions.
In the "Save Settings" section under "Save current settings as named session:", enter a name for your session.
Check "allow this session to be loaded by others" if you want others to be able to access your session and URL.
Click the "submit" button.

Click the "Browser" link under "My Sessions" to open your session in the Browser. Your session URL should look similar to this:

http://genome.ucsc.edu/cgi-bin/hgTracks?hgS_doOtherUser=submit&hgS_otherUserName=[User Name]&hgS_otherUserSessionName=[Session Name]

To display the tracks of your choice, simply add the names of the tables associated with the tracks to the end of the session URL in the format "&[table name]=[display mode]". For example, to add the Assembly track in full display mode, add the table name "&gold=full" to the end of the URL:
```
http://genome.ucsc.edu/cgi-bin/hgTracks?hgS_doOtherUser=submit&hgS_otherUserName=[User Name]&hgS_otherUserSessionName=[Session Name]&gold=full 
```
If you don't know the table name for a track, in most cases you can view it by hovering the mouse cursor over either the gray bar to the left of the Browser's graphical display or the track's name in the group listings below the graphical display. In these cases the Browser will display a URL in the bottom left corner of the window, ending with the table name in the format "g=[table name]".

Here is an example of a URL that displays the UCSC Genes track in pack mode and the RefSeq Genes in full mode:

http://genome.ucsc.edu/cgi-bin/hgTracks?hgS_doOtherUser=submit&hgS_otherUserName=[User Name]&hgS_otherUserSessionName=[Session Name]&knownGene=pack&refGene=full

Setting visibitlies via the URL

You can control the visibility of tracks via the URL with the following parameters, each linked by the & sign, similar to previous commands. Here are a few commands you can use -to control track visibility.

+to control track visibility. Note that bold text indicates a variable and not +actually an example.

hideTracks=1
trackName=hide|dense|pack|full
textSize=number
ignoreCookie=1
position=chr1:250000-300000
position=geneSymbol&singleSearch=knownCanonical

For example, you can use the following command to only show the knownGene track:

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg38&hideTracks=1&knownGene=pack

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg38&hideTracks=1&knownGene=pack

You can use the following command to go to a particular position:

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg19&position=chr1:11000-20000

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg19&position=chr1:11000-20000

You can use the following command to go to a particular gene:

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg38&position=KRAS&singleSearch=knownCanonical

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg38&position=KRAS&singleSearch=knownCanonical

Loading data using the URL

Loading data using a URL

Load Custom Track data with a URL

-You can combine the above URL settings with the hgct_customText= parameter, to input your track -line you would otherwise put in the custom track +You can combine the URL visibility settings with the hgct_customText= parameter using +a track line you would otherwise put in the custom track input box. The following is an example of the hgct_customText URL variable:

hgct_customText=track%20type=bigBed%20bigDataUrl=https://genome.ucsc.edu/goldenPath/help/examples/bigBedExample.bb

-Try the following example for reference, note that it only has data on chromosome 21: -

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg38&hgct_customText=track%20type=bigBed%20bigDataUrl=https://genome.ucsc.edu/goldenPath/help/examples/bigBedExample.bb

+Try the following example of the hgct_customText URL variable, note that the hub only has data +on chromosome 21: +

http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg38&hgct_customText=track%20type=bigBed%20bigDataUrl=https://genome.ucsc.edu/goldenPath/help/examples/bigBedExample.bb

Load a Track Hub with a URL

Similar to Custom Tracks, track hubs can be loaded into the URL usig the hubURL= -parameter. This parameter takes input similar to the Track Hub interface. Try the +

Similar to Custom Tracks, track hubs can be loaded into the URL usig the hubUrl= +parameter. This parameter takes input similar to the Track Hub interface. Try the following example for reference:

http://genome.ucsc.edu/cgi-bin/hgTracks?hubUrl=https://genome.ucsc.edu/goldenPath/help/examples/hubDirectory/hub.txt&genome=hg19

http://genome.ucsc.edu/cgi-bin/hgTracks?hubUrl=https://genome.ucsc.edu/goldenPath/help/examples/hubDirectory/hub.txt&genome=hg19