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
|
<html>
<!-- help.html Generated from make and source help.html.in !-->
<head>
<title>Quickplot Help</title>
<link rel="shortcut icon" href="/favicon.ico" type="image/x-icon" />
</head>
<body>
<center>
<h1>Quickplot Help</h1>
</center>
Quickplot can load data from GUIs (graphical user interfaces), the
command line, or by reading the data from standard input. Data
is loaded into fields. A field represents a series of numbers,
like for example the values for one variable. Any two fields may be
plotted against each other.
<br><br>
<h3>Zooming</h3>
<blockquote>
<li><b>Zooming In</b> Put the pointer (mouse) on a corner
of plot region you want to zoom to. Press the right mouse button
and hold and drag the zoom box. Release the right mouse button
then it is at another corner of the zoom region. Now Quickplot
will zoom into that zoom region.
<p> You can zoom in as many times as you like, or calculations will
permit. In all cases we've seen round off problems don't happen
until you are looking past at one data point in the plot window.
Quickplot will print a warning message to standard output if this
happens. This happens when you zoom in so far as to make it so
that the pixel distance between two adjacent points is about 10 <sup>
9 </sup> pixels. Quickplot culls out points that are not
adjacent to the plot window or in the plot window. Quickplot
linearly interpolates lines to points adjacent to points in the plot
window or on other sides of the plot window. <li><b>Zooming Out</b>
Put the pointer (mouse) in the plot window. Press
the right mouse button and hold and drag the zoom box. Release
the right mouse button then it (the zoom box) is past one edge of the
plot window. Now Quickplot will zoom out to the previous zoom
level.</p>
<p> Or to zoom out to a full view (top zoom level) of the plot: Put
the pointer (mouse) in the plot window. Press the right mouse
button and hold and drag the zoom box. Release the right mouse
button then the zoom box is past two edges (a corner) of the plot
window. Now Quickplot will zoom out to the top zoom level (no
zoom).</p>
</blockquote>
<br>
<h3>Graph Value Picking</h3>
<blockquote>
The left mouse button is used for picking and displaying
X and Y values from the graph. Just try it and see.
<p> There are three modes of number display value picking, which may
be selected on the Plot List pop-up window:
<ul>
<li><b>Pick Pointer Values</b> shows values where the mouse
pointer is in the scale of the respective plot</li>
<li><b>Interpolate Plot Values</b> shows values where the
X position of the mouse pointer is with the Y value displayed being a
linearly interpolated value</li>
<li><b>Pick Plot Point Values</b> shows X and Y plot point
positions that are closest to mouse pointer X position.</li>
</ul>
</p>
</blockquote>
<br>
<h3>Loadable File Formats</h3>
<ul>
<li><b>ASCII text</b> Quickplot can load ASCII text (plan
text) files. The number of fields (numbers) on each line must be
the same. Any number of non-number characters other than a new
line character may used to separate numbers on a given line. The
characters in numbers can only be the following 15 characters
".+-eE0123456789".
Example:
<blockquote>
<pre>
-1 -1.3 -1
0 1.1e-2 0
2 1.2E-2 1
30 1.3e+2 3
</pre>
</blockquote>
The above example has three fields and four values for each
field. A file may have any counting number of fields, that's
1,2,3,4 or more fields. If a file is loaded with a single field
an additional field, with the same number of values as the field in
the file, will be added before the field from the file.
Quickplot can read ASCII text files from standard input.
<p>
<li><b><a href="http://www.mega-nerd.com/libsndfile/">libsndfile</a>
sound file</b> Using the package libsndfile Quickplot can
read many sound file formats. An incomplete list of readable
sound file formats includes: Microsoft WAV, SGI/Apple AIFF/AIFC, and
Sun/DEC/NeXT AU/SND.. See the <a
href="http://www.mega-nerd.com/libsndfile/">libsndfile home-page</a>
for a full list of supported sound file formats.
<p>
When loading a sound file the first field (sequence) loaded will be
the time sequence, then each sound channel will follow in separate
fields.
Quickplot may be a little slow with sound files larger than thirty
seconds long. Thirty seconds of sound sampled at 44KHZ with one
channel would load 1.32 million data points. Quickplot cannot
read sound files from standard input. </ul>
<br>
<h3>Quickly looking at a hundred thousand, a million, or more data points?</h3>
<blockquote>
If you need to look at large files quickly, try running Quickplot
including the two options '--no-lines' and '--point-size=0' in the
command line. This will make the plot drawing and redrawing as
fast as it can be at the expense of having points that are just one
pixel in size, which should be no problem if you have that many
points. Once you zoom to a picture that you like you can
increase the point size or add lines, using the GUI (graphical user
interface), if you need to. Quickplot loads the entire file into
memory for any file loaded, so you may need to be careful of your
memory usage when working with large files.
<p> By default plots created in Quickplot with 1,000,000 or more
points will by drawn without lines and points of size one pixel,
unless the user has included one or more of the following options in
the command line: --no-lines, --no-points, --line-width, or
--point-size. For plots with less than 1,000,000 points the
default line width is 3 pixels and the default point size is 5 pixels.
</p>
<p> On a 2.4 Gig Hz Pentium 4 (with <a
href="http://www.gentoo.org/">Gentoo GNU/Linux</a>) with 256 Megabytes
of RAM it has been observed to take 8 seconds to load and display an
ASCII text file with 1 million data points; after startup it was
observed to take about one second to redraw with the one million
points in view. When repeating this with lines of width 3 pixels
and points of size 5 pixels the loading time is about the same and the
drawing time increases by about 3 seconds. Drawing time didn't
seem to vary with window size.</p>
</blockquote>
<br>
<h3>Command Line Options</h3>
<b>Usage: quickplot [<font color=#902040>OPTIONS</font>] [file1] [<font
color=#902040>OPTIONS</font>] [file2] [<font
color=#902040>OPTIONS</font>] ...</b>
<p> If no -p or --plot option is given then the default initial plots
will be up to 12 plots. The default initial plots will be of all
fields, except the first field in the order that the field was loaded
from a file plotted against the first field in the file. If a
file contains one field (like a sound file) than a field that contains
a linear (time) sequence of values will be generated before the file's
field is loaded. If standard input is read it will be the first file
loaded.</p>
<p></p>
<b><font color=#902040>OPTIONS</font></b></p>
<ul>
<li><b><font color=#902040>--about</font></b> or <b><font
color=#902040>-a</font></b> display some information
about Quickplot
<li><b><font color=#902040>--canvas-color RGB</font></b> or <b><font
color=#902040>-c RGB</font></b> start quickplot with the
graph background (canvas) color RGB. Examples: --canvas-color #FF0000
or --canvas-color "red" would make it red.
<li><b><font color=#902040>--different-scales</font></b> or <b><font
color=#902040>-d</font></b>
load plots on the same graph with different scales. By default
Quickplot will load plots on the same graph with the same scale if the
span of x,y values in all the plots are within an order of magnitude
of each other.
<li> <b><font color=#902040>--geometry GEOMETRY</font></b> or <b><font
color=#902040>-geometry GEOMETRY</font></b> create the
initial window with the given geometry GEOMETRY, see man page X(1) for
the GEOMETRY format. Example: quickplot --geometry=1000x300-0+30
<li> <b><font color=#902040>--grid-color RGB</font></b> or <b><font
color=#902040>-C RGB</font></b> start quickplot with the grid
color RGB. Example: --grid-color #00FF00 would make it green.
<blockquote>
<b><font color=#902040>RGB</font></b> may be in one of these formats:
<ul>
<li>#RGB (each of R, G and B is a single hex digit)
<li>#RRGGBB
<li>#RRRGGGBBB
<li>#RRRRGGGGBBBB
<li>A name from the X color database, which may be
in /usr/X11R6/lib/X11/rgb.txt. Example colors are
"steelblue" and "gainsboro".
</ul>
</blockquote>
<li><b><font color=#902040>--grid-line-width SIZE</font></b> or
<b><font color=#902040>-g SIZE</font></b> start quickplot
using plot grid width SIZE in pixels
<li><b><font color=#902040>--help</font></b> or <b><font
color=#902040>-h</font></b> display this help
<li><b><font color=#902040>--label-separator CHAR</font></b> or
<b><font color=#902040>-b CHAR</font></b> when reading
labels from the last file in the augment list before this option flag
use <b><font color=#902040>CHAR</font></b> as the label (single
character) separator. The default label separator is ' ' (space). If
this file is not an ASCII text file this will be ignored. See option:
<a href="#option_L"><b>--labels</b> or
<b>-L</b></a>.
<a name=option_L> <li><b><font color=#902040>--labels</font></b> or
<b><font color=#902040>-L</font></b> read labels from the
first line not skipped of the last file in the augment list before
this option flag. If this file is not an ASCII text file this will be
ignored.
<li><b><font color=#902040>--line-width SIZE</font></b> or <b><font
color=#902040>-I SIZE</font></b> start quickplot using
plot line width SIZE in pixels
<li><b><font color=#902040>--linear-field [L_OPTIONS]</font></b> or
<b><font color=#902040>-l [L_OPTIONS]</font></b> make a
field that is a uniformly changing linear sequence of values, like for
example time. The number of values will be gotten from the
previous file's values loaded. The field generated will be added
as the first field of the previous file. For sound files this option
is ignored.
<br>
<b><font color=#902040>L_OPTIONS</font></b>
<blockquote>
The L_OPTIONS only have an effect after the --linear-field (or -l)
option and they act on the field made from that argument. The
L_OPTIONS are:
<ul>
<li><b><font color=#902040>--start VALUE</font></b> or <b><font
color=#902040>-r VALUE</font></b> set the first value in the
sequence to VALUE. The The default first value will be zero.
<li><b><font color=#902040>--step SIZE</font></b> or <b><font
color=#902040>-t SIZE</font></b> set the sequence step size to
SIZE. The default is 1.
</ul>
</blockquote>
<!--
<li><b><font color=#902040>--log</font></b> take the log
(base 10) of the values in all fields in the previous file read.
If you want plots with log scales and some without log scales you can
list the file twice in the command line, once without the --log option
after and once with. When loading sound files this option is
ignored.
-->
<li><b><font color=#902040>--no-buttons</font></b> or <b><font
color=#902040>-B</font></b> start quickplot with no
button bar
<li><b><font color=#902040>--no-default-plots</font></b>
by default when no --plot or -p options are given Quickplot will make
some plots with the files loaded at start up. This option will cause
Quickplot not to make these default plots. When files are
loaded using the GUI defaults plot will not be made if this is set.
<li><b><font color=#902040>--no-grid</font></b> or <b><font
color=#902040>-G</font></b> start quickplot with out
drawing graph grid lines, by default, in the graphs
<li><b><font color=#902040>--no-gui</font></b> start
quickplot with out showing any of the standard GUI's (graphical user
interfaces). This is the same as uses the options --no-buttons
--no-menubar --no-statusbar and --no-tabs.
<li><b><font color=#902040>--no-lines</font></b> or <b><font
color=#902040>-i</font></b> start quickplot to plot
without drawing lines in the graphs by default
<li><b><font color=#902040>--no-menubar</font></b> or <b><font
color=#902040>-M</font></b> start quickplot with no
menubar
<li><b><font color=#902040>--no-pipe</font></b> or <b><font
color=#902040>-N</font></b> don't read data in from
standard input
<li><b><font color=#902040>--no-points</font></b> or <b><font
color=#902040>-o</font></b> start quickplot to plot
without drawing points in the graphs by default
<li><b><font color=#902040>--no-statusbar</font></b> start
Quickplot with no status bar displayed. The Quickplot status bar is a
thin widget at the bottom of the main Quickplot window which displays
pointer x, y graph values and mode information.
<li><b><font color=#902040>--no-tabs</font></b> start
Quickplot with no graph tabs displayed. Quickplot uses a notebook
like widget to let you select and view multiple graphs.
<li><b><font color=#902040>--number-of-plots NUM</font></b> or
<b><font color=#902040>-n NUM</font></b> set the possible
initial number of plots to NUM. The default possible initial
number of plots is 12.
<li><b><font color=#902040>--pipe </font></b> or <b><font
color=#902040>-P</font></b> read in data from standard
input. By default Quickplot looks for data from standard input
and stops looking if no data is found in some short amount of
time. This option will cause Quickplot to wait for standard
input indefinitely.
<li><b><font color=#902040>--plot LIST </font></b> or <b><font
color=#902040>-p LIST</font></b> plot the following list
of fields, LIST, at startup. example: --plot "0 1 3 4" will plot
field 1 VS field 0 and field 4 VS field 3. DataFields are
numbered, starting at 0, in the order that they are read in from a
file or created, as in the case of option --linear-field. A
separate Graph Tab will be created for each --plot (or -p) option
given.
<li><b><font color=#902040>--point-size SIZE</font></b> or <b><font
color=#902040>-O SIZE</font></b> start quickplot using
plot point size SIZE in pixels
<li><b><font color=#902040>--print-about</font></b>
prints the About HTML document to standard output and then exits
<li><b><font color=#902040>--print-help</font></b> prints
this Help HTML document to standard output and then exits
<li><b><font color=#902040>--same-scale</font></b> or <b><font
color=#902040>-s</font></b> plot all start-up plots on
the same scale
<li><b><font color=#902040>--silent</font></b> don't spew
even on error. The --silent option will override the effect of
the --verbose option.
<li><b><font color=#902040>--skip-lines NUM</font></b> or <b><font
color=#902040>-S NUM</font></b> skip the first NUM lines
in the previous file read. The previous file in the argument list
should be an ASCII text file.
<li><b><font color=#902040>--verbose</font></b> or <b><font
color=#902040>-v</font></b> spew more to standard output
<li><b><font color=#902040>--version</font></b> or <b><font
color=#902040>-V</font></b> print the Quickplot version
number and then exit returning 0 exit status
<li><b><font color=#902040>--with-libsndfile</font></b> if
quickplot is linked with the libsndfile library, print the version of
the libsndfile library that quickplot is linked with, and exit
returning status 0 if quickplot is linked with the libsndfile library
and 1 if quickplot is not linked with the libsndfile library
<br>
<li><b><font color=#902040>GTK+ OPTIONS</font></b><br> The following
GTK+ options are parsed by the <a
href="http://www.gtkmm.org/">gtkmm</a> and <a
href="http://www.gtk.org/">GTK+</a> APIs (application programming
interfaces), which Quickplot uses.
<blockquote>
<table> <!-- We got this list from running `galeon --help'. Where
does GTK+ keep this info??? !-->
<tr><td valign=top>--gdk-debug=FLAGS</td><td valign=top> Gdk debugging flags to set</td></tr>
<tr><td valign=top>--gdk-no-debug=FLAGS</td><td valign=top> Gdk debugging flags to unset</td></tr>
<tr><td valign=top>--display=DISPLAY</td><td valign=top> X display to use</td></tr>
<tr><td valign=top>--screen=SCREEN</td><td valign=top> X screen to use</td></tr>
<tr><td valign=top>--sync</td><td valign=top> Make X calls synchronous</td></tr>
<tr><td valign=top>--name=NAME</td><td valign=top> Program name as used by the window manager</td></tr>
<tr><td valign=top>--class=CLASS</td><td valign=top> Program class as used by the window manager</td></tr>
<tr><td valign=top>--gxid-host=HOST</td><td valign=top> </td></tr>
<tr><td valign=top>--gxid-port=PORT</td><td valign=top> </td></tr>
<tr><td valign=top>--gtk-debug=FLAGS</td><td valign=top> Gtk+ debugging flags to set</td></tr>
<tr><td valign=top>--gtk-no-debug=FLAGS</td><td valign=top> Gtk+ debugging flags to unset</td></tr>
<tr><td valign=top>--g-fatal-warnings</td><td valign=top> Make all warnings fatal</td></tr>
<tr><td valign=top>--gtk-module=MODULE</td><td valign=top> Load an additional Gtk module</td></tr>
</table>
</blockquote>
</ul>
<br>
<h3>Key Bindings</h3>
<blockquote>
Quickplot has GUIs for all of the following immutable keyboard short-cuts:
<ul>
<li><b>a</b> show information <b><u>a</u></b>bout Quickplot using a web browser</li>
<li><b>b</b> toggles the visibility of the <b><u>b</u></b>utton bar</li>
<li><b>c</b> <b><u>c</u></b>opies the current focused main window frame</li>
<li><b>d</b> <b><u>d</u></b>elete the main window. This will not close the last main window.</li>
<li><b>f</b> makes a new main window <b><u>f</u></b>rame</li></li>
<li><b>g</b> show/hide the <b><u>g</u></b>raph configuration widget</li>
<li><b>h</b> show <b><u>h</u></b>elp using a web browser</li>
<li><b>i</b> save a PNG <b><u>i</u></b>mage of the graph</li>
<li><b>m</b> show/hide the <b><u>m</u></b>enu bar</li>
<li><b>n</b> make a <b><u>n</u></b>ew graph</li>
<li><b>o</b> <b><u>o</u></b>pen a data file</li>
<li><b>p</b> show/hide the <b><u>p</u></b>lot lister widget</li>
<li><b>q</b> <b><u>q</u></b>uit</li>
<li><b>s</b> toggles the visibility of the <b><u>s</u></b>tatus bar</li>
<li><b>t</b> toggles the visibility of the graph <b><u>t</u></b>abs</li>
<li><b>esc</b> close the current focused window. This will not close the last main window.</li>
</ul>
</blockquote>
<br>
<center><hr></hr>
<a href="index.html">Top</a><hr></hr>
<a href="http://quickplot.sourceforge.net/">Quickplot</a>
version 0.8.6
release date: Thu Jan 6 20:26:45 EST 2005
</center>
</body>
</html>
|
