This file is indexed.

/usr/share/doc/stilts/sun256/plot2plane-examples.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
<html>
   
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <link rel="stylesheet" type="text/css" href="sun-style.css">
      <title>Examples</title>
   </head>
   
   <body>
      <hr>
      <a href="plot2sky.html">Next</a> <a href="plot2plane-usage.html">Previous</a> <a href="plot2plane.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="plot2sky.html">plot2sky: Draws a sky plot</a><br>
       <b>Up: </b><a href="plot2plane.html">plot2plane: Draws a plane plot</a><br>
       <b>Previous: </b><a href="plot2plane-usage.html">Usage</a><br>
      
      <hr>
      <h3><a name="plot2plane-examples">B.7.2 Examples</a></h3>
      <p>Here are some examples of <code>plot2plane</code>:
         
         <dl>
            <dt><strong><pre>
stilts plot2plane yflip=true layer_1=mark in_1=cat.fits x_1=BMAG-RMAG y_1=BMAG 
</pre></strong></dt>
            <dd>This is a colour-magnitude diagram where the input table
               has columns named RMAG and BMAG.
               The Y axis is inverted so that the magnitude values increase
               downwards not up.
               The plot is displayed in a window on the screen, and may be
               panned and zoomed with the mouse.
               
            </dd>
            <dt><strong><pre>
stilts plot2plane layer=histogram in=hip_main.fits x=plx xlog=true
                  xlabel=Parallax ylabel=
</pre></strong></dt>
            <dd>Plots a histogram of parallaxes for Hipparcos data,
               with a logarithmic X axis.  The axes are labelled explicitly,
               with an empty string in the case of the Y axis.
               
            </dd>
            <dt><strong><pre>
stilts plot2plane xpix=600 ypix=500
                  in=gavo_g2.fits x=X y=Y
                  shading=aux aux='atan2(vely,velx)' auxmap=hue auxvisible=false
                  layer_m=mark shape_m=cross size_m=4
                  layer_v=xyvector xdelta_v=velx ydelta_v=vely scale_v=2
                  out=velocities.pdf
</pre></strong></dt>
            <dd>Two layers are plotted, point markers representing position
               (4 pixels radius, shaped like crosses)
               and vectors representing velocity.
               Both markers and vectors are coloured according to the direction
               (arctan(vely/velx)) of the arrows,
               so it's easy to see points moving in similar directions;
               the "hue" colour map is good for this, since it's periodic,
               so values of +Pi and -Pi have the same colour.
               Since it's not very revealing in this case, display of the aux
               axis colour ramp beside the plot has been turned off.
               Since the X and Y coordinates and the colouring is common to both
               layers, the relevant parameters can given without suffixes to avoid
               having to repeat them.
               Output is to a PDF file.
               
            </dd>
            <dt><strong><pre>
stilts plot2plane xmin=0 xmax=6.283 ymin=-1 ymax=1 xlabel=Time
                  layer=function axis=horizontal xname=time fexpr='sin(time)'
                  dash=3,2 thick=4 color=ee6aa7
</pre></strong></dt>
            <dd>Plots a sine curve to the screen.  Initially the view is of one
               period, but you can pan and zoom interactively to see any range.
               The line is plotted in hot pink, four pixels wide, with a custom dash
               pattern.
               Since the <a href="layer-function.html">function</a> layer type has no
               data coordinates, no input table is required.
               The layer suffix here is the empty string; since there's only one
               layer, it doesn't cause any problems.
               
            </dd>
            <dt><strong><pre>
stilts plot2plane ylog=true xflip=true xmin=-5.2 xmax=3.8 ymin=250 ymax=3.5e5
           in1=6dfgs_E7.fits x1=bmag-rmag y1=vel
           layer1a=mark color1a=cyan
           layer1b=contour color1b=yellow smooth1b=9 scaling1b=log
           layer1c=mark icmd1c='every 35;select star'
                        shape1c=filled_triangle_down size1c=5 color1c=red
                        shading1c=transparent opaque1c=3
           layer2=function fexpr2='exp(x*2+12)' color2=black antialias2=true
                           dash2=dash thick2=3
           leglabel1a=Population leglabel1c=Sample legpos=.95,.95 legseq=1a,1c
           fontsize=16 texttype=latex ylabel="v\,/\,km.s^{-1}" xlabel=colour
</pre></strong></dt>
            <dd>There are four layers: 1a, 1b and 1c use the same positional data
               from the same input file, so the positional coordinates common to them
               are given the suffix "1".
               Layer "2" is unrelated, and has no input data, since it's just an
               analytic function.
               The legend is positioned to taste, and its content
               is manipulated so that only datasets 1a and 1c are described,
               and they are given custom names (the default would be their suffix names).
               
            </dd>
         </dl>
         
      </p>
      <hr><a href="plot2sky.html">Next</a> <a href="plot2plane-usage.html">Previous</a> <a href="plot2plane.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="plot2sky.html">plot2sky: Draws a sky plot</a><br>
       <b>Up: </b><a href="plot2plane.html">plot2plane: Draws a plane plot</a><br>
       <b>Previous: </b><a href="plot2plane-usage.html">Usage</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>