This file is indexed.

/usr/share/doc/stilts/sun256/plot3d-usage.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
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
<html>
   
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <link rel="stylesheet" type="text/css" href="sun-style.css">
      <title>Usage</title>
   </head>
   
   <body>
      <hr>
      <a href="plot3d-examples.html">Next</a> <a href="plot3d.html">Previous</a> <a href="plot3d.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="plot3d-examples.html">Examples</a><br>
       <b>Up: </b><a href="plot3d.html">plot3d: Old-style 3D Scatter Plot</a><br>
       <b>Previous: </b><a href="plot3d.html">plot3d: Old-style 3D Scatter Plot</a><br>
      
      <hr>
      <h3><a name="plot3d-usage">B.13.1 Usage</a></h3>
      <p>The usage of <code>plot3d</code> is
         <pre>
   stilts &lt;stilts-flags&gt; plot3d xpix=&lt;int-value&gt; ypix=&lt;int-value&gt;
                                font=dialog|serif|... fontsize=&lt;int-value&gt;
                                fontstyle=plain|bold|italic|bold-italic
                                legend=true|false title=&lt;value&gt;
                                omode=swing|out|cgi|discard|auto
                                out=&lt;out-file&gt;
                                ofmt=png|png-transp|gif|jpeg|pdf|eps|eps-gzip
                                inN=&lt;table&gt; ifmtN=&lt;in-format&gt;
                                istreamN=true|false cmdN=&lt;cmds&gt; xdataN=&lt;expr&gt;
                                ydataN=&lt;expr&gt; zdataN=&lt;expr&gt; auxdataN=&lt;expr&gt;
                                xlo=&lt;float-value&gt; ylo=&lt;float-value&gt;
                                zlo=&lt;float-value&gt; auxlo=&lt;float-value&gt;
                                xhi=&lt;float-value&gt; yhi=&lt;float-value&gt;
                                zhi=&lt;float-value&gt; auxhi=&lt;float-value&gt;
                                xlog=true|false ylog=true|false
                                zlog=true|false auxlog=true|false
                                xflip=true|false yflip=true|false
                                zflip=true|false auxflip=true|false
                                xlabel=&lt;value&gt; ylabel=&lt;value&gt; zlabel=&lt;value&gt;
                                auxlabel=&lt;value&gt;
                                xerrorN=&lt;expr&gt;|[&lt;lo-expr&gt;],[&lt;hi-expr&gt;]
                                yerrorN=&lt;expr&gt;|[&lt;lo-expr&gt;],[&lt;hi-expr&gt;]
                                zerrorN=&lt;expr&gt;|[&lt;lo-expr&gt;],[&lt;hi-expr&gt;]
                                auxshader=rainbow|pastel|... txtlabelN=&lt;value&gt;
                                subsetNS=&lt;expr&gt; nameNS=&lt;value&gt;
                                colourNS=&lt;rrggbb&gt;|red|blue|...
                                shapeNS=filled_circle|open_circle|...
                                sizeNS=&lt;int-value&gt; transparencyNS=&lt;int-value&gt;
                                lineNS=DotToDot|LinearRegression
                                linewidthNS=&lt;int-value&gt;
                                dashNS=dot|dash|...|&lt;a,b,...&gt;
                                hideNS=true|false
                                errstyleNS=lines|capped_lines|...
                                grid=true|false antialias=true|false
                                sequence=&lt;suffix&gt;,&lt;suffix&gt;,...
                                fog=&lt;float-value&gt; phi=&lt;float-value&gt;
                                theta=&lt;float-value&gt;
