This file is indexed.

/usr/share/doc/stilts/sun256/shading-weighted.html is in stilts-doc 3.1.2-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
<html>
   
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <link rel="stylesheet" type="text/css" href="sun-style.css">
      <title>weighted</title>
   </head>
   
   <body>
      <hr>
      <a href="paintMode.html">Next</a> <a href="shading-aux.html">Previous</a> <a href="ShapeMode.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="paintMode.html">Output Modes</a><br>
       <b>Up: </b><a href="ShapeMode.html">Shading Modes</a><br>
       <b>Previous: </b><a href="shading-aux.html">aux</a><br>
      
      <hr>
      <h4><a name="shading-weighted">8.4.7 <code>weighted</code></a></h4>
      <p>Paints markers like the Density mode,
         but with optional weighting by an additional
         coordinate.
         You can configure how the weighted coordinates
         are combined to give the final weighted result.
         The way that data values are mapped
         to colours is usually controlled by options
         at the level of the plot itself,
         rather than by per-layer configuration.
         
      </p>
      <p>
         <strong>Usage:</strong>
         <pre>
   shadingN=weighted weightN=&lt;num-expr&gt; colorN=&lt;rrggbb&gt;|red|blue|...
                     combineN=sum|mean|median|min|max|stdev|count|hit
</pre>
         </p>
      <p>All the parameters listed here
         affect only the relevant layer,
         identified by the suffix
         <code>N</code>.
         
      </p>
      <p>
         <strong>Example:</strong>
         
      </p>
      <div align="center"><img src="plot2-shading-weighted.png" alt="" align="middle"></div>
      <p><pre>   stilts plot2plane layer1=mark in1=dr5qso.fits
                     <strong>shading1=weighted</strong> <strong>weight1=z</strong> <strong>auxmap=plasma</strong>
                     x1=psfmag_g-psfmag_r y1=psfmag_u-psfmag_g size1=2
                     xmin=-0.5 xmax=2.5 ymin=-1 ymax=6</pre></p>
      <p>Associated parameters are as follows:
         
         <dl>
            <dt><strong><code>colorN = &lt;rrggbb&gt;|red|blue|...</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(<a href="http://docs.oracle.com/javase/6/docs/api/java/awt/Color.html">Color</a>)</em></strong></dt>
            <dd>The color of plotted data,
               given by name or as a hexadecimal RGB value.
               
               <p>The standard plotting colour names are
                  <code>red</code>, <code>blue</code>, <code>green</code>, <code>grey</code>, <code>magenta</code>, <code>cyan</code>, <code>orange</code>, <code>pink</code>, <code>yellow</code>, <code>black</code>, <code>light_grey</code>, <code>white</code>.
                  However, many other common colour names (too many to list here)
                  are also understood.
                  The list currently contains those colour names understood
                  by most web browsers,
                  from <code>AliceBlue</code> to <code>YellowGreen</code>,
                  listed e.g. in the
                  <em>Extended color keywords</em> section of
                  the <a href="http://www.w3c.org/TR/css3-color#svg-color">CSS3</a> standard.
                  
               </p>
               <p>Alternatively, a six-digit hexadecimal number <em>RRGGBB</em>
                  may be supplied,
                  optionally prefixed by "<code>#</code>" or "<code>0x</code>",
                  giving red, green and blue intensities,
                  e.g.  "<code>ff00ff</code>", "<code>#ff00ff</code>"
                  or "<code>0xff00ff</code>" for magenta.
                  
               </p>
               <p>[Default: <code>red</code>]
               </p>
            </dd>
            <dt><strong><code>combineN = sum|mean|median|min|max|stdev|count|hit</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(<a href="http://andromeda.star.bris.ac.uk/starjavadocs/uk/ac/starlink/ttools/plot2/layer/Combiner.html">Combiner</a>)</em></strong></dt>
            <dd>Defines how values contributing to the same
               pixel are combined together to produce
               the value assigned to that pixel (and hence its colour).
               
               <p>When a weight is in use,
                  <code>mean</code> or
                  <code>sum</code>
                  are typically sensible choices.
                  If there is no weight (a pure density map)
                  then <code>count</code> is usually better,
                  but in that case it may make more sense
                  (it is more efficient)
                  to use one of the other shading modes instead.
                  
               </p>
               <p>The available options are:
                  
                  <ul>
                     <li><code>sum</code>: the sum of all the combined values
                     </li>
                     <li><code>mean</code>: the mean of the combined values
                     </li>
                     <li><code>median</code>: the median of the combined values (may be slow)
                     </li>
                     <li><code>min</code>: the minimum of all the combined values
                     </li>
                     <li><code>max</code>: the maximum of all the combined values
                     </li>
                     <li><code>stdev</code>: the sample standard deviation of the combined values
                     </li>
                     <li><code>count</code>: the number of non-blank values (weight is ignored)
                     </li>
                     <li><code>hit</code>: 1 if any values present, NaN otherwise (weight is ignored)
                     </li>
                  </ul>
                  
               </p>
               <p>[Default: <code>mean</code>]
               </p>
            </dd>
            <dt><strong><code>weightN = &lt;num-expr&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Weight coordinate for weighted density shading.
               <p>This parameter gives a column name, fixed value, or algebraic expression for the
                  <code>weight</code> coordinate
                  for layer <code>N</code>.
                  The value is a numeric algebraic expression based on column names
                  as described in <a href="jel.html">Section 10</a>.
                  
               </p>
            </dd>
         </dl>
         
      </p>
      <hr><a href="paintMode.html">Next</a> <a href="shading-aux.html">Previous</a> <a href="ShapeMode.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="paintMode.html">Output Modes</a><br>
       <b>Up: </b><a href="ShapeMode.html">Shading Modes</a><br>
       <b>Previous: </b><a href="shading-aux.html">aux</a><br>
      
      <hr><i>STILTS - Starlink Tables Infrastructure Library Tool Set<br>Starlink User Note256<br>STILTS web page:
         <a href="http://www.starlink.ac.uk/stilts/">http://www.starlink.ac.uk/stilts/</a><br>Author email:
         <a href="mailto:m.b.taylor@bristol.ac.uk">m.b.taylor@bristol.ac.uk</a><br>Mailing list:
         <a href="mailto:topcat-user@jiscmail.ac.uk">topcat-user@jiscmail.ac.uk</a><br></i></body>
</html>