215016bf4adff3d8b957c388af767583214db924
abenetpa
  Wed Sep 30 07:29:04 2020 -0700
added filters and CNV color to description refs#25841

diff --git src/hg/makeDb/trackDb/human/decipher.html src/hg/makeDb/trackDb/human/decipher.html
index 4c9d4f8..3b1c9c4 100644
--- src/hg/makeDb/trackDb/human/decipher.html
+++ src/hg/makeDb/trackDb/human/decipher.html
@@ -1,95 +1,116 @@
 <H2>Description</H2>
 
 <div class="warn-note" style="border: 2px solid #9e5900; padding: 5px 20px; background-color: #ffe9cc;">
  <P><span style="font-weight: bold; color: #c70000;">NOTE:</span><br> 
  While the DECIPHER database is 
  open to the public, users seeking information about a personal medical or
  genetic condition are urged to consult with a qualified physician for
  diagnosis and for answers to personal questions.
  </P>
  <P>Because the UCSC Genes mappings for CNVs are based on associations from
  RefSeq and UniProt, they are dependent on any interpretations from those
  sources.  Furthermore, because many DECIPHER records refer to multiple gene
  names, or syndromes not tightly mapped to individual genes, the associations
  in this track should be treated with skepticism and any conclusions
  based on them should be carefully scrutinized using independent
  resources.
  </P>
  <p><b>Data Display Agreement Notice</b><br>
  These data are only available for display in the Browser, and not for bulk
  download.  Access to bulk data may be obtained directly from DECIPHER
  (<a href='http://decipher.sanger.ac.uk/datasharing' target='_blank'
  >http://decipher.sanger.ac.uk/datasharing</a>) and is subject to a
  Data Access Agreement, in which the user certifies that no attempt to
  identify individual patients will be undertaken.  The same restrictions
  apply to the public data displayed at UCSC in the UCSC Genome Browser;
  no one is authorized to attempt to identify patients by any means.
  </p>
  <p>These data are made available as soon as possible and may be a
  pre-publication release.  For information on the proper use of DECIPHER
  data, please see <a href='http://decipher.sanger.ac.uk/datasharing'
  target='_blank'>http://decipher.sanger.ac.uk/datasharing</a>.
  </p>
  <p>The DECIPHER consortium provides these data in good faith as a research
  tool, but without verifying the accuracy, clinical validity, or utility of
  the data.  The DECIPHER consortium makes no warranty, express or implied,
  nor assumes any legal liability or responsibility for any purpose for
  which the data are used.
  </p>
 </div>
 
 <P>
 The 
 <A HREF="https://decipher.sanger.ac.uk" TARGET=_BLANK>DECIPHER</A>
 database of submicroscopic chromosomal imbalance 
 collects clinical information about chromosomal 
 microdeletions/duplications/insertions, translocations and inversions, 
 and displays this information on the human genome map.
 <p>
 This track shows genomic regions of reported cases and their 
 associated phenotype information.  All data have passed the strict
 consent requirements of the DECIPHER project and are approved for
 unrestricted public release.  Clicking the Patient View ID link
 brings up a more detailed informational page on the patient at the 
 DECIPHER web site. 
-<H2>Method</H2>
+
+<H2>Display Conventions and Configuration</H2>
 <P>
-Data provided by the DECIPHER project group are imported and processed 
-to create a simple BED track to annotate the genomic regions associated 
-with individual patients.  
-</P>
+The genomic locations of DECIPHER variants are labelled with the DECIPHER variant descriptions. 
+<b>Mouseover</b> on items shows variant details, clinical interpretation, and associated conditions. 
+Further information on each variant is displayed on the details page by a click onto any variant. 
+</p>
+
+<P>
+For the <b>CNVs track</b>, the entries are colored by the <b>type of variant</b>:
 <ul>
-  <li>
-    For the CNVs track, the entries are colored <B><FONT COLOR = RED>red</FONT></B> for deletions 
-    (mean log ratio &lt; 0) and <B><FONT COLOR = BLUE>blue</FONT></B> for duplications 
-    (mean log ratio &gt; 0).  Entries where no mean ratio is available are colored
-    <b><font color="#888">grey</font></b>.</li>
-  <li>
-    For the SNVs track, the entries are colored according to the estimated pathogenicity of the
-    variant. <br>Entries are colored:
+ <li><b><font color="red">red</font></b> for loss</li>
+ <li><b><font color="blue">blue</font></b> for gain</li>
+ <li><b><font color="grey">grey</font></b> for amplification</li>
+</ul>
+</P>
+
+<P>
+A light-to-dark color gradient indicates the <b>clinical significance</b> of each variant, with 
+the lightest shade being benign, to the darkest shade being pathogenic. Detailed information on the 
+CNV color code is described <a href="https://genome.ucsc.edu/goldenPath/help/hgCnvColoring.html">here</a>.
+Items can be filtered according to the size of the variant, variant type, and clinical significance 
+using the track <b>Configure</b> options.
+</P>
+ 
+<P>
+For the <b>SNVs track</b>, the entries are colored according to the estimated <b>clinical significance</b> 
+of the variant:
 <ul>
  <li><b><font color="black">black</font></b> for likely or definitely pathogenic</li>
  <li><b><font color="#888">dark grey</font></b> for uncertain or unknown</li>
  <li><b><font color="#c8c8c8">light grey</font></b> for likely or definitely benign</li>
  </ul>
-</ul>
+</P>
+
+<H2>Method</H2>
+<P>
+Data provided by the DECIPHER project group are imported and processed
+to create a simple BED track to annotate the genomic regions associated
+with individual patients.
+</P>
+
 
 <H2>Contact</H2>
 <P>
 For more information on DECIPHER, please contact
 <A HREF="mailto:&#100;&#101;c&#105;&#112;h&#101;&#114;&#64;&#115;&#97;&#110;&#103;&#101;&#114;.
 a&#99;.
 &#117;&#107;">
 &#100;&#101;c&#105;&#112;h&#101;&#114;&#64;&#115;&#97;&#110;&#103;&#101;&#114;.a&#99;.&#117;&#107;</A>.
 </P>
 
 <H2>References</H2>
 <p>
 Firth HV, Richards SM, Bevan AP, Clayton S, Corpas M, Rajan D, Van Vooren S, Moreau Y, Pettett RM,
 Carter NP.
 <a href="https://www.cell.com/ajhg/abstract/S0002-9297(09)00107-4" target="_blank">
 DECIPHER: Database of Chromosomal Imbalance and Phenotype in Humans Using Ensembl Resources</a>.
 <em>Am J Hum Genet</em>. 2009 Apr;84(4):524-33.
 PMID: <a href="https://www.ncbi.nlm.nih.gov/pubmed/19344873" target="_blank">19344873</a>; PMC: <a
 href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC2667985/" target="_blank">PMC2667985</a>
 </p>