87eae20de868054a5abeedeb78a24d3e296b87d5 dschmelt Tue May 21 15:09:55 2019 -0700 Adding notes about TinyURL enabling URL parameters #23030 diff --git src/hg/htdocs/FAQ/FAQlink.html src/hg/htdocs/FAQ/FAQlink.html index d1f14dd..52f72b4 100755 --- src/hg/htdocs/FAQ/FAQlink.html +++ src/hg/htdocs/FAQ/FAQlink.html @@ -19,46 +19,55 @@
The easiest way to save and share tracks from the URL is by logging in to your Genome Browser account and creating a saved session. Saved sessions are a versatile way to share data that may include native annotations, Custom Tracks, Track Hubs, and Assembly Hubs. Note that the <input> format indicates a user choice and not a valid example.
-You will be able to share Genome Browser sessions with the following link format: +You will be able to share Genome Browser sessions with the following link format:
http://genome.ucsc.edu/s/<userName>/<sessionName>
For instructions on creating a saved session, go to the session user guide. If you want to specify track settings in a URL directly, please read the section on -setting track visibility via URL for a complete description. -Note that URL parameters do not work with the shorter session URLs.
+setting track visibility via URL for a complete description.-Or if you prefer a modifiable, longer URL, use the following format:
-http://genome.ucsc.edu/cgi-bin/hgTracks?hgS_doOtherUser=submit&hgS_otherUserName=<userName>&hgS_otherUserSessionName=<SessionName>
It has the advantage of being able to add additional URL parameters to the end and the -flexibility of replacing "hgTracks" with different tools to share saved settings on the Table -Browser (hgTables), Variant Annotation Integrator (hgVai), or Data Integrator (hgIntegrator). -This will preserve your option selections and can be useful to share.
+Or if you prefer the older style, which allows you to link to different tools, you may use the +following format: +http://genome.ucsc.edu/cgi-bin/hgTracks?hgS_doOtherUser=submit&hgS_otherUserName=<userName>&gS_otherUserSessionName=<SessionName>
+This longer format has the flexibility of replacing "hgTracks" with different tool names to share +saved settings on the Table Browser (hgTables), Variant Annotation Integrator (hgVai), or Data +Integrator (hgIntegrator). This will preserve your option selections and can be useful to share. +The following format will bring the recipient to a user's custom Table Browser selections:
+http://genome.ucsc.edu/cgi-bin/hgTables?hgS_doOtherUser=submit&hgS_otherUserName=<userName>&hgS_otherUserSessionName=<SessionName>
Both session link formats have the advantage of being able to add URL parameters to the end. +The shorter link format requires a question mark before any URL parameters, with ampersand +characters separating different parameters like so:
+http://genome.ucsc.edu/s/view/clinicalzoom?textSize=18
The longer format requires an ampersand between each parameter, like so:
+
You can link to a specific genome assembly and position in the Genome Browser using a URL with
the db=
and position=
parameters. Note that the <input>
format indicates a user choice and not a valid example.
http://genome.ucsc.edu/cgi-bin/hgTracks?db=<assembly>&position=<position>
Where:
db
- designates a specific genome assembly. For example, db=hg19
refers to the Feb. 2009 human genome release. For a list of db parameter values that
@@ -72,32 +81,32 @@
http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg19&position=chr1:35000-40000
You can control the visibility of tracks from the URL with the following parameters, each linked by the "&" sign, similar to position parameters. For more information, please see the optional URL parameters section of the Custom Tracks User's Guide. Note that the <input> format indicates a user choice and not a valid example.
hideTracks=1
- hides all tracks<trackName>=hide|dense|pack|full
- sets specified track or subtrack to a
chosen visibilitytextSize=<number>
- sets browser text size to a chosen number, default of
-8 and maximum of 24textSize=<number>
- sets browser text size to either 6,8,10,12,14,18,24,or
+34. Default is a textSize of 8.ignoreCookie=1
- removes pre-existing user settings like track seletion, custom
tracks, and track hubsFor example, you can use the following command to hide every track (hideTracks=1) and set the knownGene track to the pack visibility (knownGene=pack):
http://genome.ucsc.edu/cgi-bin/hgTracks?db=hg38&hideTracks=1&knownGene=pack
Composite tracks have additional URL parameters that encode options to hide, select, and display subtracks.
<trackName>_hideKids=1
- hides a specific composite track's subtracks<trackName>_sel=1
- selects specific subtrack to be 'checked', allowing
display