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