xref: /csrg-svn/usr.bin/graph/graph.1 (revision 62018)
1*62018Sbostic.\" Copyright (c) 1990, 1993
2*62018Sbostic.\"	The Regents of the University of California.  All rights reserved.
319421Smckusick.\"
448262Sbostic.\" %sccs.include.proprietary.roff%
543693Scael.\"
6*62018Sbostic.\"	@(#)graph.1	8.1 (Berkeley) 06/06/93
748262Sbostic.\"
843693Scael.Dd
943693Scael.Dt GRAPH 1
1043693Scael.Os ATT 7th
1143693Scael.Sh NAME
1243693Scael.Nm graph
1343693Scael.Nd draw a graph
1443693Scael.Sh SYNOPSIS
1543693Scael.Nm graph
1643693Scael.Op option
1750818Scael.Ar ...
1843693Scael.Sh DESCRIPTION
1943693Scael.Nm Graph
2019421Smckusickwith no options takes pairs of numbers from the
2119421Smckusickstandard input as abscissas and
2219421Smckusickordinates of a graph.
2319421SmckusickSuccessive points are connected by straight lines.
2419421SmckusickThe graph is encoded on the standard output
2519421Smckusickfor display by the
2643693Scael.Xr plot 1
2719421Smckusickfilters.
2843693Scael.Pp
2919421SmckusickIf the coordinates of a point are followed by
3019421Smckusicka nonnumeric string, that string is printed as a
3119421Smckusicklabel beginning on the point.
3219421SmckusickLabels may be surrounded with quotes "...", in
3319421Smckusickwhich case they may be empty or contain blanks
3419421Smckusickand numbers;
3519421Smckusicklabels never contain newlines.
3643693Scael.Pp
3719421SmckusickThe following options are recognized,
3819421Smckusickeach as a separate argument.
3950818Scael.Bl -tag -width flagx
4050818Scael.It Fl a
4119421SmckusickSupply abscissas automatically (they are missing from
4219421Smckusickthe input); spacing is given by the next
4319421Smckusickargument (default 1).
4419421SmckusickA second optional argument is the starting point for
4519421Smckusickautomatic abscissas (default 0 or lower limit given by
4650818Scael.Fl x ) .
4750818Scael.It Fl b
4819421SmckusickBreak (disconnect) the graph after each label in the input.
4950818Scael.It Fl c
5019421SmckusickCharacter string given by next argument
5119421Smckusickis default label for each point.
5250818Scael.It Fl g
5319421SmckusickNext argument is grid style,
5419421Smckusick0 no grid, 1 frame with ticks, 2 full grid (default).
5550818Scael.It Fl l
5619421SmckusickNext argument is label for graph.
5750818Scael.It Fl m
5819421SmckusickNext argument is mode (style)
5919421Smckusickof connecting lines:
6019421Smckusick0 disconnected, 1 connected (default).
6119421SmckusickSome devices give distinguishable line styles
6219421Smckusickfor other small integers.
6350818Scael.It Fl s
6419421SmckusickSave screen, don't erase before plotting.
6550818Scael.It Fl x Ns Op Ar l
6619421SmckusickIf
6743693Scael.Ar l
6819421Smckusickis present, x axis is logarithmic.
6919421SmckusickNext 1 (or 2) arguments are lower (and upper)
7043693Scael.Ar x
7119421Smckusicklimits.
7243693ScaelThird argument, if present, is grid spacing on
7343693Scael.Ar x
7419421Smckusickaxis.
7519421SmckusickNormally these quantities are determined automatically.
7650818Scael.It Fl y Ns Op Ar l
7719421SmckusickSimilarly for
7843693Scael.Ar y  .
7950818Scael.It Fl h
8019421SmckusickNext argument is fraction of space for height.
8150818Scael.It Fl w
8219421SmckusickSimilarly for width.
8350818Scael.It Fl r
8419421SmckusickNext argument is fraction of space to move right before plotting.
8550818Scael.It Fl u
8619421SmckusickSimilarly to move up before plotting.
8750818Scael.It Fl t
8819421SmckusickTranspose horizontal and vertical axes.
8919421Smckusick(Option
9043693Scael.Fl x
9119421Smckusicknow applies to the vertical axis.)
9250818Scael.El
9343693Scael.Pp
9419421SmckusickA legend indicating grid range is produced
9519421Smckusickwith a grid unless the
9643693Scael.Fl s
9719421Smckusickoption is present.
9843693Scael.Pp
9919421SmckusickIf a specified lower limit exceeds the upper limit,
10019421Smckusickthe axis
10119421Smckusickis reversed.
10243693Scael.Sh SEE ALSO
10343693Scael.Xr spline 1 ,
10443693Scael.Xr plot 1
10543693Scael.Sh HISTORY
10650818ScaelThe
10750818Scael.Nm graph
10850818Scaelcommand appeared in
10950818Scael.At v6 .
11043693Scael.Sh BUGS
11143693Scael.Nm Graph
11219421Smckusickstores all points internally and drops those for which
11319421Smckusickthere isn't room.
11443693Scael.Pp
11519421SmckusickSegments that run out of bounds are dropped, not windowed.
11643693Scael.Pp
11719421SmckusickLogarithmic axes may not be reversed.
118