xref: /csrg-svn/usr.bin/graph/graph.1 (revision 48262)
1*48262Sbostic.\" Copyright (c) 1990 The Regents of the University of California.
2*48262Sbostic.\" All rights reserved.
319421Smckusick.\"
4*48262Sbostic.\" %sccs.include.proprietary.roff%
543693Scael.\"
6*48262Sbostic.\"	@(#)graph.1	6.5 (Berkeley) 04/17/91
7*48262Sbostic.\"
847343Scael.Vx
943693Scael.Dd
1043693Scael.Dt GRAPH 1
1143693Scael.Os ATT 7th
1243693Scael.Sh NAME
1343693Scael.Nm graph
1443693Scael.Nd draw a graph
1543693Scael.Sh SYNOPSIS
1643693Scael.Nm graph
1743693Scael.Op option
1843693Scael\&...
1943693Scael.Sh DESCRIPTION
2043693Scael.Nm Graph
2119421Smckusickwith no options takes pairs of numbers from the
2219421Smckusickstandard input as abscissas and
2319421Smckusickordinates of a graph.
2419421SmckusickSuccessive points are connected by straight lines.
2519421SmckusickThe graph is encoded on the standard output
2619421Smckusickfor display by the
2743693Scael.Xr plot 1
2819421Smckusickfilters.
2943693Scael.Pp
3019421SmckusickIf the coordinates of a point are followed by
3119421Smckusicka nonnumeric string, that string is printed as a
3219421Smckusicklabel beginning on the point.
3319421SmckusickLabels may be surrounded with quotes "...", in
3419421Smckusickwhich case they may be empty or contain blanks
3519421Smckusickand numbers;
3619421Smckusicklabels never contain newlines.
3743693Scael.Pp
3819421SmckusickThe following options are recognized,
3919421Smckusickeach as a separate argument.
4043693Scael.Tw Fl
4143693Scael.Tp Fl a
4219421SmckusickSupply abscissas automatically (they are missing from
4319421Smckusickthe input); spacing is given by the next
4419421Smckusickargument (default 1).
4519421SmckusickA second optional argument is the starting point for
4619421Smckusickautomatic abscissas (default 0 or lower limit given by
4743693Scael.Fl x  ) .
4843693Scael.Tp Fl b
4919421SmckusickBreak (disconnect) the graph after each label in the input.
5043693Scael.Tp Fl c
5119421SmckusickCharacter string given by next argument
5219421Smckusickis default label for each point.
5343693Scael.Tp Fl g
5419421SmckusickNext argument is grid style,
5519421Smckusick0 no grid, 1 frame with ticks, 2 full grid (default).
5643693Scael.Tp Fl l
5719421SmckusickNext argument is label for graph.
5843693Scael.Tp Fl m
5919421SmckusickNext argument is mode (style)
6019421Smckusickof connecting lines:
6119421Smckusick0 disconnected, 1 connected (default).
6219421SmckusickSome devices give distinguishable line styles
6319421Smckusickfor other small integers.
6443693Scael.Tp Fl s
6519421SmckusickSave screen, don't erase before plotting.
6643693Scael.Tc Fl x
6743693Scael.Ws
6843693Scael.Op Ar l
6943693Scael.Cx
7019421SmckusickIf
7143693Scael.Ar l
7219421Smckusickis present, x axis is logarithmic.
7319421SmckusickNext 1 (or 2) arguments are lower (and upper)
7443693Scael.Ar x
7519421Smckusicklimits.
7643693ScaelThird argument, if present, is grid spacing on
7743693Scael.Ar x
7819421Smckusickaxis.
7919421SmckusickNormally these quantities are determined automatically.
8043693Scael.Tc Fl y
8143693Scael.Ws
8243693Scael.Op Ar l
8343693Scael.Cx
8419421SmckusickSimilarly for
8543693Scael.Ar y  .
8643693Scael.Tp Fl h
8719421SmckusickNext argument is fraction of space for height.
8843693Scael.Tp Fl w
8919421SmckusickSimilarly for width.
9043693Scael.Tp Fl r
9119421SmckusickNext argument is fraction of space to move right before plotting.
9243693Scael.Tp Fl u
9319421SmckusickSimilarly to move up before plotting.
9443693Scael.Tp Fl t
9519421SmckusickTranspose horizontal and vertical axes.
9619421Smckusick(Option
9743693Scael.Fl x
9819421Smckusicknow applies to the vertical axis.)
9943693Scael.Tp
10043693Scael.Pp
10119421SmckusickA legend indicating grid range is produced
10219421Smckusickwith a grid unless the
10343693Scael.Fl s
10419421Smckusickoption is present.
10543693Scael.Pp
10619421SmckusickIf a specified lower limit exceeds the upper limit,
10719421Smckusickthe axis
10819421Smckusickis reversed.
10943693Scael.Sh SEE ALSO
11043693Scael.Xr spline 1 ,
11143693Scael.Xr plot 1
11243693Scael.Sh HISTORY
11343693Scael.Nm Plot
11443693Scaelappeared in Version 6 AT&T Unix.
11543693Scael.Sh BUGS
11643693Scael.Nm Graph
11719421Smckusickstores all points internally and drops those for which
11819421Smckusickthere isn't room.
11943693Scael.Pp
12019421SmckusickSegments that run out of bounds are dropped, not windowed.
12143693Scael.Pp
12219421SmckusickLogarithmic axes may not be reversed.
123