/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=<num-expr> colorN=<rrggbb>|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 = <rrggbb>|red|blue|...</code> <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> <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 = <num-expr></code> <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>
|