Annotation of OpenXM_contrib/gnuplot/docs/gnuplot.1, Revision 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>