.TH GRAPH 1.CT 1 numbers graphics.SH NAMEgraph \- draw a graph.SH SYNOPSIS.B graph[.I option ...].SH DESCRIPTION.I Graphwith no options takes pairs of numbers from thestandard input as abscissas.RI ( x -values)and ordinates.RI ( y -values)of a graph.Successive points are connected by straight lines.The graph is encoded on the standard outputfor display by.IR plot (1)filters..PPIf an ordinate is followed bya nonnumeric string, that string is printed as alabel beginning on the point.Labels may be surrounded with quotes.L" "in which case they may be empty or contain blanksand numbers;labels never contain newlines..PPThe following options are recognized,each as a separate argument..TP.B -aSupply abscissas automatically; no.IR x -valuesappear in the input.Spacing is given by the nextargument (default 1).A second optional argument is the starting point forautomatic abscissas (default 0, or 1with a log scale in.IR x ,or the lower limit given by.BR -x )..TP.B -bBreak (disconnect) the graph after each label in the input..TP.B -cCharacter string given by next argumentis default label for each point..TP.B -gNext argument is grid style,0 no grid, 1 frame with ticks, 2 full grid (default)..TP.B -lNext argument is a legend to title the graph.Grid rangesare automatically printed as partof the title unless a.B -soption is present..TP.B -mNext argument is mode (style)of connecting lines:0 disconnected, 1 connected.Some devices give distinguishable line stylesfor other small integers.Mode \-1 (default) begins with style 1 androtates styles for successive curves under option.BR -o ..TP.B -o(Overlay.)The ordinates for.I nsuperposed curves appear in the inputwith each abscissa value.The next argument is.IR n ..TP.B -pNext argument is one or more of the characters.B bcgkmrwy,choosing pen colors by their initial letter, as in.IR plot (6).Successive curves will cycle through the colors in the given order..TP.B -sSave screen; no new page for this graph..TP.B -x lIf.B lis present,.IR x -axisis logarithmic.Next 1 (or 2) arguments are lower (and upper).I xlimits.Third argument, if present, is grid spacing on.I xaxis.Normally these quantities are determined automatically..TP.B -y lSimilarly for.IR y ..TP.B -eMake automatically determined.I xand.I yscales equal..TP.B -hNext argument is fraction of space for height..TP.B -wSimilarly for width..TP.B -rNext argument is fraction of space to move right before plotting..TP.B -uSimilarly to move up before plotting..TP.B -tTranspose horizontal and vertical axes.(Option.B -anow applies to the vertical axis.).PPIf a specified lower limit exceeds the upper limit,the axisis reversed..SH SOURCE.B /sys/src/cmd/graph.SH "SEE ALSO".IR plot (1), .IR grap (1).SH BUGSSegments that run out of bounds are dropped, not windowed.Logarithmic axes may not be reversed.Option.B -eactually makes automatic limits, rather than automatic scaling,equal.
.TH GRAPH 1
.CT 1 numbers graphics
.SH NAME
graph \- draw a graph
.SH SYNOPSIS
.B graph
[
.I option ...
]
.SH DESCRIPTION
.I Graph
with no options takes pairs of numbers from the
standard input as abscissas
.RI ( x -values)
and ordinates
.RI ( y -values)
of a graph.
Successive points are connected by straight lines.
The graph is encoded on the standard output
for display by
.IR plot (1)
filters.
.PP
If an ordinate is followed by
a nonnumeric string, that string is printed as a
label beginning on the point.
Labels may be surrounded with quotes
.L
" "
in which case they may be empty or contain blanks
and numbers;
labels never contain newlines.
.PP
The following options are recognized,
each as a separate argument.
.TP
.B -a
Supply abscissas automatically; no
.IR x -values
appear in the input.
Spacing is given by the next
argument (default 1).
A second optional argument is the starting point for
automatic abscissas (default 0, or 1
with a log scale in
.IR x ,
or the lower limit given by
.BR -x ).
.TP
.B -b
Break (disconnect) the graph after each label in the input.
.TP
.B -c
Character string given by next argument
is default label for each point.
.TP
.B -g
Next argument is grid style,
0 no grid, 1 frame with ticks, 2 full grid (default).
.TP
.B -l
Next argument is a legend to title the graph.
Grid ranges
are automatically printed as part
of the title unless a
.B -s
option is present.
.TP
.B -m
Next argument is mode (style)
of connecting lines:
0 disconnected, 1 connected.
Some devices give distinguishable line styles
for other small integers.
Mode \-1 (default) begins with style 1 and
rotates styles for successive curves under option
.BR -o .
.TP
.B -o
(Overlay.)
The ordinates for
.I n
superposed curves appear in the input
with each abscissa value.
The next argument is
.IR n .
.TP
.B -p
Next argument is one or more of the characters
.B bcgkmrwy,
choosing pen colors by their initial letter, as in
.IR plot (6).
Successive curves will cycle through the colors in the given order.
.TP
.B -s
Save screen; no new page for this graph.
.TP
.B -x l
If
.B l
is present,
.IR x -axis
is logarithmic.
Next 1 (or 2) arguments are lower (and upper)
.I x
limits.
Third argument, if present, is grid spacing on
.I x
axis.
Normally these quantities are determined automatically.
.TP
.B -y l
Similarly for
.IR y .
.TP
.B -e
Make automatically determined
.I x
and
.I y
scales equal.
.TP
.B -h
Next argument is fraction of space for height.
.TP
.B -w
Similarly for width.
.TP
.B -r
Next argument is fraction of space to move right before plotting.
.TP
.B -u
Similarly to move up before plotting.
.TP
.B -t
Transpose horizontal and vertical axes.
(Option
.B -a
now applies to the vertical axis.)
.PP
If a specified lower limit exceeds the upper limit,
the axis
is reversed.
.SH SOURCE
.B /sys/src/cmd/graph
.SH "SEE ALSO"
.IR plot (1),
.IR grap (1)
.SH BUGS
Segments that run out of bounds are dropped, not windowed.
Logarithmic axes may not be reversed.
Option
.B -e
actually makes automatic limits, rather than automatic scaling,
equal.