</pre>
         If you don't have the <code>stilts</code> script installed,
         write "<code>java -jar stilts.jar</code>" instead of
         "<code>stilts</code>" - see <a href="invoke.html">Section 3</a>.
         The available <code>&lt;stilts-flags&gt;</code> are listed
         in <a href="stilts-flags.html">Section 2.1</a>.
         For programmatic invocation, the Task class for this
         command is <code>uk.ac.starlink.ttools.task.TablePlot3D</code>.
         
      </p>
      <p>Parameter values are assigned on the command line
         as explained in <a href="task-args.html">Section 2.3</a>.
         They are as follows:
         
      </p>
      <p>
         
         <dl>
            <dt><strong><code>antialias = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>Controls whether lines are drawn using antialiasing,
               where applicable.
               If lines are drawn to a bitmapped-type graphics output format
               setting this parameter to true smooths the lines out by
               using gradations of colour for diagonal lines, and setting it
               false simply sets each pixel in the line to on or off.
               For vector-type graphics output formats, or for cases in which
               no diagonal lines are drawn, the setting of this parameter
               has no effect.
               Setting it true may slow the plot down slightly.
               
               <p>[Default: <code>true</code>]
               </p>
            </dd>
            <dt><strong><code>auxdataN = &lt;expr&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Gives a column name or expression for the aux
               axis data for table N.
               The expression is a numeric algebraic expression
               based on column names
               as described in <a href="jel.html">Section 10</a>
               
            </dd>
            <dt><strong><code>auxflip = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>If set true, the scale on the aux axis
               will increase in the opposite sense from usual
               (e.g. right to left rather than left to right).
               
               <p>[Default: <code>false</code>]
               </p>
            </dd>
            <dt><strong><code>auxhi = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>The upper limit for the plotted aux axis.
               If not set, a value will be chosen which is high enough
               to accommodate all the data.
               
            </dd>
            <dt><strong><code>auxlabel = &lt;value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Specifies a label to be used for annotating axis aux.
               A default values based on the plotted data will be used
               if no value is supplied for this parameter.
               
            </dd>
            <dt><strong><code>auxlo = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>The lower limit for the plotted aux axis.
               If not set, a value will be chosen which is low enough
               to accommodate all the data.
               
            </dd>
            <dt><strong><code>auxlog = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>If false (the default), the scale on the aux
               axis is linear; if true it is logarithmic.
               
               <p>[Default: <code>false</code>]
               </p>
            </dd>
            <dt><strong><code>auxshader = rainbow|pastel|...</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(<a href="http://andromeda.star.bris.ac.uk/starjavadocs/uk/ac/starlink/ttools/plot/Shader.html">Shader</a>)</em></strong></dt>
            <dd>Determines how data from auxiliary axes will be displayed.
               Generally this is some kind of colour ramp.
               These are the available <em>colour fixing</em> options:
               
               <ul>
                  <li><code>rainbow</code></li>
                  <li><code>pastel</code></li>
                  <li><code>standard</code></li>
                  <li><code>heat</code></li>
                  <li><code>colour</code></li>
                  <li><code>hue</code></li>
                  <li><code>greyscale</code></li>
                  <li><code>red-blue</code></li>
               </ul>
               
               and these are the available <em>colour modifying</em> options:
               
               <ul>
                  <li><code>hsv_h</code></li>
                  <li><code>hsv_s</code></li>
                  <li><code>hsv_v</code></li>
                  <li><code>intensity</code></li>
                  <li><code>rgb_red</code></li>
                  <li><code>rgb_green</code></li>
                  <li><code>rgb_blue</code></li>
                  <li><code>yuv_y</code></li>
                  <li><code>yuv_u</code></li>
                  <li><code>yuv_v</code></li>
                  <li><code>transparency</code></li>
               </ul>
               
               
               <p>[Default: <code>rainbow</code>]
               </p>
            </dd>
            <dt><strong><code>cmdN = &lt;cmds&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(<a href="http://andromeda.star.bris.ac.uk/starjavadocs/uk/ac/starlink/ttools/filter/ProcessingStep.html">ProcessingStep[]</a>)</em></strong></dt>
            <dd>Specifies processing to be performed on
               the table.
               The value of this parameter is one or more of the filter
               commands described in <a href="filterSteps.html">Section 6.1</a>.
               If more than one is given, they must be separated by
               semicolon characters (";").
               This parameter can be repeated multiple times on the same
               command line to build up a list of processing steps.
               The sequence of commands given in this way
               defines the processing pipeline which is performed on the table.
               
               <p>Commands may alteratively be supplied in an external file,
                  by using the indirection character '@'.
                  Thus a value of "<code>@filename</code>"
                  causes the file <code>filename</code> to be read for a list
                  of filter commands to execute.  The commands in the file
                  may be separated by newline characters and/or semicolons.
                  
               </p>
            </dd>
            <dt><strong><code>colourNS = &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>Defines the colour of markers plotted.
               The value may be a 6-digit hexadecimal number giving
               red, green and blue intensities,
               e.g. "<code>ff00ff</code>" for magenta.
               Alternatively it may be the name of one of the
               pre-defined colours.
               These are currently
               red, blue, green, grey, magenta, cyan, orange, pink, yellow, black and white.
               
               <p>For most purposes, either the American or the British spelling
                  is accepted for this parameter name.
                  
               </p>
            </dd>
            <dt><strong><code>dashNS = dot|dash|...|&lt;a,b,...&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(float[])</em></strong></dt>
            <dd>Defines the dash style for any lines drawn in data set
               NS
               To generate a dashed line the value may be
               one of the named dash types:
               
               <ul>
                  <li><code>dot</code></li>
                  <li><code>dash</code></li>
                  <li><code>longdash</code></li>
                  <li><code>dotdash</code></li>
               </ul>
               
               or may be a comma-separated string of on/off length values such as
               "<code>4,2,8,2</code>".
               A <code>null</code> value indicates a solid line.
               
               <p>Only has an effect if the
                  <code>lineNS</code>
                  parameter is set to draw lines.
                  
               </p>
            </dd>
            <dt><strong><code>errstyleNS = lines|capped_lines|...</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(<a href="http://andromeda.star.bris.ac.uk/starjavadocs/uk/ac/starlink/ttools/plot/ErrorRenderer.html">ErrorRenderer</a>)</em></strong></dt>
            <dd>Defines the way in which error bars (or ellipses, or...)
               will be represented for data set NS
               if errors are being displayed.
               The following options are available:
               
               <ul>
                  <li><code>none</code></li>
                  <li><code>lines</code></li>
                  <li><code>capped_lines</code></li>
                  <li><code>caps</code></li>
                  <li><code>arrows</code></li>
                  <li><code>cuboid</code></li>
                  <li><code>ellipse</code></li>
                  <li><code>crosshair_ellipse</code></li>
                  <li><code>rectangle</code></li>
                  <li><code>crosshair_rectangle</code></li>
                  <li><code>filled_ellipse</code></li>
                  <li><code>filled_rectangle</code></li>
               </ul>
               
               
               <p>[Default: <code>lines</code>]
               </p>
            </dd>
            <dt><strong><code>fog = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>Sets the level of fogging used to provide a visual
               indication of depth.
               Object plotted further away from the viewer appear more
               washed-out by a white fog.
               The default value gives a bit of fogging; increase it to
               make the fog thicker, or set to zero if no fogging is required.
               
               <p>[Default: <code>1.0</code>]
               </p>
            </dd>
            <dt><strong><code>font = dialog|serif|...</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Determines the font that will be used for textual annotation
               of the plot, including axes etc.
               At least the following fonts will be available:
               
               <ul>
                  <li><code>serif</code></li>
                  <li><code>sansserif</code></li>
                  <li><code>monospaced</code></li>
                  <li><code>dialog</code></li>
                  <li><code>dialoginput</code></li>
               </ul>
               as well as a range of system-dependent fonts,
               possibly including
               
               <ul>
                  <li><code>dejavu_sans</code></li>
                  <li><code>dejavu_sans_mono</code></li>
                  <li><code>dejavu_serif</code></li>
               </ul>
               
               <p>[Default: <code>dialog</code>]
               </p>
            </dd>
            <dt><strong><code>fontsize = &lt;int-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Integer)</em></strong></dt>
            <dd>Sets the font size used for plot annotations.
               
               <p>[Default: <code>12</code>]
               </p>
            </dd>
            <dt><strong><code>fontstyle = plain|bold|italic|bold-italic</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Integer)</em></strong></dt>
            <dd>Gives a style in which the font is to be applied for
               plot annotations.
               Options are
               <code>plain</code>,
               <code>bold</code>,
               <code>italic</code> and
               <code>bold-italic</code>.
               
               <p>[Default: <code>plain</code>]
               </p>
            </dd>
            <dt><strong><code>grid = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>If true, grid lines are drawn on the plot.
               If false, they are absent.
               
               <p>[Default: <code>true</code>]
               </p>
            </dd>
            <dt><strong><code>hideNS = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>Indicates whether the actual markers plotted for each point
               should be hidden.
               Normally this is false, but you may want to set it to true
               if the point positions are being revealed in some other way,
               for instance by error markers or lines drawn between them.
               
               <p>[Default: <code>false</code>]
               </p>
            </dd>
            <dt><strong><code>ifmtN = &lt;in-format&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Specifies the format of the input table as specified by parameter <code>inN</code>.
               The known formats are listed in <a href="inFormats.html">Section 5.2.1</a>.
               This flag can be used if you know what format your
               table is in.
               If it has the special value
               <code>(auto)</code> (the default),
               then an attempt will be
               made to detect the format of the table automatically.
               This cannot always be done correctly however, in which case
               the program will exit with an error explaining which
               formats were attempted.
               
               <p>[Default: <code>(auto)</code>]
               </p>
            </dd>
            <dt><strong><code>inN = &lt;table&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(<a href="http://www.starlink.ac.uk/stil/javadocs/uk/ac/starlink/table/StarTable.html">StarTable</a>)</em></strong></dt>
            <dd>The location of the input table.
               This may take one of the following forms:
               
               <ul>
                  <li>A filename.</li>
                  <li>A URL.</li>
                  <li>The special value "<code>-</code>",
                     meaning standard input.
                     In this case the input format must be given explicitly
                     using the <code>ifmtN</code>
                     parameter.
                     Note that not all formats can be streamed in this way.
                  </li>
                  <li>A system command line with
                     either a "<code>&lt;</code>" character at the start,
                     or a "<code>|</code>" character at the end
                     ("<code>&lt;syscmd</code>" or
                     "<code>syscmd|</code>").
                     This executes the given pipeline and reads from its
                     standard output.
                     This will probably only work on unix-like systems.
                  </li>
               </ul>
               
               In any case, compressed data in one of the supported compression
               formats (gzip, Unix compress or bzip2) will be decompressed
               transparently.
               
            </dd>
            <dt><strong><code>istreamN = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>If set true, the input table
               specified by the <code>inN</code> parameter
               will be read as a stream.
               It is necessary to give the 
               <code>ifmtN</code> parameter
               in this case.
               Depending on the required operations and processing mode,
               this may cause the read to fail (sometimes it is necessary
               to read the table more than once).
               It is not normally necessary to set this flag;
               in most cases the data will be streamed automatically
               if that is the best thing to do.
               However it can sometimes result in less resource usage when
               processing large files in certain formats (such as VOTable).
               
               <p>[Default: <code>false</code>]
               </p>
            </dd>
            <dt><strong><code>legend = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>Determines whether a legend showing which plotting style is
               used for each data set.
               Defaults to true if there is more than one set, false otherwise.
               
            </dd>
            <dt><strong><code>lineNS = DotToDot|LinearRegression</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(<a href="http://andromeda.star.bris.ac.uk/starjavadocs/uk/ac/starlink/ttools/plot/MarkStyle.Line.html">Line</a>)</em></strong></dt>
            <dd>Determines what line if any will be plotted along with the
               data points.
               The options are:
               
               <ul>
                  <li><code>null</code>:
                     No line is plotted.
                  </li>
                  <li><code>DotToDot</code>:
                     Each point is joined to the next one in sequence
                     by a straight line.
                  </li>
                  <li><code>LinearRegression</code>:
                     A linear regression line is plotted based on all the points
                     which are visible in the plot.
                     Note that the regression coefficients take no account of
                     points out of the visible range.
                  </li>
               </ul>
               
            </dd>
            <dt><strong><code>linewidthNS = &lt;int-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Integer)</em></strong></dt>
            <dd>Sets the line width in pixels for any lines drawn in data set
               NS.
               
               <p>Only has an effect if the
                  <code>lineNS</code>
                  parameter is set to draw lines.
                  
               </p>
               <p>[Default: <code>1</code>]
               </p>
            </dd>
            <dt><strong><code>nameNS = &lt;value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Provides a name to use for a subset with the symbolic label
               NS.
               This name will be used for display in the legend,
               if one is displayed.
               
            </dd>
            <dt><strong><code>ofmt = png|png-transp|gif|jpeg|pdf|eps|eps-gzip</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(<a href="http://andromeda.star.bris.ac.uk/starjavadocs/uk/ac/starlink/ttools/plot/GraphicExporter.html">GraphicExporter</a>)</em></strong></dt>
            <dd>Graphics format in which the plot is written to
               the output file, see <a href="graphicExporter.html">Section 8.6</a>.
               One of:
               
               <ul>
                  <li><code>png</code>: PNG
                  </li>
                  <li><code>png-transp</code>: PNG with transparent background
                  </li>
                  <li><code>gif</code>: GIF
                  </li>
                  <li><code>jpeg</code>: JPEG
                  </li>
                  <li><code>pdf</code>: Portable Document Format
                  </li>
                  <li><code>eps</code>: Encapsulated PostScript
                  </li>
                  <li><code>eps-gzip</code>: Gzipped Encapsulated PostScript
                  </li>
               </ul>
               May default to a sensible value depending on the
               filename given by <code>out</code>.
               
            </dd>
            <dt><strong><code>omode = swing|out|cgi|discard|auto</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(<a href="http://andromeda.star.bris.ac.uk/starjavadocs/uk/ac/starlink/ttools/plottask/PaintMode.html">PaintMode</a>)</em></strong></dt>
            <dd>Determines how the drawn plot will be output, see <a href="paintMode.html">Section 8.5</a>.
               
               <ul>
                  <li><code><a href="paintmode-swing.html">swing</a></code>:
                     Plot will be displayed in a window on the screen.
                     This plot is "live"; it can be resized and (except for old-style plots)
                     navigated around with mouse actions in the same way as plots in TOPCAT.
                  </li>
                  <li><code><a href="paintmode-out.html">out</a></code>:
                     Plot will be written to a file given by <code>out</code> using the graphics format given by <code><a href="graphicExporter.html">ofmt</a></code>.
                  </li>
                  <li><code><a href="paintmode-cgi.html">cgi</a></code>:
                     Plot will be written in a way suitable for CGI use direct from a web server.
                     The output is in the graphics format given by <code><a href="graphicExporter.html">ofmt</a></code>,
                     preceded by a suitable "Content-type" declaration.
                  </li>
                  <li><code><a href="paintmode-discard.html">discard</a></code>:
                     Plot is drawn, but discarded.  There is no output.
                  </li>
                  <li><code><a href="paintmode-auto.html">auto</a></code>:
                     Behaves as <code><a href="paintmode-swing.html">swing</a></code> or <code><a href="paintmode-out.html">out</a></code>  mode depending on presence of <code>out</code> parameter
                  </li>
               </ul>
               
               <p>[Default: <code>auto</code>]
               </p>
            </dd>
            <dt><strong><code>out = &lt;out-file&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(uk.ac.starlink.util.Destination)</em></strong></dt>
            <dd>The location of the output file.  This is usually a filename
               to write to.
               If it is equal to the special value "-"
               the output will be written to standard output.
               
            </dd>
            <dt><strong><code>phi = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>Angle in degrees through which the 3D plot is rotated
               abound the Z axis prior to drawing.
               
               <p>[Default: <code>30.0</code>]
               </p>
            </dd>
            <dt><strong><code>sequence = &lt;suffix&gt;,&lt;suffix&gt;,...</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String[])</em></strong></dt>
            <dd>Can be used to control the sequence in which different
               datasets and subsets are plotted.
               This will affect which symbols are plotted on top of,
               and so potentially obscure,
               which other ones.
               The value of this parameter is a comma-separated list of the
               "<code>NS</code>"
               suffixes which appear on the
               parameters which apply to subsets.
               The sets which are named
               will be plotted in order, so the first-named one will be
               at the bottom (most likely to be obscured).
               Note that if this parameter is supplied, then only those sets
               which are named will be plotted,
               so this parameter may also be used to restrict which plots appear
               (though it may not be the most efficient way of doing this).
               If no explicit value is supplied for this parameter,
               sets will be plotted in some sequence decided by STILTS
               (probably alphabetic by suffix).
               
            </dd>
            <dt><strong><code>shapeNS = filled_circle|open_circle|...</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(<a href="http://andromeda.star.bris.ac.uk/starjavadocs/uk/ac/starlink/ttools/plot/MarkShape.html">MarkShape</a>)</em></strong></dt>
            <dd>Defines the shapes for the markers that are plotted in
               data set NS.
               The following shapes are available:
               
               <ul>
                  <li><code>filled_circle</code></li>
                  <li><code>open_circle</code></li>
                  <li><code>cross</code></li>
                  <li><code>x</code></li>
                  <li><code>open_square</code></li>
                  <li><code>open_diamond</code></li>
                  <li><code>open_triangle_up</code></li>
                  <li><code>open_triangle_down</code></li>
                  <li><code>filled_square</code></li>
                  <li><code>filled_diamond</code></li>
                  <li><code>filled_triangle_up</code></li>
                  <li><code>filled_triangle_down</code></li>
               </ul>
               
               
            </dd>
            <dt><strong><code>sizeNS = &lt;int-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Integer)</em></strong></dt>
            <dd>Defines the marker size in pixels for markers plotted in
               data set NS.
               If the value is negative, an attempt will be made to use a
               suitable size according to how many points there are to be
               plotted.
               
               <p>[Default: <code>-1</code>]
               </p>
            </dd>
            <dt><strong><code>subsetNS = &lt;expr&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Gives the selection criterion for the subset labelled
               "<code>NS</code>".
               This is a boolean expression which may be the name of
               a boolean-valued column or any other boolean-valued expression.
               Rows for which the expression evaluates true will be included
               in the subset, and those for which it evaluates false will not.
               
            </dd>
            <dt><strong><code>theta = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>Angle in degrees through which the 3D plot is rotated
               towards the viewer
               (i.e. about the horizontal axis of the viewing plane)
               prior to drawing.
               
               <p>[Default: <code>15.0</code>]
               </p>
            </dd>
            <dt><strong><code>title = &lt;value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>A one-line title to display at the top of the plot.
               
            </dd>
            <dt><strong><code>transparencyNS = &lt;int-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Integer)</em></strong></dt>
            <dd>Determines the transparency of plotted markers
               for data set NS.
               A value of <code>&lt;n&gt;</code> means that opacity is only
               achieved (the background is only blotted out)
               when <code>&lt;n&gt;</code> pixels of this colour have been
               plotted on top of each other.
               
               <p>The minimum value is 1, which means opaque markers.
                  
               </p>
            </dd>
            <dt><strong><code>txtlabelN = &lt;value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Gives an expression which will label each plotted point.
               If given, the text (or number) resulting from evaluating
               the expression will be written near each point which is
               plotted.
               
            </dd>
            <dt><strong><code>xdataN = &lt;expr&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Gives a column name or expression for the x
               axis data for table N.
               The expression is a numeric algebraic expression
               based on column names
               as described in <a href="jel.html">Section 10</a>
               
            </dd>
            <dt><strong><code>xerrorN = &lt;expr&gt;|[&lt;lo-expr&gt;],[&lt;hi-expr&gt;]</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Gives expressions for the errors on X
               coordinates for table N.
               The following forms are permitted:
               
               <ul>
                  <li><code>&lt;expr&gt;</code>: symmetric error value
                  </li>
                  <li><code>&lt;lo-expr&gt;,&lt;hi-expr&gt;</code>:distinct lower and upper error values
                  </li>
                  <li><code>&lt;lo-expr&gt;,</code>: lower error value only
                  </li>
                  <li><code>,&lt;hi-expr&gt;</code>: upper error value only
                  </li>
                  <li><code>null</code>: no errors
                  </li>
               </ul>
               The expression in each case is a numeric algebraic expression
               based on column names
               as described in <a href="jel.html">Section 10</a>.
               
            </dd>
            <dt><strong><code>xflip = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>If set true, the scale on the x axis
               will increase in the opposite sense from usual
               (e.g. right to left rather than left to right).
               
               <p>[Default: <code>false</code>]
               </p>
            </dd>
            <dt><strong><code>xhi = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>The upper limit for the plotted x axis.
               If not set, a value will be chosen which is high enough
               to accommodate all the data.
               
            </dd>
            <dt><strong><code>xlabel = &lt;value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Specifies a label to be used for annotating axis x.
               A default values based on the plotted data will be used
               if no value is supplied for this parameter.
               
            </dd>
            <dt><strong><code>xlo = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>The lower limit for the plotted x axis.
               If not set, a value will be chosen which is low enough
               to accommodate all the data.
               
            </dd>
            <dt><strong><code>xlog = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>If false (the default), the scale on the x
               axis is linear; if true it is logarithmic.
               
               <p>[Default: <code>false</code>]
               </p>
            </dd>
            <dt><strong><code>xpix = &lt;int-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Integer)</em></strong></dt>
            <dd>The width of the output graphic in pixels.
               
               <p>[Default: <code>300</code>]
               </p>
            </dd>
            <dt><strong><code>ydataN = &lt;expr&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Gives a column name or expression for the y
               axis data for table N.
               The expression is a numeric algebraic expression
               based on column names
               as described in <a href="jel.html">Section 10</a>
               
            </dd>
            <dt><strong><code>yerrorN = &lt;expr&gt;|[&lt;lo-expr&gt;],[&lt;hi-expr&gt;]</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Gives expressions for the errors on Y
               coordinates for table N.
               The following forms are permitted:
               
               <ul>
                  <li><code>&lt;expr&gt;</code>: symmetric error value
                  </li>
                  <li><code>&lt;lo-expr&gt;,&lt;hi-expr&gt;</code>:distinct lower and upper error values
                  </li>
                  <li><code>&lt;lo-expr&gt;,</code>: lower error value only
                  </li>
                  <li><code>,&lt;hi-expr&gt;</code>: upper error value only
                  </li>
                  <li><code>null</code>: no errors
                  </li>
               </ul>
               The expression in each case is a numeric algebraic expression
               based on column names
               as described in <a href="jel.html">Section 10</a>.
               
            </dd>
            <dt><strong><code>yflip = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>If set true, the scale on the y axis
               will increase in the opposite sense from usual
               (e.g. right to left rather than left to right).
               
               <p>[Default: <code>false</code>]
               </p>
            </dd>
            <dt><strong><code>yhi = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>The upper limit for the plotted y axis.
               If not set, a value will be chosen which is high enough
               to accommodate all the data.
               
            </dd>
            <dt><strong><code>ylabel = &lt;value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Specifies a label to be used for annotating axis y.
               A default values based on the plotted data will be used
               if no value is supplied for this parameter.
               
            </dd>
            <dt><strong><code>ylo = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>The lower limit for the plotted y axis.
               If not set, a value will be chosen which is low enough
               to accommodate all the data.
               
            </dd>
            <dt><strong><code>ylog = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>If false (the default), the scale on the y
               axis is linear; if true it is logarithmic.
               
               <p>[Default: <code>false</code>]
               </p>
            </dd>
            <dt><strong><code>ypix = &lt;int-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Integer)</em></strong></dt>
            <dd>The height of the output graphic in pixels.
               
               <p>[Default: <code>300</code>]
               </p>
            </dd>
            <dt><strong><code>zdataN = &lt;expr&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Gives a column name or expression for the z
               axis data for table N.
               The expression is a numeric algebraic expression
               based on column names
               as described in <a href="jel.html">Section 10</a>
               
            </dd>
            <dt><strong><code>zerrorN = &lt;expr&gt;|[&lt;lo-expr&gt;],[&lt;hi-expr&gt;]</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Gives expressions for the errors on Z
               coordinates for table N.
               The following forms are permitted:
               
               <ul>
                  <li><code>&lt;expr&gt;</code>: symmetric error value
                  </li>
                  <li><code>&lt;lo-expr&gt;,&lt;hi-expr&gt;</code>:distinct lower and upper error values
                  </li>
                  <li><code>&lt;lo-expr&gt;,</code>: lower error value only
                  </li>
                  <li><code>,&lt;hi-expr&gt;</code>: upper error value only
                  </li>
                  <li><code>null</code>: no errors
                  </li>
               </ul>
               The expression in each case is a numeric algebraic expression
               based on column names
               as described in <a href="jel.html">Section 10</a>.
               
            </dd>
            <dt><strong><code>zflip = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>If set true, the scale on the z axis
               will increase in the opposite sense from usual
               (e.g. right to left rather than left to right).
               
               <p>[Default: <code>false</code>]
               </p>
            </dd>
            <dt><strong><code>zhi = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>The upper limit for the plotted z axis.
               If not set, a value will be chosen which is high enough
               to accommodate all the data.
               
            </dd>
            <dt><strong><code>zlabel = &lt;value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(String)</em></strong></dt>
            <dd>Specifies a label to be used for annotating axis z.
               A default values based on the plotted data will be used
               if no value is supplied for this parameter.
               
            </dd>
            <dt><strong><code>zlo = &lt;float-value&gt;</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Double)</em></strong></dt>
            <dd>The lower limit for the plotted z axis.
               If not set, a value will be chosen which is low enough
               to accommodate all the data.
               
            </dd>
            <dt><strong><code>zlog = true|false</code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<em>(Boolean)</em></strong></dt>
            <dd>If false (the default), the scale on the z
               axis is linear; if true it is logarithmic.
               
               <p>[Default: <code>false</code>]
               </p>
            </dd>
         </dl>
         
      </p>
      <hr><a href="plot3d-examples.html">Next</a> <a href="plot3d.html">Previous</a> <a href="plot3d.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="plot3d-examples.html">Examples</a><br>
       <b>Up: </b><a href="plot3d.html">plot3d: Old-style 3D Scatter Plot</a><br>
       <b>Previous: </b><a href="plot3d.html">plot3d: Old-style 3D Scatter Plot</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>