736710b4abb6ab631057f752e7a8e1b3411f1a36
hiram
  Wed Oct 25 14:14:14 2023 -0700
correct text description for query vs. target genomes for single line gap annotation meaning refs #32455

diff --git src/hg/makeDb/trackDb/human/primateChainNet.html src/hg/makeDb/trackDb/human/primateChainNet.html
index a65794b..b8a34d0 100644
--- src/hg/makeDb/trackDb/human/primateChainNet.html
+++ src/hg/makeDb/trackDb/human/primateChainNet.html
@@ -1,212 +1,212 @@
 <H2>Description</H2>
 <H3>Chain Track</H3>
 <P>
 The chain track shows alignments of human ($date) to
 other genomes using a gap scoring system that allows longer gaps 
 than traditional affine gap scoring systems. It can also tolerate gaps in both
 human and the other genome simultaneously. These 
 &quot;double-sided&quot; gaps can be caused by local inversions and 
 overlapping deletions in both species. 
 <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
-human assembly or an insertion in the other assembly.
+other assembly or an insertion in the human 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 other 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 "pack" and "full" display
 modes, the individual feature names indicate the chromosome, strand, and
 location (in thousands) of the match for each matching alignment.</P>
 
 <H3>Net Track</H3>
 <P>
 The net track shows the best human/other chain for 
 every part of the other genome. It is useful for
 finding orthologous regions and for studying genome
 rearrangement.  The human sequence used in this annotation is from
 the $date assembly.</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>
 
 <H3>Net Track</H3>
 <P>
 In full display mode, the top-level (level 1)
 chains are the largest, highest-scoring chains that
 span this region.  In many cases gaps exist in the
 top-level chain.  When possible, these are filled in by
 other chains that are displayed at level 2.  The gaps in 
 level 2 chains may be filled by level 3 chains and so
 forth. </P>
 <P>
 In the graphical display, the boxes represent ungapped 
 alignments; the lines represent gaps.  Click
 on a box to view detailed information about the chain
 as a whole; click on a line to display information
 about the gap.  The detailed information is useful in determining
 the cause of the gap or, for lower level chains, the genomic
 rearrangement. </P> 
 <P> 
 Individual items in the display are categorized as one of four types
 (other than gap):</P>
 <P><UL>
 <LI><B>Top</B> - the best, longest match. Displayed on level 1.
 <LI><B>Syn</B> - line-ups on the same chromosome as the gap in the level above
 it.
 <LI><B>Inv</B> - a line-up on the same chromosome as the gap above it, but in 
 the opposite orientation.
 <LI><B>NonSyn</B> - a match to a chromosome different from the gap in the 
 level above.
 </UL></P>
 
 <H2>Methods</H2>
 <H3>Chain track</H3>
 <P>
 Transposons that have been inserted since the human/other
 split were removed from the assemblies. The abbreviated genomes were
 aligned with lastz, and the transposons were added back in.
 The resulting alignments were converted into axt format using the lavToAxt
 program. The axt alignments were fed into axtChain, which organizes all
 alignments between a single human chromosome and a single
 chromosome from the other genome 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.
 
 <BLOCKQUOTE><TABLE BORDER=0 CELLPADDING=4 BORDERCOLOR="#aaaaaa">
 <TR ALIGN=left><TD>
 <P>
 <BLOCKQUOTE>
 The following lastz matrix was used<BR>for the alignments to: Chimp,<BR>
 Gorilla, Orangutan, Gibbon,<BR>Rhesus, Baboon and Marmoset
 </P>
 
 <TABLE BORDER=1 CELLPADDING=4 BORDERCOLOR="#aaaaaa">
 <TR ALIGN=right><TD>&nbsp;</TD><TD><B>A</B></TD><TD><B>C</B></TD><TD><B>G</B></TD><TD><B>T</B></TD></TR>
 <TR ALIGN=right><TD><B>A<B></TD><TD>90</TD><TD>-330</TD><TD>-236</TD><TD>-356</TD></TR>
 <TR ALIGN=right><TD><B>C<B></TD><TD>-330</TD><TD>100</TD><TD>-318</TD><TD>-236</TD></TR>
 
 <TR ALIGN=right><TD><B>G<B></TD><TD>-236</TD><TD>-318</TD><TD>100</TD><TD>-330</TD></TR>
 <TR ALIGN=right><TD><B>T<B></TD><TD>-356</TD><TD>-236</TD><TD>-330</TD><TD>90</TD></TR>
 </TABLE></BLOCKQUOTE>
 
 </TD><TD WIDTH=40>&nbsp;</TD><TD>
 <P>
 <BLOCKQUOTE>
 The following lastz matrix was used<BR>for the alignments to: Tarsier,<BR>
 Mouse Lemur and Bushbaby
 </P>
 <TABLE BORDER=1 CELLPADDING=4 BORDERCOLOR="#aaaaaa">
 <TR ALIGN=right><TD>&nbsp;</TD><TD><B>A</B></TD><TD><B>C</B></TD><TD><B>G</B></TD><TD><B>T</B></TD></TR>
 <TR ALIGN=right><TD><B>A<B></TD><TD>91</TD><TD>-114</TD><TD>-31</TD><TD>-123</TD></TR>
 <TR ALIGN=right><TD><B>C<B></TD><TD>-114</TD><TD>100</TD><TD>-125</TD><TD>-31</TD></TR>
 
 <TR ALIGN=right><TD><B>G<B></TD><TD>-31</TD><TD>-125</TD><TD>100</TD><TD>-114</TD></TR>
 <TR ALIGN=right><TD><B>T<B></TD><TD>-123</TD><TD>-31</TD><TD>-114</TD><TD>91</TD></TR>
 </TABLE></BLOCKQUOTE>
 </TD></TR></TABLE></BLOCKQUOTE></P>
 
 For the alignments to: Chimp, Gorilla, Orangutan, Gibbon, Rhesus,
 Baboon and Marmoset, chains scoring below a minimum
 score of '$chainMinScore' were discarded; the remaining chains
 are displayed in this track.  The linear gap matrix used with axtChain:<BR>
 $chainLinearGap
 
 For the alignments to: Tarsier, Mouse Lemur and Bushbaby, chains scoring
 below a minimum score of '3000' were discarded; the remaining chains
 are displayed in this track.  The same linear gap matrix show above
 was used with axtChain.
 </P>
 <P>Chains for low-coverage assemblies for which no browser has been built 
 (Gorilla, Baboon, Tarsier, Mouse Lemur and Bushbaby) are not available as
 browser tracks, but only from 
 <A HREF = "hgwdownload.soe.ucsc.edu.downloads.html">downloads</A>.
 </P>
 
 See also: <A HREF="http://genomewiki.ucsc.edu/index.php/Hg19_conservation_lastz_parameters"
 TARGET=_blank>lastz parameters</A> and other details (e.g., update time) 
 and chain <A HREF="http://genomewiki.ucsc.edu/index.php/Hg19_Genome_size_statistics"
 TARGET=_blank>minimum score and gap</A> parameters used in these alignments.
 
 <H3>Net 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
 chainNet 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 
 netSyntenic 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 netClass 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>
 
 <H2>Credits</H2>
 <P>
 Lastz (previously known as blastz) was developed at
 <A HREF="http://www.bx.psu.edu/miller_lab/" 
 TARGET=_blank>Pennsylvania State University</A> by 
 Minmei Hou, Scott Schwartz, Zheng Zhang, and Webb Miller with advice from
 Ross Hardison.</P>
 <P>
 Lineage-specific repeats were identified by Arian Smit and his 
 <A HREF="http://www.repeatmasker.org" TARGET=_blank>RepeatMasker</A>
 program.</P>
 <P>
 The axtChain 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 chainNet, netSyntenic, and netClass programs were
 developed at the University of California
 Santa Cruz by Jim Kent.</P>
 <P>
 
 <H2>References</H2>
 <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>