7072384d5e6f4228bec4186d3d677527be0c9bc5
mspeir
  Fri Jun 26 09:37:20 2026 -0700
Adding data access to hs1 pages on the RR, refs #

diff --git src/hg/makeDb/trackDb/human/hs1/hs1PrimateChainNet.html src/hg/makeDb/trackDb/human/hs1/hs1PrimateChainNet.html
index b925065444c..99636787f57 100644
--- src/hg/makeDb/trackDb/human/hs1/hs1PrimateChainNet.html
+++ src/hg/makeDb/trackDb/human/hs1/hs1PrimateChainNet.html
@@ -1,196 +1,223 @@
 <h2>Description</h2>
 <p>
 This track shows regions of this <em>target</em> genome (Human - Jan. 2022 (T2T CHM13v2.0/hs1) - Telomere to telomere (T2T) assembly of haploid CHM13 + chrY (GCA_009914755.4)) that has alignment
 to other <em>query</em> genomes (&quot;chain&quot; subtracks) or in synteny (&quot;net&quot; subtracks).
 The alignable parts are shown with thick blocks that look like exons.
 Non-alignable parts between these are shown like introns.
 </p>
 
 <p>
 Other <em>query</em> genome assemblies aligning to this <em>target</em> genome assembly:
 <ul>
 <li>% 91.315 <a href='https://genome.ucsc.edu/h/GCA_029289425.2_NHGRI_mPanPan1-v2.0_pri' target=_blank>GCA_029289425.2_NHGRI_mPanPan1-v2.0_pri</a> pygmy chimpanzee 2024-01-08 National Human Genome Research Institute, National Institutes of Health</li>
 <li>% 91.315 <a href='https://genome.ucsc.edu/h/GCA_028858775.2_NHGRI_mPanTro3-v2.0_pri' target=_blank>GCA_028858775.2_NHGRI_mPanTro3-v2.0_pri</a> chimpanzee 2024-01-08 National Human Genome Research Institute, National Institutes of Health</li>
 <li>% 90.999 <a href='https://genome.ucsc.edu/h/GCA_029281585.2_NHGRI_mGorGor1-v2.0_pri' target=_blank>GCA_029281585.2_NHGRI_mGorGor1-v2.0_pri</a> western lowland gorilla 2024-01-08 National Human Genome Research Institute, National Institutes of Health</li>
 <li>% 88.699 <a href='https://genome.ucsc.edu/h/GCA_028885655.2_NHGRI_mPonAbe1-v2.0_pri' target=_blank>GCA_028885655.2_NHGRI_mPonAbe1-v2.0_pri</a> Sumatran orangutan 2024-01-05 National Human Genome Research Institute, National Institutes of Health</li>
 <li>% 88.670 <a href='https://genome.ucsc.edu/h/GCA_028885625.2_NHGRI_mPonPyg2-v2.0_pri' target=_blank>GCA_028885625.2_NHGRI_mPonPyg2-v2.0_pri</a> Bornean orangutan 2024-01-08 National Human Genome Research Institute, National Institutes of Health</li>
 <li>% 84.462 <a href='https://genome.ucsc.edu/h/GCA_028878055.2_NHGRI_mSymSyn1-v2.0_pri' target=_blank>GCA_028878055.2_NHGRI_mSymSyn1-v2.0_pri</a> siamang 2024-01-05 National Human Genome Research Institute, National Institutes of Health</li>
 <li>% 66.921 <a href='https://genome.ucsc.edu/h/GCF_011100555.1_mCalJa1.2.pat.X' target=_blank>GCF_011100555.1_mCalJa1.2.pat.X</a> white-tufted-ear marmoset 2021-04-28 Vertebrate Genomes Project</li>
 <li>% 31.755 <a href='https://genome.ucsc.edu/h/GCF_020740605.2_mLemCat1.pri' target=_blank>GCF_020740605.2_mLemCat1.pri</a> Ring-tailed lemur 2021-11-04 Vertebrate Genomes Project</li>
 <li>% 14.855 <a href='https://genome.ucsc.edu/h/GCF_027406575.1_mNycCou1.pri' target=_blank>GCF_027406575.1_mNycCou1.pri</a> slow loris 2022-12-28 Vertebrate Genomes Project</li>
 </ul>
 </p>
 <h3>Alignments identity</h3>
 <table border='1'>
 <caption>showing percent identity, how much of the target is matched by the query</caption>
 <thead style='position:sticky; top:0; background-color: white;'><tr>
 <th>chains</th><th>syntenic</th><th>reciprocal<br>best</th><th>common<br>name</th><th>assembly</th>
 </tr></thead><tbody>
 <tr><td style='text-align:right;'>91.315</td><td style='text-align:right;'>90.708</td><td style='text-align:right;'>89.043</td><td>pygmy chimpanzee</td><td>GCA_029289425.2_NHGRI_mPanPan1-v2.0_pri</td></tr>
 <tr><td style='text-align:right;'>91.315</td><td style='text-align:right;'>90.674</td><td style='text-align:right;'>89.076</td><td>chimpanzee</td><td>GCA_028858775.2_NHGRI_mPanTro3-v2.0_pri</td></tr>
 <tr><td style='text-align:right;'>90.999</td><td style='text-align:right;'>90.319</td><td style='text-align:right;'>88.448</td><td>western lowland gorilla</td><td>GCA_029281585.2_NHGRI_mGorGor1-v2.0_pri</td></tr>
 <tr><td style='text-align:right;'>88.699</td><td style='text-align:right;'>87.864</td><td style='text-align:right;'>85.780</td><td>Sumatran orangutan</td><td>GCA_028885655.2_NHGRI_mPonAbe1-v2.0_pri</td></tr>
 <tr><td style='text-align:right;'>88.670</td><td style='text-align:right;'>87.822</td><td style='text-align:right;'>85.755</td><td>Bornean orangutan</td><td>GCA_028885625.2_NHGRI_mPonPyg2-v2.0_pri</td></tr>
 <tr><td style='text-align:right;'>84.462</td><td style='text-align:right;'>83.337</td><td style='text-align:right;'>80.990</td><td>siamang</td><td>GCA_028878055.2_NHGRI_mSymSyn1-v2.0_pri</td></tr>
 <tr><td style='text-align:right;'>66.921</td><td style='text-align:right;'>65.793</td><td style='text-align:right;'>64.181</td><td>white-tufted-ear marmoset</td><td>GCF_011100555.1_mCalJa1.2.pat.X</td></tr>
 <tr><td style='text-align:right;'>31.755</td><td style='text-align:right;'>30.955</td><td style='text-align:right;'>30.652</td><td>Ring-tailed lemur</td><td>GCF_020740605.2_mLemCat1.pri</td></tr>
 <tr><td style='text-align:right;'>14.855</td><td style='text-align:right;'>14.032</td><td style='text-align:right;'>14.306</td><td>slow loris</td><td>GCF_027406575.1_mNycCou1.pri</td></tr>
 </tbody></table>
 <h3>Chain Track</h3>
 <p>
 The chain tracks shows alignments of the other genome assemblies to the
 Human/Homo sapiens/Jan. 2022 (T2T CHM13v2.0/hs1)/Jan. 2022 (T2T CHM13v2.0/hs1) genome using a gap scoring system that allows longer gaps
 than traditional affine gap scoring systems. It can also tolerate gaps in both
 <em>query</em> and <em>target</em> genomes simultaneously. These
 &quot;double-sided&quot; gaps can be caused by local inversions and
 overlapping deletions in both species.
 </p>
 <p>
 The chain track displays boxes joined together by either single or
 double lines. The boxes represent aligning regions.
 Single lines indicate gaps that are largely due to a deletion in the
 <em>query</em> assembly or an insertion in the <em>target</em>
 assembly.  Double lines represent more complex gaps that involve substantial
 sequence in both species. This may result from inversions, overlapping
 deletions, an abundance of local mutation, or an unsequenced gap in one
 species.  In cases where multiple chains align over a particular region of
 the <em>target</em> genome, the chains with single-lined gaps are often
 due to processed pseudogenes, while chains with double-lined gaps are more
 often due to paralogs and unprocessed pseudogenes.</p>
 <p>
 In the &quot;pack&quot; and &quot;full&quot; display
 modes, the individual feature names indicate the chromosome, strand, and
 location (in thousands) of the match for each matching alignment.</p>
 <p>
 There could be four different types of chain tracks:
 <ul>
 <li><b>Chains</b> - The first level of chain track showing all potential chains.
   The other chain tracks are derived from this chain data.</li>
 <li><b>Syntenic</b> - Filtered first level chain showing the corresponding
   regions between the two genomes in the alignment that have the same
   order of blocks and direction in the alignment.</li>
 <li><b>Reciprocal best</b> - Filtered first level chain showing the
   corresponding regions where the best target to query alignment,
   and the best query to target alignment identify the same regions.</li>
 <li><b>Lift over</b> - filtered first level chain selecting out the
   best/longest syntenic regions used to translate coordinates from the
   target genome to the query genome.</li>
 </ul>
 </p>
 
 <h3>Alignment Track</h3>
 <p>
 The alignment track shows the <b>net</b> derived from the chain data in the
 format of a pair-wise side by side alignment.  The net file is converted
 to the <a href='https://genome.ucsc.edu/FAQ/FAQformat.html#format5'
 target=_blank>MAF format</a> for this display.
 </p>
 
 <h2>Display Conventions and Configuration</h2>
 <h3>Chain Track</h3>
 <p>By default, the chains to chromosome-based assemblies are colored
 based on which chromosome they map to in the aligning organism. To turn
 off the coloring, check the &quot;off&quot; button next to: Color
 track based on chromosome.</p>
 <p>
 To display only the chains of one chromosome in the aligning
 organism, enter the name of that chromosome (e.g. chr4) in box next to:
 Filter by chromosome.</p>
 
 <h2>Alignment Track</h3>
 <p>
 At base level in full display mode, this track will show the
 sequence of <em>query</em> as it aligned to <em>target</em>.  When the view is
 too large to show such detail, blocks of alignments will show
 corresponding alignments to other chromosomes with colors indicating other
 chromosomes.
 </p>
 
 <h2>Methods</h2>
 <h3>Chain track</h3>
 <p>
 The <em>query</em> genome was aligned to <em>target</em> genome with <em>lastz</em>.
 The resulting alignments were converted into axt format using the <em>lavToAxt</em>
 program. The axt alignments were fed into <em>axtChain</em>, which organizes all
 alignments between a single <em>query</em> chromosome and a single
 <em>target</em> chromosome into a group and creates a kd-tree out
 of the gapless subsections (blocks) of the alignments. A dynamic program
 was then run over the kd-trees to find the maximally scoring chains of these
 blocks.
 </p>
 
 <h3>Alignment track</h3>
 <p>
 Chains were derived from lastz alignments, using the methods
 described on the chain tracks description pages, and sorted with the
 highest-scoring chains in the genome ranked first. The program
 <em>chainNet</em> was then used to place the chains one at a time, trimming them as
 necessary to fit into sections not already covered by a higher-scoring chain.
 During this process, a natural hierarchy emerged in which a chain that filled
 a gap in a higher-scoring chain was placed underneath that chain. The program
 <em>netSyntenic</em> was used to fill in information about the relationship between
 higher- and lower-level chains, such as whether a lower-level
 chain was syntenic or inverted relative to the higher-level chain.
 The program <em>netClass</em> was then used to fill in how much of the gaps and chains
 contained <em>N</em>s (sequencing gaps) in one or both species and how much
 was filled with transposons inserted before and after the two organisms
 diverged.
 </p>
 
 <p>
 The resulting net file was converted to axt format via <em>netToAxt</em>,
 then converted to maf format via <em>axtToMaf</em>, then converted to
 the bigMaf format with <em>mafToBigMaf</em> and <em>bedToBigBed</em>
 </p>
 
