This file is indexed.

/usr/share/doc/dpuser-doc/plotting.html is in dpuser-doc 3.3+p1+dfsg-2build1.

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
<html>
<head>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <meta name="Author" content="Thomas Ott">
   <title>DPUSER - The Next Generation: Plotting</title>
 <style type="text/css" title="currentStyle">
  @import "dpuser.css";
 </style>
<link rel="shortcut icon" href="dpuser.ico" type="image/xicon">
</head>
<body>

<div id="header">DPUSER - The Next Generation</div>
<div id="menu">
<ul>
<li><a href="index.html">Introduction</a></li>
<li><a href="history.html">History</a></li>
<li><a href="syntax.html">Syntax</a></li>
<li><a href="operators.html">Operators</a></li>
<li><a href="ifandloop.html">Structural commands</a></li>
<li><a href="variables.html">Data types</a></li>
<li><a class="current" href="plotting.html">Graphics</a></li>
<li><a href="fitsfiles.html">Fits files</a></li>
<li><a href="category.html">Category index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="procedures.html">Procedure index</a></li>
<li><a href="pgplot.html">Pgplot index</a></li>
<li><a href="examples.html">Examples</a></li>
<hr>
<li><a href="qfitsview.html">QFitsView documentation</a></li>
<hr>
</ul>
<form method="GET" action="search.html">
<input type="text" size=15 name="keywords">
<input type="submit" value="Search">
</form>
</div>
<div id="content">
<h1>Plotting</h1>
<p>DPUSER incorporates the complete <a href="http://astro.caltech.edu/~tjp/pgplot/" target="_top">PGPLOT</a>
package. All modules of this package are realized as procedures (<a href="pgplot.html">see
list of available PGPLOT procedures</a>). The PGPLOT documentation provided
here is a verbatim copy of the online documentation of PGPLOT.
<br>DPUSER uses a global variable
<tt>plotdevice</tt> to control graphics
output. Available devices depend on your installation of PGPLOT. The default
graphics device on UNIX workstations is <tt>"/xserve"</tt>. This can be
changed by assigning a new string value to the variable. A typical use
of PGPLOT looks like this:
<blockquote><tt>plotdevice = "/tmp/test.eps/ps"&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// Write ps output to /tmp/test.eps</tt>
<br><tt>x = [-3600:3600]/10&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// create x-axes</tt>
<br><tt>y = sin(x, /deg)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// create sine function (y-axes)</tt>
<br><tt>pgopen plotdevice&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// Start plotting</tt>
<br><tt>pgenv -360, 360, -1, 1, 0, 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// draw labeled frame</tt>
<br><tt>pglab "angle", "sine", "test plot"&nbsp;&nbsp; // annotate plot</tt>
<br><tt>pgline 7201, x, y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// draw the sine function</tt>
<br><tt>pgend&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// end plotting</tt>
<br><tt>plotdevice = "/xserve"&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// reset graph output to X</tt></blockquote>
Since plotting a x-y graph is, amongs others, a very common task, DPUSER
provides several convenience procedures to do things like this: <a href="procedure_plot.html">plot</a>,
<a href="procedure_contour.html">contour</a>,
<a href="procedure_surface.html">surface</a>,
and <a href="procedure_shade.html">shade</a>. The above example using
the plot command looks like this:
<blockquote><tt>plotdevice = "/tmp/test.eps/ps"&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// Write ps output to /tmp/test.eps</tt>
<br><tt>x = [-3600:3600]/10&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// create x-axes</tt>
<br><tt>y = sin(x, /deg)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// create sine function (y-axes)</tt>
<br><tt>plot x, y, xtitle="angle", ytitle="sine", title="test plot"</tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// do the plot</tt>
<br><tt>plotdevice = "/xserve"&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
// reset graph output to X</tt></blockquote>
This can be done even shorter:
<blockquote><tt>plot sin([-3600:3600]/10)</tt></blockquote>
will plot a sine function without any annotation to the current plot device,
overriding any previous plot. A very simple contour plot can also be done:
<blockquote><tt>contour gauss(129,129,30,50,30), [1:9]*10</tt></blockquote>
will do a contour plot of an elliptical gaussian with contour levels 10%,
20%, ..., 90%.

</div>
<div id="copyright">
Copyright &copy; Thomas Ott ---- DPUSER - The Next Generation 3.3 (Rev. )
</div>
</body>
</html>