xref: /original-bsd/usr.bin/graph/graph.1 (revision 95a66346)
1.\" Copyright (c) 1990 Regents of the University of California.
2.\" All rights reserved.  The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
5.\"     @(#)graph.1	6.4 (Berkeley) 03/14/91
6.\"
7.Vx
8.Vx
9.Dd
10.Dt GRAPH 1
11.Os ATT 7th
12.Sh NAME
13.Nm graph
14.Nd draw a graph
15.Sh SYNOPSIS
16.Nm graph
17.Op option
18\&...
19.Sh DESCRIPTION
20.Nm Graph
21with no options takes pairs of numbers from the
22standard input as abscissas and
23ordinates of a graph.
24Successive points are connected by straight lines.
25The graph is encoded on the standard output
26for display by the
27.Xr plot 1
28filters.
29.Pp
30If the coordinates of a point are followed by
31a nonnumeric string, that string is printed as a
32label beginning on the point.
33Labels may be surrounded with quotes "...", in
34which case they may be empty or contain blanks
35and numbers;
36labels never contain newlines.
37.Pp
38The following options are recognized,
39each as a separate argument.
40.Tw Fl
41.Tp Fl a
42Supply abscissas automatically (they are missing from
43the input); spacing is given by the next
44argument (default 1).
45A second optional argument is the starting point for
46automatic abscissas (default 0 or lower limit given by
47.Fl x  ) .
48.Tp Fl b
49Break (disconnect) the graph after each label in the input.
50.Tp Fl c
51Character string given by next argument
52is default label for each point.
53.Tp Fl g
54Next argument is grid style,
550 no grid, 1 frame with ticks, 2 full grid (default).
56.Tp Fl l
57Next argument is label for graph.
58.Tp Fl m
59Next argument is mode (style)
60of connecting lines:
610 disconnected, 1 connected (default).
62Some devices give distinguishable line styles
63for other small integers.
64.Tp Fl s
65Save screen, don't erase before plotting.
66.Tc Fl x
67.Ws
68.Op Ar l
69.Cx
70If
71.Ar l
72is present, x axis is logarithmic.
73Next 1 (or 2) arguments are lower (and upper)
74.Ar x
75limits.
76Third argument, if present, is grid spacing on
77.Ar x
78axis.
79Normally these quantities are determined automatically.
80.Tc Fl y
81.Ws
82.Op Ar l
83.Cx
84Similarly for
85.Ar y  .
86.Tp Fl h
87Next argument is fraction of space for height.
88.Tp Fl w
89Similarly for width.
90.Tp Fl r
91Next argument is fraction of space to move right before plotting.
92.Tp Fl u
93Similarly to move up before plotting.
94.Tp Fl t
95Transpose horizontal and vertical axes.
96(Option
97.Fl x
98now applies to the vertical axis.)
99.Tp
100.Pp
101A legend indicating grid range is produced
102with a grid unless the
103.Fl s
104option is present.
105.Pp
106If a specified lower limit exceeds the upper limit,
107the axis
108is reversed.
109.Sh SEE ALSO
110.Xr spline 1 ,
111.Xr plot 1
112.Sh HISTORY
113.Nm Plot
114appeared in Version 6 AT&T Unix.
115.Sh BUGS
116.Nm Graph
117stores all points internally and drops those for which
118there isn't room.
119.Pp
120Segments that run out of bounds are dropped, not windowed.
121.Pp
122Logarithmic axes may not be reversed.
123