+<h2>Data Access</h2>
+<p>
+The chains and alignments can be explored interactively with the
+<a href="../cgi-bin/hgTables" target="_blank">Table Browser</a> or the
+<a href="../cgi-bin/hgIntegrator" target="_blank">Data Integrator</a>. The data can also be
+accessed from scripts through our <a href="https://api.genome.ucsc.edu" target="_blank">REST
+API</a>.</p>
+<p>
+For automated analysis, the underlying chain data are stored as bigChain files (one per query
+assembly) in the <tt>chainNet/</tt> directory on our
+<a href="https://hgdownload.soe.ucsc.edu/gbdb/$db/chainNet/" target="_blank">download server</a>.
+For chain tracks, individual regions or the whole genome annotation can be obtained using our tool
+<tt>bigChainToChain</tt>, while for net tracks, data can be accessed using the <tt>bigBedtoBed</tt>.
+Both tools can be compiled from the source code or downloaded as precompiled
+binaries for your system. Instructions for downloading source code and binaries can be found
+<a href="https://hgdownload.soe.ucsc.edu/downloads.html#utilities_downloads" target="_blank">here</a>.
+Both tools can also be used to obtain only features within a given range, for example:</p>
+<tt>bigChainToChain https://hgdownload.soe.ucsc.edu/gbdb/hs1/chainNet/hs1.chainRBestGCA_028858775.2.bb -chrom=chr6 -start=0 -end=1000000 stdout</tt>
+<br>
+<tt>bigBedToBed https://hgdownload.soe.ucsc.edu/gbdb/hs1/chainNet/hs1.GCA_028858775.2.net.bb -chrom=chr6 -start=0 -end=1000000 stdout</tt>
+<p>
+Please refer to our
+<a href="https://groups.google.com/a/soe.ucsc.edu/forum/#!forum/genome" target="_blank">mailing
+list archives</a> for questions, or our
+<a href="../FAQ/FAQdownloads.html#download36" target="_blank">Data Access FAQ</a> for more
+information.</p>
+
 <h2>Credits</h2>
 <p>
 <em>lastz</em> was developed by Robert Harris, Pennsylvania State University.
 </p>
 <p>
 The <em>axtChain</em> program was developed at the University of California at
 Santa Cruz by Jim Kent with advice from Webb Miller and David Haussler.</p>
 <p>
 The browser display and database storage of the chains and nets were created
 by Robert Baertsch and Jim Kent.</p>
 <p>
 The <em>chainNet</em>, <em>netSyntenic</em>, and <em>netClass</em> programs
 were developed at the University of California
 Santa Cruz by Jim Kent.</p>
 
 <h2>References</h2>
 <p>
 Harris, R.S.
 <a href="http://www.bx.psu.edu/~rsharris/lastz/"
 target=_blank>(2007) Improved pairwise alignment of genomic DNA</a>
 Ph.D. Thesis, The Pennsylvania State University
 </p>
 
 <p>
 Chiaromonte F, Yap VB, Miller W.
 <A HREF="http://psb.stanford.edu/psb-online/proceedings/psb02/chiaromonte.pdf"
 TARGET=_blank>Scoring pairwise genomic sequence alignments</A>.
 <em>Pac Symp Biocomput</em>. 2002:115-26.
 PMID: <a href="https://www.ncbi.nlm.nih.gov/pubmed/11928468" target="_blank">11928468</a>
 </p>
 
 <p>
 Kent WJ, Baertsch R, Hinrichs A, Miller W, Haussler D.
 <A HREF="https://www.pnas.org/content/100/20/11484"
 TARGET=_blank>Evolution's cauldron:
 duplication, deletion, and rearrangement in the mouse and human genomes</A>.
 <em>Proc Natl Acad Sci U S A</em>. 2003 Sep 30;100(20):11484-9.
 PMID: <a href="https://www.ncbi.nlm.nih.gov/pubmed/14500911" target="_blank">14500911</a>; PMC: <a
 href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC208784/" target="_blank">PMC208784</a>
 </p>
 
 <p>
 Schwartz S, Kent WJ, Smit A, Zhang Z, Baertsch R, Hardison RC,
 Haussler D, Miller W.
 <A HREF="https://genome.cshlp.org/content/13/1/103.abstract"
 TARGET=_blank>Human-mouse alignments with BLASTZ</A>.
 <em>Genome Res</em>. 2003 Jan;13(1):103-7.
 PMID: <a href="https://www.ncbi.nlm.nih.gov/pubmed/12529312" target="_blank">12529312</a>; PMC: <a
 href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC430961/" target="_blank">PMC430961</a>
 </p>