Annotation of OpenXM_contrib/gnuplot/docs/gnuplot.1, Revision 1.1.1.1
1.1 maekawa 1: .\" dummy line
2: .TH GNUPLOT 1 "31 August 1990"
3: .UC 4
4: .SH NAME
5: gnuplot \- an interactive plotting program
6: .SH SYNOPSIS
7: .B gnuplot
8: [ X11 options ] [file ...]
9: .br
10: .SH DESCRIPTION
11: .I Gnuplot
12: is a command-driven interactive function plotting program.
13: .PP
14: If files are given,
15: .I gnuplot
16: loads each file with the
17: .I load
18: command, in the order specified.
19: .I Gnuplot
20: exits after the last file is processed.
21: .PP
22: Here are some of its features:
23: .PP
24: Plots any number of functions, built up of C operators, C library
25: functions, and some things C doesn't have like **, sgn(), etc. Also
26: support for plotting data files, to compare actual
27: data to theoretical curves.
28: .PP
29: User-defined X and Y ranges (optional auto-ranging), smart axes scaling,
30: smart tic marks.
31: .PP
32: Labelling of X and Y axes.
33: .PP
34: User-defined constants and functions.
35: .PP
36: Support through a generalized graphics driver for
37: AED 512,
38: AED 767,
39: BBN BitGraph,
40: Commodore Amiga,
41: Roland DXY800A,
42: EEPIC,
43: TeXDraw,
44: EmTeX,
45: Epson 60dpi printers,
46: Epson LX-800,
47: Fig,
48: HP2623,
49: HP2648,
50: HP75xx,
51: HPGL,
52: HP LaserJet II,
53: Imagen,
54: Iris 4D,
55: Linux,
56: MS-DOS Kermit,
57: Kyocera laser printer,
58: LaTeX,
59: NEC CP6 pinwriter,
60: PostScript,
61: QMS QUIC,
62: ReGis (VT125 and VT2xx),
63: SCO Xenix CGI,
64: Selanar,
65: Star color printer,
66: Tandy DMP-130 printer,
67: Tek 401x,
68: Tek 410x,
69: Vectrix 384,
70: VT like Tektronix emulator,
71: Unix PC (ATT 3b1 or ATT 7300),
72: unixplot,
73: and X11.
74: The PC version compiled by Microsoft C
75: supports IBM CGA, EGA, VGA, Hercules, ATT 6300,
76: and Corona 325 graphics.
77: The PC version compiled by Borland C++
78: supports IBM CGA, EGA, MCGA, VGA, Hercules and ATT 6300 graphics.
79: Other devices can be added simply, but will require recompiling.
80: .PP
81: Shell escapes and command line substitution.
82: .PP
83: Load and save capability.
84: .PP
85: Output redirection.
86: .PP
87: All computations performed in the complex domain. Just the real part is
88: plotted by default, but functions like imag() and abs() and arg() are
89: available to override this.
90: .SH X11 OPTIONS
91: .I Gnuplot
92: provides the \fIx11\fP terminal type for use
93: with X servers. This terminal type is set automatically at startup if
94: the \fBDISPLAY\fR environment variable is set, if the \fBTERM\fR environment
95: variable is set to \fBxterm\fR, or if the \fB\-display\fR command line
96: option is used.
97: For terminal type \fIx11\fR, \fIgnuplot\fP
98: accepts the standard X Toolkit options and resources such as geometry, font,
99: and background. See the X(1) man page for a description of
100: the options.
101: In addition to the X Toolkit options:
102: .PP
103: \fB\-clear\fP requests that the window be cleared momentarily before a
104: new plot is displayed.
105: .PP
106: \fB\-gray\fP requests grayscale rendering on grayscale or color displays.
107: (Grayscale displays receive monochrome rendering by default.)
108: .PP
109: \fB\-mono\fP forces monochrome rendering on color displays.
110: .PP
111: \fB\-persist\fP lets plot windows survive after main gnuplot program exits.
112: .PP
113: \fB-raise\fP raises the plot window after each plot.
114: .PP
115: \fB-noraise\fp does not raise the plot window after each plot.
116: .PP
117: \fB\-tvtwm\fP requests that geometry specifications
118: for position of the window be made relative to the currently displayed
119: portion of the virtual root.
120: .PP
121: These options may also be controlled with resources in your \fB.Xdefaults\fR
122: file.
123: For example: \fBgnuplot*gray: on\fP .
124: .PP
125: \fIGnuplot\fP provides a command line option (\fB\-pointsize \fIv\fR) and
126: a resource (\fBgnuplot*pointsize: \fIv\fR) to control the size of points
127: plotted with the "points" plotting style. The value \fIv\fR is a real
128: number (greater than 0 and less than or equal to ten) used as a
129: scaling factor for point sizes. For example, \fB\-pointsize 2\fR uses
130: points twice the default size, and \fB\-pointsize 0.5\fR uses points
131: half the normal size.
132: .PP
133: For monochrome displays, \fIgnuplot\fR does not honor foreground or
134: background colors. The default is black-on-white. \fB\-rv\fP or
135: \fBgnuplot*reverseVideo: on\fP requests white-on-black.
136: .PP
137: For color displays \fIgnuplot\fP honors
138: the following resources (shown here with default values). The values
139: may be color names in the X11 rgb.txt file on your system, hexadecimal
140: RGB color specifications (see X11 documentation), or a color name
141: followed by a comma and an \fIintensity\fR value from 0 to 1. For example,
142: \fBblue,.5\fR means a half intensity blue.
143: .sp
144: .B "gnuplot*background: white"
145: .br
146: .B "gnuplot*textColor: black"
147: .br
148: .B "gnuplot*borderColor: black"
149: .br
150: .B "gnuplot*axisColor: black"
151: .br
152: .B "gnuplot*line1Color: red"
153: .br
154: .B "gnuplot*line2Color: green"
155: .br
156: .B "gnuplot*line3Color: blue"
157: .br
158: .B "gnuplot*line4Color: magenta"
159: .br
160: .B "gnuplot*line5Color: cyan"
161: .br
162: .B "gnuplot*line6Color: sienna"
163: .br
164: .B "gnuplot*line7Color: orange"
165: .br
166: .B "gnuplot*line8Color: coral"
167: .br
168:
169: When \fB\-gray\fP is selected, \fIgnuplot\fP honors
170: the following resources for grayscale or color displays (shown here with
171: default values). Note that the default background is black.
172: .sp
173: .B "gnuplot*background: black"
174: .br
175: .B "gnuplot*textGray: white"
176: .br
177: .B "gnuplot*borderGray: gray50"
178: .br
179: .B "gnuplot*axisGray: gray50"
180: .br
181: .B "gnuplot*line1Gray: gray100"
182: .br
183: .B "gnuplot*line2Gray: gray60"
184: .br
185: .B "gnuplot*line3Gray: gray80"
186: .br
187: .B "gnuplot*line4Gray: gray40"
188: .br
189: .B "gnuplot*line5Gray: gray90"
190: .br
191: .B "gnuplot*line6Gray: gray50"
192: .br
193: .B "gnuplot*line7Gray: gray70"
194: .br
195: .B "gnuplot*line8Gray: gray30"
196: .br
197:
198: \fIGnuplot\fP honors the following resources for setting the width in
199: pixels of plot lines (shown here with default values.) 0 or 1 means
200: a minimal width line of 1 pixel width. A value of 2 or 3 may
201: improve the appearance of some plots.
202: .sp
203: .br
204: .B "gnuplot*borderWidth: 2"
205: .br
206: .B "gnuplot*axisWidth: 0"
207: .br
208: .B "gnuplot*line1Width: 0"
209: .br
210: .B "gnuplot*line2Width: 0"
211: .br
212: .B "gnuplot*line3Width: 0"
213: .br
214: .B "gnuplot*line4Width: 0"
215: .br
216: .B "gnuplot*line5Width: 0"
217: .br
218: .B "gnuplot*line6Width: 0"
219: .br
220: .B "gnuplot*line7Width: 0"
221: .br
222: .B "gnuplot*line8Width: 0"
223: .br
224:
225: \fIGnuplot\fP honors the following resources for setting the dash style
226: used for plotting lines. 0 means a solid line. A 2 digit number \fIjk\fR
227: (\fIj\fP and \fIk\fP are >= 1 and <= 9) means a dashed line with a
228: repeated pattern of \fIj\fR pixels on followed by \fIk\fR pixels off.
229: For example, '16' is a "dotted" line with 1 pixel on followed by 6 pixels
230: off. More elaborate on/off patterns can be specified with a 4 digit value.
231: For example, '4441' is 4 on, 4 off, 4 on, 1 off. The default values shown
232: below are for monochrome displays or monochrome rendering on color or
233: grayscale displays. For color displays, the defaults for all are 0
234: (solid line) except for \fBaxisDashes\fR which defaults to a '16' dotted
235: line.
236: .sp
237: .br
238: .B "gnuplot*borderDashes: 0"
239: .br
240: .B "gnuplot*axisDashes: 16"
241: .br
242: .B "gnuplot*line1Dashes: 0"
243: .br
244: .B "gnuplot*line2Dashes: 42"
245: .br
246: .B "gnuplot*line3Dashes: 13"
247: .br
248: .B "gnuplot*line4Dashes: 44"
249: .br
250: .B "gnuplot*line5Dashes: 15"
251: .br
252: .B "gnuplot*line6Dashes: 4441"
253: .br
254: .B "gnuplot*line7Dashes: 42"
255: .br
256: .B "gnuplot*line8Dashes: 13"
257: .br
258: .PP
259: The size or aspect ratio of a plot may be changed by resizing the
260: .I gnuplot
261: window.
262: .SH AUTHORS
263: Thomas Williams, Pixar Corporation,
264: .br
265: (info-gnuplot@dartmouth.edu)
266: .br
267: and Colin Kelley.
268: .PP
269: Additions for labelling by Russell Lang, Monash University, Australia.
270: .br
271: (rjl@monu1.cc.monash.edu.au)
272: .br
273: Further additions by David Kotz, Dartmouth College, New Hampshire, USA
274: (formerly of Duke University, North Carolina, USA).
275: .br
276: (David.Kotz@Dartmouth.edu)
277: .SH BUGS
278: The atan() function does not work correctly for complex arguments.
279: .br
280: The bessel functions do not work for complex arguments.
281: .br
282: See the
283: .I help bugs
284: command in gnuplot.
285: .SH SEE ALSO
286: See the printed manual or the on-line help for details on specific commands.
287: .br
288: X(1).
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>