git.maemo.org Git - gnuplot/blob - man/gnuplot.1

   1 .\" dummy line
   2 .TH GNUPLOT 1 "03 January 2001"
   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 for many output devices and file formats
  37 .PP
  38 Shell escapes and command line substitution.
  39 .PP
  40 Load and save capability.
  41 .PP
  42 Output redirection.
  43 .PP
  44 All computations performed in the complex domain.  Just the real part is
  45 plotted by default, but functions like imag() and abs() and arg() are
  46 available to override this.
  47 .SH X11 OPTIONS
  48 .I Gnuplot
  49 provides the \fIx11\fP terminal type for use
  50 with X servers. This terminal type is set automatically at startup if
  51 the \fBDISPLAY\fR environment variable is set, if the \fBTERM\fR environment
  52 variable is set to \fBxterm\fR, or if the \fB\-display\fR command line
  53 option is used.
  54 For terminal type \fIx11\fR, \fIgnuplot\fP
  55 accepts the standard X Toolkit options and resources such as geometry, font,
  56 and background. See the X(1) man page for a description of
  57 the options.
  58 In addition to the X Toolkit options:
  59 .PP
  60 \fB\-clear\fP requests that the window be cleared momentarily before a
  61 new plot is displayed.
  62 .PP
  63 \fB\-gray\fP requests grayscale rendering on grayscale or color displays.
  64 (Grayscale displays receive monochrome rendering by default.)
  65 .PP
  66 \fB\-mono\fP forces monochrome rendering on color displays.
  67 .PP
  68 \fB\-persist\fP lets plot windows survive after main gnuplot program exits.
  69 .PP
  70 \fB-raise\fP raises the plot window after each plot.
  71 .PP
  72 \fB-noraise\fp does not raise the plot window after each plot.
  73 .PP
  74 \fB\-tvtwm\fP requests that geometry specifications
  75 for position of the window be made relative to the currently displayed
  76 portion of the virtual root.
  77 .PP
  78 These options may also be controlled with resources in your \fB.Xdefaults\fR
  79 file.
  80 For example: \fBgnuplot*gray: on\fP .
  81 .PP
  82 \fIGnuplot\fP provides a command line option (\fB\-pointsize \fIv\fR) and
  83 a resource (\fBgnuplot*pointsize: \fIv\fR) to control the size of points
  84 plotted with the "points" plotting style. The value \fIv\fR is a real
  85 number (greater than 0 and less than or equal to ten) used as a
  86 scaling factor for point sizes. For example, \fB\-pointsize 2\fR uses
  87 points twice the default size, and \fB\-pointsize 0.5\fR uses points
  88 half the normal size.
  89 .PP
  90 For monochrome displays, \fIgnuplot\fR does not honor foreground or
  91 background colors. The default is black-on-white. \fB\-rv\fP or
  92 \fBgnuplot*reverseVideo: on\fP requests white-on-black.
  93 .PP
  94 For color displays \fIgnuplot\fP honors
  95 the following resources (shown here with default values). The values
  96 may be color names in the X11 rgb.txt file on your system, hexadecimal
  97 RGB color specifications (see X11 documentation), or a color name
  98 followed by a comma and an \fIintensity\fR value from 0 to 1. For example,
  99 \fBblue,.5\fR means a half intensity blue.
 100 .sp
 101 .B  "gnuplot*background: white"
 102 .br
 103 .B  "gnuplot*textColor: black"
 104 .br
 105 .B  "gnuplot*borderColor: black"
 106 .br
 107 .B  "gnuplot*axisColor: black"
 108 .br
 109 .B  "gnuplot*line1Color: red"
 110 .br
 111 .B  "gnuplot*line2Color: green"
 112 .br
 113 .B  "gnuplot*line3Color: blue"
 114 .br
 115 .B  "gnuplot*line4Color: magenta"
 116 .br
 117 .B  "gnuplot*line5Color: cyan"
 118 .br
 119 .B  "gnuplot*line6Color: sienna"
 120 .br
 121 .B  "gnuplot*line7Color: orange"
 122 .br
 123 .B  "gnuplot*line8Color: coral"
 124 .br
 125
 126 When \fB\-gray\fP is selected, \fIgnuplot\fP honors
 127 the following resources for grayscale or color displays (shown here with
 128 default values). Note that the default background is black.
 129 .sp
 130 .B  "gnuplot*background: black"
 131 .br
 132 .B  "gnuplot*textGray: white"
 133 .br
 134 .B  "gnuplot*borderGray: gray50"
 135 .br
 136 .B  "gnuplot*axisGray: gray50"
 137 .br
 138 .B  "gnuplot*line1Gray: gray100"
 139 .br
 140 .B  "gnuplot*line2Gray: gray60"
 141 .br
 142 .B  "gnuplot*line3Gray: gray80"
 143 .br
 144 .B  "gnuplot*line4Gray: gray40"
 145 .br
 146 .B  "gnuplot*line5Gray: gray90"
 147 .br
 148 .B  "gnuplot*line6Gray: gray50"
 149 .br
 150 .B  "gnuplot*line7Gray: gray70"
 151 .br
 152 .B  "gnuplot*line8Gray: gray30"
 153 .br
 154
 155 \fIGnuplot\fP honors the following resources for setting the width in
 156 pixels of plot lines (shown here with default values.) 0 or 1 means
 157 a minimal width line of 1 pixel width. A value of 2 or 3 may
 158 improve the  appearance of some plots.
 159 .sp
 160 .br
 161 .B  "gnuplot*borderWidth: 2"
 162 .br
 163 .B  "gnuplot*axisWidth: 0"
 164 .br
 165 .B  "gnuplot*line1Width: 0"
 166 .br
 167 .B  "gnuplot*line2Width: 0"
 168 .br
 169 .B  "gnuplot*line3Width: 0"
 170 .br
 171 .B  "gnuplot*line4Width: 0"
 172 .br
 173 .B  "gnuplot*line5Width: 0"
 174 .br
 175 .B  "gnuplot*line6Width: 0"
 176 .br
 177 .B  "gnuplot*line7Width: 0"
 178 .br
 179 .B  "gnuplot*line8Width: 0"
 180 .br
 181
 182 \fIGnuplot\fP honors the following resources for setting the dash style
 183 used for plotting lines.  0 means a solid line. A 2 digit number \fIjk\fR
 184 (\fIj\fP and \fIk\fP are >= 1  and <= 9) means a dashed line with a
 185 repeated pattern of \fIj\fR pixels on followed by \fIk\fR pixels off.
 186 For example, '16' is a "dotted" line with 1 pixel on followed by 6 pixels
 187 off.  More elaborate on/off patterns can be specified with a 4 digit value.
 188 For example, '4441' is 4 on, 4 off, 4 on, 1 off. The default values shown
 189 below are for monochrome displays or monochrome rendering on color or
 190 grayscale displays. For color displays, the defaults for all are 0
 191 (solid line) except for \fBaxisDashes\fR which defaults to a '16' dotted
 192 line.
 193 .sp
 194 .br
 195 .B  "gnuplot*borderDashes: 0"
 196 .br
 197 .B  "gnuplot*axisDashes: 16"
 198 .br
 199 .B  "gnuplot*line1Dashes: 0"
 200 .br
 201 .B  "gnuplot*line2Dashes: 42"
 202 .br
 203 .B  "gnuplot*line3Dashes: 13"
 204 .br
 205 .B  "gnuplot*line4Dashes: 44"
 206 .br
 207 .B  "gnuplot*line5Dashes: 15"
 208 .br
 209 .B  "gnuplot*line6Dashes: 4441"
 210 .br
 211 .B  "gnuplot*line7Dashes: 42"
 212 .br
 213 .B  "gnuplot*line8Dashes: 13"
 214 .br
 215 .PP
 216 The size or aspect ratio of a plot may be changed by resizing the
 217 .I gnuplot
 218 window.
 219 .SH AUTHORS
 220 Thomas Williams, Pixar Corporation,
 221 .br
 222 (gnuplot-info@lists.sourceforge.net)
 223 .br
 224 and Colin Kelley.
 225 .PP
 226 Additions for labelling by Russell Lang, Monash University, Australia.
 227 .br
 228 (rjl@monu1.cc.monash.edu.au)
 229 .br
 230 Further additions by David Kotz, Dartmouth College, New Hampshire, USA
 231 (formerly of Duke University, North Carolina, USA).
 232 .br
 233 (David.Kotz@Dartmouth.edu)
 234 .SH BUGS
 235 See the
 236 .I help bugs
 237 command in gnuplot.
 238 .SH SEE ALSO
 239 See the printed manual or the on-line help for details on specific commands.
 240 .br
 241 X(1).