/usr/share/doc/python-visual/html/graph.html is in python-visual 1:5.12-1.6build1.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><!-- InstanceBegin template="/visual/Templates/template.dwt" codeOutsideHTMLIsLocked="false" -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- InstanceBeginEditable name="doctitle" -->
<title>graph</title>
<!-- InstanceEndEditable -->
<!-- InstanceBeginEditable name="head" -->
<link href="VisualRef.css" rel="stylesheet" type="text/css" />
<!-- InstanceEndEditable -->
<script type="text/javascript">
<!--
function MM_jumpMenu(targ,selObj,restore){ //v3.0
eval(targ+".location='"+selObj.options[selObj.selectedIndex].value+"'");
if (restore) selObj.selectedIndex=0;
}
//-->
</script>
<link href="VisualRef.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table width="800" border="0" cellpadding="0" cellspacing="0">
<!--DWLayoutDefaultTable-->
<tr>
<td width="10" valign="top" bgcolor="#FFFFFF"><!--DWLayoutEmptyCell--> </td>
<td width="10" height="272" valign="top" bgcolor="#DDDDDD"><p> </p> </td>
<td width="173" valign="top" bgcolor="#DDDDDD"><p class="Normal"><a href="index.html">Home</a></p>
<p class="Normal">If you're new to Python <br />
and VPython: <a href="VisualIntro.html">Introduction</a></p>
<p class="Normal">A VPython <a href="VPython_Intro.pdf" target="_blank">tutorial</a></p>
<p class="Normal"><a href="primitives.html">Pictures</a> of 3D objects</p>
<p class="Normal">Choose a 3D object:</p>
<select name="jumpMenu4" id="jumpMenu4" onchange="MM_jumpMenu('parent',this,0)">
<option>Choose an object</option>
<option value="cylinder.html">Overview</option>
<option value="arrow.html">arrow</option>
<option value="box.html">box</option>
<option value="cone.html">cone</option>
<option value="convex.html">convex</option>
<option value="curve.html">curve</option>
<option value="cylinder.html">cylinder</option>
<option value="ellipsoid.html">ellipsoid</option>
<option value="faces.html">faces</option>
<option value="frame.html">frame</option>
<option value="helix.html">helix</option>
<option value="label.html">label</option>
<option value="lights.html">lights</option>
<option value="points.html">points</option>
<option value="pyramid.html">pyramid</option>
<option value="ring.html">ring</option>
<option value="sphere.html">sphere</option>
</select>
<p class="Normal">Work with 3D objects:</p>
<select name="jumpMenu4" id="jumpMenu5" onchange="MM_jumpMenu('parent',this,0)">
<option>Choose an option</option>
<option value="color.html">Color & Opacity</option>
<option value="lights.html">Lighting</option>
<option value="materials.html">Materials & Textures</option>
<option value="defaults.html">Defaults</option>
<option value="rate.html">Animation Speed</option>
<option value="rotation.html">Rotations</option>
<option value="options.html">Additional Options</option>
<option value="delete.html">Delete an Object</option>
<option value="float.html">3/4 = 0?</option>
</select>
<p class="Normal">Windows, Events, & Files:</p>
<select name="jumpMenu4" id="jumpMenu6" onchange="MM_jumpMenu('parent',this,0)">
<option>Choose a topic</option>
<option value="display.html">Windows</option>
<option value="lights.html">Lighting</option>
<option value="mouse.html">Mouse Events</option>
<option value="mouse_click.html"> Mouse Click</option>
<option value="mouse_drag.html"> Mouse Drag</option>
<option value="keyboard.html">Keyboard Events</option>
<option value="controls.html">Buttons and Sliders</option>
<option value="files.html">Reading/Writing Files</option>
</select>
<p class="Normal"><a href="vector.html">Vector operations </a></p>
<p class="Normal"><a href="graph.html">Graphs</a></p>
<p class="Normal"><a href="factorial.html">factorial/combin</a></p>
<p class="Normal">What's new in <a href="new_features.html">Visual 5</a></p>
<p class="Normal"><a href="http://vpython.org" target="_blank">VPython web site</a><br />
<a href="license.txt" target="_blank">Visual license</a><br />
<a href="http://www.python.org" target="_blank">Python web site</a> <br />
<a href="http://www.python.org/doc/2.5.2/lib/module-math.html" target="_blank">Math module</a> (sqrt etc.)<br />
<a href="http://www.scipy.org/Documentation" target="_blank">Numpy module</a> (arrays) </p></td>
<td width="21" valign="top" bgcolor="#FFFFFF"><!--DWLayoutEmptyCell--> </td>
<td width="586" rowspan="2" valign="top"><!-- InstanceBeginEditable name="content" -->
<h1 class="Heading-1"> <font color="#0000A0">Graph Plotting</font></h1>
<p class="Normal"> In this section we describe features for plotting graphs
with tick marks and labels. Here is a simple example of how to plot a graph (arange creates a numeric array running from 0 to 8, stopping short of 8.1):</p>
<p class="program"> from visual.graph import * # import graphing features
<br />
funct1 = gcurve(color=color.cyan) # a graphics curve<br />
for x in arange(0., 8.1, 0.1): # x goes from 0 to 8<br />
funct1.plot(pos=(x,5.*cos(2.*x)*exp(-0.2*x))) # plot</p>
<p class="Normal"> Importing from <span class="attribute">visual.graph</span> makes available all Visual objects plus the graph plotting module. The graph
is autoscaled to display all the data in the window.</p>
<p class="Normal"> A connected curve (<span class="attribute">gcurve</span>)
is just one of several kinds of graph plotting objects. Other options are
disconnected dots (<span class="attribute">gdots</span>),
vertical bars (<span class="attribute">gvbars</span>), horizontal bars (<span class="attribute">ghbars</span>),
and binned data displayed as vertical bars (<span class="attribute">ghistogram</span>;
see later discussion). When creating one of these objects, you can specify
a color attribute. For <span class="attribute">gvbars</span> and <span class="attribute">ghbars</span> you can specify a <span class="attribute">delta</span> attribute, which
specifies the width of the bar (the default is <span class="attribute">delta=1</span>). For <span class="attribute">gdots</span> you can specify a <span class="attribute">shape</span> attribute "round" or "square" (default is <span class="attribute">shape="round"</span>) and a <span class="attribute">size</span> attribute, which
specifies the width of the dot in pixels (default is <span class="attribute">size=5</span>).</p>
<p class="Normal"> You can plot more than one thing on the same graph:</p>
<p class="program"> funct1 = gcurve(color=color.cyan) <br />
funct2 = gvbars(delta=0.05, color=color.blue)<br />
for x in arange(0., 8.1, 0.1): <br />
funct1.plot(pos=(x,5.*cos(2.*x)*exp(-0.2*x))) # curve<br />
funct2.plot(pos=(x,4.*cos(0.5*x)*exp(-0.1*x)))# vbars</p>
<p class="Normal"> In a plot operation you can specify a different color to override the original setting:</p>
<p class="program"> mydots.plot(pos=(x1,y1), color=color.green)
<p class="Normal"> When you create a <span class="attribute">gcurve</span>, <span class="attribute">gdots</span>, <span class="attribute">gvbars</span>,
or <span class="attribute">ghbars</span> object, you can provide a list
of points to be plotted, just as is the case with the ordinary <span class="attribute">curve</span> object:</p>
<p class="program"> values = [(1,2), (3,4), (-5,2), (-5,-3)]<br />
data = gdots(pos=values, color=color.blue)</p>
<p class="Normal">This list option is available only when creating the <span class="attribute">gdots</span> object.</p>
<p class="Normal"><strong><font color="#0000A0">Overall gdisplay options</font></strong></p>
<p class="Normal">You can establish a <span class="attribute">gdisplay</span> to set the size, position, and title for the title bar of the graph window,
specify titles for the x and y axes, and specify maximum values for each
axis, before creating <span class="attribute">gcurve</span> or other kind
of graph plotting object:</p>
<p class="program"> graph1 = gdisplay(x=0, y=0, width=600, height=150, <br />
title='N
vs. t', xtitle='t', ytitle='N', <br />
xmax=50.,
xmin=-20., ymax=5E3, ymin=-2E3, <br />
foreground=color.black,
background=color.white)</p>
<p class="Normal"> In this example, the graph window will be located at (0,0),
with a size of 600 by 150 pixels, and the title bar will say 'N vs. t'.
The graph will have a title 't' on the horizontal axis and 'N' on the vertical
axis. Instead of autoscaling the graph to display all the data, the graph
will have fixed limits. The horizontal axis will extend from -20 to +50,
and the vertical axis will extend from -200. to +5000 (xmin and ymin must
be negative; xmax and ymax must be positive.) The foreground color (white
by default) is black, and the background color (black by default) is white.
If you simply say <span class="attribute">gdisplay()</span>, the defaults
are <span class="attribute">x=0</span>, <span class="attribute">y=0</span>, <span class="attribute">width=800</span>, <span class="attribute">height=400</span>,
no titles, fully autoscaled.</p>
<p class="Normal"> Every gdisplay has the attribute <span class="attribute">display</span>,
so you can place additional labels or manipulate the graphing window.
The only objects that you can place in the graphing window are labels,
curves, faces, and points.</p>
<p class="program">graph1 = gdisplay()<br />
label(display=graph1.display, pos=(3,2), text="P")<br />
graph1.display.visible = 0 # make the display invisible </p>
<p class="Normal">You can have more than one graph window: just create another <span class="attribute"> gdisplay</span>. By default, any graphing objects
created following a <span class="attribute">gdisplay</span> belong to that
window, or you can specify which window a new object belongs to: </p>
<p class="program"> energy = gdots(gdisplay=graph2.display, color=color.blue)</p>
<p class="Normal"><strong><font color="#0000A0">Histograms (sorted, binned data)</font></strong></p>
<p class="Normal">The purpose of <span class="attribute">ghistogram</span> is
to sort data into bins and display the distribution. Suppose you have a list
of the ages of a group of people, such as [5, 37, 12, 21, 8, 63, 52, 75, 7].
You want to sort these data into bins 20 years wide and display the numbers
in each bin in the form of vertical bars. The first bin (0 to 20) contains
4 people [5, 12, 8, 7], the second bin (20 to 40) contains 2 people [21, 37],
the third bin (40 to 60) contains 1 person [52], and the fourth bin (60-80)
contains 2 people [63, 75]. Here is how you could make this display:</p>
<p class="program"> from visual.graph import * <br />
.....<br />
agelist1<em class="code"> = </em>[5, 37, 12, 21, 8, 63, 52, 75, 7] <br />
ages = ghistogram(bins=arange(0, 80, 20), color=color.red) <br />
ages.plot(data=agelist1) # plot the age distribution<br />
.....<br />
ages.plot(data=agelist2) # plot a different distribution</p>
<p class="Normal"> You specify a list (bins) into which data will be sorted.
In the example given here, bins goes from 0 to 80 by 20's. By default, if
you later say</p>
<p class="program"> ages.plot(data=agelist2)</p>
<p class="Normal"> the new distribution replaces the old one. If on the other hand you say</p>
<p class="program"> ages.plot(data=agelist2, accumulate=True)</p>
<p class="Normal"> the new data are added to the old data. </p>
<p class="Normal"> If you say the following, </p>
<p class="program"> ghistogram(bins=arange(0,50,0.1), accumulate=True, <br />
average=True)</p>
<p class="Normal"> each plot operation will accumulate the data and average the
accumulated data. The default is no accumulation and no averaging.</p>
<p class="Normal"><strong><font color="#0000A0">gdisplay vs. display</font></strong></p>
<p class="Normal">A gdisplay window is closely related to a display window. The main difference
is that a gdisplay is essentially two-dimensional and has nonuniform x and
y scale factors. When you create a gdisplay (either explicitly, or implicitly
with the first gcurve or other graphing object), the current display is saved
and restored, so that later creation of ordinary Visual objects such as sphere
or box will correctly be associated with a previous display, not the more
recent gdisplay.</p>
<!-- InstanceEndEditable --></td>
</tr>
<tr>
<td height="16" colspan="4"></td>
</tr>
</table>
</body>
<!-- InstanceEnd --></html>
|