d60963c11b6d1f67e678c6ff2cf9c82f2ada9e12 lrnassar Tue Mar 26 17:28:58 2024 -0700 Encouraging session use as the first option when sharing custom tracks, refs #23842 diff --git src/hg/htdocs/goldenPath/help/customTrackText.html src/hg/htdocs/goldenPath/help/customTrackText.html index e2f25fc..8b15c48 100755 --- src/hg/htdocs/goldenPath/help/customTrackText.html +++ src/hg/htdocs/goldenPath/help/customTrackText.html @@ -729,32 +729,43 @@ configuring BAM tracks and the configuring graph-based tracks help pages to learn how to further change the display.
To make your Genome Browser annotation track viewable by people on other machines or at other sites, follow the steps below.
Step 1. Put your formatted annotation file on your web site.
Be sure that the file permissions allow it to be read by others.
-Step 2. Construct a URL that will link this annotation file to the Genome Browser. +Step 2. Create a session link, or construct a URL that will link this annotation file to the Genome Browser.
+The easiest way to share custom tracks is through the use of +sessions. First, upload your tracks as +discussed in the Loading a Custom Track into the Genome Browser section. +Then create a named session that includes your custom tracks by navigating to the "Sessions" +page through the "My Data" section in the menu bar. Once there, follow the instructions in the +Creating a Session section of the Sessions help page. +Once you have saved your custom track into a named session, you can share that session with others +by sharing the URL from the "Browser" link or emailing it to them directly by clicking +the "Email" link.
++Alternatively, you can create a URL. The URL must contain 3 pieces of information specific to your annotation data:
org=human
. To specify a particular genome assembly for an organism, use the
db parameter, db=<databaseName>
, where databaseName is the UCSC
code for the genome assembly. For a list of these codes, see the Genome Browser
FAQ. Examples of this include:
db=hg38 (Human Dec. 2013 assembly = GRCh38), db=mm10 (Mouse Dec. 2011 assembly = GRCm38).genome=<databaseName>
, which acts in the same manner as
the db parameter. Here is an example using the house mouse (Mus musculus, 129S1_SvImJ)
assembly hub:
The URL of the annotation file on your web site. This information is of the form
hgt.customText=<url>
or hgct_customText=<url>
,
where url points to the annotation file on your website.
An example of an annotation file URL is http://genome.ucsc.edu/goldenPath/help/test.bed.Combine the above pieces of information into a URL of the following format (the information specific to your annotation file is highlighted):
http://genome.ucsc.edu/cgi-bin/hgTracks?org=<organismName>&position=<chrPosition>&hgt.customText=<url>
Step 3. Provide the URL to others.
-To upload a custom annotation track from a URL into the Genome Browser, paste the URL into the large -text edit box on the Add Custom Tracks page, then click the Submit button.
+If you created a session, that stable link can be freely shared.-Custom Tracks can also be shared with others through named sessions. First, upload your tracks as -discussed in the Loading a Custom Track into the Genome Browser section. Then create a named session that includes your custom tracks by navigating to the "Sessions" -page through the "My Data" section in the menu bar. Once there, follow the instructions in the -Creating a Session section of the Sessions help page. -Once you have saved your custom track into a named session, you can share that session with others -by sharing the URL from the "Browser" link or emailing it to them directly by clicking -the "Email" link.
+Otherwise, to upload a custom annotation track from a URL into the Genome Browser, paste the URL into the large +text edit box on the Add Custom Tracks page, then click the Submit button.For integration into your own website e.g. in an html IFRAME, you can obtain the track image only, without the rest of the genome browser user interface, by replacing hgTracks in the URL with hgRenderTracks, such as in this example:
http://genome.ucsc.edu/cgi-bin/hgRenderTracks?db=hg19&position=chr9%3A136130563-136150630
If you'd like to share your annotation track with a broader audience, send the URL for your track—along with a description of the format, methods, and data used—to the UCSC Genome mailing list genome@soe.ucsc.edu.