File: xplot.1

package info (click to toggle)
xplot-xplot.org 0.90.7.1-4
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 1,848 kB
  • sloc: ansic: 4,283; perl: 724; sh: 152; makefile: 133
file content (148 lines) | stat: -rw-r--r-- 4,015 bytes parent folder | download | duplicates (2)
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
.Dd 27 January 1999
.Dt XPLOT.ORG 1
.Os
.Sh NAME
.Nm xplot.org
.Nd fast tool to graph and visualize lots of data
.Sh SYNOPSIS
.Nm xplot.org
.Op Ar -v
.Op Ar -x 
.Op Ar -y
.Op Ar -tile
.Op Ar -mono
.Op Ar -1
.Op Ar -d display | -display display
.Op Ar -d2 display
.Ar file 
.Op Ar files...
.Sh DESCRIPTION
.Nm xplot.org
is a fast visualization tool for examining multiple data sets in
parallel plots.  It supports easy zoom-in and zoom-out capabilities,
and synchronized views into multiple data sets (with the 
.Ar -x , 
.Ar -y , 
and 
.Ar -tile
options).
.Sh OPTIONS
.Bl -item
.It
.Ar -1
allows one to look at multiple data sets, one at a time.
This changes the behavior of click-right and shift-click-right from
exiting and printing to cycling forward and backward through the
various plots.
.It
.Ar -d
.Ar display, 
.Ar -display
.Ar display,
.It
.Ar -d2
.Ar display, 
all select which display(s) on which to draw the graphs.
.It
.Ar -mono
causes the graph(s) to be drawn in black and white, with no use of
color. 
.It
.Ar -tile
allows one to look at multiple data sets in parallel.  The plots will
each consume 1/nth of the vertical space that would have been used
with one plot.  This works well if the window manager refrains from
wasting pixels with decorative tabs and respects the hints that
.Nm xplot.org
provides.
.It
.Ar -v
prints the version number.
.It
.Ar -x
causes several graphs to be synchronized on the X-axis (zooming in one
window zooms all the others, with the same portion of the X-axis on
display).  The Y-axis of the other graphs will be autoscaled to fit
the data.
.It
.Ar -y
causes several graphs to be synchronized on the Y-axis (zooming in one
window zooms all the others, with the same portion of the Y-axis on
display).
.El
.Sh USE OF MOUSE BUTTONS
When running
.Nm xplot.org, 
the mouse may be used to zoom in and out on data.
.Pp
Dragging with the left mouse button depressed while inside the axes of
the graph draws a rubber-band box around the area to be replotted in
the existing window.
.Pp
Dragging with the left mouse button depressed while outside the axes
(below the X-axis or to the left of the Y-axis) selects the range of
the axis to plot.  In effect, this is like the previous mechanism, but
only zooming on one axis.
.Pp
Dragging with the middle mouse button inside the axes pans the graph;
the start-drag position ends up being at the end-drag position.
Dragging on the axes pans only in one dimension.
.Pp
Clicking the left mouse button zooms out to the previous view.
One can zoom in multiple times, then back up through each view.
Panning locations are not saved.
.Pp
Clicking the right mouse button exits the program.
.Pp
Shift-clicking on the mouse buttons produces Postscript files with the
same axis extents as the current view.  Shift-left produces a
full-page view.  Shift-middle produces a squarish plot, and
shift-right a plot such that three of them fit on a page of LaTeX.
.Sh PLOT LANGUAGE
There are several example files 
.Pa demo.0,
.Pa demo.1, 
.Pa demo.2,
etc., 
stored with the 
.Nm xplot.org
sources.  
.Pa demo.0
lists all the commands.
.Dl xplot.org demo.0
demonstrates 
.Nm xplot.org's 
capabilities.
.Sh USE WITH TCPDUMP
The command
.Dl tcpdump -tt -S ... > tcpdump.out
saves a 
.Nm tcpdump 
formatted output trace to
.Ar tcpdump.out.  The 
.Ar -tt
and 
.Ar -S 
flags tell 
.Nm tcpdump 
to print an unformatted timestamp and to use absolute TCP sequence
numbers. 
.Pp
This trace can then be examined by being processed with
.Nm tcpdump2xplot.
.Dl tcpdump -plot tcpdump.out
.Sh SEE ALSO
.Xr tcpdump2xplot 1
.Xr tcpdump 8
.Sh HISTORY
The
.Nm xplot.org
command was written by Tim Shepard as a tool to use in his analysis of
TCP performance while at MIT.
Some features were added by Andrew Heybey and Greg Troxel.
.Sh BUGS
Some people may not like that the right mouse button exits without
confirmation, although others consider it a feature that enables
rapidly viewing hundreds of similar plots.
.Pp
Should use standard X geometry specifications.