shithub: riscv

ref: 92d5d58784130a456dec269ce0d876ba7ad89932
dir: /sys/man/1/fplot/

View raw version
.TH FPLOT 1
.SH NAME
fplot \- plot elementary function
.SH SYNOPSIS
.B fplot
[
.B -c
[
.B -s
.I size
]] [
.B -r
.I range
]
.I functions ...
.SH DESCRIPTION
.I Fplot
plots elementary
.I functions
separated by spaces. The default output is the screen, but if the
.B -c
option is specified, the plot is written to the standard output as an r8g8b8
.IR image (6).
The latter image size is either 640x480 or the one specified by the
.B -s
option's argument (in the WIDTHxHEIGHT format). The
.B -r
option accepts as argument the x and y ranges, in the format
.LR "xmin:xmax ymin:ymax".
By default
.I fplot
draws coordinate axes and tick marks; the
.B -a
option inhibits this.
.PP
Each function to be plotted may be a combination of the independent variable x, 
the elementary operations (+, -, *, / and %), and the functions described in
.IR sin (2)
and
.IR exp (2).
The exception being that x^n raises x to the nth power, log is the base 10 logarithm, 
and ln is the natural logarithm.
.SH EXAMPLES
Plot the absolute value and x^3 functions to a 400x400 image(6) on standard output and view with
.IR page (1).
.IP
.EX
fplot -c -s 400x400 'abs(x)' 'x^3' | page
.EE
.SH SOURCE
.B /sys/src/cmd/fplot.c
.SH SEE ALSO
.IR exp (2),
.IR sin (2),
.IR image (6),
.IR plot (1).
.SH DIAGNOSTICS
.I Fplot
either exits with
.LR "syntax error"
or an empty status.
.SH BUGS
There is no unary plus or minus.
.PP
Axes are not drawn in
.B -c
output.
.SH HISTORY
.I Fplot
first appeared in 9front (July, 2011).