home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / print / gnuplt35 / gnuplot.gih < prev    next >
Text File  |  1993-10-17  |  123KB  |  3,278 lines

  1. ?
  2.  GNUPLOT is a command-driven interactive function plotting program.
  3.  
  4.  For help on any topic, type `help` followed by the name of the topic.
  5.  
  6.  The new GNUPLOT user should begin by reading the `introduction` topic
  7.  (type `help introduction`) and about the `plot` command (type `help plot`).
  8.  Additional help can be obtained from the USENET newsgroup
  9.  comp.graphics.gnuplot.
  10.  
  11. ?copyright
  12.       Copyright (C) 1986 - 1993   Thomas Williams, Colin Kelley
  13.  
  14.    Permission to use, copy, and distribute this software and its
  15.    documentation for any purpose with or without fee is hereby granted,
  16.    provided that the above copyright notice appear in all copies and
  17.    that both that copyright notice and this permission notice appear
  18.    in supporting documentation.
  19.  
  20.    Permission to modify the software is granted, but not the right to
  21.    distribute the modified code.  Modifications are to be distributed
  22.    as patches to released version.
  23.  
  24.    This software is provided "as is" without express or implied warranty.
  25.  
  26.  
  27.    AUTHORS
  28.  
  29.      Original Software:
  30.        Thomas Williams,  Colin Kelley.
  31.  
  32.      Gnuplot 2.0 additions:
  33.          Russell Lang, Dave Kotz, John Campbell.
  34.  
  35.      Gnuplot 3.0 additions:
  36.          Gershon Elber and many others.
  37.  
  38.    There is a mailing list for gnuplot users. Note, however, that the
  39.    newsgroup 
  40.          comp.graphics.gnuplot 
  41.    is identical to the mailing list (they
  42.    both carry the same set of messages). We prefer that you read the
  43.    messages through that newsgroup, to subscribing to the mailing list.
  44.    (If you can read that newsgroup, and are already on the mailing list,
  45.    please send a message info-gnuplot-request@dartmouth.edu, asking to be
  46.    removed from the mailing list.)
  47.  
  48.    The address for mailing to list members is
  49.          info-gnuplot@dartmouth.edu
  50.    and for mailing administrative requests is 
  51.          info-gnuplot-request@dartmouth.edu
  52.    The mailing list for bug reports is 
  53.          bug-gnuplot@dartmouth.edu
  54.    The list of those interested in beta-test versions is
  55.          info-gnuplot-beta@dartmouth.edu
  56.  
  57. ?introduction
  58.  GNUPLOT is a command-driven interactive function plotting program.
  59.  It is case sensitive (commands and function names written in lowercase
  60.  are not the same as those written in CAPS). All command names may be
  61.  abbreviated, as long as the abbreviation is not ambiguous. Any number
  62.  of commands may appear on a line, separated by semicolons (;).
  63.  Strings are indicated with quotes.  They may be either single or double
  64.  quotation marks, e.g.,
  65.  
  66.           load "filename"
  67.           cd 'dir'
  68.  
  69.  Any command-line arguments are assumed to be names of files containing
  70.  GNUPLOT commands, with the exception of standard X11 arguments, which
  71.  are processed first. Each file is loaded with the `load` command, in the
  72.  order specified. GNUPLOT exits after the last file is processed.  When
  73.  no load files are named, gnuplot enters into an interactive mode.
  74.  
  75.  Commands may extend over several input lines, by ending each
  76.  line but the last with a backslash (\). The backslash must be the LAST
  77.  character on each line. The effect is as if the backslash and newline
  78.  were not there. That is, no white space is implied, nor is a comment
  79.  terminated. Therefore, commenting out a continued line comments out
  80.  the entire command (see `comment`).
  81.  
  82.  In this documentation, curly braces ({}) denote optional arguments to
  83.  many commands, and a vertical bar (|) separates mutually exclusive
  84.  choices.  GNUPLOT keywords or help topics are indicated by backquotes
  85.  or `boldface` (where available).  Angle brackets (<>) are used to mark
  86.  replaceable tokens.
  87.  
  88.  For help on any topic, type `help` followed by the name of the topic.
  89.  
  90.  The new GNUPLOT user should begin by reading about the `plot`
  91.  command (type `help plot`).
  92. ?cd
  93.  The `cd` command changes the working directory.
  94.  
  95.  Syntax:
  96.          cd "<directory-name>"
  97.  
  98.  The directory name must be enclosed in quotes.
  99.  
  100.  Examples:
  101.          cd 'subdir'
  102.          cd ".."
  103. ?clear
  104.  The `clear` command erases the current screen or output device as
  105.  specified by `set output`. This usually generates a formfeed on
  106.  hardcopy devices. Use `set terminal` to set the device type.
  107. ?line-editing
  108. ?editing
  109. ?history
  110. ?command line-editing
  111.  The Unix, Atari, VMS, MS-DOS and OS/2 versions of GNUPLOT support command
  112.  line-editing.  Also, a history mechanism allows previous commands to be
  113.  edited, and re-executed. After the command line has been edited, a newline
  114.  or carriage return will enter the entire line regardless of where the
  115.  cursor is positioned.
  116.  
  117.  The editing commands are as follows:
  118.  
  119.   `Line-editing`:
  120.  
  121.   ^B moves back a single character.
  122.   ^F moves forward a single character.
  123.   ^A moves to the beginning of the line.
  124.   ^E moves to the end of the line.
  125.   ^H and DEL delete the previous character.
  126.   ^D deletes the current character.
  127.   ^K deletes from current position to the end of line.
  128.   ^L,^R redraws line in case it gets trashed.
  129.   ^U deletes the entire line.
  130.   ^W deletes the last word.
  131.  
  132.   `History`:
  133.  
  134.   ^P moves back through history.
  135.   ^N moves forward through history.
  136.  
  137.  On the IBM PC the use of a TSR program such as DOSEDIT or CED may be
  138.  desired for line editing. For such a case GNUPLOT may be compiled with
  139.  no line editing capability (default makefile setup). Set READLINE in the
  140.  makefile and add readline.obj to the link file if GNUPLOT line editing
  141.  is to be used for the IBM PC. The following arrow keys may be used
  142.  on the IBM PC and Atari versions if readline is used:
  143.  
  144.   Left  Arrow     - same as ^B.
  145.   Right Arrow     - same as ^F.
  146.   Ctl Left  Arrow - same as ^A.
  147.   Ctl Right Arrow - same as ^E.
  148.   Up    Arrow     - same as ^P.
  149.   Down  Arrow     - same as ^N.
  150.  
  151.  The Atari version of readline defines some additional key aliases:
  152.  
  153.   Undo            - same as ^L.
  154.   Home            - same as ^A.
  155.   Ctrl Home       - same as ^E.
  156.   ESC             - same as ^U.
  157.   Help            - `help' plus return.
  158.   Ctrl Help       - `help '.
  159.  
  160.  (The readline function in gnuplot is not the same as the readline used
  161.  in GNU BASH and GNU EMACS.  It is somewhat compatible however.)
  162. ?comments
  163.  Comments are supported as follows: a # may appear in most places in a line
  164.  and GNUPLOT will ignore the rest of the line. It will not have this
  165.  effect inside quotes, inside numbers (including complex numbers), inside
  166.  command substitutions, etc. In short, it works anywhere it makes sense
  167.  to work.
  168. ?environment
  169.  A number of shell environment variables are understood by GNUPLOT.
  170.  None of these are required, but may be useful.
  171.  
  172.  If GNUTERM is defined, it is used as the name of the terminal type to
  173.  be used. This overrides any terminal type sensed by GNUPLOT on start
  174.  up, but is itself overridden by the .gnuplot (or equivalent) start-up
  175.  file (see `start-up`), and of course by later explicit changes.
  176.  
  177.  On Unix, AmigaDOS, AtariTOS, MS-DOS and OS/2, GNUHELP may be defined
  178.  to be the pathname of the HELP file (gnuplot.gih).
  179.  
  180.  On VMS, the symbol GNUPLOT$HELP should be defined as the name of
  181.  the help library for GNUPLOT.
  182.  
  183.  On Unix, HOME is used as the name of a directory to search for
  184.  a .gnuplot file if none is found in the current directory.
  185.  On AmigaDOS, AtariTOS, MS-DOS and OS/2, GNUPLOT is used. On VMS, SYS$LOGIN:
  186.  is used. See `help start-up`.
  187.  
  188.  On Unix, PAGER is used as an output filter for help messages.
  189.  
  190.  On Unix, AtariTOS and AmigaDOS, SHELL is used for the `shell` command.
  191.  On MS-DOS and OS/2, COMSPEC is used for the `shell` command.
  192.  
  193.  On AmigaDOS, GNUFONT is used for the screen font.  For example:
  194.  "setenv GNUFONT sapphire/14".
  195.  
  196.  On MS-DOS, if the BGI interface is used, the variable `BGI` is used to point
  197.  to the full path of the BGI drivers directory. Furthermore SVGA is used to
  198.  name the Super VGA BGI driver in 800x600 res., and its mode of operation
  199.  as 'Name.Mode'.
  200.  E.g., if the Super VGA driver is C:\TC\BGI\SVGADRV.BGI and mode 3 is
  201.  used for 800x600 res., then: 'set BGI=C:\TC\BGI' and 'set SVGA=SVGADRV.3'.
  202. ?exit
  203. ?quit
  204.  The commands `exit` and `quit` and the END-OF-FILE character
  205.  will exit GNUPLOT. All these commands will clear the output device
  206.  (as the `clear` command does) before exiting.
  207. ?expressions
  208.  In general, any mathematical expression accepted by C, FORTRAN,
  209.  Pascal, or BASIC is valid. The precedence of these operators is
  210.  determined by the specifications of the C programming language.
  211.  White space (spaces and tabs) is ignored inside expressions.
  212.  
  213.  Complex constants may be expressed as the {<real>,<imag>}, where <real>
  214.  and <imag> must be numerical constants. For example, {3,2}
  215.  represents 3 + 2i; {0,1} represents `i` itself. The curly braces
  216.  are explicitly required here.
  217. ?expressions functions
  218. ?functions
  219.  The functions in GNUPLOT are the same as the corresponding functions
  220.  in the Unix math library, except that all functions accept integer,
  221.  real, and complex arguments, unless otherwise noted. The `sgn`
  222.  function is also supported, as in BASIC.
  223. ?expressions functions abs
  224. ?functions abs
  225. ?abs
  226.  The `abs` function returns the absolute value of its argument. The
  227.  returned value is of the same type as the argument.
  228.  
  229.  For complex arguments, abs(x) is defined as the length of x in the
  230.  complex plane [i.e.,  sqrt(real(x)**2 + imag(x)**2) ].
  231. ?expressions functions acos
  232. ?functions acos
  233. ?acos
  234.  The `acos` function returns the arc cosine (inverse cosine) of its
  235.  argument. `acos` returns its argument in radians.
  236. ?expressions functions arg
  237. ?functions arg
  238. ?arg
  239.  The `arg` function returns the phase of a complex number, in radians.
  240. ?expressions functions asin
  241. ?functions asin
  242. ?asin
  243.  The `asin` function returns the arc sin (inverse sin) of its argument.
  244.  `asin` returns its argument in radians.
  245. ?expressions functions atan
  246. ?functions atan
  247. ?atan
  248.  The `atan` function returns the arc tangent (inverse tangent) of its
  249.  argument. `atan` returns its argument in radians.
  250. ?expressions functions besj0
  251. ?functions besj0
  252. ?besj0
  253.  The `besj0` function returns the j0th Bessel function of its argument.
  254.  `besj0` expects its argument to be in radians.
  255. ?expressions functions besj1
  256. ?functions besj1
  257. ?besj1
  258.  The `besj1` function returns the j1st Bessel function of its argument.
  259.  `besj1` expects its argument to be in radians.
  260. ?expressions functions besy0
  261. ?functions besy0
  262. ?besy0
  263.  The `besy0` function returns the y0th Bessel function of its argument.
  264.  `besy0` expects its argument to be in radians.
  265. ?expressions functions besy1
  266. ?functions besy1
  267. ?besy1
  268.  The `besy1` function returns the y1st Bessel function of its argument.
  269.  `besy1` expects its argument to be in radians.
  270. ?expressions functions ceil
  271. ?functions ceil
  272. ?ceil
  273.  The `ceil` function returns the smallest integer that is not less than its
  274.  argument. For complex numbers, `ceil` returns the smallest integer
  275.  not less than the real part of its argument.
  276. ?expressions functions cos
  277. ?functions cos
  278. ?cos
  279.  The `cos` function returns the cosine of its argument. `cos` expects its
  280.  argument to be in radians.
  281. ?expressions functions cosh
  282. ?functions cosh
  283. ?cosh
  284.  The `cosh` function returns the hyperbolic cosine of its argument.
  285.  `cosh` expects its argument to be in radians.
  286. ?expressions functions erf
  287. ?functions erf
  288. ?erf
  289.  The `erf` function returns the error function of the real part of
  290.  its argument.
  291.  If the argument is a complex value, the imaginary component is ignored.
  292. ?expressions functions erfc
  293. ?functions erfc
  294. ?erfc
  295.  The `erfc` function returns 1.0 - the error function of the
  296.  real part of its argument.
  297.  If the argument is a complex value, the imaginary component is ignored.
  298. ?expressions functions exp
  299. ?functions exp
  300. ?exp
  301.  The `exp` function returns the exponential function of its argument
  302.  (`e` raised to the power of its argument).
  303. ?expressions functions floor
  304. ?functions floor
  305. ?floor
  306.  The `floor` function returns the largest integer not greater than its
  307.  argument. For complex numbers, `floor` returns the largest
  308.  integer not greater than the real part of its argument.
  309. ?expressions functions gamma
  310. ?functions gamma
  311. ?gamma
  312.  The `gamma` function returns the gamma function of the real part of
  313.  its argument. For integer n, gamma(n+1) = n! .
  314.  If the argument is a complex value, the imaginary component is ignored.
  315. ?expressions functions ibeta
  316. ?functions ibeta
  317. ?ibeta
  318.  The `ibeta` function returns the incomplete beta function of the real
  319.  parts of its arguments. p, q > 0 and x in [0:1]
  320.  If the arguments are complex, the imaginary components are ignored.
  321. ?expressions functions inverf
  322. ?functions inverf
  323. ?inverf
  324.  The `inverf` function returns the inverse error function of the real
  325.  part of its argument.
  326. ?expressions functions igamma
  327. ?functions igamma
  328. ?igamma
  329.  The `igamma` function returns the incomplete gamma function of the real
  330.  parts of its arguments. a > 0 and x >= 0
  331.  If the arguments are complex, the imaginary components are ignored.
  332. ?expressions functions imag
  333. ?functions imag
  334. ?imag
  335.  The `imag` function returns the imaginary part of its argument as a
  336.  real number.
  337. ?expressions functions invnorm
  338. ?functions invnorm
  339. ?invnorm
  340.  The `invnorm` function returns the inverse normal distribution function
  341.  of the real part of its argument.
  342. ?expressions functions int
  343. ?functions int
  344. ?int
  345.  The `int` function returns the integer part of its argument, truncated
  346.  toward zero.
  347. ?expressions functions lgamma
  348. ?functions lgamma
  349. ?lgamma
  350.  The `lgamma` function returns the natural logarithm of the gamma
  351.  function of the real part of its argument.
  352.  If the argument is a complex value, the imaginary component is ignored.
  353. ?expressions functions log
  354. ?functions log
  355. ?log
  356.  The `log` function returns the natural logarithm (base `e`) of its
  357.  argument.
  358. ?expressions functions log10
  359. ?functions log10
  360. ?log10
  361.  The `log10` function returns the logarithm (base 10) of its argument.
  362. ?expressions functions norm
  363. ?functions norm
  364. ?norm
  365.  The `norm` function returns the normal distribution function
  366.  (or Gaussian) of the real part of its argument.
  367. ?expressions functions rand
  368. ?functions rand
  369. ?rand
  370.  The `rand` function returns a pseudo random number in the interval [0:1]
  371.  using the real part of its argument as a seed. If seed < 0 the sequence
  372.  is (re)initialized.
  373.  If the argument is a complex value, the imaginary component is ignored.
  374. ?expressions functions real
  375. ?functions real
  376. ?real
  377.  The `real` function returns the real part of its argument.
  378. ?expressions functions sgn
  379. ?functions sgn
  380. ?sgn
  381.  The `sgn` function returns 1 if its argument is positive, -1 if its
  382.  argument is negative, and 0 if its argument is 0. If the argument
  383.  is a complex value, the imaginary component is ignored.
  384. ?expressions functions sin
  385. ?functions sin
  386. ?sin
  387.  The `sin` function returns the sine of its argument. `sin` expects its
  388.  argument to be in radians.
  389. ?expressions functions sinh
  390. ?functions sinh
  391. ?sinh
  392.  The `sinh` function returns the hyperbolic sine of its argument. `sinh`
  393.  expects its argument to be in radians.
  394. ?expressions functions sqrt
  395. ?functions sqrt
  396. ?sqrt
  397.  The `sqrt` function returns the square root of its argument.
  398. ?expressions functions tan
  399. ?functions tan
  400. ?tan
  401.  The `tan` function returns the tangent of its argument. `tan` expects
  402.  its argument to be in radians.
  403. ?expressions functions tanh
  404. ?functions tanh
  405. ?tanh
  406.  The `tanh` function returns the hyperbolic tangent of its argument.
  407.  `tanh` expects its argument to be in radians.
  408. ?expressions operators
  409. ?operators
  410.  The operators in GNUPLOT are the same as the corresponding operators
  411.  in the C programming language, except that all operators accept
  412.  integer, real, and complex arguments, unless otherwise noted.
  413.  The ** operator (exponentiation) is supported, as in FORTRAN.
  414.  
  415.  Parentheses may be used to change order of evaluation.
  416. ?expressions operators binary
  417. ?operators binary
  418. ?binary
  419.  The following is a list of all the binary operators and their
  420.  usages:
  421.  
  422.   Symbol      Example      Explanation
  423.    **          a**b          exponentiation
  424.    *           a*b           multiplication
  425.    /           a/b           division
  426.    %           a%b         * modulo
  427.    +           a+b           addition
  428.    -           a-b           subtraction
  429.    ==          a==b          equality
  430.    !=          a!=b          inequality
  431.    &           a&b         * bitwise AND
  432.    ^           a^b         * bitwise exclusive OR
  433.    |           a|b         * bitwise inclusive OR
  434.    &&          a&&b        * logical AND
  435.    ||          a||b        * logical OR
  436.    ?:          a?b:c       * ternary operation
  437.  
  438.  (*) Starred explanations indicate that the operator requires
  439.  integer arguments.
  440.  
  441.  Logical AND (&&) and OR (||) short-circuit the way they do in C.
  442.  That is, the second && operand is not evaluated if the first is
  443.  false; the second || operand is not evaluated if the first is true.
  444.  
  445.  The ternary operator evaluates its first argument (a). If it is
  446.  true (non-zero) the second argument (b) is evaluated and returned,
  447.  otherwise the third argument (c) is evaluated and returned.
  448. ?expressions operators unary
  449. ?operators unary
  450. ?unary
  451.  The following is a list of all the unary operators and their
  452.  usages:
  453.  
  454.   Symbol     Example      Explanation
  455.    -           -a          unary minus
  456.    ~           ~a        * one's complement
  457.    !           !a        * logical negation
  458.    !           a!        * factorial
  459.  
  460.  (*) Starred explanations indicate that the operator requires an
  461.  integer argument.
  462.  
  463.  The factorial operator returns a real number to allow a greater range.
  464. ?help
  465.  The `help` command displays on-line help. To specify information on a
  466.  particular topic use the syntax:
  467.  
  468.          help {<topic>}
  469.  
  470.  If <topic> is not specified, a short message is printed about
  471.  GNUPLOT. After help for the requested topic is given, help for a
  472.  subtopic may be requested by typing its name, extending the help
  473.  request. After that subtopic has been printed, the request may be
  474.  extended again, or simply pressing return goes back one level to the
  475.  previous topic. Eventually, the GNUPLOT command line will return.
  476. ?load
  477.  The `load` command executes each line of the specified input file as
  478.  if it had been typed in interactively. Files created by the `save`
  479.  command can later be `load`ed. Any text file containing valid
  480.  commands can be created and then executed by the `load` command.
  481.  Files being `load`ed may themselves contain `load` commands. See
  482.  `comment` for information about comments in commands.
  483.  
  484.  The `load` command must be the last command on the line.
  485.  
  486.  Syntax:
  487.          load "<input-file>"
  488.  
  489.  The name of the input file must be enclosed in quotes.
  490.  
  491.  Examples:
  492.  
  493.          load 'work.gnu'
  494.          load "func.dat"
  495.  
  496.  The `load` command is performed implicitly on any file names given as
  497.  arguments to GNUPLOT. These are loaded in the order specified, and
  498.  then GNUPLOT exits.
  499. ?pause
  500.  The `pause` command displays any text associated with the command and
  501.  then waits a specified amount of time or until the carriage return is
  502.  pressed.  `pause` is especially useful in conjunction with `load` files.
  503.  
  504.  Syntax:
  505.          pause <time> {"<string>"}
  506.  
  507.  <time> may be any integer constant or expression. Choosing -1 will
  508.  wait until a carriage return is hit, zero (0) won't pause at all, and
  509.  a positive integer will wait the specified number of seconds.
  510.  
  511.  Note: Since `pause` is not part of the plot it may interact with
  512.  different device drivers differently (depending upon how text and
  513.  graphics are mixed).
  514.  
  515.  Examples:
  516.          pause -1    # Wait until a carriage return is hit
  517.          pause 3     # Wait three seconds
  518.          pause -1  "Hit return to continue"
  519.          pause 10  "Isn't this pretty?  It's a cubic-spline."
  520.  
  521. ?plot
  522. ?splot
  523.  `plot` and `splot` are the primary commands of the program. They plot
  524.  functions and data in many, many ways. `plot` is used to plot 2-d
  525.  functions and data, while `splot` plots 3-d surfaces and data.
  526.  
  527.  Syntax:
  528.  
  529.         plot {ranges} {<function> | {"<datafile>" {using ...}}}
  530.                      {title} {style} {, <function> {title} {style}...}
  531.  
  532.         splot {ranges} {<function> | {"<datafile>" {index i} {using ...}}}
  533.                      {title} {style} {, <function> {title} {style}...}
  534.  
  535.  where either a <function> or the name of a data file enclosed in quotes is
  536.  supplied.  A function is a mathematical expression, or a pair (`plot`) or
  537.  triple (`splot`) of mathematical expressions in the case of parametric
  538.  functions.  User-defined functions and variables may also be defined here.
  539.  
  540.  `plot` and `splot` commands can be as simple as
  541.  
  542.          plot sin(x)
  543.  
  544.  and
  545.  
  546.          splot x * y
  547.  
  548.  or as complex as (!)
  549.  
  550.   plot [t=1:10] [-pi:pi*2] tan(t), "data.1" using 2:3 with lines,
  551.         t**2 with points
  552. ?plot data-file
  553. ?plot datafile
  554. ?splot data-file
  555. ?splot datafile
  556. ?data-file
  557. ?datafile
  558. ?data
  559.  Discrete data contained in a file can be displayed by specifying the
  560.  name of the data file (enclosed in quotes) on the `plot` or `splot`
  561.  command line. Data files should contain one data point per line.
  562.  Lines beginning with # (or ! on VMS) will be treated as comments
  563.  and ignored. For `plot`s, each data point represents an (x,y)
  564.  pair. For `splot`s, each point is an (x,y,z) triple. For `plot`s with
  565.  error bars (see `plot errorbars`), each data point is either
  566.  (x,y,ydelta) or (x,y,ylow,yhigh). In all cases, the numbers on each
  567.  line of a data file must be separated by blank space. This blank
  568.  space divides each line into columns.
  569.  
  570.  For `plot`s the x value may be omitted, and for `splot`s the x
  571.  and y values may be omitted. In either case the omitted values are
  572.  assigned the current coordinate number. Coordinate numbers start at 0
  573.  and are incremented for each data point read.
  574.  
  575.  To specify other formats, see `plot datafile using`.
  576.  
  577.  In the `plot` command, blank lines in the data file cause a break in
  578.  the plot. There will be no line drawn between the preceding and
  579.  following points if the plot style is `lines` or `linespoints` (see
  580.  `plot style`). This does not change the plot style, as would plotting
  581.  the data as separate curves.
  582.  
  583.  This example compares the data in the file population.dat to a
  584.  theoretical curve:
  585.  
  586.          pop(x) = 103*exp((1965-x)/10)
  587.          plot [1960:1990] 'population.dat', pop(x)
  588.  
  589.  The file population.dat might contain:
  590.  
  591.          # Gnu population in Antarctica since 1965
  592.          1965   103
  593.          1970   55
  594.          1975   34
  595.          1980   24
  596.          1985   10
  597.  
  598.  When a data file is plotted, `samples` and `isosamples` are ignored.
  599.  Curves plotted using the `plot` command are automatically extended to
  600.  hold the entire curve. Similarly grid data plotted using the `splot`
  601.  command is automatically extended, using the assumption that isolines
  602.  are separated by blank lines (a line with only a CR/LF in it).
  603.  
  604.  Implicitly, there are two types of 3-d datafiles. If all the isolines
  605.  are of the same length, the data is assumed to be a grid data, i.e.,
  606.  the data has a grid topology. Cross isolines in the other parametric
  607.  direction (the ith cross isoline passes through the ith point of all the
  608.  provided isolines) will also be drawn for grid data. (Note contouring
  609.  is available for grid data only.) If all the isolines are not of the
  610.  same length, no cross isolines will be drawn and contouring that data
  611.  is impossible.
  612.  
  613.  For splot, data files may contain more than one mesh and by default
  614.  all meshes are plotted. Meshes are separated from each other, in the
  615.  file, by double blank lines. To control and splot a single mesh from
  616.  a multi mesh file, use the index modifier. See `splot index` for more.
  617.  
  618.  For splot if 3-d datafile and using format (see `splot datafile using`)
  619.  specify only z (height field), a non parametric mode must be specified.
  620.  If, on the other hand, x, y, and z are all specified, a parametric
  621.  mode should be selected (see `set parametric`) since data is defining a
  622.  parametric surface.
  623.  
  624.  A simple example of plotting a 3-d data file is
  625.  
  626.          set parametric
  627.          splot 'glass.dat'
  628.  
  629.  or
  630.  
  631.          set noparametric
  632.          splot 'datafile.dat'
  633.  
  634.  where the file datafile.dat might contain:
  635.  
  636.          # The valley of the Gnu.
  637.          10
  638.          10
  639.          10
  640.  
  641.          10
  642.          5
  643.          10
  644.  
  645.          10
  646.          1
  647.          10
  648.  
  649.          10
  650.          0
  651.          10
  652.  
  653.  Note datafile.dat defines a 4 by 3 grid ( 4 rows of 3 points each ).
  654.  Rows are separated by blank lines.
  655.  
  656.  On some computer systems with a popen function (UNIX), the datafile
  657.  can be piped through a shell command by starting the file name
  658.  with a '<'.  For example:
  659.  
  660.          pop(x) = 103*exp(-x/10)
  661.          plot '< awk "{print $1-1965, $2}" population.dat', pop(x)
  662.  
  663.  would plot the same information as the first population example
  664.  but with years since 1965 as the x axis.  If you want to execute
  665.  this example, you have to delete all comments from the data file
  666.  above or substitute the following command for the first part of the
  667.  command above (the part up to the comma):
  668.  
  669.          plot '< awk "$0 !~ /^#/ {print $1-1965, $2}" population.dat'
  670.  
  671.  It is also possible to apply a single function to the "y" value only,
  672.  e.g.
  673.  
  674.          plot 'population.dat' thru p(x)
  675.  
  676.  For more information about 3-d plotting, see `splot`.
  677. ?plot data-file using
  678. ?plot datafile using
  679. ?splot data-file using
  680. ?splot datafile using
  681. ?using
  682.  The format of data within a file can be selected with the `using`
  683.  option. An explicit scanf string can be used, or simpler column
  684.  choices can be made.
  685.  
  686.  Syntax:
  687.  
  688.          plot "datafile" { using { <ycol> |
  689.                                    <xcol>:<ycol> |
  690.                                    <xcol>:<ycol>:<ydelta> |
  691.                                    <xcol>:<ycol>:<ylow>:<yhigh> |
  692.                                    <xcol>:<ycol>:<ylow>:<yhigh>:<boxwidth> }
  693.                                  {"<scanf string>"} } ...
  694.  
  695.  and
  696.  
  697.          splot "datafile" { using { <xcol>:<ycol>:<zcol> | <zcol> }
  698.                                   {"<scanf string>"} } ...
  699.  
  700.  <xcol>, <ycol>, and <zcol> explicitly select the columns to plot from
  701.  a space or tab separated multicolumn data file. If only <ycol> is
  702.  selected for `plot`, <xcol> defaults to 1. If only <zcol> is selected
  703.  for `splot`, then only that column is read from the file. An <xcol> of
  704.  0 forces <ycol> to be plotted versus its coordinate number. <xcol>,
  705.  <ycol>, and <zcol> can be entered as constants or expressions.
  706.  
  707.  If errorbars (see also `plot errorbars`) are used for `plot`s,
  708.  ydelta (for example, a +/- error) should be provided as the third
  709.  column, or ylow and yhigh as third and fourth columns.
  710.  
  711.  If boxes or boxerrorbars are used for `plot`s, a fifth column to
  712.  specify the width of the box may be given.  This implies that columns
  713.  three and four must also be provided even if they are not used.
  714.  If you want to plot boxes from a data file with three columns,
  715.  set ylow and yhigh to y using the following command:
  716.          plot "datafile" using 1:2:2:2:3 with boxes
  717.  
  718.  Scanf strings override any <xcol>:<ycol>(:<zcol>) choices, except for
  719.  ordering of input, e.g.,
  720.          plot "datafile" using 2:1 "%f%*f%f"
  721.  causes the first column to be y and the third column to be x.
  722.  
  723.  If the scanf string is omitted, the default is generated based on the
  724.  <xcol>:<ycol>(:<zcol>) choices. If the `using` option is omitted, "%f%f"
  725.  is used for `plot` ("%f%f%f%f" for `errorbars` `plot`s) and "%f%f%f" is
  726.  used for `splot`.
  727.  
  728.  Examples:
  729.  
  730.          plot "MyData" using "%*f%f%*20[^\n]%f" with lines
  731.  
  732.  Data are read from the file "MyData" using the format
  733.  "%*f%f%*20[^\n]%f". The meaning of this format is: "%*f" ignore the
  734.  first number, "%f" then read in the second and assign to x,
  735.  "%*20[^\n]" then ignore 20 non-newline characters, "%f" then read in
  736.  the y value.
  737.  
  738.          n=3;
  739.          plot "MyData", "MyData" using n
  740.  
  741.  causes GNUPLOT to plot the second and third columns of MyData versus
  742.  the first column. The command 'n=4; replot' would then plot the second
  743.  and fourth columns of MyData versus the first column.
  744.  
  745.          splot "glass.dat" using 1
  746.  
  747.  causes GNUPLOT to plot the first coordinate of the points of glass.dat
  748.  as the z coordinate while ignoring the other two coordinates.
  749.  
  750.  Note: GNUPLOT first reads a line of the data file into a buffer and
  751.  then does a
  752.          sscanf(input_buffer, scanf_string, &x, &y{, &z});
  753.  where 'x', 'y', and 'z' are of type 'float'. Any scanf string that
  754.  specifies two (three for `splot`, three or four for `errorbars`) float
  755.  numbers may be used.
  756. ?plot errorbars
  757. ?errorbars
  758.  Error bars are supported for 2-d data file plots by reading one or
  759.  two additional columns specifying ydelta or ylow and yhigh
  760.  respectively. No support exists for x error bars or any error bars
  761.  for `splot`s.
  762.  
  763.  In the default situation, GNUPLOT expects to see three or four
  764.  numbers on each line of the data file, either (x, y, ydelta) or
  765.  (x, y, ylow, yhigh). The x coordinate must be specified. The order
  766.  of the numbers must be exactly as given above. Data files in this
  767.  format can easily be plotted with error bars:
  768.  
  769.          plot "data.dat" with errorbars
  770.  
  771.  The error bar is a vertical line plotted from (x, ylow) to (x,
  772.  yhigh). If ydelta is specified instead of ylow and yhigh,
  773.  ylow=y-ydelta and yhigh=y+ydelta are derived. If there
  774.  are only two numbers on the line, yhigh and ylow are both set to
  775.  y. To get lines plotted between the data points, `plot` the
  776.  data file twice, once with errorbars and once with lines.
  777.  
  778.  If y autoscaling is on, the y range will be adjusted to fit the
  779.  error bars.
  780.  
  781.  The `using` option may be used to specify how columns of the data file
  782.  are to be assigned to x, y, ydelta, ylow, and yhigh. The x column must
  783.  be provided and both the x and y columns must appear before the
  784.  errorbar columns. If three column numbers are given, they are x, y,
  785.  and ydelta. If four columns are given, they are x, y, ylow, and
  786.  yhigh.
  787.  
  788.  Examples:
  789.  
  790.          plot "data.dat" using 1:2:3:4 with errorbars
  791.          plot "data.dat" using 3:2:6 with errorbars
  792.          plot "data.dat" using 3:4:8:7 with errorbars
  793.  
  794.  The first example reads, x, y, ylow, and yhigh, from columns 1, 2, 3,
  795.  and 4. This is equivalent to the default.  The second example reads x
  796.  from the third column, y from second and ydelta from the sixth column.
  797.  The third example reads x from the third column, y from the fourth,
  798.  ylow from the eighth, and yhigh from seventh columns.
  799.  
  800.  See also `plot using` and `plot style`.
  801. ?plot parametric
  802. ?splot parametric
  803. ?parametric
  804.  When in parametric mode (`set parametric`) mathematical expressions must
  805.  be given in pairs for `plot` and in triplets for `splot`:
  806.          plot sin(t),t**2
  807.  or
  808.          splot cos(u)*cos(v),cos(u)*sin(v),sin(u)
  809.  
  810.  Data files are plotted as before, except any preceding parametric
  811.  function must be fully specified before a data file is given as a
  812.  plot. In other words, the x parametric function (sin(t) above) and
  813.  the y parametric function (t**2 above) must not be interrupted with
  814.  any modifiers or data functions; doing so will generate a syntax error
  815.  stating that the parametric function is not fully specified.
  816.  
  817.  Ranges take on a different meaning when in parametric mode. The first
  818.  range on the `plot` command is the `trange`, the next is the `xrange`,
  819.  and the last is the `yrange`. For `splot` the order is `urange`,
  820.  `vrange`, `xrange`, `yrange`, and finally `zrange`. The following
  821.  `plot` command shows setting the `trange` to [-pi:pi], the `xrange` to
  822.  [-1.3:1.3] and the `yrange` to [-1:1] for the duration of the plot:
  823.          plot [-pi:pi] [-1.3:1.3] [-1:1] sin(t),t**2
  824.  
  825.  Other modifiers, such as `with` and `title`, may be specified only
  826.  after the parametric function has been completed:
  827.          plot sin(t),t**2 title 'Parametric example' with linespoints
  828.  
  829.  
  830. ?splot ranges
  831. ?plot ranges
  832. ?ranges
  833.  The optional range specifies the region of the plot that will be
  834.  displayed.
  835.  
  836.  Ranges may be provided on the `plot` and `splot` command line and
  837.  affect only that plot, or in the `set xrange`, `set yrange`, etc.,
  838.  commands, to change the default ranges for future plots.
  839.  
  840.  Syntax:
  841.          [{<dummy-var> =} {<xmin> : <xmax>}] { [{<ymin> : <ymax>}] }
  842.  
  843.  where <dummy-var> is the independent variable (the defaults are x and
  844.  y, but this may be changed with `set dummy`) and the min and max
  845.  terms can be constant expressions.
  846.  
  847.  Both the min and max terms are optional. The ':' is also optional
  848.  if neither a min nor a max term is specified. This allows '[ ]' to
  849.  be used as a null range specification.
  850.  
  851.  Specifying a range in the `plot` command line turns autoscaling for
  852.  that axis off for that plot. Using one of the `set` range commands
  853.  turns autoscaling off for that axis for future plots, unless changed
  854.  later. (See `set autoscale`).
  855.  
  856.  Examples:
  857.  
  858.  This uses the current ranges:
  859.          plot cos(x)
  860.  
  861.  This sets the x range only:
  862.          plot [-10:30] sin(pi*x)/(pi*x)
  863.  
  864.  This is the same, but uses t as the dummy-variable:
  865.          plot [t = -10 :30]  sin(pi*t)/(pi*t)
  866.  
  867.  This sets both the x and y ranges:
  868.          plot [-pi:pi] [-3:3]  tan(x), 1/x
  869.  
  870.  This sets only the y range, and turns off autoscaling on both axes:
  871.          plot [ ] [-2:sin(5)*-8] sin(x)**besj0(x)
  872.  
  873.  This sets xmax and ymin only:
  874.          plot [:200] [-pi:]  exp(sin(x))
  875.  
  876.  This sets the x, y, and z ranges:
  877.          splot [0:3] [1:4] [-1:1] x*y
  878. ?splot index
  879. ?index
  880.  Splotting of multi mesh data files can be controlled via the index modifier.
  881.  A data file can contain more than one mesh, and in that case all meshes
  882.  in the file will be splotted by default. Meshes are separated from each
  883.  other, in the data file, by double blank lines. To splot a single mesh in
  884.  a multi mesh file use the index modifier which specify which mesh to splot.
  885.  First mesh is mesh 0.
  886.  
  887.  Example:
  888.  
  889.  splot "data1" index 2 with points
  890.  
  891.  will splot the third mesh in file data1 with points.
  892. ?plot style
  893. ?splot style
  894. ?style
  895. ?plot with
  896. ?with
  897.  Plots may be displayed in one of eight styles: `lines`, `points`,
  898.  `linespoints`, `impulses`, `dots`, `errorbars`, `steps`, `boxes`, or
  899.  `boxerrorbars`.  The `lines` style connects adjacent points with lines.
  900.  The `points` style displays a small symbol at each point.
  901.  The `linespoints` style does both `lines` and `points`.
  902.  The `impulses` style displays a vertical line from the x axis
  903.  (or from the grid base for `splot`) to each point. The `dots` style
  904.  plots a tiny dot at each point; this is useful for
  905.  scatter plots with many points.
  906.  
  907.  The `errorbars` style is only relevant to 2-d data file plotting. It
  908.  is treated like `points` for `splot`s and function `plot`s. For data
  909.  `plot`s, `errorbars` is like `points`, except that a vertical error
  910.  bar is also drawn: for each point (x,y), a line is drawn from
  911.  (x,ylow) to (x,yhigh). A tic mark is placed at the ends of the error
  912.  bar. The ylow and yhigh values are read from the data file's columns,
  913.  as specified with the `using` option to plot. See `plot errorbars` for
  914.  more information.
  915.  
  916.  The `boxes` style is only relevant to 2-d plotting.  Another style
  917.  called `boxerrorbars` is also available and is only relevant to 2-d
  918.  data file plotting.  This style is a combination of the `boxes` and
  919.  `errorbars` styles.  The `boxes` style draws a box centred about
  920.  the given x coordinate from the yaxis to the given y coordinate.
  921.  The width of the box is obtained in one of three ways.  First, if a 
  922.  data file has a fifth column, this will be used to set the width of 
  923.  the box. Columns 3 and 4 (for `boxerrorbars`) are necessary but
  924.  ignored in this instance.  Secondly, if a width has been set using 
  925.  the `set boxwidth` command, this will be used.  Otherwise the width 
  926.  of each box will be calculated automatically so that it touches the
  927.  adjacent boxes.
  928.  
  929.  The `steps` style is only relevant to 2-d plotting.  This style
  930.  connects consecutive points with two line segments: the first
  931.  from (x1,y1) to (x2,y1) and the second from (x2,y1) to (x2,y2).
  932.  
  933.  Default styles are chosen with the `set function style` and
  934.  `set data style` commands.
  935.  
  936.  By default, each function and data file will use a different
  937.  line type and point type, up to the maximum number of available
  938.  types. All terminal drivers support at least six different point
  939.  types, and re-use them, in order, if more than six are required.
  940.  The LaTeX driver supplies an additional six point types (all variants
  941.  of a circle), and thus will only repeat after twelve curves are
  942.  plotted with points.
  943.  
  944.  If desired, the style and (optionally) the line type and point type
  945.  used for a curve can be specified.
  946.  
  947.  Syntax:
  948.  
  949.          with <style> {<linetype> {<pointtype>}}
  950.  
  951.  where <style> is either `lines`, `points`, `linespoints`, `impulses`,
  952.  `dots`, `steps`, or `errorbars`. The <linetype> and <pointtype> are
  953.  positive integer constants or expressions and specify the line type
  954.  and point type to be used for the plot. Line type 1 is the first line
  955.  type used by default, line type 2 is the second line type used by
  956.  default, etc.
  957.  
  958.  Examples:
  959.  
  960.  This plots sin(x) with impulses:
  961.          plot sin(x) with impulses
  962.  
  963.  This plots x*y with points, x**2 + y**2 default:
  964.          splot x*y w points, x**2 + y**2
  965.  
  966.  This plots tan(x) with the default function style, "data.1" with lines:
  967.          plot [ ] [-2:5] tan(x), "data.1" with l
  968.  
  969.  This plots "leastsq.dat" with impulses:
  970.          plot 'leastsq.dat' w i
  971.  
  972.  This plots the data file 'population' with boxes:
  973.          plot "population" with boxes
  974.  
  975.  This plots "exper.dat" with errorbars and lines connecting the points:
  976.          plot 'exper.dat' w lines, 'exper.dat' w errorbars
  977.  
  978.  Here 'exper.dat' should have three or four data columns.
  979.  
  980.  This plots x**2 + y**2 and x**2 - y**2 with the same line type:
  981.          splot x**2 + y**2 with line 1, x**2 - y**2 with line 1
  982.  
  983.  This plots sin(x) and cos(x) with linespoints, using the
  984.  same line type but different point types:
  985.          plot sin(x) with linesp 1 3, cos(x) with linesp 1 4
  986.  
  987.  This plots file "data" with points style 3:
  988.          plot "data" with points 1 3
  989.  Note that the line style must be specified when specifying the point
  990.  style, even when it is irrelevant. Here the line style is 1 and the
  991.  point style is 3, and the line style is irrelevant.
  992.  
  993.  See `set style` to change the default styles.
  994. ?plot title
  995. ?splot title
  996.  A title of each plot appears in the key. By default the title is
  997.  the function or file name as it appears on the plot command line.
  998.  The title can be changed by using the `title` option. This option
  999.  should precede any `with` option.
  1000.  
  1001.  Syntax:
  1002.          title "<title>"
  1003.  
  1004.  where <title> is the new title of the plot and must be enclosed in
  1005.  quotes. The quotes will not be shown in the key.
  1006.  
  1007.  Examples:
  1008.  
  1009.  This plots y=x with the title 'x':
  1010.          plot x
  1011.  
  1012.  This plots the "glass.dat" file with the title 'surface of revolution':
  1013.          splot "glass.dat" title 'surface of revolution'
  1014.  
  1015.  This plots x squared with title "x^2" and "data.1" with title
  1016.  'measured data':
  1017.          plot x**2 title "x^2", "data.1" t 'measured data'
  1018.  
  1019.  The title can be omitted from the key with the "notitle" option for
  1020.  plot and splot.  This can be useful when some curves
  1021.  are plotted solely for decoration; for example, if one wanted a
  1022.  circular border for a polar plot, he could say:
  1023.  
  1024.  Example:
  1025.         set polar
  1026.         plot my_function(x), 1 notitle
  1027.  
  1028.  This would generate a key entry for "my_function" but not for "1".
  1029.  See the poldat.dem example.
  1030.  
  1031.  
  1032. ?print
  1033.  The `print` command prints the value of <expression> to the screen.
  1034.  
  1035.  Syntax:
  1036.          print <expression>
  1037.  
  1038.  See `expressions`.
  1039. ?pwd
  1040.  The `pwd` command prints the name of the working directory to the screen.
  1041.  
  1042.  Syntax:
  1043.          pwd
  1044. ?quit
  1045.  The `exit` and `quit` commands and END-OF-FILE character will exit
  1046.  GNUPLOT. All these commands will clear the output device (as the
  1047.  `clear` command does) before exiting.
  1048. ?replot
  1049.  The `replot` command without arguments repeats the last `plot` or `splot`
  1050.  command. This can be useful for viewing a plot with different `set`
  1051.  options, or when generating the same plot for several devices.
  1052.  
  1053.  Arguments specified after a `replot` command will be added onto the last
  1054.  `plot` (`splot`) command (with an implied ',' separator) before it is
  1055.  repeated. `replot` accepts the same arguments as the `plot` (`splot`)
  1056.  commands except that ranges cannot be specified.
  1057.  See `command line-editing` for ways to edit the last `plot`
  1058.  (`splot`) command.
  1059. ?reread
  1060.  The `reread` command causes the current gnuplot command file, as specified
  1061.  by a `load` command or on the command line, to be reset to its starting
  1062.  point before further commands are read from it.  This essentially implements
  1063.  an endless loop of the commands from the beginning of the command file to
  1064.  the `reread` command.  The `reread` command has no effect if input from
  1065.  standard input.
  1066. ?save
  1067.  The `save` command saves user-defined functions, variables, set
  1068.  options or all three plus the last `plot` (`splot`) command to the
  1069.  specified file.
  1070.  
  1071.  Syntax:
  1072.          save  {<option>} "<filename>"
  1073.  
  1074.  where <option> is `functions`, `variables` or `set`. If no option is
  1075.  used, GNUPLOT saves functions, variables, set options and the last `plot`
  1076.  (`splot`) command.
  1077.  
  1078.  `save`d files are written in text format and may be read by the `load`
  1079.  command.
  1080.  
  1081.  The filename must be enclosed in quotes.
  1082.  
  1083.  Examples:
  1084.  
  1085.          save "work.gnu"
  1086.          save functions 'func.dat'
  1087.          save var 'var.dat'
  1088.          save set "options.dat"
  1089. ?set
  1090. ?show
  1091. ?show all
  1092.  The `set` command sets LOTS of options.
  1093.  
  1094.  The `show` command shows their settings. `show all` shows all the
  1095.  settings.
  1096. ?set angles
  1097. ?show angles
  1098. ?angles
  1099. ?set angles degrees
  1100.  By default, GNUPLOT assumes the independent variable in polar plots
  1101.  is in units of radians. If `set angles degrees` is specified before
  1102.  `set polar` then the default range is [0:360] and the independent
  1103.  variable has units of degrees. This is particularly useful for
  1104.  plots of data files. The angle setting also hold for the 3-d
  1105.  mapping as set via the `set mapping` command.
  1106.  
  1107.  Syntax:
  1108.          set angles { degrees | radians }
  1109.          show angles
  1110. ?set arrow
  1111. ?set noarrow
  1112. ?show arrow
  1113. ?arrow
  1114. ?noarrow
  1115.  Arbitrary arrows can be placed on a plot using the `set arrow`
  1116.  command.
  1117.  
  1118.  Syntax:
  1119.  
  1120.           set arrow {<tag>} {from <sx>,<sy>{,<sz>}}
  1121.                             {to <ex>,<ey>{,<ez>}} {{no}head}
  1122.           set noarrow {<tag>}
  1123.           show arrow
  1124.  
  1125.  
  1126.  Unspecified coordinates default to 0. The x, y, and z values are in
  1127.  the graph's coordinate system. The z coordinate is only used in
  1128.  `splot` commands. <tag> is an integer that identifies the arrow. If no
  1129.  tag is given, the lowest unused tag value is assigned automatically.
  1130.  The tag can be used to delete or change a specific arrow. To change
  1131.  any attribute of an existing arrow, use the `set arrow` command with
  1132.  the appropriate tag, and specify the parts of the arrow to be
  1133.  changed. Specifying nohead requests the arrow be drawn without a head
  1134.  (yielding a line segment). By default, arrows have heads.
  1135.  
  1136.  Arrows outside the plotted boundaries are permitted but may cause
  1137.  device errors.
  1138.  
  1139.  Examples:
  1140.  
  1141.  To set an arrow pointing from the origin to (1,2), use:
  1142.           set arrow to 1,2
  1143.  To set an arrow from (-10,4,2) to (-5,5,3), and tag the arrow number
  1144.  3, use:
  1145.           set arrow 3 from -10,4,2 to -5,5,3
  1146.  To change the preceding arrow begin at 1,1,1, without an arrow head,
  1147.  use:
  1148.           set arrow 3 from 1,1,1 nohead
  1149.  To delete arrow number 2 use:
  1150.           set noarrow 2
  1151.  To delete all arrows use:
  1152.           set noarrow
  1153.  To show all arrows (in tag order) use:
  1154.           show arrow
  1155. ?set autoscale
  1156. ?set noautoscale
  1157. ?show autoscale
  1158. ?autoscale
  1159. ?noautoscale
  1160.  Auto scaling may be set individually on the x, y or z axis
  1161.  or globally on all axes. The default is to autoscale all axes.
  1162.  
  1163.  When autoscaling, the plot range is automatically computed and the
  1164.  dependent axis (y for a `plot` and z for `splot`) is scaled to
  1165.  include the range of the function or data being plotted.
  1166.  
  1167.  If autoscaling of the dependent axis (y or z) is not set, the
  1168.  current y or z range is used.
  1169.  
  1170.  See `set yrange` or `set zrange`.
  1171.  
  1172.  Autoscaling the independent variables (x for `plot` and x,y for
  1173.  `splot`) is a request to set the domain to match any data file being
  1174.  plotted. If there are no data files then autoscaling an independent
  1175.  variable has no effect. In other words, in the absence of a data
  1176.  file, functions alone do not affect the x range (or the y range if
  1177.  plotting z = f(x,y)).
  1178.  
  1179.  See `set xrange`, or `set yrange`.
  1180.  
  1181.  The behavior of autoscaling remains consistent in parametric mode,
  1182.  however, there are more dependent variables and hence more control
  1183.  over x, y, and z plot scales. In parametric mode, the independent or
  1184.  dummy variable is t for `plot`s and u,v for `splot`s.  Autoscale in
  1185.  parametric mode, then, controls all ranges (t, u, v, x, y, and z) and
  1186.  allows x, y, and z to be fully autoscaled.
  1187.  
  1188.  See `set parametric`.
  1189.  
  1190.  Syntax:
  1191.          set autoscale <axes>
  1192.          set noautoscale <axes>
  1193.          show autoscale
  1194.  
  1195.  where <axes> is either `x`, `y`, `z` or `xy`. If <axes> is not given
  1196.  then all axes are assumed.
  1197.  
  1198.  Examples:
  1199.  
  1200.  This sets autoscaling of the y axis. x axis autoscaling is not
  1201.  affected.
  1202.          set autoscale y
  1203.  
  1204.  This sets autoscaling of the x and y axes.
  1205.          set autoscale xy
  1206.  
  1207.  This sets autoscaling of the x, y and z axes.
  1208.          set autoscale
  1209.  
  1210.  This disables autoscaling of the x, y and z axes.
  1211.          set noautoscale
  1212.  
  1213.  This disables autoscaling of the z axis only.
  1214.          set noautoscale z
  1215. ?autoscale parametric
  1216. ?set autoscale t
  1217.  When in parametric mode (`set parametric`) the xrange is as
  1218.  fully scalable as the yrange. In other words, in parametric
  1219.  mode the x axis can be automatically scaled to fit the range
  1220.  of the parametric function that is being plotted. Of course,
  1221.  the y axis can also be automatically scaled just as in the
  1222.  non-parametric case. If autoscaling on the x axis is not set,
  1223.  the current x range is used.
  1224.  
  1225.  When there is a mix of data files and functions, the xrange of
  1226.  the functions is selected as that of the data files if autoscale
  1227.  is true for x. While this keeps the behavior compatible with
  1228.  non-parametric plotting, it may not be retained in the future.
  1229.  The problem is that, in parametric mode, the x and y ranges are
  1230.  not as distinguishable as in the non-parametric mode and this
  1231.  behavior may not be the most useful.
  1232.  
  1233.  For completeness a last command `set autoscale t` is accepted.
  1234.  However, the effect of this "scaling" is very minor. When
  1235.  GNUPLOT determines that the t range would be empty it makes a
  1236.  small adjustment if autoscaling is true. Otherwise, GNUPLOT
  1237.  gives an error. Such behavior may, in fact, not be very useful
  1238.  and the command `set autoscale t` is certainly questionable.
  1239.  
  1240.  `splot` extends the above idea similarly. If autoscaling is set then
  1241.  x, y, and z ranges are computed and each axis scaled to fit the
  1242.  resulting data.
  1243. ?set border
  1244. ?set noborder
  1245. ?show border
  1246. ?border
  1247. ?noborder
  1248.  The `set border` and `set noborder` commands controls the display of
  1249.  the plot borders for the `plot` and `splot` commands.
  1250.  
  1251.  Syntax:
  1252.          set border
  1253.          set noborder
  1254.          show border
  1255. ?set boxwidth
  1256. ?show boxwidth
  1257. ?boxwidth
  1258.  The `set boxwidth` command is used to set the default width of
  1259.  boxes in the `boxes` and `boxerrorbars` styles.
  1260.  
  1261.  If a data file is plotted without the width being specified in the
  1262.  fifth column, or a function is plotted, the width of each box is
  1263.  set by the `set boxwidth` command.  If a width is given after the
  1264.  `set boxwidth` command then this is used as the width.  Otherwise
  1265.  the width of each box will be calculated automatically so that
  1266.  it touches the adjacent boxes.
  1267.  
  1268.  Syntax:
  1269.           set boxwidth {<width>}
  1270.           show boxwidth
  1271.  
  1272.  To set the box width to automatic use the command
  1273.           set boxwidth
  1274. ?set clabel
  1275. ?set noclabel
  1276. ?show clabel
  1277. ?clabel
  1278. ?noclabel
  1279.  GNUPLOT will vary the linetype used for each contour level
  1280.  when clabel is set. When this option on (the default), a
  1281.  legend labels each linestyle with the z level it represents.
  1282.  
  1283.  Syntax:
  1284.          set clabel
  1285.          set noclabel
  1286.          show clabel
  1287. ?set clip
  1288. ?set noclip
  1289. ?show clip
  1290. ?clip
  1291. ?noclip
  1292.  GNUPLOT can clip data points and lines that are near the boundaries
  1293.  of a plot.
  1294.  
  1295.  Syntax:
  1296.          set clip <clip-type>
  1297.          set noclip <clip-type>
  1298.          show clip
  1299.  
  1300.  Three clip types are supported by GNUPLOT: `points`, `one`, and `two`.
  1301.  One, two, or all three clip types may be active for a single plot.
  1302.  
  1303.  The `points` clip type forces GNUPLOT to clip (actually, not plot at
  1304.  all) data points that fall within but too close to the boundaries
  1305.  (this is so the large symbols used for points will not extend outside
  1306.  the boundary lines). Without clipping points near the boundaries may
  1307.  look bad; try adjusting the x and y ranges.
  1308.  
  1309.  Setting the `one` clip type causes GNUPLOT to plot the line segments
  1310.  which have only one of the two endpoints within the plotting region.
  1311.  Only the in-range portion of the line is drawn.  The alternative is to
  1312.  not draw any portion of the line segment.
  1313.  
  1314.  Some lines may have both endpoints out of range, but pass through the
  1315.  plotting area. Setting the `two` clip-type allows the visible portion
  1316.  of these lines to be drawn.
  1317.  
  1318.  In no case is a line drawn outside the plotting area.
  1319.  
  1320.  The defaults are `noclip points`, `clip one`, and `noclip two`.
  1321.  
  1322.  To check the state of all forms of clipping, use
  1323.          show clip
  1324.  
  1325.  For backward compatibility with older versions, the following forms
  1326.  are also permitted.
  1327.         set clip
  1328.         set noclip
  1329.  `set clip` is synonymous with `set clip points`. `set noclip` turns
  1330.  off all three types of clipping.
  1331. ?set cntrparam
  1332. ?show cntrparam
  1333. ?cntrparam
  1334.  Sets the different parameters for the contouring plot (see also `contour`).
  1335.  
  1336.  Syntax:
  1337.   set cntrparam { { linear | cubicspline | bspline } |
  1338.      points <n> |
  1339.      order <n>  |
  1340.      levels { [ auto ] <n> |
  1341.      discrete <z1>,<z2>, ... |
  1342.      incremental {<start>, <incr>{, <end>} } }
  1343.  
  1344.  Examples:
  1345.      set cntrparam bspline
  1346.      set cntrparam points 7
  1347.      set cntrparam order 10
  1348.      set cntrparam levels auto 5                   # 5 automatic levels
  1349.      set cntrparam levels discrete .1,1/exp(1),.9  # 3 discrete at .1,.37,.9
  1350.      set cntrparam levels incremental  0,.1,.4
  1351.      # 5 incremental levels at 0, .1, .2, .3 and .4
  1352.      set cntrparam levels 10
  1353.      # sets n = 10 retaining current setting of auto, discr. and
  1354.      # increment's start and increment value, while changing end
  1355.      set cntrparam levels incremental 100,50
  1356.      # set start = 100 and increment = 50, retaining n levels
  1357.  
  1358.  This command controls the way contours are plotted. <n> should be an
  1359.  integral constant expression and <z1>, <z2> any constant expressions.
  1360.  The parameters are:
  1361.  
  1362.  `linear`, `cubicspline`, `bspline` - Controls type of approximation or
  1363.  interpolation. If `linear`, then the contours are drawn piecewise
  1364.  linear, as extracted from the surface directly. If `cubicspline`, then
  1365.  piecewise linear contours are interpolated to form a somewhat smoother
  1366.  contours, but which may undulate. The third option is the uniform
  1367.  `bspline`, which only approximates the piecewise linear data but is
  1368.  guaranteed to be smoother.
  1369.  
  1370.  `points` - Eventually all drawings are done with piecewise linear
  1371.  strokes.  This number controls the number of points used to
  1372.  approximate a curve.  Relevant for `cubicspline` and `bspline` modes
  1373.  only.
  1374.  
  1375.  `order`  - Order of the bspline approximation to be used. The bigger this
  1376.  order is, the smoother the resulting contour.  (Of course, higher order
  1377.  bspline curves will move further away from the original piecewise linear
  1378.  data.)  This option is relevant for `bspline` mode only. Allowed values are
  1379.  integers in the range from 2 (linear) to 10.
  1380.  
  1381.  `levels` - Number of contour levels, 'n'.  Selection of the levels is
  1382.  controlled by 'auto' (default), 'discrete', and 'incremental'. For 'auto',
  1383.  if the surface is bounded by zmin and zmax then contours will be
  1384.  generated from zmin+dz to zmax-dz in steps of size dz, where
  1385.  dz = (zmax - zmin) / (levels + 1).  For 'discrete', contours will be
  1386.  generated at z = z1, z2 ... as specified.  The number of discrete levels
  1387.  is limited to MAX_DISCRETE_LEVELS, defined in plot.h to be 30.  If
  1388.  'incremental', contours are generated at <n> values of z beginning at
  1389.  <start> and increasing by <increment>.
  1390. ?set contour
  1391. ?show contour
  1392. ?contour
  1393.  Enable contour drawing for surfaces. This option is available for `splot`
  1394.  only.
  1395.  
  1396.  Syntax:
  1397.          set contour { base | surface | both }
  1398.          set nocontour
  1399.  
  1400.  If no option is provided to `set contour`, the default is `base`.
  1401.  The three options specify where to draw the contours: `base` draws
  1402.  the contours on the grid base where the x/ytics are placed, `surface`
  1403.  draws the contours on the surfaces themselves, and `both` draws the
  1404.  contours on both the base and the surface.
  1405.  
  1406.  See also `set cntrparam` for the parameters that affect the drawing of
  1407.  contours.
  1408. ?set data style
  1409. ?show data style
  1410. ?data style
  1411.  The `set data style` command changes the default plotting style
  1412.  for data plots.
  1413.  
  1414.  Syntax:
  1415.          set data style
  1416.          show data style
  1417.          set data style <style-choice>
  1418.  
  1419.  In the first case, `set data style` returns the possible style
  1420.  choices:  `lines`, `points`, `linespoints`, `dots`, `steps`,
  1421.  `impulses`, `errorbars`, `boxes` or `boxerrorbars`.  `show data style`
  1422.  shows the current default plotting style for data.  `set data style dots`
  1423.  would actually  change the default plotting style.  See also `plot`.
  1424. ?set dgrid3d
  1425. ?show dgrid3d
  1426. ?dgrid3d
  1427.  Enables and sets the different parameters for non grid to grid data mapping.
  1428.  
  1429.  Syntax:
  1430.          set dgrid3d {,{<row_size>}{,{<col_size>}{,<norm>}}}
  1431.          set nodgrid3d
  1432.  
  1433.  Examples:
  1434.         set dgrid3d 10,10,2
  1435.         set dgrid3d ,,4
  1436.  
  1437.  The first selects a grid of size 10 by 10 to be constructed and the use
  1438.  of L2 norm in the distance computation. The second only modifies the norm
  1439.  to be used to L4.
  1440.  
  1441.  By default this option is disabled. When enabled, 3d data read from a file
  1442.  is always treaded as a scattered data set. A grid with dimensions derived
  1443.  from a bounding box of the scattered data and size as specified by the
  1444.  row/col_size above is created for plotting and contouring. The grid is
  1445.  equally spaced in x and y while the z value is computed as a weighted
  1446.  average of the scattered points distance to the grid points. The closer
  1447.  the scatter points to a grid point are the more effect they have on that
  1448.  grid point. The third, norm, parameter controls the "meaning" of the
  1449.  distance, by specifying the distance norm. This distance computation
  1450.  is optimized for powers of 2 norms, specifically 1, 2, 4, 8, and 16, but
  1451.  any nonnegative integer can be used.
  1452.  
  1453.  This dgrid3d option is a simple low pass filter that converts scattered data
  1454.  to a grid data set. More sophisticated approaches to this problem exists and
  1455.  should be used as a preprocess to and outside gnuplot if this simple solution
  1456.  is found inadequate.
  1457.  
  1458. ?set dummy
  1459. ?show dummy
  1460. ?dummy
  1461.  By default, GNUPLOT assumes that the independent variable for the
  1462.  `plot` command is x, and the independent variables for the `splot`
  1463.  command are x and y. They are called the dummy variables because it
  1464.  is just a notation to indicate the independent variables.
  1465.  The `set dummy` command changes these default dummy variable names.
  1466.  For example, it may be more convenient to call the dummy variable t
  1467.  when plotting time functions:
  1468.  
  1469.          set dummy t
  1470.          plot sin(t), cos(t)
  1471.  
  1472.  Syntax:
  1473.          set dummy <dummy-var>{,<dummy-var>}
  1474.          show dummy
  1475.  
  1476.  Examples:
  1477.          set dummy u,v
  1478.          set dummy ,s
  1479.  
  1480.  to set both dummy variables to u and v or set only the second
  1481.  variable to s.
  1482.  
  1483.  The `set parametric` command also changes the dummy variables (to t
  1484.  for `plot` and u,v for `splot`s).
  1485.  
  1486. ?set format
  1487. ?show format
  1488. ?format
  1489.  The format of the tic-mark labels can be set with the `set format`
  1490.  command. The default format for both axes is "%g", but other formats
  1491.  such as "%.2f" or "%3.0fm" are often desirable. Anything accepted by
  1492.  printf when given a double precision number, and then accepted by the
  1493.  terminal, will work. In particular, the formats f, e, and g will work,
  1494.  and the d, o, x, c, s, and u formats will not work.
  1495.  
  1496.  Syntax:
  1497.          set format {<axes>} {"<format-string>"}
  1498.          show format
  1499.  
  1500.  where <axes> is either `x`, `y`, `z`, `xy`, or nothing (which is the
  1501.  same as `xy`). The length of the string representing a ticmark (after
  1502.  formatting with printf) is restricted to 100 characters.  If the
  1503.  format string is omitted, the format will be returned to the default
  1504.  "%g". For LaTeX users, the format "$%g$" is often desirable.  If the
  1505.  empty string "" is used, no label will be plotted with each tic,
  1506.  though the tic mark will still be plotted. To eliminate all tic marks,
  1507.  use `set noxtics` or `set noytics`.
  1508.  
  1509.  See also `set xtics` and `set ytics` for more control over tic labels.
  1510. ?set function style
  1511. ?show function style
  1512. ?function style
  1513.  The `set function style` command changes the default plotting style
  1514.  for functions.
  1515.  
  1516.  Syntax:
  1517.          set function style
  1518.          show function style
  1519.          set function style <style-choice>
  1520.  
  1521.  In the first case, `set function style` returns the possible style
  1522.  choices:  `lines`, `points`, `linespoints`, `dots`, `steps`,
  1523.  `impulses`, `errorbars`, `boxes`, or `boxerrorbars`.
  1524.  `show function style` shows the current default plotting style for
  1525.  functions.  `set function style linespoints` would actually change
  1526.  the default plotting style.   See also `plot`.
  1527. ?show functions
  1528.  The `show functions` command lists all user-defined functions and
  1529.  their definitions.
  1530.  
  1531.  Syntax:
  1532.          show functions
  1533. ?set grid
  1534. ?show grid
  1535. ?grid
  1536.  The optional `set grid` draws a grid at the tic marks with the axis
  1537.  linetype.
  1538.  
  1539.  Syntax:
  1540.          set grid
  1541.          set nogrid
  1542.          show grid
  1543. ?set hidden3d
  1544. ?show hidden3d
  1545.  The `set hidden3d` command enables hidden line removal for explicit
  1546.  surface plotting (see `splot`).
  1547.  Hidden line removal may be used for both explicit functions and for
  1548.  explicit data.  It now works for parametric surfaces as well.
  1549.  
  1550.  When this flag is set both the surface hidden portion and possibly
  1551.  its hidden contours (see `set contour`) as well as the hidden grid will be
  1552.  removed. Labels and arrows are always visible and are unaffected by this
  1553.  command.
  1554.  
  1555.  Each surface has its hidden parts removed with respect to itself and to
  1556.  other surfaces, if more than one surface is plotted. This mode is
  1557.  meaningful when surfaces are plotted using line style drawing only.
  1558.  
  1559.  Syntax:
  1560.          set hidden3d
  1561.          set nohidden3d
  1562.          show hidden3d
  1563. ?set isosamples
  1564. ?show isosamples
  1565. ?isosamples
  1566.  An isoline is a curve parametrized by one of the surface parameters
  1567.  while the other surface parameter is fixed. Isolines are a simple
  1568.  means to display a surface. By fixing the u parameter of surface
  1569.  s(u,v), the iso-u lines of the form c(v) = s(u0,v) are produced, and
  1570.  by fixing the v parameter, the iso-v lines of the form c(u) = s(u,v0)
  1571.  are produced.
  1572.  
  1573.  The isoline density of surfaces may be changed by the `set isosamples`
  1574.  command. By default, sampling is set to 10 isolines per u or v axis.
  1575.  A higher sampling rate will produce more accurate plots, but will take
  1576.  longer. This parameter has no effect on data file plotting.
  1577.  
  1578.  Syntax:
  1579.          set isosamples <iso_1> {,<iso_2>}
  1580.          show isosamples
  1581.  
  1582.  Each surface plot will have <iso_1> iso-u lines and <iso_2> iso-v lines.
  1583.  If you only specify <iso_1>, <iso_2> will be set to the same value as
  1584.  <iso_1>.
  1585.  
  1586.  When a surface plot is being done without the removal of hidden
  1587.  lines, `set samples` also has an effect on the number of points being
  1588.  evaluated. See `set samples`.
  1589. ?set key
  1590. ?show key
  1591. ?key
  1592.  The `set key` enables a key describing curves on a plot.  By default
  1593.  the key is placed in the upper right corner of the plot.
  1594.  
  1595.  Syntax:
  1596.          set key
  1597.          set key <x>,<y>{,<z>}
  1598.          set nokey
  1599.          show key
  1600.  
  1601.  The coordinates <x>, <y> (and <z> for `splot`s) specify the location
  1602.  of the key on the plot. The key is drawn as a sequence of lines, with
  1603.  one plot described on each line. On the right hand side of each line
  1604.  is a representation that attempts to mimic the way the curve is
  1605.  plotted.  On the left side of each line is the text description,
  1606.  obtained from the `plot` command. See `plot title` to change this
  1607.  description. The lines are vertically arranged so an imaginary
  1608.  straight line divides the left- and right-hand sides of the key. It is
  1609.  the coordinates of this line that are specified with the `set key`
  1610.  command. In a `plot`, only the x and y coordinates are used to specify
  1611.  the line position.  For a `splot`, x, y and z are all being used as a
  1612.  3-d location mapped using the same mapping as the plot itself to form
  1613.  the required 2-d screen position of the imaginary line.
  1614.  
  1615.  Some or all of the key may be outside of the plot boundary, although
  1616.  this may interfere with other labels and may cause an error on some
  1617.  devices.
  1618.  
  1619.  Examples:
  1620.  
  1621.  This places the key at the default location:
  1622.          set key
  1623.  This disables the key:
  1624.          set nokey
  1625.  This places a key at coordinates 2,3.5,2
  1626.          set key 2,3.5,2
  1627. ?set label
  1628. ?set nolabel
  1629. ?show label
  1630. ?label
  1631. ?nolabel
  1632.  Arbitrary labels can be placed on the plot using the `set label`
  1633.  command.  If the z coordinate is given on a `plot` it is ignored; if
  1634.  it is missing on a `splot` it is assumed to be 0.
  1635.  
  1636.  Syntax:
  1637.  
  1638.           set label {<tag>} {"<label_text>"} {at <x>,<y>{,<z>}}
  1639.                             {<justification>}
  1640.           set nolabel {<tag>}
  1641.           show label
  1642.  
  1643.  
  1644.  The text defaults to "", and the position to 0,0,0.  The <x>, <y>, and
  1645.  <z> values are in the graph's coordinate system.  The tag is an
  1646.  integer that is used to identify the label. If no <tag> is given, the
  1647.  lowest unused tag value is assigned automatically. The tag can be used
  1648.  to delete or change a specific label. To change any attribute of an
  1649.  existing label, use the `set label` command with the appropriate tag,
  1650.  and specify the parts of the label to be changed.
  1651.  
  1652.  By default, the text is placed flush left against the point x,y,z.
  1653.  To adjust the way the label is positioned with respect to the point
  1654.  x,y,z, add the parameter <justification>, which may be `left`, `right`
  1655.  or `center`, indicating that the point is to be at the left, right or
  1656.  center of the text. Labels outside the plotted boundaries are
  1657.  permitted but may interfere with axes labels or other text.
  1658.  
  1659.  Examples:
  1660.  
  1661.  To set a label at (1,2) to "y=x" use:
  1662.           set label "y=x" at 1,2
  1663.  To set a label "y=x^2" with the right of the text at (2,3,4), and tag
  1664.  the label number 3, use:
  1665.           set label 3 "y=x^2" at 2,3,4 right
  1666.  To change the preceding label to center justification, use:
  1667.           set label 3 center
  1668.  To delete label number 2 use:
  1669.           set nolabel 2
  1670.  To delete all labels use:
  1671.           set nolabel
  1672.  To show all labels (in tag order) use:
  1673.           show label
  1674.  
  1675.  (The EEPIC, Imagen, LaTeX, and TPIC drivers allow \\ in a string to specify
  1676.  a newline.)
  1677. ?set logscale
  1678. ?set nologscale
  1679. ?show logscale
  1680. ?logscale
  1681. ?nologscale
  1682.  Log scaling may be set on the x, y, and z axes.
  1683.  
  1684.  Syntax:
  1685.          set logscale <axes> <base>
  1686.          set nologscale <axes>
  1687.          show logscale
  1688.  
  1689.  where <axes> may be any combinations of `x`, `y`, and `z`, in any
  1690.  order, and where <base> is the base of the log scaling.  If <base>
  1691.  is not given, then 10 is assumed.  If <axes> is not given then all
  1692.  three axes are assumed.  The command `set logscale` turns on log
  1693.  scaling on the specified axes, while `set nologscale` turns off
  1694.  log scaling.
  1695.  
  1696.  Examples:
  1697.  
  1698.  To enable log scaling in both x and z axes:
  1699.         set logscale xz
  1700.  To enable scaling log base 2 of the y axis:
  1701.         set logscale y 2
  1702.  To disable z axis log scaling:
  1703.         set nologscale z
  1704. ?set mapping
  1705. ?show mapping
  1706. ?mapping
  1707.  
  1708.  Syntax:
  1709.          set mapping { cartesian | spherical | cylindrical }
  1710.  
  1711.  Data for `splot`s are usually in regular Euclidean space and are
  1712.  provided in Cartesian coordinates. Such 3-d data require three
  1713.  coordinates (x, y and z) or one coordinate (only z) in each line in
  1714.  the data file.  In order to be able to use spherical or cylindrical
  1715.  coordinate systems, use the `set mapping` command. In both cases two
  1716.  coordinates are expected in each line of the data. For a spherical
  1717.  coordinate system, these are theta and phi (in units as specified by
  1718.  `set angles`) and the mapping is:
  1719.  
  1720.          x = cos( theta ) * cos( phi )
  1721.          y = sin( theta ) * cos( phi )
  1722.          z = sin( phi )
  1723.  
  1724.  For a cylindrical coordinate system, the mapping uses two variables,
  1725.  theta (in units as specified by `set angles`) and z:
  1726.  
  1727.          x = cos( theta )
  1728.          y = sin( theta )
  1729.          z = z
  1730.  
  1731.  Again, note that mapping will affect data file `splot`s only.
  1732. ?set offsets
  1733. ?show offsets
  1734. ?offsets
  1735.  The amount of the graph that the plot takes up may be controlled to
  1736.  some extent with the `set offsets` command. This command takes four
  1737.  offset arguments: <left>, <right>, <top> and <bottom>. By default,
  1738.  each offset is 0. Each offset may be a constant or an expression. Left
  1739.  and right offsets are given in units of the x axis, while top and
  1740.  bottom offsets are given in units of the y axis. The plot of sin(x),
  1741.  displayed with offsets of 0, 0, 2, 2 will take up 1/3 of the
  1742.  displayed y axis. Offsets are particularly useful with polar
  1743.  coordinates as a means of compensating for aspect ratio distortion.
  1744.  Offsets are ignored in `splot`s.
  1745.  
  1746.  Syntax:
  1747.          set offsets <left>, <right>, <top>, <bottom>
  1748.          show offsets
  1749. ?set output
  1750. ?show output
  1751. ?output
  1752.  By default, plots are displayed to the standard output. The
  1753.  `set output` command redirects the display to the specified file
  1754.  or device.
  1755.  
  1756.  Syntax:
  1757.          set output {"<filename>"}
  1758.          show output
  1759.  
  1760.  The filename must be enclosed in quotes. If the filename is
  1761.  omitted, output will be sent to the standard output.
  1762.  
  1763.  On machines with popen functions (UNIX), output can be piped
  1764.  through a shell command if the first letter of the filename
  1765.  is '|'.  For instance,
  1766.  
  1767.  Syntax:
  1768.          set output "|lpr -Plaser filename"
  1769.          set output "|lp -dlaser filename"
  1770.  
  1771.  (On MSDOS machines, set output "prn" will direct the output
  1772.  to the default printer.)
  1773.  
  1774. ?set parametric
  1775. ?set noparametric
  1776. ?show parametric
  1777. ?parametric
  1778. ?noparametric
  1779.  The `set parametric` command changes the meaning of `plot` (`splot`)
  1780.  from normal functions to parametric functions. The command
  1781.  `set noparametric` changes the plotting style back to normal,
  1782.  single-valued expression plotting.
  1783.  
  1784.  In 2-d plotting, a parametric function is determined by a pair
  1785.  of parametric functions operating on a parameter. An example
  1786.  of a 2-d parametric function would be plot sin(t),cos(t) (which
  1787.  defines a circle).
  1788.  
  1789.  For 3-d plotting, the surface is described as x=f(u,v), y=g(u,v),
  1790.  z=h(u,v). Therefore a triplet of functions are required. An example of
  1791.  3-d parametric function would be cos(u)*cos(v),cos(u)*sin(v),sin(u)
  1792.  (which defines a sphere). It takes three parametric function
  1793.  specifications in terms of the parametric dummy arguments to describe
  1794.  a single graph.
  1795.  
  1796.  The total set of possible plots is a superset of the simple f(x)
  1797.  style plots, since the two (three) functions can describe the
  1798.  x and y (and z) values to be computed separately. In fact,
  1799.  plots of the type t,f(t) (u,v,f(u,v)) are equivalent to those
  1800.  produced with f(x) when the x values are computed using the
  1801.  identity function as the first function.
  1802.  
  1803.  Note that the order the parametric functions are specified is
  1804.  xfunction, yfunction (and zfunction) and that each operates over the
  1805.  common parametric domain.
  1806.  
  1807.  Also, the `set parametric` function implies a new range of values.
  1808.  Whereas the normal f(x) and f(x,y) style plotting assume an xrange
  1809.  and yrange (and zrange), the parametric mode additionally specifies a
  1810.  trange, urange, and vrange. These ranges may be set
  1811.  directly with `set trange`, `set urange` and `set vrange`, or by
  1812.  specifying the range on the `plot` or `splot` commands. Currently
  1813.  the default range for these parametric variables is [-5:5].
  1814.  Setting the ranges to something more meaningful is expected.
  1815. ?set polar
  1816. ?set nopolar
  1817. ?show polar
  1818. ?polar
  1819. ?nopolar
  1820.  The `set polar` command changes the meaning of the plot from
  1821.  rectangular coordinates to polar coordinates. In polar coordinates,
  1822.  the dummy variable (x) is an angle. The range of this angle is changed
  1823.  from whatever it was to [0:2*pi], or, if degree unit has been selected,
  1824.  to [0:360] (see `set angles`).
  1825.  
  1826.  The command `set nopolar` changes the meaning of the plot back to the
  1827.  default rectangular coordinate system. The range of x is changed from
  1828.  whatever it was to [-10:10].
  1829.  
  1830.  The `set polar` command is not supported for `splot`s.  See the
  1831.  `set mapping` command for similar functionality for `splot`s.
  1832.  
  1833.  While in polar coordinates the meaning of an expression in x is really
  1834.  r = f(x), where x is an angle of rotation. The xrange controls the
  1835.  domain (the angle) of the function, and the yrange controls the range
  1836.  (the radius). The plot is plotted in a rectangular box, and the x and
  1837.  y axes are both in units of the radius. Thus, the yrange controls both
  1838.  dimensions of the plot output. The tics and units are written along
  1839.  the axes rather than at the left and bottom. These unit are offset by
  1840.  <rmin> specified by the `rrange` (See `set rrange`). It is not
  1841.  possible to specify different output dimensions in the x or y
  1842.  directions. The yrange can be used to shift the plot diagonally to
  1843.  display only the first or third quadrants.
  1844.  
  1845.  Syntax:
  1846.          set polar
  1847.          set nopolar
  1848.          show polar
  1849.  Example:
  1850.          set polar
  1851.          plot x*sin(x)
  1852.          plot [-2*pi:2*pi] [-3:3] x*sin(x)
  1853.  The first plot uses the default polar angular domain of 0 to 2*pi.
  1854.  The radius (and the size of the plot) is scaled automatically. The
  1855.  second plot expands the domain, and restricts the range of the radius
  1856.  (and the size of the plot) to [-3:3].
  1857. ?set rrange
  1858. ?show rrange
  1859. ?rrange
  1860.  The `set rrange` command sets the radial range used to compute x and y
  1861.  values when in polar mode. If not in polar mode (see `set polar`) then
  1862.  this range is not used. Use of this command offsets the polar
  1863.  singularity to the <rmin> value and shifts the units on the axes tic
  1864.  marks. For instance, `set rrange [-40:40]` would set the origin to -40
  1865.  and would plot values of radial values between -40 to 40. Thus, if
  1866.  360 degrees of data were plotted, then the plot would extend 80 units
  1867.  in radially from the origin.  To view the entire plot,  a
  1868.  `set yrange [-80:80]` command would create a square viewport with
  1869.  a circular plot tangent at the axes.  Because `xrange` is used
  1870.  specify the angular extent, only a square viewport can be specified
  1871.  by `yrange`.  For instance, `set yrange [0:80]` would display the
  1872.  first quadrant and `set yrange [-80:0]` would display the third
  1873.  quadrant.  Any square viewport of any size can be specified but it
  1874.  is constrained to be centered on a 45 degree line.
  1875.  
  1876.  This range may also be specified on the `plot` command line when in
  1877.  polar mode.
  1878.  
  1879.  Syntax:
  1880.          set rrange [{<rmin> : <rmax>}]
  1881.  
  1882.  where <rmin> and <rmax> terms are constants or expressions.
  1883.  
  1884.  Both the <rmin> and <rmax> terms are optional. Anything omitted will
  1885.  not be changed, so
  1886.          set rrange [:10]
  1887.  changes rmax to 10 without affecting rmin.
  1888. ?set samples
  1889. ?show samples
  1890. ?samples
  1891.  The sampling rate of functions may be changed by the `set samples`
  1892.  command. By default, sampling is set to 100 points. A higher sampling
  1893.  rate will produce more accurate plots, but will take longer. This
  1894.  parameter no longer has any effect on data-file plotting.
  1895.  
  1896.  Syntax:
  1897.          set samples <samples_1> {,<samples_2>}
  1898.          show samples
  1899.  
  1900.  When a 2-d plot is being done, only the value of <samples_1> is
  1901.  relevant.
  1902.  
  1903.  When a surface plot is being done without the removal of hidden
  1904.  lines, the value of samples specifies the number of samples that are
  1905.  evaluated per iso line. Each iso-v line will have <sample_1> samples
  1906.  and each iso-u line will have <sample_2> samples. If you only specify
  1907.  <samples_1>, <samples_2> will be set to the same value as <samples_1>.
  1908.  See also `set isosamples`.
  1909. ?set size
  1910. ?show size
  1911. ?size
  1912.  The `set size` command scales the displayed size of the plot.  On some
  1913.  terminals, changing the size of the plot will result in text being
  1914.  misplaced. Increasing the size of the plot may produce strange
  1915.  results. Decreasing is safer.
  1916.  
  1917.  Syntax:
  1918.  
  1919.          set size {<xscale>,<yscale>}
  1920.          show size
  1921.  
  1922.  The <xscale> and <yscale> values are the scaling factors for the size.
  1923.  The defaults (1,1) are selected if the scaling factors are omitted.
  1924.  
  1925.  Examples:
  1926.  
  1927.  To set the size to normal size use:
  1928.          set size
  1929.  To make the plot half size use:
  1930.          set size 0.5,0.5
  1931.  To make a landscape plot have a 1:1 aspect ratio in polar mode use:
  1932.          set size 0.721,1.0
  1933.  To show the size use:
  1934.          show size
  1935.  
  1936.  For the LaTeX and Fig terminals the default size (scale factor 1,1)
  1937.  is 5 inches wide by 3 inches high. The big Fig terminal (`bfig`) is 7
  1938.  inches wide by 5 inches high. The postscript default is landscape mode
  1939.  10 inches wide and 7 inches high.
  1940.  Note that the size of the plot includes the space used by the labels;
  1941.  the plotting area itself is smaller.
  1942. ?set style
  1943. ?show style
  1944. ?style
  1945. ?lines
  1946. ?points
  1947. ?linespoints
  1948. ?impulses
  1949. ?dots
  1950. ?steps
  1951. ?errorbars
  1952. ?boxes
  1953. ?boxerrorbars
  1954. ?bargraph
  1955.  Plots may be displayed in one of eight styles: `lines`, `points`,
  1956.  `linespoints`, `impulses`, `dots`, `steps`, `errorbars`, `boxes`, or
  1957.  `boxerrorbars`.  The `lines` style connects adjacent points with lines.
  1958.  The `points` style displays a small symbol at each point.
  1959.  The `linespoints` style does both `lines` and `points`.
  1960.  The `impulses` style displays a vertical line from the x axis
  1961.  (or from the grid base for `splot`) to each point. The `dots` style
  1962.  plots a tiny dot at each point; this is useful for
  1963.  scatter plots with many points.
  1964.  
  1965.  The `errorbars` style is only relevant to 2-d data file plotting. It
  1966.  is treated like `points` for `splot`s and function `plot`s. For data
  1967.  `plot`s, `errorbars` is like `points`, except that a vertical error
  1968.  bar is also drawn: for each point (x,y), a line is drawn from
  1969.  (x,ylow) to (x,yhigh). A tic mark is placed at the ends of the error
  1970.  bar. The ylow and yhigh values are read from the data file's columns,
  1971.  as specified with the `using` option to plot. See `plot errorbars` for
  1972.  more information.
  1973.  
  1974.  The `boxes` style is only relevant to 2-d plotting.  It draws
  1975.  a box centred about the given x coordinate from the yaxis to the given
  1976.  y coordinate.   The width of the box is obtained in one of three
  1977.  ways.  If a data file has a fifth column, this will be used to set
  1978.  the width of the box.  Otherwise, if a width has been set using the
  1979.  `set boxwidth` command, this will be used.  Otherwise the width of each
  1980.  box will be calculated automatically so that it touches the adjacent
  1981.  boxes.  Another style called `boxerrorbars` is also available and is
  1982.  only  relevant to 2-d data file plotting.  This style is a combination
  1983.  of the `boxes` and `errorbars` styles.
  1984.  
  1985.  The `steps` style is only relevant to 2-d plotting.  This style
  1986.  connects consecutive points with two line segments: the first
  1987.  from (x1,y1) to (x2,y1) and the second from (x2,y1) to (x2,y2).
  1988.  
  1989.  Default styles are chosen with the `set function style` and
  1990.  `set data style` commands. See `plot style` for information about
  1991.  how to override the default plotting style for individual functions.
  1992.  
  1993.  Syntax:
  1994.          set function style <style>
  1995.          set data style <style>
  1996.          show function style
  1997.          show data style
  1998.  
  1999.  where <style> is `lines`, `points`, `linespoints`, `impulses`,
  2000.  `dots`, `steps`, `errorbars`, `boxes`, or `boxerrorbars`.
  2001. ?set surface
  2002. ?set nosurface
  2003. ?show surface
  2004. ?surface
  2005.  `set surface` controls the display of surfaces. It is useful if
  2006.  contours are to be displayed by themselves. Whenever `set nosurface`
  2007.  is issued, no surface isolines/mesh will be drawn. See also
  2008.  `set contour`.
  2009.  
  2010.  Syntax:
  2011.          set surface
  2012.          set nosurface
  2013.          show surface
  2014. ?set terminal
  2015. ?show terminal
  2016. ?terminal
  2017.  GNUPLOT supports many different graphics devices. Use the
  2018.  `set terminal` command to select the type of device for which
  2019.  GNUPLOT will produce output.
  2020.  
  2021.  Syntax:
  2022.          set terminal {<terminal-type>}
  2023.          show terminal
  2024.  
  2025.  If <terminal-type> is omitted, GNUPLOT will list the available
  2026.  terminal types. <terminal-type> may be abbreviated.
  2027.  
  2028.  Use `set output` to redirect this output to a file or device.
  2029.  
  2030.  Several terminals have additional options. For example, see `dumb`,
  2031.  `iris4d`, `hpljii` or `postscript`.
  2032. ?set terminal aifm
  2033. ?aifm
  2034.  Several options may be set in the Adobe Illustrator 3.0 driver.
  2035.  
  2036.  Syntax:
  2037.          set terminal aifm {<color>}
  2038.                                  {"<fontname>"} {<fontsize>}
  2039.  
  2040.  Selecting default sets all options to their default values.
  2041.  <color> is either `color` or `monochrome`.
  2042.  "<fontname>" is the name of a valid PostScript font.
  2043.  <fontsize> is the size of the font in PostScript points, before
  2044.  scaling by the `set size` command.
  2045.  Defaults are `monochrome`, "Helvetica", and 14pt.
  2046.  
  2047.  Also, since AI does not really support multiple pages, multiple
  2048.  graphs will be output directly on one another.  However, each graph
  2049.  will be grouped individually, making it easy to separate them inside
  2050.  AI (just pick them up and move them).
  2051.  
  2052.  Examples:
  2053.  
  2054.          set term aifm
  2055.          set term aifm 22
  2056.          set size 0.7,1.4
  2057.          set term aifm color "Times-Roman" 14
  2058.  
  2059. ?set terminal atari
  2060. ?atari
  2061.  The `atari` terminal has an option to set the character size and the
  2062.  screen colors.  The driver expects a space separated list the char size
  2063.  and maximal 16 3 digit hex numbers where each digit represents RED, GREEN
  2064.  and BLUE (in that order).  The range of 0-15 is scaled to whatever color
  2065.  range the screen actually has.  On a normal ST screen, odd and even
  2066.  intensities are the same.
  2067.  
  2068.  Examples:
  2069.  
  2070.         set terminal atari 4 # (use small (6x6) font)
  2071.         set terminal atari 6 0 # (set monochrome screen to white on black)
  2072.         set terminal atari 13 0 fff f00 f0 f ff f0f ff0
  2073.         # (set first eight colors to black, white, green, blue, cyan, \
  2074.           purple, and yellow and use large font (8x16).)
  2075.  
  2076.  Additionally, if an environment variable GNUCOLORS exists, its
  2077.  contents are interpreted as an options string, but an explicit terminal
  2078.  option takes precedence.
  2079.  
  2080. ?set terminal dumb
  2081. ?dumb
  2082.  The dumb terminal driver has an optional size specification.
  2083.  
  2084.  Syntax:
  2085.          set terminal dumb {<xsize> <ysize>}
  2086.  
  2087.  where <xsize> and <ysize> set the size of the dumb terminals. Default
  2088.  is 79 by 24.
  2089.  
  2090.  Examples:
  2091.          set term dumb
  2092.          set term dumb 79 49 # VGA screen--why would anyone want to do that?
  2093. ?set terminal epson
  2094. ?set terminal epson180
  2095. ?set terminal epson60
  2096. ?set terminal starc
  2097. ?set terminal tandy60
  2098. ?epson
  2099.  
  2100.  This set of drivers support Epson printers and derivatives.   See also
  2101.  the NEC driver.  `epson` is a generic 9 wire printer with a resolution
  2102.  of 512x384. `starc` is a Star Color printer with the same resolution.
  2103.  `epson180` and `epson60` are 180 dpi and 60 dpi drivers for newer
  2104.  24 wire printers.  This also includes bubble jet printers.  Their
  2105.  resolutions are 1260x1080 and 480x360, respectively.  The `tandy60`
  2106.  is identical to the `epson60` driver with one additional escape
  2107.  sequence to start IBM mode.  With all of these drivers, a binary
  2108.  copy is required on a PC to print.  Do not use `print`.
  2109.  
  2110.         copy file /b lpt1:
  2111.  
  2112.  
  2113. ?set terminal gpic
  2114. ?gpic
  2115.  
  2116.  This driver is only known to work the Free Software Foundation
  2117.  gpic/groff package.  Modification for the Document Workbench
  2118.  pic/troff package would be appreciated.  FSF gpic can also
  2119.  produce TeX output.
  2120.  
  2121.  A simple graph can be formatted using
  2122.  
  2123.       groff -p -mpic -Tps file.pic > file.ps.
  2124.  
  2125.  The output from pic can be pipe-lined into eqn, so it is possible to put
  2126.  complex functions in a graph with the set label and set {x/y}label commands.
  2127.  For instance,
  2128.  
  2129.     set ylab '@space 0 int from 0 to x alpha ( t ) roman d t@'
  2130.  
  2131.  Will label the y-axis with a nice integral if formatted with the
  2132.  command:
  2133.  
  2134.     gpic filename.pic | geqn -d@@ -Tps | groff -m[macro-package] -Tps
  2135.          > filename.ps
  2136.  
  2137.  Figures made this way can be scaled to fit into a document. The pic
  2138.  language is easy to understand, so the graphs can be edited by hand if
  2139.  need be. All coordinates in the pic-file produced by gnuplot are given
  2140.  as x+gnuplotx and y+gnuploty. By default x and y are given the value 0
  2141.  If this line is removed with an editor in a number of files one can
  2142.  put several graphs i one figure like this (default size is 5.0x3.0 inches)
  2143.  
  2144.     .PS 8.0
  2145.     x=0;y=3
  2146.     copy "figa.pic"
  2147.     x=5;y=3
  2148.     copy "figb.pic"
  2149.     x=0;y=0
  2150.     copy "figc.pic"
  2151.     x=5;y=0
  2152.     copy "figd.pic"
  2153.     .PE
  2154.  
  2155.  This will produce an 8 inches wide figure with four graphs in two rows
  2156.  on top of each other
  2157.  
  2158.  One can also achieve the same thing by the command
  2159.  
  2160.    set term pic x y
  2161.  
  2162.  For example, using
  2163.  
  2164.    .PS 6.0
  2165.    copy "trig.pic"
  2166.    .PE
  2167.  
  2168. ?set terminal hpljii
  2169. ?hpljii
  2170.  The HP LaserJet II and HP DeskJet drivers have a single option.
  2171.  
  2172.  Syntax:
  2173.          set terminal hpljii {<resolution>}
  2174.          set terminal hpdj   {<resolution>}
  2175.  
  2176.  where <resolution> is the resolution of the output in dots per inch.
  2177.  It must be `75`, `100`, `150` or `300`.  Note: there must be
  2178.  enough memory available to rasterize at the higher resolutions.
  2179.  
  2180.  Example:
  2181.          set terminal hpljii 150
  2182.  
  2183. ?set terminal latex
  2184. ?latex
  2185.  The LaTeX and EMTeX driver allows one to specify a font type and a font
  2186.  size for the labels around a gnuplot graph.
  2187.  
  2188.  Options are:
  2189.  Fonts:
  2190.        default          (Roman 10 point)
  2191.        courier
  2192.        roman
  2193.  
  2194.  at any size you specify. (BEWARE METAFONT will not like odd sizes.)
  2195.  eg.
  2196.        gnuplot> set term latex courier 5
  2197.  
  2198.  Unless your driver is capable of building fonts at any size (e.g. dvips),
  2199.  stick to the standard 10, 11 and 12 point size.
  2200.  
  2201. ?set terminal iris4d
  2202. ?iris4d
  2203.  The iris4d driver can operate in two modes.
  2204.  
  2205.  Syntax:
  2206.          set terminal iris4d {24}
  2207.  
  2208.  If the hardware supports only 8 bits, use the default
  2209.  `set terminal iris4d`. If, however, the hardware supports 24 bits
  2210.  (8 per red/green/blue), use `set terminal iris4d 24`.
  2211.  
  2212.  When using 24-bit mode, the colors can be directly specified via the
  2213.  file .gnuplot_iris4d that is searched in the current directory and
  2214.  then in the home directory specified by the HOME environment variable.
  2215.  This file holds RGB values for the background, border, labels and nine
  2216.  plotting colors, in that order. For example, here is a file containing
  2217.  the default colors:
  2218.  
  2219.          85   85   85     /* Back Ground */
  2220.          0    0    0      /* Boundary */
  2221.          170  0    170    /* Labeling */
  2222.          85   255  255    /* Plot Color 1 */
  2223.          170  0    0      /* Plot Color 2 */
  2224.          0    170  0      /* Plot Color 3 */
  2225.          255  85   255    /* Plot Color 4 */
  2226.          255  255  85     /* Plot Color 5 */
  2227.          255  85   85     /* Plot Color 6 */
  2228.          85   255  85     /* Plot Color 7 */
  2229.          0    170  170    /* Plot Color 8 */
  2230.          170  170  0      /* Plot Color 9 */
  2231.  
  2232.  This file has exactly 12 lines of RGB triples. No empty lines are
  2233.  allowed and anything after the third number in line is ignored.
  2234.  
  2235. ?set terminal mf
  2236. ?mf
  2237. ?metafont
  2238.  The mf terminal driver creates a input file to the MetaFont program.
  2239.  Thus a figure may be used in the TeX document in the same way as a
  2240.  character is.
  2241.  
  2242.  To use the plot in a document the MetaFont program must be run
  2243.  with the output file from GnuPlot as input. Thus, the user needs a basic
  2244.  knowledge of the font creating process and inclusion of a new font in a
  2245.  document. However, if the Metafont program is set up properly at the
  2246.  local site an unexperienced user could perform the operation without
  2247.  much trouble.
  2248.  
  2249.  The text support is based on a MetaFont character set.
  2250.  Currently the Computer Modern Roman font set is input but the
  2251.  user are in principal free to chose whatever fonts he/she needs.
  2252.  The MetaFont source files for the chosen font must be available.
  2253.  Each character is stored in a separate picture variable in MetaFont. These
  2254.  variables may be manipulated (rotated, scaled etc.) when characters are
  2255.  needed. The drawback is the interpretation time in the MetaFont
  2256.  program. On some machines (i.e. PC) the limited amount of memory available
  2257.  may also cause problem if too many pictures are stored.
  2258.  
  2259. ?set terminal mf detailed
  2260. ?mf detailed
  2261. ?metafont detailed
  2262.  
  2263.  - Set your terminal to metafont:
  2264.    set terminal mf
  2265.  - Select an output-file, e.g.:
  2266.    set output "myfigures.mf"
  2267.  - Do your plots. Each plot will generate a separate character. Its default
  2268.  size will be 5*3 inches. You can change the size by saying set size 0.5,0.5
  2269.  or whatever fraction of the default size you want to have.
  2270.  
  2271.  - Quit gnuplot.
  2272.  
  2273.  - Generate a tfm- and gf-file by running metafont on the output of gnuplot.
  2274.  Since the plot is quite large (5*3 in), you will have to use a version
  2275.  of metafont that has a value of at least 150000 for memmax. On Unix-systems
  2276.  these are conventionally installed under the name bigmf. For the following
  2277.  assume that the command virmf stands for a big version of metafont. For example:
  2278.  
  2279.  - Invoke metafont:
  2280.      virmf '&plain'
  2281.  - Select the output device: At the metafont prompt ('*') type:
  2282.      \mode:=CanonCX;     % or whatever printer you use
  2283.  - Optionally select a magnification:
  2284.      mag:=1;             % or whatever you wish
  2285.  - Input the gnuplot-file:
  2286.      input myfigures.mf
  2287.  On a typical Unix machine there will usually be a script called mf that
  2288.  executes virmf '&plain', so you probably can substitute mf for virmf &plain.
  2289.  This will generate two files: mfput.tfm and mfput.$$$gf (where $$$ indicates
  2290.  the resolution of your device). The above can be conveniently achieved by
  2291.  typing everything on the command line, e.g.:
  2292.  virmf '&plain' '\mode:=CanonCX; mag:=1; input myfigures.mf'
  2293.  In this case the output files will be named myfigures.tfm and
  2294.  myfigures.300gf.
  2295.  
  2296.  - Generate a pk-file from the gf-file using gftopk:
  2297.    gftopk myfigures.300gf myfigures.300pk
  2298.  The name of the output-file for gftopk depends on the dvi-driver you use.
  2299.  Ask your local TeX-administrator about the naming conventions.
  2300.  Next, either install the tfm- and pk-files in the appropriate directories,
  2301.  or set your environment-variables properly. Usually this involves setting
  2302.  TEXFONTS to include the current directory and do the same thing for the
  2303.  environment-variable that your dvi-driver uses (no standard name here...).
  2304.  This step is necessary so that TeX will find the font-metric file and your
  2305.  dvi-driver will find the pk-file.
  2306.  
  2307.  - To include your plots in your document you have to tell TeX the font:
  2308.    \font\gnufigs=myfigures
  2309.  Each plot you made is stored in a single character. The first plot is
  2310.  character 0, the second is character 1, and so on... After doing the above
  2311.  step you can use the plots just like any other characters. Therefore, to
  2312.  place plots 1 and 2 centered in your document, all you have to do is:
  2313.    \centerline{\gnufigs\char0}
  2314.    \centerline{\gnufigs\char1}
  2315.  in plain TeX. For LaTeX you can, of course, use the picture environment
  2316.  and place the plot according to your wishes using the \makebox and \put
  2317.  macros.
  2318.  
  2319.  It saves you a lot of time, once you have generated the
  2320.  font, since TeX handles the plots as characters and uses minimal time to
  2321.  place them. Also the documents you make change more often, than the plots
  2322.  do. Also it saves a lot of TeX-memory. One last advantage of
  2323.  using the metafont-driver is that the dvi-file really remains device
  2324.  independent, because no \special-commands are used as in the eepic- and
  2325.  tpic-drivers.
  2326. ?set terminal mif
  2327. ?mif
  2328.  Several options may be set in the MIF 3.00 driver.
  2329.  
  2330.  Syntax:
  2331.       set terminal mif {<pentype>} {<curvetype>} {<help>}
  2332.  
  2333.  <pentype> selects "colour" of the graphics.
  2334.       `colour`     plot lines with line types >= 0 in colour (MIF sep. 2-7).
  2335.       `monochrome` plot all line types in black (MIF sep. 0).
  2336.  <curvetype> selects how "curves" are plotted.
  2337.       `polyline`   plot curves as continuous curves.
  2338.       `vectors`    plot curves as collections of vectors
  2339.  <help> print online help on standard error output.
  2340.       `help`       print a short description of the usage, and the options
  2341.       `?`          print a short description of the usage
  2342.  
  2343.  This terminal driver produces Frame Maker MIF format version 3.00. It
  2344.  plots in MIF Frames with the size 15*10 [cm], and plot primitives with
  2345.  the same pen will be grouped in the same MIF group. Plot primitives in
  2346.  a gnuplot plot will be plotted in a MIF Frame, and several MIF Frames
  2347.  are collected in one large MIF Frame.
  2348.  Plot primitives with line types >= 0 will as default be drawn in colour.
  2349.  As default curves are plotted as continuous lines. The MIF font used for
  2350.  text is "Times".
  2351.  
  2352.  Examples:
  2353.  
  2354.       set term mif
  2355.       set term mif vectors
  2356.       set term mif help
  2357.  
  2358.  
  2359. ?set terminal nec-cp6
  2360. ?nec-cp6
  2361.  One option may be set in the nec-cp6 driver.  The resolution of this
  2362.  driver is 400x320.
  2363.  
  2364.  Syntax:
  2365.          set terminal nec-cp6 monochrome
  2366.          set terminal nec-cp6 color
  2367.          set terminal nec-cp6 draft
  2368.  
  2369. ?set terminal pbm
  2370. ?pbm
  2371.  Several options may be set in the PBMplus driver.
  2372.  
  2373.  Syntax:
  2374.          set terminal pbm {<fontsize>} {<colormode>}
  2375.  
  2376.  where <fontsize> is `small`, `medium`, or `large` and <colormode> is
  2377.  `monochrome`, `gray` or `color`.
  2378.  Default size is 640 pixels wide and 480 pixels high.
  2379.  The output for `monochrome` is a portable bitmap (one bit per pixel).
  2380.  The output for `gray` is a portable graymap (three bits per pixel).
  2381.  The output for `color` is a portable pixmap (color, four bits per pixel).
  2382.  The output of these drivers can be used with Jef Poskanzer's
  2383.  excellent PBMPLUS package which provides programs to convert
  2384.  the above PBMPLUS formats to GIF, TIFF, MacPaint, Macintosh PICT,
  2385.  PCX, X11 bitmap and many others.
  2386.  
  2387.  Examples:
  2388.  
  2389.          set term pbm small
  2390.          set size 2,2
  2391.          set term pbm color medium
  2392.  
  2393. ?set terminal pcl5
  2394. ?pcl5
  2395.  Three options may be set in the pcl5 driver.  The driver
  2396.  actually uses HPGL-2 but there is a name conflict among
  2397.  the terminal devices.
  2398.  
  2399.  Syntax:
  2400.          set terminal pcl5 {<mode>} {<font>} {<fontsize>}
  2401.  
  2402.  where <mode> is `landscape`, or `portrait`, <font> is `stick`,
  2403.  `univers`, or `cg_times`, and fontsize is the size in points.
  2404.          set terminal pcl5 landscape
  2405.  
  2406. ?set terminal postscript
  2407. ?postscript
  2408.  Several options may be set in the PostScript driver.
  2409.  
  2410.  Syntax:
  2411.          set terminal postscript {<mode>} {<color>} {<dashed>}
  2412.                                  {"<fontname>"} {<fontsize>}
  2413.  
  2414.  where <mode> is `landscape`, `portrait`, `eps` or `default`.
  2415.  Selecting default sets all options to their defaults.
  2416.  <color> is either `color` or `monochrome`.
  2417.  <dashed> is either `solid` or `dashed`.
  2418.  "<fontname>" is the name of a valid PostScript font.
  2419.  <fontsize> is the size of the font in PostScript points.
  2420.  Defaults are `landscape`, `monochrome`, `dashed`, "Helvetica", and 14pt.
  2421.  Default size of PostScript plot is landscape mode 10 inches wide
  2422.  and 7 inches high.
  2423.  
  2424.  To get EPS output, use the `eps` mode and make only one plot per file.
  2425.  In `eps` mode the whole plot is halved in size; the fonts are half the
  2426.  given size, and the plot is 5 inches wide and 3.5 inches high.
  2427.  
  2428.  Examples:
  2429.  
  2430.          set term postscript default       # old postscript
  2431.          set term postscript landscape 22  # old psbig
  2432.          set term postscript eps 14   # old epsf1
  2433.          set term postscript eps 22   # old epsf2
  2434.          set size 0.7,1.4
  2435.          set term post portrait color "Times-Roman" 14
  2436.  
  2437. ?set terminal regis
  2438. ?table
  2439.  The `regis` terminal device has the option of using 4 or 16
  2440.  colors.  The default is 4.  For example:
  2441.         set term regis 16
  2442.  
  2443. ?set terminal table
  2444. ?table
  2445.  Instead of producing a picture, term type `table` prints out
  2446.  the evaluation results in a multicolumn ASCII table of X Y Z values.
  2447.  For those times when you really want to see the numbers, now you
  2448.  can see them on the screen or save to a file.
  2449.  
  2450. ?set terminal windows
  2451. ?windows
  2452.  Three options may be set in the windows driver.
  2453.  
  2454.  Syntax:
  2455.          set terminal windows {<color>} {"<fontname>"} {<fontsize>}
  2456.  
  2457.  `<color>` is either `color` or `monochrome`.
  2458.  `"<fontname>"` is the name of a valid Windows font.
  2459.  `<fontsize>` is the size of the font in points.
  2460.  
  2461. ?set terminal windows graph-menu
  2462. ?graph-menu
  2463.  The `gnuplot graph` window has the following options on a pop up menu
  2464.  accessed by pressing the right mouse button or selecting `Options`
  2465.  from the system menu:
  2466.  
  2467.  `Bring to Top` when checked brings the graph window to
  2468.  the top after every plot.
  2469.  
  2470.  `Color` when checked enables color linestyles.
  2471.  When unchecked it forces monochrome linestyles.
  2472.  
  2473.  `Copy to Clipboard` copies a bitmap and a Metafile picture.
  2474.  
  2475.  `Background...` sets the window background color.
  2476.  
  2477.  `Choose Font...` selects the font used in the graphics window.
  2478.  
  2479.  `Line Styles...` allows customization of the line colors
  2480.  and styles.
  2481.  
  2482.  `Print...` prints the graphics windows using a Windows printer
  2483.  driver and allows selection of the printer and scaling of the output.
  2484.  The output produced by `Print` is not as good as that from gnuplot's
  2485.  own printer drivers.
  2486.  
  2487.  `Update wgnuplot.ini` saves the current window locations, window
  2488.  sizes, text window font, text window font size, graph window font,
  2489.  graph window font size, background color and linestyles to the
  2490.  initialisation file `WGNUPLOT.INI`.
  2491.  
  2492. ?set terminal windows printing
  2493. ?printing
  2494.  In order of preference, graphs may be be printed in the
  2495.  following ways.
  2496.  
  2497.  `1.` Use the gnuplot command `set terminal` to select a printer
  2498.  and `set output` to redirect output to a file.
  2499.  
  2500.  `2.` Select the `Print...` command from the `gnuplot graph` window.
  2501.  An extra command `screendump` does this from the text window.
  2502.  
  2503.  `3.` If `set output "PRN"` is used, output will go to a temporary file.
  2504.  When you exit from gnuplot or when you change the output with another
  2505.  `set output` command, a dialog box will appear for you to select
  2506.  a printer port.  If you choose OK, the output will be printed
  2507.  on the selected port, passing unmodified through the print
  2508.  manager.  It is possible to accidently (or deliberately) send
  2509.  printer output meant for one printer to an incompatible printer.
  2510.  
  2511. ?set terminal windows text-menu
  2512. ?text-menu
  2513.  The `gnuplot text` window has the following options on a pop up menu
  2514.  accessed by pressing the right mouse button or selecting `Options`
  2515.  from the system menu:
  2516.  
  2517.  `Copy to Clipboard` copies marked text to the clipboard.
  2518.  
  2519.  `Paste` copies text from the clipboard as if typed by the user.
  2520.  
  2521.  `Choose Font...` selects the font used in the text window.
  2522.  
  2523.  `System Colors` when selected makes the text window honor the
  2524.  System Colors set using the Control Panel.  When unselected,
  2525.  text is black or blue on a white background.
  2526.  
  2527.  `Update wgnuplot.ini` saves the current text window location, text
  2528.  window size, text window font and text window font size to the
  2529.  initialisation file `WGNUPLOT.INI`.
  2530.  
  2531.  `MENU BAR`
  2532.  
  2533.  If the menu file `WGNUPLOT.MNU` is found in the same directory as
  2534.  WGNUPLOT.EXE, then the menu specified in `WGNUPLOT.MNU` will
  2535.  be loaded.
  2536.  
  2537.  Menu commands are:
  2538.    [Menu]       Start a new menu with the name on the following line
  2539.    [EndMenu]    End current menu.
  2540.    --           Insert a horizontal menu separator
  2541.    |            Insert a vertical menu separator
  2542.    [Button]     Put next macro on a push button instead of a menu.
  2543.  
  2544.  Macros take two lines with the macro name (menu entry) on the first
  2545.  line and the macro on the second line.  Leading spaces are ignored.
  2546.  
  2547.  Macros commands are:
  2548.    [INPUT]      Input string with prompt terminated by [EOS] or {ENTER}
  2549.    [EOS]        End Of String terminator.  Generates no output.
  2550.    [OPEN]       Get name of file to open from list box, with title of
  2551.                 list box terminated by [EOS], followed by default
  2552.                 filename terminated by [EOS] or {ENTER}
  2553.                 This uses COMMDLG.DLL from Windows 3.1.
  2554.    [SAVE]       Get name of file to save.  Similar to [OPEN]
  2555.  
  2556.  Macros character substitutions are:
  2557.    {ENTER}      Carriage Return '\r'
  2558.    {TAB}        Tab     '\011'
  2559.    {ESC}        Escape  '\033'
  2560.    {^A}         '\001'
  2561.    ...
  2562.    {^_}         '\031'
  2563.  
  2564.  Macros are limited to 256 characters after expansion.
  2565.  
  2566. ?set terminal windows wgnuplot.ini
  2567. ?wgnuplot.ini
  2568.  Windows gnuplot will read some of its options from the `[WGNUPLOT]` section
  2569.  of `WGNUPLOT.INI` in the Windows directory.
  2570.  An example `WGNUPLOT.INI` file is shown below.
  2571.   [WGNUPLOT]
  2572.   TextOrigin=0 0
  2573.   TextSize=640 150
  2574.   TextFont=Terminal,9
  2575.   GraphOrigin=0 150
  2576.   GraphSize=640 330
  2577.   GraphFont=Arial,10
  2578.   GraphColor=1
  2579.   GraphToTop=1
  2580.   GraphBackground=255 255 255
  2581.   Border=0 0 0 0 0
  2582.   Axis=192 192 192 2 2
  2583.   Line1=0 0 255 0 0
  2584.   Line2=0 255 0 0 1
  2585.   Line3=255 0 0 0 2
  2586.   Line4=255 0 255 0 3
  2587.   Line5=0 0 128 0 4
  2588.  The `GraphFont` entry specifies the font name and size in points.
  2589.  The 5 numbers given in the `Border`, `Axis` and `Line` entries are
  2590.  the `Red` intensity (0-255), `Green` intensity, `Blue` intensity,
  2591.  `Color Linestyle` and `Mono Linestyle`.
  2592.  `Linestyles` are 0=SOLID, 1=DASH, 2=DOT, 3=DASHDOT, 4=DASHDOTDOT.
  2593.  In the example `WGNUPLOT.INI` file above, Line 2 is a green solid
  2594.  line in color mode, or a dashed line in monochrome mode.
  2595.  The default line width is 1 pixel.  If `Linestyle` is negative it
  2596.  specifies the width of a SOLID line in pixels.
  2597.  Line1 and any linestyle used with the `points` style must be
  2598.  SOLID with unit width.
  2599.  
  2600. ?set terminal windows windows3.0
  2601. ?windows3.0
  2602.  Windows 3.1 is preferred, but WGNUPLOT will run under Windows 3.0
  2603.  with the following restrictions:
  2604.  
  2605.  `1.` COMMDLG.DLL and SHELL.DLL (available with Windows 3.1 or Borland C++ 3.1)
  2606.  must be in the windows directory.
  2607.  
  2608.  `2.` WGNUPLOT.HLP produced by Borland C++ 3.1 is in Windows 3.1 format.
  2609.  You need to use the WINHELP.EXE supplied with Borland C++ 3.1.
  2610.  
  2611.  `3.` It won't run in real mode due to lack of memory.
  2612.  
  2613.  `4.` Truetype fonts are not available in the graph window.
  2614.  
  2615.  `5.` Drag-drop does not work.
  2616.  
  2617. ?set tics
  2618. ?show tics
  2619. ?tics
  2620.  By default, tics are drawn inwards from the border on all four sides.
  2621.  The `set tics` command can be used to change the tics to be
  2622.  drawn outwards on the left and bottom borders only.
  2623.  This is useful when doing impulse plots.
  2624.  
  2625.  Syntax:
  2626.          set tics {<direction>}
  2627.          show tics
  2628.  
  2629.  where <direction> may be `in` or `out`. `set tics` defaults to `in`.
  2630.  
  2631.  See also the `set xtics`, `set ytics`, and `set ztics` command for more
  2632.  control of tic marks.
  2633. ?set ticslevel
  2634. ?show ticslevel
  2635. ?ticslevel
  2636.  Using splot, in 3-d plots, one can adjust the relative height of the
  2637.  vertical (Z) axis using `set ticslevel`. The numeric argument provided
  2638.  specifies the location of the bottom of the scale. a zero will put it
  2639.  on the bottom grid and any positive number somewhere along the z axis.
  2640.  
  2641.  Syntax:
  2642.          set ticslevel {<level>}
  2643.          show tics
  2644.  
  2645.  where <level> is a non negative numeric argument. For example,
  2646.  
  2647.          set ticslevel 0.5
  2648.  
  2649.  sets the tics level to the default value.
  2650.  
  2651.  See also the `set view`.
  2652. ?set time
  2653. ?show time
  2654. ?time
  2655.  The optional `set time` places the time and date of the plot either
  2656.  at the top or bottom of the left margin. The exact location is
  2657.  device dependent.
  2658.  
  2659.  Syntax:
  2660.          set time {<xoff>}{,<yoff>}
  2661.          set notime
  2662.          show time
  2663.  
  2664.  Specifying constants <xoff> or <yoff> as optional offsets for the time
  2665.  will move the time <xoff> or <yoff> character screen coordinates. For
  2666.  example,
  2667.  
  2668.          set time ,-3
  2669.  
  2670.  will change only the y offset of the time, moving the title down by
  2671.  roughly the height of three characters.
  2672.  
  2673. ?set title
  2674. ?show title
  2675. ?title
  2676.  The `set title` command produces a plot title that is centered at the
  2677.  top of the plot. Using the optional x,y screen offsets, the title
  2678.  can be placed anywhere on the plot. `set title` with no parameters
  2679.  clears the title.
  2680.  
  2681.  Syntax:
  2682.           set title {"<title-text>"} {<xoff>}{,<yoff>}
  2683.           show title
  2684.  
  2685.  Specifying constants <xoff> or <yoff> as optional offsets for the
  2686.  title will move the title <xoff> or <yoff> character screen
  2687.  coordinates. Note these are screen coordinates and not plot
  2688.  coordinates. For example,
  2689.  
  2690.           set title ,-1
  2691.  
  2692.  will change only the y offset of the title, moving the title down by
  2693.  roughly the height of one character.
  2694.  
  2695.  (The EEPIC, Imagen, LaTeX, and TPIC drivers allow \\ in a string to specify
  2696.  a newline.)
  2697. ?set trange
  2698. ?show trange
  2699. ?trange
  2700.  The `set trange` command sets the parametric range used to compute
  2701.  x and y values when in parametric mode. If not in parametric mode
  2702.  (see `set parametric`) then this range is not used. This command
  2703.  does not affect x/y autoscaling or x/y ranges.
  2704.  
  2705.  This range may also be specified on the `plot` command line when
  2706.  in parametric mode.
  2707.  
  2708.  Syntax:
  2709.          set trange [{<tmin> : <tmax>}]
  2710.  
  2711.  where <tmin> and <tmax> terms are constants or expressions.
  2712.  
  2713.  Both the <tmin> and <tmax> terms are optional. Anything omitted will
  2714.  not be changed, so
  2715.          set trange [:10]
  2716.  changes tmax to 10 without affecting tmin.  See also `set urange` and
  2717.  `set parametric`.
  2718. ?set urange
  2719. ?show urange
  2720. ?urange
  2721.  The `set urange` and `set vrange` commands sets the parametric ranges used
  2722.  to compute x, y, and z values when in `splot` parametric mode. If not in
  2723.  parametric mode (see `set parametric`) then these ranges are not used. This
  2724.  command does not affect x/y autoscaling or x/y ranges.
  2725.  
  2726.  This range may also be specified on the `splot` command line when
  2727.  in parametric mode.  See `plot` for more information
  2728.  
  2729.  Syntax:
  2730.          set urange [{<umin> : <umax>}]
  2731.  
  2732.  where <umin> and <umax> terms are constants or expressions.
  2733.  
  2734.  Both the <umin> and <umax> terms are optional. Anything omitted will
  2735.  not be changed, so
  2736.          set urange [:10]
  2737.  changes umax to 10 without affecting umin.  See also `set trange`.
  2738. ?show variables
  2739.  The `show variables` command lists all user-defined variables and
  2740.  their values.
  2741.  
  2742.  Syntax:
  2743.          show variables
  2744. ?set view
  2745. ?show view
  2746. ?view
  2747.  The `set view` command sets the view point for `splot`s. This
  2748.  command controls the way the 3-d coordinates of the plot are mapped
  2749.  into the 2-d screen space. This command provides controls to both
  2750.  rotation and scaling of the plotted data but supports orthographic
  2751.  projections only.
  2752.  
  2753.  Syntax:
  2754.          set view <rot_x> {,{<rot_z>}{,{<scale>}{,<scale_z>}}}
  2755.          show view
  2756.  
  2757.  where <rot_x> and <rot_z> control the rotation angles (in degrees)
  2758.  along a virtual 3-d coordinate system aligned with the screen such
  2759.  that the screen horizontal axis is x, screen vertical axis is y, and
  2760.  the axis perpendicular to the screen is z. <rot_x> is bounded to the
  2761.  [0:180] range with a default of 60 degrees, while <rot_z> is bounded
  2762.  to the [0:360] range with a default of 30 degrees. <scale> controls
  2763.  the scaling of the entire `splot`, while <scale_z> scales the z axis
  2764.  only. Both scales default to 1.0.
  2765.  
  2766.  Examples:
  2767.          set view 60, 30, 1, 1
  2768.          set view ,,0.5
  2769.  
  2770.  The first sets all the four default values. The second changes
  2771.  only scale, to 0.5.
  2772.  
  2773.  See also `set ticslevel`.
  2774. ?set vrange
  2775. ?show vrange
  2776. ?vrange
  2777.  The `set vrange` command is similar to the `set urange` command.
  2778.  Please see `set urange`.
  2779. ?set xlabel
  2780. ?show xlabel
  2781. ?xlabel
  2782.  The `set xlabel` command sets the x-axis label that is centered along
  2783.  the x axis. Using the optional x,y screen offsets, the label can be
  2784.  placed anywhere on the plot. `set xlabel` with no parameters clears
  2785.  the label.
  2786.  
  2787.  Syntax:
  2788.           set xlabel {"<label>"} {<xoff>}{,<yoff>}
  2789.           show xlabel
  2790.  
  2791.  Specifying constants <xoff> or <yoff> as optional offsets for the
  2792.  label will move the label <xoff> or <yoff> character screen
  2793.  coordinates. For example,
  2794.  
  2795.           set xlabel -1
  2796.  
  2797.  will change only the x offset of the xlabel, moving the label roughly
  2798.  one character width to the left.
  2799.  
  2800.  (The EEPIC, Imagen, LaTeX, and TPIC drivers allow \\ in a string to specify
  2801.  a newline.)
  2802. ?set xrange
  2803. ?show xrange
  2804. ?xrange
  2805.  The `set xrange` command sets the horizontal range that will be
  2806.  displayed. This command turns x axis autoscaling off.
  2807.  
  2808.  This range may also be specified on the `plot` command line.
  2809.  
  2810.  Syntax:
  2811.          set xrange [{<xmin> : <xmax>}]
  2812.  
  2813.  where <xmin> and <xmax> terms are constants or expressions.
  2814.  
  2815.  Both the <xmin> and <xmax> terms are optional. Anything omitted will
  2816.  not be changed, so
  2817.          set xrange [:10]
  2818.  changes xmax to 10 without affecting xmin.
  2819. ?set xtics
  2820. ?set noxtics
  2821. ?show xtics
  2822. ?xtics
  2823. ?noxtics
  2824.  Fine control of the x axis tic marks is possible with the
  2825.  `set xtics` command. The x-axis tic marks may be turned off with the
  2826.  `set noxtics` command. They may be turned on (the default state) with
  2827.  `set xtics`.
  2828.  
  2829.  Syntax:
  2830.           set xtics { {<start>, <incr>{, <end>}} |
  2831.                       {({"<label>"} <pos> {, {"<label>"} <pos>}...)} }
  2832.           set noxtics
  2833.           show xtics
  2834.  
  2835.  The <start>, <incr>, <end> form specifies that a series of tics will
  2836.  be plotted on the x axis between the x values <start> and <end>
  2837.  with an increment of <incr>. If <end> is not given it is assumed to be
  2838.  infinity. The increment may be negative. For example,
  2839.            set xtics 0,.5,10
  2840.  makes tics at 0, 0.5, 1, 1.5, ..., 9.5, 10.
  2841.  
  2842.  The ("<label>" <pos>, ...) form allows arbitrary tic positions or
  2843.  non-numeric tic labels. A set of tics are a set of positions, each
  2844.  with its own optional label. Note that the label is a string enclosed
  2845.  by quotes, and may be a constant string, such as "hello", or contain
  2846.  formatting information for the tic number (which is the same as the
  2847.  position), such as "%3f clients". See `set format` for more
  2848.  information about this case. The label may even be empty.
  2849.  Examples:
  2850.           set xtics ("low" 0, "medium" 50, "high" 100)
  2851.           set xtics (1,2,4,8,16,32,64,128,256,512,1024)
  2852.           set xtics ("bottom" 0, "" 10, "top" 20)
  2853.  
  2854.  Tics will only be plotted when in range.
  2855.  
  2856.  The `set ytics` and `set noytics` commands work identically.
  2857.  See also the `set format` command.
  2858. ?set xdtics
  2859. ?set noxdtics
  2860. ?show xdtics
  2861. ?xdtics
  2862. ?noxdtics
  2863.  The `set xdtics` commands converts the x axis tic marks to days of
  2864.  the week where 0=Sun and 6=Sat.  Overflows are converted modulo 7
  2865.  to dates.
  2866.  
  2867.  Examples:
  2868.         set xdtics
  2869.  
  2870.  Sets x axis tics in days.
  2871.  
  2872.  The `set ydtics` `set zdtics` and `set noydtics` `set nozdtics` commands
  2873.  work identically.
  2874.  See also the `set format` command.
  2875.  
  2876. ?set xmtics
  2877. ?set noxmtics
  2878. ?show xmtics
  2879. ?xmtics
  2880. ?noxmtics
  2881.  The `set xmtics` commands converts the x axis tic marks to months of
  2882.  the years where 1=Jan and 12=Dec.  Overflows are converted modulo 12
  2883.  to months.
  2884.  
  2885.  Examples:
  2886.         set xmtics
  2887.  
  2888.  Sets x axis tics into months.
  2889.  
  2890.  The `set ymtics` `set zmtics` and `set noymtics` `set nozmtics` commands
  2891.  work identically.
  2892.  See also the `set format` command.
  2893.  
  2894. ?set xzeroaxis
  2895. ?set noxzeroaxis
  2896. ?show xzeroaxis
  2897. ?xzeroaxis
  2898. ?noxzeroaxis
  2899.  `set xzeroaxis` draws the x-axis. By default, this option is on.
  2900.  `set noxzeroaxis` causes GNUPLOT to omit the x-axis.
  2901.  
  2902.  Syntax:
  2903.          set xzeroaxis
  2904.          set noxzeroaxis
  2905.          show xzeroaxis
  2906. ?set ylabel
  2907. ?show ylabel
  2908. ?ylabel
  2909.  The `set ylabel` command sets the y-axis label.  The position of this
  2910.  label depends on the terminal, and can be one of the following three
  2911.  positions (the position can be adjusted with optional parameters).
  2912.  
  2913.  1. Horizontal text flushed left at the top left of the plot.
  2914.  Terminals that cannot rotate text will probably use this method.
  2915.  
  2916.  2. Vertical text centered vertically at the left of the plot.
  2917.  Terminals that can rotate text will probably use this method.
  2918.  
  2919.  3. Horizontal text centered vertically at the left of the plot.
  2920.  The EEPIC, LaTeX and TPIC drivers use this method. The user must insert
  2921.  line breaks using \\ to prevent the ylabel from overwriting
  2922.  the plot. To produce a vertical row of characters, add \\
  2923.  between every printing character (but this is ugly).
  2924.  
  2925.  Syntax:
  2926.           set ylabel {"<label>"} {<xoff>}{,<yoff>}
  2927.           show ylabel
  2928.  
  2929.  With no parameters, the label is cleared. Specifying constants <xoff>
  2930.  or <yoff> as optional offsets for the label will move the label <xoff>
  2931.  or <yoff> character screen coordinates. For example,
  2932.  
  2933.           set ylabel -1
  2934.  
  2935.  will change only the x offset of the ylabel, moving the label roughly
  2936.  one character width left of its default position. This is especially
  2937.  useful with the LaTeX driver.
  2938.  
  2939.  (The EEPIC, Imagen, LaTeX, and TPIC drivers allow \\ in a string to specify
  2940.  a newline.)
  2941. ?set yrange
  2942. ?show yrange
  2943. ?yrange
  2944.  The `set yrange` command sets the vertical range that will be
  2945.  displayed. This command turns y axis autoscaling off.
  2946.  
  2947.  This range may also be specified on the `plot` command line.
  2948.  
  2949.  Syntax:
  2950.          set yrange [{<ymin> : <ymax>}]
  2951.  
  2952.  where <ymin> and <ymax> terms are constants or expressions.
  2953.  
  2954.  Both the <ymin> and <ymax> terms are optional. Anything omitted will
  2955.  not be changed, so
  2956.          set yrange [:10]
  2957.  changes ymax to 10 without affecting ymin.
  2958. ?set ytics
  2959. ?set noytics
  2960. ?show ytics
  2961. ?ytics
  2962. ?noytics
  2963.  The `set ytics` and `set noytics` commands are similar to the `set xtics`
  2964.  and `set noxtics` commands. Please see `set xtics`.
  2965. ?set ydtics
  2966. ?set noydtics
  2967. ?show ydtics
  2968. ?ydtics
  2969. ?noydtics
  2970.  The `set ydtics` and `set noydtics` commands are similar to the `set xdtics`
  2971.  and `set noxdtics` commands. Please see `set xdtics`.
  2972. ?set ymtics
  2973. ?set noymtics
  2974. ?show ymtics
  2975. ?ymtics
  2976. ?noymtics
  2977.  The `set ymtics` and `set noymtics` commands are similar to the `set xmtics`
  2978.  and `set noxmtics` commands. Please see `set xmtics`.
  2979. ?set yzeroaxis
  2980. ?set noyzeroaxis
  2981. ?show yzeroaxis
  2982. ?yzeroaxis
  2983. ?noyzeroaxis
  2984.  `set yzeroaxis` draws the y-axis. By default, this option is on.
  2985.  `set noyzeroaxis` causes GNUPLOT to omit the y-axis.
  2986.  
  2987.  Syntax:
  2988.          set yzeroaxis
  2989.          set noyzeroaxis
  2990.          show yzeroaxis
  2991. ?set zero
  2992. ?show zero
  2993. ?zero
  2994.  The `zero` value is the default threshold for values approaching 0.0.
  2995.  GNUPLOT will not plot a point if its imaginary part is greater in
  2996.  magnitude than the `zero` threshold. Axis ranges cannot be less than
  2997.  `zero`. The default `zero` value is 1e-8. This can be changed with
  2998.  the `set zero` command.
  2999.  
  3000.  Syntax:
  3001.          set zero <expression>
  3002.          show zero
  3003. ?set zeroaxis
  3004. ?set nozeroaxis
  3005. ?show zeroaxis
  3006. ?zeroaxis
  3007. ?nozeroaxis
  3008.  `set zeroaxis` draws the x-axis and y-axis. By default, this option is
  3009.  on.  `set nozeroaxis` causes GNUPLOT to omit the axes, and is
  3010.  equivalent to `set noxzeroaxis; set noyzeroaxis.`
  3011.  
  3012.  Syntax:
  3013.          set zeroaxis
  3014.          set nozeroaxis
  3015.          show zeroaxis
  3016.  See `set xzeroaxis` and `set yzeroaxis`.
  3017. ?set zlabel
  3018. ?show zlabel
  3019. ?zlabel
  3020.  The `set zlabel` command sets the z-axis label that is centered along
  3021.  the z axis. Using the optional x,y screen offsets, the label can be
  3022.  placed anywhere on the plot. `set zlabel` with no parameters clears
  3023.  the label.
  3024.  
  3025.  Syntax:
  3026.           set zlabel {"<label>"} {<xoff>}{,<yoff>}
  3027.           show zlabel
  3028.  
  3029.  Specifying constants <xoff> or <yoff> as optional offsets for the
  3030.  label will move the label <xoff> or <yoff> character screen
  3031.  coordinates. For example,
  3032.  
  3033.           set zlabel ,1
  3034.  
  3035.  will change only the y offset of the zlabel, moving the label roughly
  3036.  one character height up.
  3037.  
  3038.  The zlabel will be drawn whenever surfaces or contours are plotted,
  3039.  in the space above the grid level.
  3040.  
  3041.  (The EEPIC, Imagen, LaTeX, and TPIC drivers allow \\ in a string to specify
  3042.  a newline.)
  3043. ?set zrange
  3044. ?show zrange
  3045. ?zrange
  3046.  The `set zrange` command sets the vertical range that will be
  3047.  displayed. This command turns z axis autoscaling off.  The zrange is
  3048.  used only by `splot` and is ignored by `plot`.
  3049.  
  3050.  This range may also be specified on the `splot` command line.
  3051.  
  3052.  Syntax:
  3053.          set zrange [{<zmin> : <zmax>}]
  3054.  
  3055.  where <zmin> and <zmax> terms are constants or expressions.
  3056.  
  3057.  Both the <zmin> and <zmax> terms are optional. Anything omitted will
  3058.  not be changed, so
  3059.          set zrange [2:]
  3060.  changes zmin to 2 without affecting zmax.
  3061. ?set ztics
  3062. ?set noztics
  3063. ?show ztics
  3064. ?ztics
  3065. ?noztics
  3066.  The `set ztics` and `set noztics` commands are similar to the
  3067.  `set xtics` and `set noxtics` commands. Please see `set xtics`.
  3068. ?set zdtics
  3069. ?set nozdtics
  3070. ?show zdtics
  3071. ?zdtics
  3072. ?nozdtics
  3073.  The `set zdtics` and `set nozdtics` commands are similar to the
  3074.  `set xdtics` and `set noxdtics` commands. Please see `set xdtics`.
  3075.  
  3076. ?set zmtics
  3077. ?set nozmtics
  3078. ?show zmtics
  3079. ?zmtics
  3080. ?nozmtics
  3081.  The `set zmtics` and `set nozmtics` commands are similar to the
  3082.  `set xmtics` and `set noxmtics` commands. Please see `set xmtics`.
  3083. ?shell
  3084.  The `shell` command spawns an interactive shell. To return to
  3085.  GNUPLOT, type `logout` if using VMS, `exit` or the END-OF-FILE
  3086.  character if using Unix, `endcli` if using AmigaDOS, or `exit` if
  3087.  using MS-DOS or OS/2.
  3088.  
  3089.  A single shell command may be spawned by preceding it with the !
  3090.  character ($ if using VMS) at the beginning of a command line.
  3091.  Control will return immediately to GNUPLOT after this command is
  3092.  executed. For example, in VMS, AmigaDOS, MS-DOS or OS/2,
  3093.  
  3094.       ! dir
  3095.  
  3096.  prints a directory listing and then returns to GNUPLOT.
  3097.  
  3098.  On an Atari, the `!` command first checks whether a shell is already
  3099.  loaded and uses it, if available. This is practical if GNUPLOT is run
  3100.  from `gulam`, for example.
  3101. ?splot
  3102. ?surface plot
  3103.  Three-dimensional surface and contour plotting is available in
  3104.  GNUPLOT with the `splot` command. See the `plot` command for features
  3105.  common to the `plot` command.
  3106.  
  3107.  See also `set contour`, `set cntrparam`, and `set surface`.
  3108.  
  3109. ?binary-data
  3110. ?binary files
  3111.  Gnuplot will dynamically determine if a datafile is ASCII or
  3112.  binary.  ASCII data files are discussed in the `plot` section.
  3113.  For three dimensions, single precision floats are stored as follows:
  3114.  
  3115.        <ncols> <x0> <x1> <x2> ...
  3116.        <y0> <z0,0> <z0,1> <z0,2> ...
  3117.        <y1> <z1,0> <z1,1> <z1,2> ...
  3118.  
  3119.  which is converted into triplet:
  3120.  
  3121.        <x0> <y0> <z0,0>
  3122.        <x0> <y1> <z0,1>
  3123.        <x0> <y2> <z0,2>
  3124.  
  3125.        <x1> <y0> <z1,0>
  3126.        <x1> <y1> <z1,1>
  3127.        <x1> <y2> <z1,2>
  3128.  
  3129.  These triplets are then converted into gnuplot iso_curves and then
  3130.  uses gnuplot to do the rest of the plotting.
  3131.  
  3132.  A collection of matrix and vector manipulation routines (in C) are
  3133.  provided in `gnubin.c`.  The routine to write binary data is
  3134.  
  3135.   int fwrite_matrix(file,m,nrl,nrl,ncl,nch,row_title,column_title)
  3136.  
  3137.  An example of using these routines is provided in the file `bf_test.c`.
  3138.  The corresponding demo file is `demo/binary.dem`.
  3139. ?startup
  3140. ?start
  3141. ?.gnuplot
  3142.  When GNUPLOT is run, it looks for an initialization file to load.
  3143.  This file is called `.gnuplot` on Unix and AmigaDOS systems, and
  3144.  `GNUPLOT.INI` on other systems. If this file is not found in the
  3145.  current directory, the program will look for it in the home directory
  3146.  (under AmigaDOS, AtariTOS, MS-DOS and OS/2, the environment variable
  3147.  GNUPLOT should contain the name of this directory).  Note: if NOCWDRC
  3148.  is defined during the installation, GNUPLOT will not read from the
  3149.  current directory.
  3150.  
  3151.  If this file is found, GNUPLOT executes the commands in this file.
  3152.  This is most useful for setting the terminal type and defining any
  3153.  functions or variables that are used often.
  3154. ?substitution
  3155.  Command-line substitution is specified by a system command enclosed in
  3156.  backquotes. This command is spawned and the output it produces
  3157.  replaces the name of the command (and backquotes) on the command line.
  3158.  
  3159.  Newlines in the output produced by the spawned command are replaced
  3160.  with blanks.
  3161.  
  3162.  Command-line substitution can be used anywhere on the GNUPLOT command
  3163.  line.
  3164.  
  3165.  Example:
  3166.  
  3167.  This will run the program `leastsq` and replace `leastsq` (including
  3168.  backquotes) on the command line with its output:
  3169.  
  3170.           f(x) = `leastsq`
  3171.  
  3172.  or, in VMS
  3173.  
  3174.           f(x) = `run leastsq`
  3175. ?userdefined
  3176. ?variables
  3177.  New user-defined variables and functions of one through five variables may
  3178.  be declared and used anywhere.
  3179.  
  3180.  User-defined function syntax:
  3181.          <function-name> ( <dummy1> {,<dummy2> {, ...} } ) = <expression>
  3182.  
  3183.  where <expression> is defined in terms of <dummy1> through <dummy5>.
  3184.  
  3185.  User-defined variable syntax:
  3186.          <variable-name> = <constant-expression>
  3187.  
  3188.  Examples:
  3189.          w = 2
  3190.          q = floor(tan(pi/2 - 0.1))
  3191.          f(x) = sin(w*x)
  3192.          sinc(x) = sin(pi*x)/(pi*x)
  3193.          delta(t) = (t == 0)
  3194.          ramp(t) = (t > 0) ? t : 0
  3195.          min(a,b) = (a < b) ? a : b
  3196.          comb(n,k) = n!/(k!*(n-k)!)
  3197.          len3d(x,y,z) = sqrt(x*x+y*y+z*z)
  3198.  
  3199.  Note that the variable `pi` is already defined.
  3200.  
  3201.  See `show functions` and `show variables`.
  3202. ?bugs
  3203.  The bessel functions do not work for complex arguments.
  3204.  
  3205.  The gamma function does not work for complex arguments.
  3206.  
  3207.  There is a bug in the stdio library for old Sun operating systems
  3208.  (SunOS Sys4-3.2). The "%g" format for 'printf' sometimes incorrectly
  3209.  prints numbers (e.g., 200000.0 as "2"). Thus, tic mark labels may be
  3210.  incorrect on a Sun4 version of GNUPLOT. A work-around is to rescale
  3211.  the data or use the `set format` command to change the tic mark format
  3212.  to "%7.0f" or some other appropriate format. This appears to have been
  3213.  fixed in SunOS 4.0.
  3214.  
  3215.  Another bug: On a Sun3 under SunOS 4.0, and on Sun4's under Sys4-3.2
  3216.  and SunOS 4.0, the 'sscanf' routine incorrectly parses "00 12" with
  3217.  the format "%f %f" and reads 0 and 0 instead of 0 and 12. This
  3218.  affects data input. If the data file contains x coordinates that are
  3219.  zero but are specified like '00', '000', etc, then you will read the
  3220.  wrong y values. Check any data files or upgrade the SunOS.
  3221.  It appears to have been fixed in SunOS 4.1.1.
  3222.  
  3223.  Microsoft C 5.1 has a nasty bug associated with the %g format for
  3224.  printf. When any of the formats "%.2g", "%.1g", "%.0g", "%.g" are
  3225.  used, printf will incorrectly print numbers in the range 1e-4 to 1e-1.
  3226.  Numbers that should be printed in the %e format are incorrectly
  3227.  printed in the %f format, with the wrong number of zeros after the
  3228.  decimal point.
  3229.  
  3230.  To work around this problem, use the %e or %f formats explicitly.
  3231.  
  3232.  GNUPLOT, when compiled with Microsoft C, did not work correctly on two
  3233.  VGA displays that were tested. The CGA, EGA and VGA drivers should
  3234.  probably be rewritten to use the Microsoft C graphics library.
  3235.  GNUPLOT compiled with Borland C++ uses the Turbo C graphics drivers and
  3236.  does work correctly with VGA displays.
  3237.  
  3238.  VAX/VMS 4.7 C compiler release 2.4 also has a poorly implemented %g
  3239.  format for printf. The numbers are printed numerically correct, but
  3240.  may not be in the requested format. The K&R second edition says that
  3241.  for the %g format, %e is used if the exponent is less than -4 or greater
  3242.  than or equal to the precision. The VAX uses %e format if the exponent
  3243.  is less than -1. The VAX appears to take no notice of the precision
  3244.  when deciding whether to use %e or %f for numbers less than 1.
  3245.  To work around this problem, use the %e or %f formats explicitly.
  3246.  From the VAX C 2.4 release notes:
  3247.  e,E,f,F,g,G  Result will always contain a decimal  point.
  3248.  For g and G, trailing zeros will not be removed from the result.
  3249.  
  3250.  VAX/VMS 5.2 C compiler release 3.0 has a slightly better implemented
  3251.  %g format than release 2.4, but not much. Trailing decimal points are
  3252.  now removed, but trailing zeros are still not removed from %g numbers
  3253.  in exponential format.
  3254.  
  3255.  ULTRIX X11R3 has a bug that causes the X11 driver to display "every
  3256.  other" plot.  The bug seems to be fixed in DEC's release of X11R4 so
  3257.  newer releases of ULTRIX don't seem to have the problem.  Solutions for
  3258.  older sites include upgrading the X11 libraries (from DEC or direct from
  3259.  MIT) or defining ULTRIX_KLUDGE when compiling the x11.trm file.  Note
  3260.  that the kludge is not an ideal fix, however.
  3261.  
  3262.  The constant HUGE was incorrectly defined in the NeXT OS 2.0 operating
  3263.  system.  HUGE should be set to 1e38 in plot.h. This error has been
  3264.  corrected in the 2.1 version of NeXT OS.
  3265.  
  3266.  Some older models of HP plotters do not have a page eject command 'PG'.
  3267.  The current HPGL driver uses this command in HPGL_reset.  This may need
  3268.  to be removed for these plotters.  The current PCL5 driver uses HPGL/2
  3269.  for text as well as graphics.  This should be modified to use scalable
  3270.  PCL fonts.
  3271.  
  3272.  On the Atari version, it is not possible to send output directly to
  3273.  the printer (using `/dev/lp` as output file), since CRs are added to LFs in
  3274.  binary output. As a workaround write the output to a file and copy it to
  3275.  the printer afterwards using a shell command.
  3276.  
  3277.  Please report any bugs to bug-gnuplot@dartmouth.edu.
  3278.