From: Andreas Gerler <baron@bundesbrandschatzamt.de>
Date: Sun, 26 Apr 2026 17:52:45 +0000 (+0200)
Subject: update gnuplot
X-Git-Url: http://git.bundesbrandschatzamt.de/?a=commitdiff_plain;h=f629d024af7ca608e8e63e005a62ad6e20fbc5a7;p=emacsconfig.git

update gnuplot
---

diff --git a/elpa/gnuplot-20250724.1531/dir b/elpa/gnuplot-20250724.1531/dir
deleted file mode 100644
index 37ad9fe4..00000000
--- a/elpa/gnuplot-20250724.1531/dir
+++ /dev/null
@@ -1,18 +0,0 @@
-This is the file .../info/dir, which contains the
-topmost node of the Info hierarchy, called (dir)Top.
-The first time you invoke Info you start off looking at this node.
-
-File: dir,	Node: Top	This is the top of the INFO tree
-
-  This (the Directory node) gives a menu of major topics.
-  Typing "q" exits, "H" lists all Info commands, "d" returns here,
-  "h" gives a primer for first-timers,
-  "mEmacs<Return>" visits the Emacs manual, etc.
-
-  In Emacs, you can click mouse button 2 on a menu item or cross reference
-  to select it.
-
-* Menu:
-
-Math
-* GNUPLOT: (gnuplot).           An Interactive Plotting Program
diff --git a/elpa/gnuplot-20250724.1531/gnuplot-autoloads.el b/elpa/gnuplot-20250724.1531/gnuplot-autoloads.el
deleted file mode 100644
index 88ce31e8..00000000
--- a/elpa/gnuplot-20250724.1531/gnuplot-autoloads.el
+++ /dev/null
@@ -1,90 +0,0 @@
-;;; gnuplot-autoloads.el --- automatically extracted autoloads (do not edit)   -*- lexical-binding: t -*-
-;; Generated by the `loaddefs-generate' function.
-
-;; This file is part of GNU Emacs.
-
-;;; Code:
-
-(add-to-list 'load-path (or (and load-file-name (directory-file-name (file-name-directory load-file-name))) (car load-path)))
-
-
-
-;;; Generated autoloads from gnuplot.el
-
-(autoload 'gnuplot-mode "gnuplot" "\
-Major mode for editing and executing GNUPLOT scripts.
-This was written with version 4.6 of gnuplot in mind, but should
-work with newer and older versions.
-
-Report bugs at https://github.com/emacs-gnuplot/gnuplot/issues
-
-                            ------O------
-
-Gnuplot-mode includes two different systems for keyword completion and
-documentation lookup: a newer one, `gnuplot-context-sensitive-mode' ,
-which is enabled by default, and a older one which extracts keywords
-from gnuplot's Info file.  Both systems allow looking up documentation
-in the Info file.  With the context-sensitive mode active,
-`gnuplot-mode' can also provide Eldoc syntax hints as you type.
-
-                            ------O------
-
-There are several known shortcomings of `gnuplot-mode', version 0.5g
-and up.  Many of the shortcomings involve the graphical interface
-(refered to as the GUI) to setting arguments to plot options.  Here is
-a list:
-
- 1.  Currently there is no way for `gnuplot-mode' to know if information
-     sent to gnuplot was correctly plotted.
- 2.  \"plot\", \"splot\", and \"fit\" are handled in the GUI, but are
-     a bit flaky.  Their arguments may not be read correctly from
-     existing text, and continuation lines (common for plot and splot)
-     are not supported.
- 3.  The GUI does not know how to read from continuation lines.
- 4.  Comma separated position arguments to plot options are
-     unsupported in the GUI.  Colon separated datafile modifiers (used
-     for plot, splot, and fit) are not supported either.  Arguments
-     not yet supported by the GUI generate messages printed in grey
-     text.
- 5.  The GUI handling of \"hidden3d\" is flaky and \"cntrparam\" is
-     unsupported.
-
-(fn)" t)
-(autoload 'gnuplot-make-buffer "gnuplot" "\
-Open a new buffer in `gnuplot-mode'.
-When invoked, it switches to a new, empty buffer visiting no file
-and then starts `gnuplot-mode'.
-
-It is convenient to bind this function to a global key sequence.  For
-example, to make the F10 key open a gnuplot script buffer, put the
-following in your .emacs file:
-     (global-set-key [(f10)] \\='gnuplot-make-buffer)" t)
-(autoload 'run-gnuplot "gnuplot" "\
-Run an inferior Gnuplot process." t)
-(add-to-list 'auto-mode-alist '("\\.gp\\'" . gnuplot-mode))
-(add-to-list 'interpreter-mode-alist '("gnuplot" . gnuplot-mode))
-(register-definition-prefixes "gnuplot" '("gnuplot-"))
-
-
-;;; Generated autoloads from gnuplot-context.el
-
-(register-definition-prefixes "gnuplot-context" '("gnuplot-context-"))
-
-
-;;; Generated autoloads from gnuplot-gui.el
-
-(register-definition-prefixes "gnuplot-gui" '("gnuplot-gui-"))
-
-;;; End of scraped data
-
-(provide 'gnuplot-autoloads)
-
-;; Local Variables:
-;; version-control: never
-;; no-byte-compile: t
-;; no-update-autoloads: t
-;; no-native-compile: t
-;; coding: utf-8-emacs-unix
-;; End:
-
-;;; gnuplot-autoloads.el ends here
diff --git a/elpa/gnuplot-20250724.1531/gnuplot-context.el b/elpa/gnuplot-20250724.1531/gnuplot-context.el
deleted file mode 100644
index 25831a61..00000000
--- a/elpa/gnuplot-20250724.1531/gnuplot-context.el
+++ /dev/null
@@ -1,2203 +0,0 @@
-;;; gnuplot-context.el -- context-sensitive help and completion for gnuplot -*- lexical-binding: t -*-
-
-;; Copyright (C) 2012-2013 Jon Oddie <jonxfield@gmail.com>
-
-;; Author: Jon Oddie <jonxfield@gmail.com>
-
-;; This file is not part of GNU Emacs.
-
-;; This program is free software: you can redistribute it and/or modify
-;; it under the terms of the GNU General Public License as published by
-;; the Free Software Foundation, either version 3 of the License, or
-;; (at your option) any later version.
-
-;; This program is distributed in the hope that it will be useful,
-;; but WITHOUT ANY WARRANTY; without even the implied warranty of
-;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-;; GNU General Public License for more details.
-
-;; You should have received a copy of the GNU General Public License
-;; along with this program.  If not, see <https://www.gnu.org/licenses/>.
-
-;;; Commentary:
-
-;;
-;; This file enhances gnuplot-mode with context-sensitive completion,
-;; ElDoc support, and info page lookup for gnuplot script and shell
-;; buffers.
-;;
-;; Usage
-;; =====
-;;
-;; Make sure to byte-compile this file, or things will be noticeably
-;; slow.
-;;
-;; Summary of key bindings:
-;;     C-c C-d            read info page for construction at point
-;;     C-u C-c C-d        prompt for info page to read
-;;     C-c M-h, C-c C-/   pop up multi-line ElDoc string for construction
-;;                          at point
-;;
-;; Gnuplot's context sensitive mode is best controlled using Customize
-;; (M-x customize-group gnuplot): simply enable the
-;; `gnuplot-context-sensitive-mode' setting.  You may also want to set
-;; the Emacs variable `tab-always-indent' to `complete' so that the
-;; TAB key does auto-completion on lines which are already indented.
-;;
-;; If you need to turn context sensitivity on or off from Lisp code
-;; for some reason, call the function
-;; `gnuplot-context-sensitive-mode', which behaves like a minor mode.
-;;
-;; With `eldoc-mode' support, `gnuplot-mode' will show one-line syntax
-;; hints automatically in the echo area.  Whether `eldoc-mode' is
-;; active or not, you can always pop up a longer description of syntax
-;; using `gnuplot-context-help-at-point' (C-c C-/ or C-c M-h).
-;;
-;; Internal details
-;; ================
-;;
-;; Gnuplot's command language has a fair amount of syntactic
-;; complexity, and the only way I could think of to support these
-;; features was to do a complete parse of the command line.  So that's
-;; what this package does.  Instead of building a parse tree, it
-;; matches up until the token at point, and then either makes a list
-;; of possible completions, or sets the variables
-;; `gnuplot-context--eldoc' and `gnuplot-context--info-at-point' based
-;; on where it is in the grammar at that point.
-;;
-;; The parsing/matching process happens in two phases: tokenizing
-;; (`gnuplot-context--tokenize') and matching
-;; (`gnuplot-context--match-pattern').  In order to be able to
-;; construct a full list of possible completions via backtracking, the
-;; matching algorithm simulates a simple stack machine with
-;; continuations.  At byte-compile time, the PEG-like grammar in
-;; S-expression notation (`gnuplot-grammar') is compiled down into a
-;; vector of "machine code" for the parsing machine (see
-;; `gnuplot-context--compile-pattern',
-;; `gnuplot-context--compile-grammar' and
-;; `gnuplot-context--compiled-grammar').  This is complicated, but it
-;; seems to work well enough, and it saves on the Emacs call stack.
-;;
-;; Compiling the grammar does require increasing `max-lisp-eval-depth'
-;; modestly.  This shouldn't cause any problems on modern machines, and
-;; it only needs to be done once, at byte-compilation time.
-;;
-;; The parsing machine and compiler are partially based on the
-;; description in Medeiros and Ierusalimschy 2008, "A Parsing Machine
-;; for PEGs" (https://dl.acm.org/citation.cfm?doid=1408681.1408683).
-;;
-;; The pattern-matching language
-;; =============================
-;;
-;; The gnuplot-mode grammar (see `gnuplot-context--compiled-grammar')
-;; is a list of rules (RULE PATTERN), with each pattern written in
-;; S-expression notation as follows:
-;;
-;;    any
-;;      Match any token
-;;
-;;    name, number, string, separator
-;;      Match a token of the given type.  "Separator" is semicolon, the
-;;      statement separator.
-;;
-;;    Any other symbol
-;;      Match another named rule in the grammar.  May be recursive.
-;;
-;;    "STRING"
-;;      Match literally: a token with exactly the text "STRING".
-;;
-;;   (kw KEYWORD ALIASES ...)
-;;  Match abbreviated Gnuplot keywords.  KEYWORD can be a string or
-;;  a cons (PREFIX . SUFFIX).  In the latter case, this pattern
-;;  will match PREFIX plus any number of characters from the
-;;  beginning of SUFFIX.  Any literal string from ALIASES will
-;;  also match.  The token-id of the matching token is mutated to
-;;  the canonical value of KEYWORD.
-;;  Example:
-;;   (kw ("linew" ."idth") "lw") matches "linew", "linewi",
-;;  ... "linewidth" as well as "lw".  Any of these tokens will
-;;  appear as "linewidth" in subsequent processing.  (This is
-;;  important for the "info-keyword" form, see below).
-;;
-;; The other pattern forms combine simpler patterns, much like regular
-;; expressions or PEGs (parsing expression grammars):
-;;
-;;    (sequence { (:eldoc "eldoc string") }
-;;              { (:info "info page") }
-;;              { (:no-info) }
-;;           PATTERN PATTERN... )
-;;      Match all the PATTERNs in sequence or fail.  Sequences can also
-;;      have optional ElDoc strings and info pages associated with
-;;      them; the innermost ElDoc or info page around point is the one
-;;      shown to the user.  Alternatively, either property may be a
-;;      symbol, which should be a function to be called to get the
-;;      real value.  Finally, if no ElDoc string is specified but the
-;;      variable `gnuplot-eldoc-hash' contains a value for the name of
-;;      the info page at point, that value is used as the ElDoc string
-;;      instead.
-;;
-;;  For better readability, sequence forms can also be written as
-;;  a vector, omitting the `sequence': [PATTERN PATTERN ...]
-;;
-;;    (either PATTERN PATTERN...)
-;;      Match the first PATTERN to succeed, or fail if none
-;;      matches.  Like regexp `|'.
-;;
-;;    (many PATTERN)
-;;  Match PATTERN zero or more times, greedily; like regexp
-;;  `*'.  Unlike a regular expression matcher, the parsing machine
-;;  will not backtrack and try to match fewer times if a later
-;;  part of the pattern fails.  This applies equally to the other
-;;  non-deterministic forms "either" and "maybe".
-;;
-;;    (maybe PATTERN)
-;;      Match PATTERN zero or one times, like regexp `?'.
-;;
-;;    (capture NAME PATTERN)
-;;      Match PATTERN, capturing the tokens in a capture group named
-;;      NAME.  Capture groups are stored in `gnuplot-context--captures'
-;;      and can be retrieved using `gnuplot-context--capture-group'.  This is
-;;      used to store the plotting style, which we need in order to
-;;      give the correct ElDoc string for "using" clauses, and for
-;;      info keywords (see below)
-;;
-;;    (info-keyword PATTERN)
-;;      Match PATTERN, and use whatever the value of the first token
-;;      it matches is to look up info pages for this pattern.  Most
-;;      Gnuplot info pages have the same name as the keyword they
-;;      document, so by using this we only have to put :info
-;;      properties on the few that don't, such as "set".
-;;
-;;    For convenience, "many", "maybe", "capture" and "info-keyword"
-;;    wrap the rest of their arguments in an implicit "sequence" form,
-;;    so we can write (maybe "," expression) instead of
-;;    (maybe (sequence "," expression))
-;;
-;;    (delimited-list PATTERN SEPARATOR)
-;;      Match a list of PATTERNs separated by SEPARATOR.  Sugar for:
-;;      (sequence PATTERN (many (sequence SEPARATOR PATTERN)))
-;;
-;;   (assert LISP-FORM)
-;;  Evaluate LISP-FORM and fail if it returns NIL.  We need this in
-;;  the patterns for "plot" and "splot" to check whether the
-;;  command at point should be parsed in parametric mode or
-;;  not.  See `gnuplot-context--guess-parametric-p'.
-;;
-;;
-;; Bugs, TODOs, etc.
-;; =======================
-;;
-;; It would be useful to complete on user-defined functions and
-;; variables as well as built-ins.
-;;
-;; Completion probably will not work in continuation lines entered
-;; into the gnuplot interaction buffer.
-;;
-;; It would be better to pop up longer syntax descriptions in a
-;; temporary window, rather than making the echo area grow to fit
-;; many lines.
-;;
-;; In ElDoc mode, we parse the whole line every time the user stops
-;; typing.  This is wasteful; should cache things in text properties
-;; instead.
-;;
-;; The pattern matching engine uses backtracking, which can take
-;; exponential time.  So far it seems "fast enough" in actual use.
-;;
-;; The patterns don't really distinguish between "plot" and "splot"
-;; for things like plot styles, binary arguments, etc.
-;;
-;; Some other the patterns are probably not quite right, especially for
-;; things like abbreviated keywords, and features that I don't use
-;; myself like "fit".  Hopefully anyone bothered by this will submit
-;; patches ;-)
-;;
-;; It would be possible to provide more helpful ElDoc strings for
-;; sub-parts of complicated options like "cntrparam".  This is a time
-;; and maintenance issue rather than a technical one.
-
-;;; Code:
-
-(require 'gnuplot)
-(require 'gnuplot-eldoc)
-
-
-;;;; The tokenizer.
-
-(cl-defstruct (gnuplot-context--token
-               (:constructor gnuplot-context--token-make)
-               (:copier nil))
-  start     ; Buffer start position
-  end       ; Buffer end position
-  id        ; Text
-  type)     ; a symbol: name, number, string, operator, separator
-
-(defvar gnuplot-context--operator-regexp
-  (eval-when-compile
-    (regexp-opt
-     '("(" ")" "(" ")" "{" "," "}" "[" ":" "]" "!" "**" "-" "+" "~" "!" "*" "/"
-       "%" "+" "-" "." "<" "<=" ">" ">=" "==" "!=" "eq" "ne" "&" "^" "|" "&&" "||"
-       "?" ":" "=" "$")))
-  "Regexp to match Gnuplot operators for tokenizing.")
-
-(eval-when-compile
-  (defmacro gnuplot-context--tokenize-by-regexps (&rest rules)
-    `(cond ,@(mapcar
-              (lambda (rule)
-                (let ((regexp (car rule))
-                      (token-type (cadr rule)))
-                  `((looking-at ,regexp)
-                    (let ((str (match-string-no-properties 0)))
-                      (forward-char (length str))
-                      (gnuplot-context--token-make :id str
-                                                   :type ',token-type
-                                                   :start (match-beginning 0)
-                                                   :end (match-end 0))))))
-              rules))))
-
-(defun gnuplot-context--tokenize (&optional completing-p)
-  "Tokenize the Gnuplot command at point.
-Return a list of `gnuplot-context--token' objects.
-
-If COMPLETING-P is non-nil, omits the token at point if it is a
-name; otherwise continues tokenizing up to the token at point.  FIXME."
-  (let ((tokens '())
-        (stop-point (min (point)
-                         (gnuplot--point-at-end-of-command))))
-    (save-excursion
-      (if (save-excursion               ; HACK FIXME
-            (gnuplot--beginning-of-continuation)
-            (looking-at "\\s-*if\\s-*("))
-          (gnuplot--beginning-of-continuation)
-        (gnuplot--beginning-of-command))
-      (while
-          ;; Skip whitespace and continuation lines
-          (progn
-            (skip-syntax-forward "-" stop-point)
-            (while (looking-at "\\\\\n")
-              (forward-line)
-              (skip-syntax-forward "-" stop-point))
-            ;; Don't tokenize anything starting after point
-            (and (not (looking-at "#"))
-                 (< (point) stop-point)))
-        (let* ((from (point))
-               (token
-                (cond
-                 ((gnuplot-context--tokenize-by-regexps
-                   ("[[:alpha:]_][[:alpha:]0-9_]*" name)
-                   ("[0-9]+\\(\\.[0-9]*\\)?\\([eE][+-]?[0-9]+\\)?\\|\\.[0-9]+\\([eE][+-]?[0-9]+\\)?" number)
-                   (gnuplot-context--operator-regexp operator)
-                   (";" separator)))
-
-                 ((looking-at "['\"]")
-                  (let* ((bounds (bounds-of-thing-at-point 'sexp))
-                         (to (or (cdr bounds) stop-point)))
-                    (goto-char to)
-                    (gnuplot-context--token-make
-                     :id (buffer-substring-no-properties from to)
-                     :type 'string
-                     :start from :end to)))
-
-                 (t (error
-                     "gnuplot-context--tokenize: bad token beginning %s"
-                     (buffer-substring-no-properties (point) stop-point))))))
-
-          (push token tokens))))
-
-    ;; If we are looking for completions, AND if the last token
-    ;; read is a name, AND if point is within the bounds of the
-    ;; last token, then discard it. The matching function
-    ;; generates a list of all possible tokens that could appear
-    ;; in that position for completion.
-    (if (and completing-p
-             tokens
-             (eq (gnuplot-context--token-type (car tokens)) 'name)
-             (<= (point) (gnuplot-context--token-end (car tokens))))
-        (pop tokens))
-
-    (nreverse tokens)))
-
-
-;;;; The pattern and grammar compiler
-;;
-;; These functions compile the source S-expression grammar into a
-;; vector of instructions for the parsing machine,
-;; `gnuplot-context--match-pattern'. Its state consists of a program counter
-;; (PC), a position in the list of tokens, a call stack, and a second
-;; stack of backtracking entries (continuations). Its "machine
-;; instructions" are the following:
-;;
-;;    (any)
-;;      Match any token (fails only at end of command).
-;;
-;;    (literal LITERAL NO-COMPLETE)
-;;      Match token with `gnuplot-context--token-id' LITERAL or fail. If we
-;;      have reached the token before point, include LITERAL in the
-;;      completion list unless NO-COMPLETE is non-`nil'.
-;;
-;;    (token-type TYPE)
-;;      Match a token with `gnuplot-context--token-type' TYPE, or fail.
-;;
-;;    (keyword REGEXP NAME)
-;;      Match any token whose `gnuplot-context--token-id' matches REGEXP. Use
-;;      NAME for the completion list.
-;;
-;;    (jump OFFSET FIXED)
-;;      Jump to (set PC to) OFFSET if FIXED is non-nil, otherwise to
-;;      PC + OFFSET
-;;
-;;    (call OFFSET FIXED)
-;;      Like "jump", but push a return address onto the stack for
-;;      (return). (The compiler adds the name of the rule being called
-;;      as a fourth element on the end of the list, but this is just a
-;;      comment for debugging purposes).
-;;
-;;    (return)
-;;      Return to the PC address on top of the stack, or finish
-;;      matching if stack is empty. (Usually this doesn't happen,
-;;      because the machine stops as soon as it gets to the token at
-;;      point).
-;;
-;;    (choice OFFSET)
-;;      Push a backtracking entry for location PC + OFFSET onto the
-;;      backtracking stack. Backtracking entries save the contents of
-;;      the call stack, position in the token list, the values of
-;;      capture groups, and the record of loop progress (see below).
-;;
-;;    (check-progress)
-;;      Break out of infinite loops, like (many (many ...)).  Checks
-;;      an alist of conses (pc . tokens) for the position in the token
-;;      stream the last time this instruction was reached, and breaks
-;;      out of the loop if stuck in the same place; otherwise pushes a
-;;      new entry onto the list.
-;;
-;;    (fail)
-;;      Pop the most recent backtracking entry and continue from
-;;      there, or fail the whole match if out of backtrack
-;;      points. Failing to match returns the remainder of the token
-;;      list, although we don't currently use this for anything.
-;;
-;;    (commit OFFSET)
-;;      Discard one backtracking point and jump to PC + OFFSET. This
-;;      is used to make the (either) form non-deterministic.
-;;
-;;    (push TYPE VALUE)
-;;      Push an entry for an eldoc or info string (specified by TYPE)
-;;      onto the stack.
-;;
-;;    (pop TYPE)
-;;      Pop something off the stack; checks that it has the expected
-;;      TYPE, for safety.
-;;
-;;    (save-start NAME)
-;;      Open a capture group named NAME. Pushes an entry onto
-;;      `gnuplot-context--captures' with current position in token list as the
-;;      start of the group.
-;;
-;;    (save-end NAME)
-;;      Close the capture group named NAME. Finds the topmost entry in
-;;      `gnuplot-context--captures' with this name and sets its endpoint to the
-;;      current position in token list. Error if no group with that
-;;      name is found.
-;;
-;;    (label NAME)
-;;      This should never be reached and will cause an error. The
-;;      compiler inserts it at the beginning of compiled rules only
-;;      for debugging purposes.
-;;
-
-(eval-and-compile
-  ;; Compile a single pattern into a list of instructions. Leaves
-  ;; calls to other rules as symbolic instructions (call SYMBOL) and
-  ;; jumps, commits etc. as relative offsets; these are resolved into
-  ;; absolute locations by `gnuplot-context--compile-grammar', below.
-  (defun gnuplot-context--compile-pattern (pat)
-    (cond
-     ;; Strings match a single token literally
-     ((stringp pat)
-      ;; Don't add non-words to completion lists
-      (let ((wordp (string-match-p "^\\sw\\(\\sw\\|\\s_\\)*$" pat)))
-        `((literal ,pat ,(not wordp)))))
-
-     ;; Symbols match token types or calls to other patterns
-     ((symbolp pat)
-      (cl-case pat
-        ((any) `((any)))
-        ((name number string separator) `((token-type ,pat)))
-        (t `((call ,pat)))))
-
-     ;; Syntactic sugar: write sequences (sequence ...) as vectors [...]
-     ((vectorp pat)
-      (gnuplot-context--compile-pattern
-       (append '(sequence) pat '())))
-
-     ;; Other forms combine simpler patterns
-     (t
-      (let ((type (car pat)))
-        (cl-case type
-          ;; (sequence...): concatenate patterns, with optional eldoc
-          ;; and info strings
-          ((sequence)
-           (cl-destructuring-bind
-               (subpats eldoc info)
-               (gnuplot-context--filter-arg-list (cdr pat))
-             (let ((eldoc-push '()) (eldoc-pop '())
-                   (info-push '()) (info-pop '())
-                   (compiled
-                    (mapcar 'gnuplot-context--compile-pattern subpats)))
-               (if eldoc
-                   (setq eldoc-push `((push eldoc ,eldoc))
-                         eldoc-pop `((pop eldoc))))
-               (if info
-                   (if (eq info :no-info)
-                       (setq info-push '((push no-scan t))
-                             info-pop '((pop no-scan)))
-                     (setq info-push `((push info ,info))
-                           info-pop `((pop info)))))
-               (apply 'append
-                      `(,info-push
-                        ,eldoc-push
-                        ,@compiled
-                        ,eldoc-pop
-                        ,info-pop)))))
-
-          ;; (either...): choose between patterns
-          ((either)
-           (cond
-            ((= (length pat) 2)         ; trivial case
-             (gnuplot-context--compile-pattern (cadr pat)))
-
-            ((> (length pat) 3)         ; could be more efficient...
-             (gnuplot-context--compile-pattern (gnuplot-context--either-helper pat)))
-
-            (t              ; two patterns
-             (let* ((pat1 (cadr pat))
-                    (pat2 (cl-caddr pat))
-                    (pat1-c (gnuplot-context--compile-pattern pat1))
-                    (pat2-c (gnuplot-context--compile-pattern pat2))
-                    (pat1-l (length pat1-c))
-                    (pat2-l (length pat2-c)))
-               `((choice ,(+ pat1-l 2))
-                 ,@pat1-c
-                 (commit ,(+ pat2-l 1))
-                 ,@pat2-c)))))
-
-          ;; Repetition (*)
-          ((many)
-           (let* ((pat1 (cons 'sequence (cdr pat)))
-                  (pat1-c (gnuplot-context--compile-pattern pat1))
-                  (pat1-l (length pat1-c)))
-             `((choice ,(+ pat1-l 3))
-               (check-progress)         ; bail out of infinite loops
-               ,@pat1-c
-               (commit ,(- (+ pat1-l 2))))))
-
-          ;; Repetition (+)
-          ((many1)
-           (let* ((pat1 (cdr pat)))
-             (gnuplot-context--compile-pattern
-              `(sequence ,@pat1 (many ,@pat1)))))
-
-          ;; Optional (?)
-          ((maybe)
-           (let* ((pat1 (cons 'sequence (cdr pat)))
-                  (pat1-c (gnuplot-context--compile-pattern pat1))
-                  (pat1-l (length pat1-c)))
-             `((choice ,(+ pat1-l 1))
-               ,@pat1-c)))
-
-          ;; Syntactic sugar for delimited lists
-          ((delimited-list)
-           (let* ((item (cadr pat))
-                  (sep (cl-caddr pat)))
-             (gnuplot-context--compile-pattern
-              `(sequence ,item (many (sequence ,sep ,item))))))
-
-          ;; keywords
-          ((kw)
-           (cl-destructuring-bind (regex name)
-               (gnuplot-context--keyword-helper (cdr pat))
-             `((keyword ,regex ,name))))
-
-          ;; Capturing groups
-          ((capture)
-           (let* ((name (cadr pat))
-                  (pat1 (cons 'sequence (cddr pat)))
-                  (pat1-c (gnuplot-context--compile-pattern pat1)))
-             `((save-start ,name)
-               ,@pat1-c
-               (save-end ,name))))
-
-          ;; Use the first token as an info keyword
-          ((info-keyword)
-           (let* ((pat1 (cons 'sequence (cdr pat)))
-                  (pat1-c (gnuplot-context--compile-pattern pat1)))
-             `((push info first-token)
-               ,@pat1-c
-               (pop info))))
-
-          ;; Assertions
-          ((assert)
-           (let* ((form (cadr pat)))
-             `((assert ,form))))
-
-          (t
-           (error "gnuplot-context--compile-pattern: bad pattern form %s" pat)))))))
-
-  ;; Helper function for destructuring (sequence ...) forms in patterns
-  ;; Takes the cdr of the sequence form, returns a list (PATTERNS ELDOC
-  ;; INFO).
-  (defun gnuplot-context--filter-arg-list (args)
-    (let ((accum '())
-          (eldoc nil) (info nil))
-      (dolist (item args)
-        (let ((type (car-safe item)))
-          (cl-case type
-            ((:eldoc) (setq eldoc (cadr item)))
-            ((:no-info) (setq info :no-info)) ; inhibit stack scanning
-            ((:info) (setq info (cadr item)))
-            (t (push item accum)))))
-      (list (reverse accum) eldoc info)))
-
-  ;; Helper function for compiling (kw...) patterns
-  ;; Takes the cdr of the kw form, returns a list (REGEXP KEYWORD)
-  (defun gnuplot-context--keyword-helper (args)
-    (let ((keyword (car args)) (aliases (cdr args)))
-      (when (consp keyword)
-        (let ((pre (car keyword)) (suf (cdr keyword)))
-          (setq keyword (concat pre suf))
-          (while (progn
-                   (push pre aliases)
-                   (not (zerop (length suf))))
-            (setq pre (concat pre (substring suf 0 1))
-                  suf (substring suf 1)))))
-      (let ((regex
-             (concat "^"
-                     (regexp-opt (cons keyword aliases))
-                     "$")))
-        (list regex keyword))))
-
-  ;; Helper function for compiling (either ...) patterns. Rewrites
-  ;; alternates (either A B C) into (either A (either B (either C D)))
-  (defun gnuplot-context--either-helper (pat)
-    (if (= (length pat) 3)
-        pat
-      `(either ,(cadr pat)
-               ,(gnuplot-context--either-helper
-                 (cons 'either (cddr pat))))))
-
-  ;; Compile the grammar (a list of rule-pattern pairs (RULE PATTERN))
-  ;; into a single vector of matching-machine instructions. Compiles
-  ;; each pattern individually, then "links" them into one vector,
-  ;; converting symbolic (call ...) instructions into numeric offsets
-  (defun gnuplot-context--compile-grammar (grammar start-symbol)
-    (let ((compiled-pats '())         ; Alist of (name . instructions)
-          ;; Reserve space for a jump to the start symbol
-          (code-length 1))
-
-      ;; Compile each rule and find the total number of instructions
-      (dolist (item grammar)
-        (let* ((name (car item))
-               (pat (cadr item))
-               (code (gnuplot-context--compile-pattern pat)))
-          (push (cons name code) compiled-pats)
-          ;; Reserve space for a label at the beginning and (return) at
-          ;; the end
-          (setq code-length (+ code-length 2 (length code)))))
-
-      ;; Copy instructions into a single vector
-      (let ((object-code (make-vector code-length nil))
-            (name->offset (make-hash-table))
-            (i 1))
-        (setf (aref object-code 0) `(jump ,start-symbol))
-        (dolist (chunk compiled-pats)
-          (let ((name (car chunk))
-                (code (cdr chunk)))
-            (setf (aref object-code i) `(label ,name))
-            (cl-incf i)
-            (puthash name i name->offset)
-            (while code
-              (setf (aref object-code i) (car code)
-                    code (cdr code)
-                    i (1+ i)))
-            (setf (aref object-code i) '(return)
-                  i (1+ i))))
-
-        ;; Resolve symbolic and relative jumps
-        (let ((pattern-name nil))
-          (dotimes (i (length object-code))
-            (let ((inst (aref object-code i)))
-              (cl-case (car inst)
-                ((label)
-                 (setq pattern-name (cadr inst)))
-
-                ((jump call choice commit)
-                 (cond
-                  ((symbolp (cadr inst))
-                   (let* ((name (cadr inst))
-                          (location (gethash name name->offset)))
-                     (if (not location)
-                         (error
-                          (concat "gnuplot-context--compile-grammar: "
-                                  "No rule found for symbol `%s' in pattern `%s'")
-                          name pattern-name))
-                     (setcdr inst `(,location ,name))))
-
-                  ((numberp (cadr inst))
-                   (let* ((offset (cadr inst))
-                          (location (+ offset i)))
-                     (setcdr inst `(,location))))
-
-                  (t
-                   (error "gnuplot-context--compile-grammar: bad instruction %s" inst))))))))
-        object-code))))
-
-;;; The grammar.
-(defvar gnuplot-context--compiled-grammar
-  (eval-when-compile
-    (let ((max-lisp-eval-depth 600))
-      (gnuplot-context--compile-grammar
-       '((expression
-          [infix-expression (maybe "?" expression ":" expression)])
-
-         (prefix-operator
-          (either "!" "~" "-" "+"))
-
-         (infix-operator
-          (either "**" "*" "/" "%" "+" "-" "." "<" "<=" ">" ">=" "==" "!=" "eq" "ne"
-                  "&" "^" "|" "&&" "||"))
-
-         (infix-expression
-          [(many prefix-operator)
-           primary-expression
-           (many infix-operator expression)])
-
-         (primary-expression
-          [(either number string parenthesized-expression
-                   column-ref complex-number function-call name)
-           (many "!")
-           (maybe "**" infix-expression)
-           (maybe substring-range)])
-
-         (function-call
-          (either
-           (info-keyword
-            [(either "abs" "acos" "acosh" "arg" "asin" "asinh" "atan" "atan2" "atanh"
-                     "besj0" "besj1" "besy0" "besy1" "ceil" "column" "columnhead"
-                     "cos" "cosh" "defined" "erf" "erfc" "exists" "exp" "floor"
-                     "gamma" "gprintf" "ibeta" "igamma" "imag" "int" "inverf"
-                     "invnorm" "lambertw" "lgamma" "log" "log10" "norm" "real"
-                     "sgn" "sin" "sinh" "sprintf" "sqrt" "strftime" "stringcolumn"
-                     "strlen" "strptime" "strstrt" "substr" "tan" "tanh" "timecolumn"
-                     "tm_hour" "tm_mday" "tm_min" "tm_mon" "tm_sec" "tm_wday"
-                     "tm_yday" "tm_year" "valid" "value" "word" "words" "rand")
-             parenthesized-expression])
-           [(:info "elliptic_integrals")
-            (either "EllipticK" "EllipticE" "EllipticPi")
-            parenthesized-expression]
-           [name
-            parenthesized-expression]))
-
-         (parenthesized-expression
-          ["(" comma-list ")"])
-
-         (complex-number
-          ["{" (maybe "-") number "," (maybe "-") number "}"])
-
-         (column-ref
-          ["$" number])
-
-         (substring-range-component
-          (maybe (either "*" expression)))
-
-         (substring-range
-          ["[" (delimited-list substring-range-component ":" 2 2) "]"])
-
-;;; Assignments
-         (lhs
-          [name (maybe "(" (delimited-list name "," 1) ")")])
-
-         (assignment
-          [lhs "=" (either assignment expression)])
-
-;;; Lists of expressions
-         (comma-list
-          (delimited-list (either assignment expression) ","))
-
-         (colon-list
-          (delimited-list expression ":"))
-
-         (tuple
-          ["(" (delimited-list expression "," 2 3) ")"])
-
-;;; Commands
-         (command
-          (info-keyword
-           (either plot-command splot-command replot-command fit-command print-command
-                   set-command cd-command call-command simple-command
-                   eval-command load-command lower-raise-command pause-command
-                   save-command system-command test-command undefine-command
-                   update-command assignment if-command new-if-command do-command)))
-
-         (command-list
-          (delimited-list command separator))
-
-         (block ["{" command-list (maybe separator) "}"])
-
-;;; old-style one-line if(..) command
-         (if-command
-          (info-keyword
-           "if" parenthesized-expression command-list
-           (maybe separator "else" command-list)))
-
-;;; new-style block-structured if
-         (new-if-command
-          (info-keyword
-           "if" parenthesized-expression block
-           (maybe "else" block)))
-
-;;; block-structured "do"
-         (do-command
-          (info-keyword "do" iteration-spec block))
-
-;;; PLOT, SPLOT commands
-         (plot-command
-          [(kw ("pl" . "ot"))
-
-           (either
-            ;; Parametric ranges
-            [(assert (gnuplot-context--guess-parametric-p))
-             (maybe t-axis-range) (maybe x-axis-range) (maybe y-axis-range)]
-
-            ;; Non-parametric ranges
-            [(maybe x-axis-range) (maybe y-axis-range)])
-
-           plot-body])
-
-         (splot-command
-          [ ;; This capturing group lets `gnuplot-context--find-using-eldoc' know
-           ;; that this is an splot command
-           (capture :splot-command (kw ("spl" . "ot")))
-
-           (either
-            ;; Parametric ranges
-            [(assert (gnuplot-context--guess-parametric-p))
-             (maybe u-axis-range) (maybe v-axis-range)
-             (maybe x-axis-range) (maybe y-axis-range) (maybe z-axis-range)]
-
-            ;; Non-parametric ranges
-            [(maybe x-axis-range) (maybe y-axis-range) (maybe z-axis-range)])
-
-           plot-body])
-
-         (replot-command [(kw "replot") plot-body])
-
-         ;; Axis ranges
-         (axis-range-component
-          (maybe (either "*" expression)))
-
-         (axis-range-body
-          (delimited-list axis-range-component ":" 2 3))
-
-         (axis-range
-          [(:info "ranges")
-           "[" (maybe (maybe name "=") axis-range-body) "]"])
-
-         (x-axis-range [(:eldoc "X RANGE: [{<dummy>=}<min>:<max>]") axis-range])
-         (y-axis-range [(:eldoc "Y RANGE: [{<dummy>=}<min>:<max>]") axis-range])
-         (z-axis-range [(:eldoc "Z RANGE: [{<dummy>=}<min>:<max>]") axis-range])
-         (t-axis-range [(:eldoc "T RANGE: [{<dummy>=}<min>:<max>]") axis-range])
-         (u-axis-range [(:eldoc "U RANGE: [{<dummy>=}<min>:<max>]") axis-range])
-         (v-axis-range [(:eldoc "V RANGE: [{<dummy>=}<min>:<max>]") axis-range])
-
-         ;; Body of a plot/splot command. Should really be different for
-         ;; parametric vs non-parametric, but that's too hard.
-         (plot-body
-          (delimited-list
-           [(maybe iteration-spec) plot-expression plot-modifiers]
-           ","))
-
-         ;; Iteration: for [... ]
-         (iteration-spec
-          [(:info "iteration")
-           (many1
-            "for" "[" name
-            (either ["=" (delimited-list expression ":")]
-                    ["in" expression])
-            "]")])
-
-         ;; Expressions to plot can be preceded by any number of
-         ;; assignments, with or without commas
-         (plot-expression
-          [(many [(:no-info) assignment (maybe ",")])
-           expression])
-
-;;; Plot/splot modifiers
-         ;; These should probably be more different for plot and splot ...
-         (plot-modifiers (many (either plot-modifier datafile-modifier)))
-
-         (plot-modifier
-          (info-keyword
-           (either
-            ;; simple one-word modifiers
-            (kw "nohidden3d") (kw "nocontours") (kw "nosurface")
-
-            ;; word followed by expression
-            [(either
-              (kw ("lines" . "tyle") "ls")
-              (kw ("linet" . "ype") "lt")
-              (kw ("linew" . "idth") "lw")
-              (kw ("pointt" . "ype") "pt")
-              (kw ("points" . "ize") "ps")
-              (kw ("pointi" . "nterval") "pi"))
-             expression]
-
-            ;; others defined below
-            title-modifier notitle-modifier axes-modifier with-modifier
-            linecolor-modifier fillstyle-modifier)))
-
-         (title-modifier
-          [(kw ("t" . "itle")) expression])
-
-         (notitle-modifier
-          [(:info "title")
-           (kw ("not" . "itle"))
-           (maybe string)])
-
-         (axes-modifier
-          [(kw ("ax" . "es")) (either "x1y1" "x1y2" "x2y1" "x2y2")])
-
-         (linecolor-modifier
-          [(kw ("linec" . "olor") "lc") color-spec])
-
-         (fillstyle-modifier
-          [(kw "fillstyle" "fs")
-           ;; fill-style also used by "set style fill"
-           fill-style])
-
-         (fill-style
-          [(either
-            "empty"
-            [(maybe "transparent")
-             (either "pattern" "solid")
-             (maybe (either fill-style-border-clause expression))])
-           (maybe fill-style-border-clause)])
-
-         (fill-style-border-clause
-          (either "noborder" [(kw ("bo" . "rder")) expression]))
-
-         (color-spec
-          [(:info "colorspec")
-           (either
-            (kw ("var" . "iable"))
-
-            [(kw ("pal" . "ette"))
-             (either "z"
-                     [(either "frac" "cb") expression])]
-
-            [(kw ("rgb" . "color"))
-             (either (kw ("var" . "iable")) string)])])
-
-         (with-modifier
-          [(:info "plotting_styles")
-           (kw ("w" . "ith"))
-
-           ;; plotting-style also used for "set style data"
-           (capture :with-style plotting-style)])
-
-         (plotting-style
-          (info-keyword
-           (either
-            ;; Simple styles that take no arguments
-            (kw ("l" . "ines")) (kw ("i" . "mpulses")) (kw ("p" . "oints"))
-            (kw ("linesp" . "oints") "lp") (kw ("d" . "ots")) (kw ("yerrorl" . "ines"))
-            (kw ("errorl" . "ines")) (kw ("xerrorl" . "ines")) (kw ("xyerrorl" . "ines"))
-            (kw ("ye" . "rrorbars")) (kw ("e" . "rrorbars")) (kw ("xe" . "rrorbars"))
-            (kw ("xye" . "rrorbars")) (kw "boxes") (kw ("hist" . "ograms"))
-            (kw ("boxer" . "rorbars")) (kw ("boxx" . "yerrorbars")) (kw ("st" . "eps"))
-            (kw ("fs" . "teps")) (kw ("his" . "teps")) (kw ("fin" . "ancebars"))
-            (kw ("can" . "dlesticks")) (kw ("pm" . "3d"))
-            (kw ("cir" . "cles"))
-
-            ;; Image styles all use the same info page
-            [(:info "image")
-             (either (kw ("ima" . "ge"))
-                     (kw ("rgbima" . "ge"))
-                     (kw ("rgba" . "lpha")))]
-
-            ;; More complicated styles defined below
-            labels-style-clause
-            filledcurves-style-clause
-            vectors-style-clause)))
-
-         (labels-style-clause
-          [(kw "labels")
-           (maybe textcolor-spec)])
-
-         (filledcurves-style-clause
-          [(kw ("filledc" . "urves"))
-           (maybe
-            (either
-             "closed"
-
-             ["xy" "=" expression "," expression]
-
-             [(maybe (either "above" "below"))
-              (maybe [(either "x1" "x2" "y1" "y2")
-                      (maybe "=" expression)])]))])
-
-         (vectors-style-clause
-          [(kw ("vec" . "tors"))
-           (many
-            (either
-             "nohead" "head" "heads" "filled" "empty" "nofilled" "front" "back"
-             [(kw "arrowstyle" "as") expression]
-             ["size" (delimited-list expression ",")]
-             linestyle-spec))])
-
-;;; Various style specifiers, used in different places
-         (linestyle-spec
-          (many1
-           (either
-            [(kw ("lines" . "tyle") "ls") expression]
-            [(kw ("linet" . "ype") "lt") expression]
-            [(kw ("linew" . "idth") "lw") expression])))
-
-         (textcolor-spec
-          [(kw "textcolor" "tc")
-           (either "default"
-                   ["lt" expression]
-                   color-spec)])
-
-         (pointsize-spec [(kw "pointsize" "ps") expression])
-
-;;; Datafile modifiers
-         (datafile-modifier
-          (info-keyword
-           (either binary-modifier
-                   [(maybe "nonuniform") (kw ("mat" . "rix"))]
-                   index-modifier every-modifier
-                   thru-modifier using-modifier
-                   smooth-modifier
-                   "volatile" "noautoscale")))
-
-         (index-modifier
-          [(kw ("i" . "ndex"))
-           (either string (delimited-list expression ":" 0 2))])
-
-         (every-modifier
-          [(kw ("ev" . "ery")) (delimited-list (maybe expression) ":")])
-
-         (thru-modifier
-          [(kw "thru") expression])
-
-         (using-modifier
-          [(:eldoc gnuplot-context--find-using-eldoc)
-           (kw ("u" . "sing"))
-           (either
-            string
-            [colon-list (maybe string)])])
-
-         (smooth-modifier
-          [(kw ("s" . "mooth"))
-           (either (kw ("a" . "csplines")) (kw ("b" . "ezier")) (kw ("c" . "splines"))
-                   (kw ("s" . "bezier")) (kw ("u" . "nique")) (kw ("f" . "requency"))
-                   (kw ("cum" . "ulative")) (kw ("k" . "density")))])
-
-;;; Binary datafile modifiers
-         (binary-modifier
-          ["binary" (many binary-keyword)])
-
-         (binary-keyword
-          (either
-           ;; All of these binary keywords are described on the same
-           ;; info page
-           [(:info "keywords")
-            (either
-             "transpose" "flipx" "flipy" "flipz"
-             ["flip" "=" (either "x" "y" "z")]
-             ["scan" "=" name]
-             [(either "dx" "dy" "dz") "=" number]
-             [(either "origin" "center" "perpendicular") "="
-              (delimited-list tuple ":")]
-             [(kw ("rot" . "ate") "rotation") "="
-              (sequence expression (maybe (kw ("d" . "eg")) (kw ("p" . "i"))))])]
-
-           ;; remaining binary keywords have their own info pages
-           (info-keyword
-            (either
-             [(either "array" "record")
-              "="
-              (delimited-list expression ":")]
-
-             [(either "skip")
-              "="
-              (delimited-list expression ":")]
-
-             [(either "format" "endian" "filetype")
-              "="
-              expression]))))
-
-;;; "fit" command
-         (fit-command
-          [(:info "fit")
-           (kw "fit")
-           (many axis-range)
-           expression
-           string
-           (many plot-modifier)
-           (kw "via")
-           (either string (delimited-list name ","))])
-
-;;; print command
-         (print-command
-          [(kw ("pr" . "int")) (delimited-list expression ",")])
-
-;;; set commands
-         (set-command
-          [(:eldoc "set ...")
-           (:info "set-show")
-           (either (kw "set") (kw "unset") (kw "show"))
-           (maybe iteration-spec)
-           (info-keyword
-            (either set-angles-clause set-arrow-clause
-                    set-autoscale-clause set-bars-clause
-                    set-border-clause set-boxwidth-clause
-                    set-clabel-clause set-clip-clause
-                    set-cntrparam-clause set-colorbox-clause
-                    set-contour-clause set-datafile-clause
-                    set-decimalsign-clause set-dgrid3d-clause
-                    set-dummy-clause set-encoding-clause
-                    set-fit-clause set-fontpath-clause
-                    set-format-clause set-grid-clause
-                    set-hidden3d-clause set-historysize-clause
-                    set-isosamples-clause set-key-clause
-                    set-label-clause set-loadpath-clause
-                    set-locale-clause set-logscale-clause
-                    set-mapping-clause set-margin-clause
-                    set-multiplot-clause set-mxtics-clause
-                    set-object-clause set-offsets-clause
-                    set-origin-clause set-output-clause
-                    set-parametric-clause set-pm3d-clause
-                    set-palette-clause set-pointsize-clause
-                    set-polar-clause set-print-clause
-                    set-samples-clause set-size-clause
-                    set-style-clause
-                    set-surface-clause set-table-clause
-                    set-terminal-clause set-termoption-clause
-                    set-tics-clause set-tics-clause-2
-                    set-xtics-clause
-                    set-timestamp-clause set-timefmt-clause
-                    set-title-clause set-view-clause
-                    set-data-clause set-dtics-clause
-                    set-xlabel-clause
-                    set-mtics-clause set-range-clause
-                    set-xyplane-clause set-zero-clause
-                    set-zeroaxis-clause))])
-
-;;; positions and coordinate systems for set options
-         (position-system
-          (either "first" "second" "graph" "screen" "character"))
-
-         (dimension [(maybe position-system) expression])
-
-         (position
-          [dimension "," dimension (maybe "," dimension)])
-
-         (to (either "to" "rto"))
-
-;;; all the different "set ... " options
-         (set-angles-clause
-          ["angles" (either "degrees" "radians")])
-
-         (set-arrow-clause
-          ["arrow" (maybe number)
-           (many
-            (either ["from" position] [to position]
-                    [(kw "arrowstyle" "as") expression]
-                    "nohead" "head" "backhead" "heads"
-                    ["size" dimension "," expression (maybe "," expression)]
-                    "filled" "empty" "nofilled" "front" "back"
-                    linecolor-modifier linestyle-spec))])
-
-         (set-autoscale-clause
-          ["autoscale"
-           (either "fix"
-                   "keepfix"
-                   "x" "y" "z" "cb" "x2" "y2" "xy"
-                   "xmin" "ymin" "zmin" "cbmin" "x2min" "y2min"
-                   "xmax" "ymax" "zmax" "cbmax" "x2max" "y2max"
-                   "xfix" "yfix" "zfix" "cbfix" "x2fix" "y2fix"
-                   "xfixmax" "yfixmax" "zfixmax" "cbfixmax" "x2fixmax" "y2fixmax"
-                   "xfixmin" "yfixmin" "zfixmin" "cbfixmin" "x2fixmin" "y2fixmin")])
-
-         (set-bars-clause
-          ["bars"
-           (either expression "small" "large" "fullwidth")
-           (either "front" "back")])
-
-         (set-border-clause
-          ["border"
-           (maybe number)
-           (maybe (either "front" "back"))
-           (maybe (kw "linewidth" "lw") expression)
-           (maybe
-            (either (kw "linestyle" "ls") (kw "linetype" "lt"))
-            expression)])
-
-         (set-boxwidth-clause
-          ["boxwidth"
-           (maybe expression)
-           (maybe (either (kw ("abs" . "olute")) "relative"))])
-
-         (set-clabel-clause
-          ["clabel" (maybe string)])
-
-         (set-clip-clause
-          ["clip" (maybe (either "points" "one" "two"))])
-
-         (set-cntrparam-clause
-          [(kw "cntrparam")
-           (either
-            "linear" "cubicspline" "bspline"
-
-            [(either "points" "order") number]
-
-            [(kw "levels")
-             (either
-              number
-              (sequence (kw "auto") (maybe number))
-              (sequence
-               (kw "discrete") comma-list)
-              (sequence
-               (kw "incremental") (delimited-list expression "," 2 3)))])])
-
-         (set-colorbox-clause
-          [(:info "color_box")
-           (kw ("colorb" . "ox"))
-           (many
-            (either
-             (kw ("vert" . "ical")) (kw ("horiz" . "ontal"))
-             "default" "user"
-             ["origin" expression "," expression]
-             ["size" expression "," expression]
-             "front" "back"
-             "noborder" "bdefault"
-             ["border" expression]))])
-
-         (set-contour-clause
-          ["contour" (either "base" "surface" "both")])
-
-         (set-datafile-clause
-          ["datafile"
-           (either [(:info "set_datafile_fortran")
-                    "fortran"]
-                   [(:info "set_datafile_nofpe_trap")
-                    "nofpe_trap"]
-                   [(:info "set_datafile_missing")
-                    "missing" (maybe string)]
-                   [(:info "set_datafile_separator")
-                    "separator" (either "whitespace" string)]
-                   [(:info "set_datafile_commentschars")
-                    "commentschars" (maybe string)]
-                   [(:info "set_datafile_binary")
-                    "binary" (many binary-keyword)])])
-
-         (set-decimalsign-clause
-          ["decimalsign"
-           (either string ["locale" (maybe string)])])
-
-         (set-dgrid3d-clause
-          ["dgrid3d"
-           (maybe expression)       ; fixme
-           (maybe "," expression)
-           (either
-            "splines"
-            ["qnorm" expression]
-            [(either "gauss" "cauchy" "exp" "box" "hann")
-             (maybe expression)
-             (maybe "," expression)])])
-
-         (set-dummy-clause
-          ["dummy"
-           name (maybe "," name)])
-
-         (set-encoding-clause
-          ["encoding"
-           (either "default" "iso_8859_1" "iso_8859_15" "iso_8859_2" "iso_8859_9"
-                   "koi8r" "koi8u" "cp437" "cp850" "cp852" "cp1250" "cp1251" "cp1254"
-                   "utf8" "locale")])
-
-         (set-fit-clause
-          [(:info "fit_")
-           "fit"
-           (either
-            ["logfile" string]
-            "errorvariables" "noerrorvariables")])
-
-         (set-fontpath-clause
-          ["fontpath" (many string)])
-
-         (set-format-clause
-          [(:info "format_")
-           "format"
-           (maybe (either "x" "y" "xy" "x2" "y2" "z" "cb"))
-           string])
-
-         (set-grid-clause
-          ["grid"
-           (either "nomxtics" "mxtics" "noxtics" "xtics" "nomytics" "mytics"
-                   "noytics" "ytics" "nomztics" "mztics" "noztics" "ztics"
-                   "nomx2tics" "mx2tics" "nox2tics" "x2tics" "nomy2tics"
-                   "my2tics" "noy2tics" "y2tics" "nomcbtics" "mcbtics"
-                   "nocbtics" "cbtics" "layerdefault" "front" "back"
-                   [linestyle-spec (maybe "," linestyle-spec)])])
-
-         (set-hidden3d-clause
-          [(kw ("hidden" . "3d"))
-           (many
-            (either
-             "defaults" "front" "back"
-             ["offset" expression] "nooffset"
-             ["trianglepattern"
-              (either "0" "1" "2" "3" "4" "5" "6" "7")]
-             ["undefined" (either "1" "2" "3")]
-             ["noundefined"]
-             "altdiagonal" "noaltdiagonal"
-             "bentover" "nobentover"))])
-
-         (set-historysize-clause
-          ["historysize" number])
-
-         (set-isosamples-clause
-          [(kw ("isosam" . "ples")) number (maybe "," number)])
-
-         (set-key-clause
-          ["key"
-           (many
-            (either "on" "off" "default"
-                    [(either "inside" "outside")
-                     (either "lmargin" "rmargin" "tmargin" "bmargin")]
-                    ["at" expression "," expression]
-                    "left" "right" "center" "top" "bottom" "vertical"
-                    "horizontal" "Left" "Right" "reverse" "noreverse" "invert"
-                    "noinvert" "above" "over" "below" "under"
-                    ["samplen" number]
-                    ["spacing" number]
-                    ["width" number]
-                    [(either "autotitle" "noautotitle") (maybe "columnheader")]
-                    ["title" expression] "enhanced" "noenhanced" ["font" string]
-                    textcolor-spec
-                    [(either "box" "nobox") linestyle-spec]
-                    ["maxcols" (either expression "auto")]
-                    ["maxrows" (either expression "auto")]))])
-
-         (set-label-clause
-          ["label"
-           (maybe expression)
-           (either label-clause-component expression)
-           (many label-clause-component)])
-
-         (label-clause-component
-          (either
-           ["at" position]
-           "left" "center" "right"
-           (either "norotate" ["rotate" "by" expression])
-           ["font" string]
-           "noenhanced"
-           "front" "back"
-           textcolor-spec
-           "nopoint" ["point" (many (either pointsize-spec linestyle-spec))]
-           ["offset" position]))
-
-         (set-loadpath-clause
-          ["loadpath" (many string)])
-
-         (set-locale-clause
-          ["locale" (maybe string)])
-
-         (set-logscale-clause
-          ["logscale"
-           (either "x" "y" "xy" "x2" "y2" "z" "cb" name)])
-
-         (set-mapping-clause
-          ["mapping" (either "cartesian" "spherical" "cylindrical")])
-
-         (set-margin-clause
-          [(either "bmargin" "lmargin" "rmargin" "tmargin")
-           (maybe "at" "screen") expression])
-
-         ;; TODO: set-mouse-clause
-
-         (set-multiplot-clause
-          ["multiplot"
-           (maybe
-            ["layout" number "," number
-             (maybe (either "rowsfirst" "columnsfirst"))
-             (maybe (either "downwards" "upwards"))
-             (maybe "title" string)
-             (maybe "scale" number (maybe "," number))
-             (maybe "offset" number (maybe "," number))])])
-
-         (set-mxtics-clause
-          [(:info "mxtics")
-           (either "mxtics" "mytics" "mztics" "mx2tics" "my2tics" "mcbtics")
-           (either "default" number)])
-
-         ;; "set object", objects, dimensions, positions
-         (set-object-clause
-          ["object"
-           (maybe number)
-           (info-keyword
-            (either rectangle-object ellipse-object circle-object polygon-object))
-           (maybe (either "front" "back" "behind"))
-           (maybe (kw "fillcolor" "fc") color-spec)
-           (maybe "fs" expression)
-           (maybe "default")
-           (maybe (kw "linewidth" "lw") expression)])
-
-         (rectangle-object
-          [(kw ("rect" . "angle"))
-           (maybe
-            (either
-             ["from" position (either "to" "rto") position]
-             ["center" position "size" dimension "," dimension]
-             ["at" position "size" dimension "," dimension]))])
-
-         (ellipse-object
-          ["ellipse"
-           (either "at" "center") position
-           "size" dimension "," dimension
-           (maybe "angle" number)])
-
-         (circle-object
-          ["circle"
-           (either "at" "center") position
-           "size" dimension
-           (maybe "arc" "[" number ":" number "]")])
-
-         (polygon-object
-          ["polygon"
-           "from" position (many (either "to" "rto") position)])
-
-         ;; "set offsets"
-         (set-offsets-clause
-          ["offsets"
-           (delimited-list [(maybe "graph") expression] "," 4 4)])
-
-         (set-origin-clause
-          ["origin" expression "," expression])
-
-         (set-output-clause
-          ["output" (maybe string)])
-
-         (set-parametric-clause
-          [(:info "parametric_")
-           (kw ("param" . "etric"))])
-
-         (set-pm3d-clause
-          ["pm3d"
-           (many
-            (either
-             ["at" name]
-             ["interpolate" number "," number]
-             (either "scansautomatic" "scansforward" "scansbackward" "depthorder")
-             ["flush" (either "begin" "center" "end")]
-             (either "ftriangles" "noftriangles")
-             (either "clip1in" "clip4in")
-             ["corners2color"
-              (either "mean" "geomean" "median" "min" "max" "c1" "c2" "c3" "c4")]
-             ["hidden3d" number]
-             "nohidden3d"
-             "implicit" "explicit" "map"))])
-
-         (set-palette-clause
-          ["palette"
-           (many
-            (either
-             "gray" "color"
-             ["gamma" number]
-             ["rgbformulae" number "," number "," number]
-             "defined"          ; not complete
-             ["functions" expression "," expression "," expression]
-             ["file" string (many datafile-modifier)]
-             "RGB" "HSV" "CMY" "YIQ" "XYZ"
-             "positive" "negative"
-             "nops_allcF" "ps_allcF"
-             ["maxcolors" number]))])
-
-         (set-pointsize-clause pointsize-spec)
-
-         (set-polar-clause "polar")
-
-         (set-print-clause
-          [(:info "print_")
-           "print"
-           (maybe string)])
-
-         (set-samples-clause
-          ["samples" expression (maybe "," expression)])
-
-         (set-size-clause
-          ["size"
-           (either
-            "square" "nosquare"
-            ["ratio" expression]
-            "noratio"
-            [expression "," expression])])
-
-         (set-style-clause
-          ["style"
-           (either style-arrow-clause style-data-clause style-fill-clause
-                   style-function-clause style-increment-clause
-                   style-line-clause style-circle-clause style-rectangle-clause)])
-
-         ;; begin subclauses of "set style ..."
-         (style-arrow-clause
-          [(:info "set_style_arrow")
-           "arrow"
-           number
-           (either
-            "default"
-            (many
-             (either "nohead" "head" "heads"
-                     "filled" "empty" "nofilled"
-                     "front" "back"
-                     ["size" dimension "," number (maybe "," number)]
-                     linestyle-spec)))])
-
-         (style-data-clause
-          [(:info "set_style_data")
-           "data" plotting-style])
-
-         (style-fill-clause
-          [(:info "set_style_fill")
-           "fill" fill-style])
-
-         (style-function-clause
-          [(:info "set_style_function")
-           "function" plotting-style])
-
-         (style-increment-clause
-          [(:info "set_style_increment")
-           "increment"
-           (either (kw ("d" . "efault")) (kw ("u" . "serstyles")))])
-
-         (style-line-clause
-          [(:info "set_style_line")
-           "line"
-           expression
-           (either
-            "default"
-            (many
-             (either
-              "palette"
-              [(kw ("linet" . "ype") "lt")
-               (either expression color-spec)]
-              [(kw ("linec" . "olor") "lc") color-spec]
-              [(either (kw ("linew" . "idth") "lw")
-                       (kw ("pointt" . "ype") "pt")
-                       (kw ("points" . "ize") "ps")
-                       (kw ("pointi" . "nterval") "pi"))
-               expression])))])
-
-         (style-circle-clause
-          [(:info "set_style_circle")
-           "circle" "radius" dimension])
-
-         (style-rectangle-clause
-          [(:info "set_style_rectangle")
-           "rectangle"
-           (many
-            (either
-             "front" "back"
-             [(kw ("linew" . "idth") "lw") expression]
-             [(kw "fillcolor" "fc") color-spec]
-             ["fs" expression]))])
-         ;; end of "set style ..." clauses
-
-         (set-surface-clause "surface")
-
-         (set-table-clause ["table" (maybe string)])
-
-         (set-terminal-clause       ; not sure how to do this...
-          ["terminal" (maybe (either "push" "pop"))])
-
-         (set-termoption-clause
-          ["termoption"
-           (either
-            "enhanced" "noenhanced"
-            ["font" string]
-            "solid" "dashed"
-            [(kw "linewidth" "lw") expression])])
-
-         (set-tics-clause
-          ["tics"
-           (many
-            (either
-             "axis" "border" "mirror" "nomirror" "in" "out"
-             ["scale" (either "default" [expression (maybe "," expression)])]
-             [(either "rotate" "norotate") (maybe "by" expression)]
-             ["offset" expression] "nooffset"
-             ["format" string]
-             ["font" string]
-             textcolor-spec))])
-
-         (set-tics-clause-2
-          ["tics" (either "front" "back")])
-
-         (set-xtics-clause
-          [(:info "xtics")
-           (either "xtics" "ytics" "ztics" "x2tics" "y2tics" "cbtics")
-           (many
-            (either
-             "axis" "border" "mirror" "nomirror" "in" "out"
-             ["scale" (either "default" [expression (maybe "," expression)])]
-             [(either "rotate" "norotate") (maybe "by" expression)]
-             ["offset" position] "nooffset"
-             "add" "autofreq"
-             ["(" (delimited-list [(maybe string) expression (maybe number)] ",") ")"]
-             ["format" string]
-             ["font" string]
-             "rangelimited"
-             textcolor-spec
-             (delimited-list expression ",")))])
-
-         (set-timestamp-clause
-          ["timestamp"
-           (maybe string)
-           (maybe (either "top" "bottom"))
-           (maybe (either "rotate" "norotate"))
-           (maybe "offset" position)
-           (maybe "font" string)])
-
-         (set-timefmt-clause
-          ["timefmt" string])
-
-         (set-title-clause
-          [(:info "title_")
-           "title"
-           (maybe expression)
-           (many
-            (either
-             ["offset" position]
-             ["font" string]
-             textcolor-spec
-             "enhanced" "noenhanced"))])
-
-         (set-view-clause
-          ["view"
-           (either
-            "map"
-            [(either "equal" "noequal") (maybe (either "xy" "xyz"))]
-            (delimited-list (maybe expression) ","))])
-
-         (set-data-clause
-          [(:info "xdata")
-           (either "xdata" "ydata" "zdata" "x2data" "y2data" "cbdata")
-           (maybe (either "time" "geographic"))])
-
-         (set-dtics-clause
-          [(:info "xdtics")
-           (either "xdtics" "ydtics" "zdtics" "x2dtics" "y2dtics" "cbdtics")])
-
-         (set-xlabel-clause
-          [(:info "xlabel")
-           (either (kw ("xlab" . "el")) (kw ("ylab" . "el"))
-                   (kw ("zlab" . "el")) (kw ("x2lab" . "el"))
-                   (kw ("y2lab" . "el")) (kw ("cblab" . "el")))
-           (maybe expression)
-           (many
-            (either
-             ["offset" position]
-             ["font" string]
-             textcolor-spec
-             "enhanced" "noenhanced"))])
-
-         (set-mtics-clause
-          [(:info "xmtics")
-           (either "xmtics" "ymtics" "zmtics" "x2mtics" "y2mtics" "cbmtics")])
-
-         (set-range-clause
-          [(:info "xrange")
-           (either (kw ("xr" . "ange")) (kw ("yr" . "ange"))
-                   (kw ("x2r" . "ange")) (kw ("y2r" . "ange"))
-                   (kw ("zr" . "ange")) (kw ("tr" . "ange"))
-                   (kw ("ur" . "ange")) (kw ("vr" . "ange"))
-                   (kw ("rr" . "ange")) (kw ("cbr" . "ange")))
-           (either
-            "restore"
-            ["[" (maybe
-                  [(maybe axis-range-component) ":"
-                   (maybe axis-range-component)])
-             "]"
-             (many (either "reverse" "noreverse" "writeback" "nowriteback"))])])
-
-         (set-xyplane-clause
-          ["xyplane" (either "at" "relative") expression])
-
-         (set-zero-clause
-          ["zero" expression])
-
-         (set-zeroaxis-clause
-          [(:info "zeroaxis")
-           (either "zeroaxis" "xzeroaxis" "x2zeroaxis" "yzeroaxis" "y2zeroaxis"
-                   "zzeroaxis")
-           (maybe linestyle-spec)])
-
-;;; Other commands
-         (cd-command
-          ["cd" string])
-
-         (call-command
-          ["call" string (many expression)])
-
-         (simple-command
-          (either "clear" "exit" "quit" "pwd" "refresh" "reread" "reset"
-                  "shell"))
-
-         (eval-command
-          ["eval" expression])
-
-         (load-command
-          ["load" string])
-
-         (lower-raise-command [(either "lower" "raise") number])
-
-         (pause-command
-          ["pause"
-           (either
-            expression
-            ["mouse" (maybe endcondition (maybe "," endcondition))])
-           string])
-
-         (endcondition (either "keypress" "button1" "button2" "button3" "close" "any"))
-
-         (save-command
-          ["save"
-           (either "functions" "variables" "terminal" "set")
-           string])
-
-         (system-command
-          ["system" string])
-
-         (test-command
-          ["test"
-           (either
-            "terminal"
-            ["palette"
-             (maybe
-              (either "rgb" "rbg" "grb" "gbr" "brg" "bgr"))])])
-
-         (undefine-command
-          ["undefine" (many name)])
-
-         (update-command
-          ["update" string (maybe string)]))
-
-       ;; This is the start symbol
-       'command))))
-
-
-;; The following macros are used for debugging; load
-;; gnuplot-debug-context.el and then re-load this file to enable
-;; them. For normal use, they compile to no-ops.
-(eval-when-compile
-  (when (not (featurep 'gnuplot-debug-context))
-    (defmacro gnuplot-context--with-trace-buffer (&rest _) "No-op." '(progn nil))
-    (defmacro gnuplot-context--trace (&rest _) "No-op." '(progn nil))
-    (defmacro gnuplot-context--debug (&rest _) "No-op." '(progn nil))))
-
-
-;;;; Variables to be set via pattern matching
-(defvar gnuplot-context--completions nil
-  "List of possible `gnuplot-mode' completions at point.
-This is filled in by `gnuplot-context--match-pattern' when it reaches the
-token before point.")
-
-(defvar gnuplot-context--info-at-point nil
-  "Relevant page of the Gnuplot info manual for the construction at point.
-
-Set by `gnuplot-context--match-pattern' using information from
-`gnuplot-context--compiled-grammar'.  `gnuplot-context--match-pattern'
-pushes ElDoc and info strings onto the stack as it runs, and scans the
-stack for the topmost entry when it reaches the token at point.")
-
-(defvar gnuplot-context--captures nil
-  "Alist of named capture groups for `gnuplot-mode' completion code.
-
-Each entry is of the form (NAME BEGIN END), where NAME is the
-name specified in the (capture NAME PATTERN) form in the
-`gnuplot-context--compiled-grammar' source, BEGIN is the tail of the token
-list beginning the capture group, and END is the tail of the
-token list just after the end of the capture group.")
-
-(defvar gnuplot-context--eldoc nil
-  "ElDoc documentation string for the Gnuplot construction at point.
-
-Set by `gnuplot-context--match-pattern'.  See also
-`gnuplot-context-info-at-point'.")
-
-
-;;;; The pattern matching machine
-(defun gnuplot-context--match-pattern (instructions tokens completing-p
-                                                    &optional start-symbol)
-  "Parse TOKENS, setting completions, info and ElDoc information.
-
-This function parses TOKENS by simulating a stack machine with
-unlimited backtracking.  If COMPLETING-P is non-nil, it stops
-before the token at point and collects a list of the next tokens
-that it would accept in `gnuplot-context--completions'.  If COMPLETING-P is
-nil, it parses up to the token at point and sets `gnuplot-context--eldoc'
-and `gnuplot-context--info-at-point' based on the contents of the stack
-there."
-  (catch 'return
-    (let ((pc 0)            ; Program counter
-          ;; Stack of return addresses (return PC), eldoc strings
-          ;; (eldoc STRING) and info pages (info STRING)
-          (stack '())
-          ;; Stack of backtracking records:
-          ;; ((STACK TOKENS RESUME-PC CAPTURES PROGRESS) ...)
-          (backtrack '())
-          ;; Match failure flag, set to `t' to cause backtracking
-          (fail nil)
-          ;; Flag set by JUMP and CALL instructions to stop PC advance
-          (jump nil)
-          ;; Record of progress made within (many ...) loops, an alist
-          ;; of conses (pc . tokens)
-          (progress '()))
-
-      (gnuplot-context--with-trace-buffer (erase-buffer))
-
-      (when start-symbol        ; HACK FIXME
-        (let ((look-for `(label ,start-symbol)))
-          (while (not (equal (aref instructions pc) look-for))
-            (cl-incf pc))
-          (cl-incf pc)))
-
-      (setq gnuplot-context--completions nil
-            gnuplot-context--eldoc nil
-            gnuplot-context--info-at-point nil
-            gnuplot-context--captures nil)
-
-      (cl-flet ((advance
-                  ()
-                  (pop tokens)
-                  (if (and (null tokens) (not completing-p))
-                      (gnuplot-context--scan-stack stack tokens)))
-                (fail () (setq fail t)))
-
-        ;; Main loop
-        (while t
-          (let* ((inst (aref instructions pc))
-                 (opcode (car inst))
-                 (token (car tokens))
-                 (end-of-tokens (null tokens)))
-            (gnuplot-context--trace "%s\t%s\t%s\n" pc inst (and token (gnuplot-context--token-id token)))
-
-            (cl-case opcode
-              ;; (literal LITERAL NO-COMPLETE)
-              ((literal)
-               (let ((expect (cadr inst))
-                     (no-complete (cl-caddr inst)))
-                 (cond (end-of-tokens
-                        (unless no-complete
-                          (gnuplot-context--trace "\tpushing \"%s\" to completions\n" expect)
-                          (push expect gnuplot-context--completions))
-                        (fail))
-
-                       ((not (equal (gnuplot-context--token-id token) expect))
-                        (fail))
-
-                       ;; otherwise succeed
-                       (t (advance)))))
-
-              ;; (token-type TYPE)
-              ((token-type)
-               (let ((expect (cadr inst)))
-                 (if (or end-of-tokens
-                         (not (eq (gnuplot-context--token-type token) expect)))
-                     (fail)
-                   (advance))))
-
-              ;; (keyword REGEXP NAME): match any token whose ID
-              ;; regexp-matches REGEXP, use NAME for completions
-              ((keyword)
-               (let ((regexp (cadr inst))
-                     (name (cl-caddr inst)))
-                 (cond (end-of-tokens
-                        (gnuplot-context--trace "\tpushing \"%s\" to completions\n" name)
-                        (push name gnuplot-context--completions)
-                        (fail))
-
-                       ((not (string-match-p regexp (gnuplot-context--token-id token)))
-                        (fail))
-
-                       ;; otherwise succeed
-                       (t
-                        (setf (gnuplot-context--token-id token) name)
-                        (advance)))))
-
-              ;; (any): match any token
-              ((any)
-               (if end-of-tokens
-                   (fail)
-                 (advance)))
-
-              ;; (jump LOCATION): jump to instruction at LOCATION
-              ((jump)
-               (let ((location (cadr inst)))
-                 (setq jump location)))
-
-              ;; (call LOCATION): push the next instruction as a
-              ;; return location and jump
-              ((call)
-               (let ((location (cadr inst)))
-                 (push `(return ,(+ pc 1)) stack)
-                 (setq jump location)))
-
-              ;; (return): return to address at topmost RETURN record on
-              ;; stack, or stop matching and return if stack is empty
-              ((return)
-               (while (and stack
-                           (not (eq (caar stack) 'return)))
-                 (pop stack))
-               (if (not stack)
-                   ;; Successful match
-                   (throw 'return (list tokens))
-                 ;; Otherwise, return to caller
-                 (let* ((r (pop stack))
-                        (r-pc (cadr r)))
-                   (setq jump r-pc))))
-
-              ;; (choice LOCATION): push LOCATION onto the stack of
-              ;; backtracking points and continue at next instruction
-              ((choice)
-               (let ((location (cadr inst)))
-                 (push `(,stack ,tokens ,location ,gnuplot-context--captures
-                                ,progress)
-                       backtrack)))
-
-              ;; (commit LOCATION): discard most recent backtrack point
-              ;; and jump to LOCATION
-              ((commit)
-               (let ((location (cadr inst)))
-                 (if (not backtrack)
-                     (error "No more backtrack points in commit"))
-                 (pop backtrack)
-                 (setq jump location)))
-
-              ;; (fail): force this match to fail, going back to most
-              ;; recent backtrack point
-              ((fail)
-               (fail))
-
-              ;; (assert): run Lisp code and fail if it returns NIL
-              ((assert)
-               (let ((form (cadr inst)))
-                 (if (not (eval form)) (fail))))
-
-              ;; (push TYPE VALUE): push an info page or eldoc string
-              ;; onto the stack
-              ((push)
-               (let* ((type (cadr inst))
-                      (value (cl-caddr inst)))
-                 (push `(,type ,value ,tokens) stack)))
-
-              ;; (pop TYPE): pop something off the stack
-              ((pop)
-               (let ((type (cadr inst)))
-                 (if (not (and stack
-                               (eq (caar stack) type)))
-                     (error "Expected a %s on the stack but found %s" type stack))
-                 (pop stack)))
-
-              ;; (save-start NAME): save current token pointer as
-              ;; beginning of capture group NAME
-              ((save-start)
-               (let ((name (cadr inst)))
-                 (push `(,name ,tokens nil) gnuplot-context--captures)))
-
-              ;; (save-end NAME): save current token pointer as end of
-              ;; capture group NAME
-              ((save-end)
-               (let* ((name (cadr inst))
-                      (record (assoc name gnuplot-context--captures)))
-                 (if (not record)
-                     (error "Gnuplot-match-tokens: no open capture group named %s" name)
-                   (setf (cl-caddr record) tokens)
-                   (gnuplot-context--debug (gnuplot-dump-captures)))))
-
-              ;; (check-progress): make sure not stuck in an infinite loop
-              ((check-progress)
-               (let ((prev-progress (cdr (assoc pc progress))))
-                 (if (and prev-progress (eq prev-progress tokens))
-                     (fail)
-                   (push (cons pc tokens) progress))))
-
-              (t
-               (error "Bad instruction: %s" inst)))
-
-            ;; Increment PC or jump
-            (setq pc (or jump (1+ pc))
-                  jump nil)
-
-            ;; Backtrack on failure
-            (when fail
-              (if (not backtrack)   ; Out of backtracking stack: failed match
-                  (throw 'return nil)
-                (gnuplot-context--trace "\t*fail*\t%s\n" (length backtrack))
-                (gnuplot-context--debug (gnuplot-dump-backtrack backtrack))
-                ;; If we got as far as token-at-point before failing,
-                ;; scan the stack for eldoc and info strings
-                (when (and end-of-tokens (not completing-p))
-                  (gnuplot-context--scan-stack stack tokens))
-
-                (cl-destructuring-bind
-                    (bt-stack bt-tokens bt-pc bt-captures bt-progress)
-                    (pop backtrack)
-                  (setq stack bt-stack
-                        tokens bt-tokens
-                        pc bt-pc
-                        gnuplot-context--captures bt-captures
-                        progress bt-progress
-                        fail nil)
-                  (gnuplot-context--debug (gnuplot-dump-progress progress)))))))))))
-
-(defun gnuplot-context--scan-stack (stack tokens)
-  "Scan STACK for the most recently pushed eldoc and info strings."
-  (gnuplot-context--trace "\t* scanning stack *\n")
-  (gnuplot-context--debug (gnuplot-backtrace stack))
-  (gnuplot-context--debug (gnuplot-dump-captures))
-
-  (catch 'no-scan
-    (while (and stack
-                (not (and gnuplot-context--info-at-point gnuplot-context--eldoc)))
-      (let* ((item (car stack))
-             (type (car item))
-             (position (cl-caddr item))) ; must progress by at least one token
-        (if (and (memq type '(info eldoc no-scan))
-                 (not (eq position tokens)))
-            (cl-case type
-              ((no-scan)
-               (throw 'no-scan nil))
-
-              ((info)
-               (when (not gnuplot-context--info-at-point)
-                 (let ((info (cadr item)))
-                   (setq gnuplot-context--info-at-point
-                         (cond
-                          ((eq info 'first-token)
-                           (gnuplot-context--token-id (car position)))
-                          ((functionp info) (funcall info))
-                          (t info)))
-                   (when gnuplot-context--info-at-point
-                     (gnuplot-context--trace "\tset info to \"%s\"\n" gnuplot-context--info-at-point)
-                     (unless gnuplot-context--eldoc
-                       (let ((eldoc
-                              (car (gethash gnuplot-context--info-at-point gnuplot-eldoc-hash))))
-                         (when eldoc
-                           (setq gnuplot-context--eldoc eldoc)
-                           (gnuplot-context--trace "\tand set eldoc to \"%s\"\n" eldoc))))))))
-
-              ((eldoc)
-               (when (not gnuplot-context--eldoc)
-                 (let ((eldoc (cadr item)))
-                   (setq gnuplot-context--eldoc
-                         (if (functionp eldoc) (funcall eldoc) eldoc))
-                   (gnuplot-context--trace "\tset eldoc to \"%s\"\n" gnuplot-context--eldoc)))))))
-      (pop stack))))
-
-(defun gnuplot-context--capture-group (name)
-  "Return capture group NAME from the most recent parse, as a list of tokens."
-  (let ((record (assoc name gnuplot-context--captures)))
-    (if (not record) nil
-      (let ((begin (cadr record))
-            (end (cl-caddr record))
-            (accum '()))
-        (while (and begin (not (eq begin end)))
-          (push (pop begin) accum))
-        (nreverse accum)))))
-
-
-;;; Interface to the matching machine
-(defun gnuplot-context--parse-at-point (completing-p)
-  (let ((tokens (gnuplot-context--tokenize completing-p)))
-    (gnuplot-context--match-pattern gnuplot-context--compiled-grammar tokens completing-p)))
-
-;; Completions
-(defun gnuplot-context--completions ()
-  (gnuplot-context--parse-at-point t)
-  gnuplot-context--completions)
-
-(defun gnuplot-context-completion-at-point ()
-  "Return completions of keyword preceding point, using context."
-  (list (save-excursion
-          (skip-syntax-backward "w_" (gnuplot--point-at-beginning-of-command))
-          (point))
-        (point)
-        (gnuplot-context--completions)))
-
-;; Eldoc help
-(defun gnuplot-context-eldoc-function (&rest _)
-  "Return the ElDoc string for the Gnuplot construction at point."
-  (gnuplot-context--parse-at-point nil)
-  gnuplot-context--eldoc)
-
-(defun gnuplot-context-help-at-point ()
-  "Pop up the extended documentation for the construction at point."
-  (interactive nil gnuplot-mode gnuplot-comint-mode)
-  (gnuplot-context--parse-at-point nil)
-  (if gnuplot-context--info-at-point
-      (let ((eldoc
-             (cadr (gethash gnuplot-context--info-at-point gnuplot-eldoc-hash))))
-        (if eldoc (message eldoc)))))
-
-;; Info lookup
-(defun gnuplot-context-info-at-point (&optional query)
-  "Open the relevant gnuplot info page for the construction at point."
-  (interactive "P" gnuplot-mode gnuplot-comint-mode)
-  (setq gnuplot-context--info-at-point nil)
-  (unless query
-    (gnuplot-context--parse-at-point nil))
-  (if (or query (not gnuplot-context--info-at-point))
-      (let ((info
-             (info-lookup-interactive-arguments 'symbol)))
-        (setq gnuplot-context--info-at-point (car info))))
-  (when gnuplot-context--info-at-point
-    (gnuplot-context--find-info-node gnuplot-context--info-at-point)))
-
-(defun gnuplot-context--find-info-node (node)
-  (save-window-excursion
-    (info (format "(gnuplot)%s" node)))
-  (gnuplot--adjust-info-display))
-
-
-;;; Some context-sensitive hacks
-
-;; ElDoc strings for "using" specs, which depend on other information
-;; from the parsed command
-
-(defvar gnuplot-context--using-eldoc
-  '(("boxerrorbars" . "x:y:ydelta{:xdelta} | x:y:ylow:yhigh{:xdelta}")
-    ("boxes" . "x:y{:x_width}")
-    ("boxxyerrorbars" . "x:y:xdelta:ydelta | x:y:xlow:xhigh:ylow:yhigh")
-    ("candlesticks" . "x:box_min:whisker_min:whisker_high:box_high | date:open:low:high:close")
-    ("circles" . "x:y:radius")
-    ("dots" . "x{:y{:z}}")
-    ("filledcurves" . "x:y | x:y1:y2")
-    ("financebars" . "date:open:low:high:close")
-    ("fsteps" . "y | x:y")
-    ("histeps" . "y | x:y")
-    ("histograms" . "y:yerr | y:ymin:ymax")
-    ("image" . "x:y:value")
-    ("rgbimage" . "x:y:r:g:b")
-    ("rgbalpha" . "x:y:r:g:b:a")
-    ("impulses" . "x{:y{:z}}")
-    ("labels" . "x:y:string")
-    ("lines" . "y | x:y")
-    ("steps" . "y | x:y")
-    ("vectors" . "x:y:xdelta:ydelta")
-    ("xerrorbars" . "x:y:xdelta | x:y:xlow:xhigh")
-    ("xyerrorbars" . "x:y:xdelta:ydelta | x:y:xlow:xhigh:ylow:yhigh")
-    ("yerrorbars" . "x:y:ydelta | x:y:ylow:yhigh")
-    ("yerrorlines" . "x:y:ydelta | x:y:ylow:yhigh")
-    ("xerrorlines" "x:y:xdelta | x:y:xlow:xhigh")
-    ("xyerrorlines" . "x:y:xdelta:ydelta | x:y:xlow:xhigh:ylow:yhigh"))
-  "Alist of ElDoc strings for Gnuplot \"using\" clauses in \"plot\" commands.")
-
-(defvar gnuplot-context--using-3d-eldoc
-  (append
-   '(("fsteps" . "z | x:y:z")
-     ("histeps" . "z | x:y:z")
-     ("histograms" . "y:yerr | y:ymin:ymax")
-     ("image" . "x:y:z:value")
-     ("rgbimage" . "x:y:z:r:g:b")
-     ("rgbalpha" . "x:y:z:r:g:b:a")
-     ("labels" . "x:y:z:string")
-     ("lines" . "z | x:y:z")
-     ("steps" . "z | x:y:z")
-     ("vectors" . "x:y:z:xdelta:ydelta:zdelta"))
-   gnuplot-context--using-eldoc)
-  "Alist of ElDoc strings for Gnuplot \"using\" clauses in \"splot\" commands.")
-
-(defun gnuplot-context--find-using-eldoc ()
-  "Return ElDoc string for a Gnuplot \"using\" clause, based on plotting style.
-
-This will fail if the \"using\" clause comes before the \"with\"
-clause."
-  (let ((with-style (gnuplot-context--capture-group :with-style))
-        (3d-p (gnuplot-context--capture-group :splot-command))
-        (column-description nil))
-    (if with-style
-        (let ((with-style-string (gnuplot-context--token-id (car with-style))))
-          (setq column-description
-                (or (and 3d-p
-                         (cdr (assoc with-style-string gnuplot-context--using-3d-eldoc)))
-                    (cdr (assoc with-style-string gnuplot-context--using-eldoc))
-                    "<columns>"))))
-    (format "using %s {'format'}" column-description)))
-
-;;; Needed for correctly parsing plot commands
-(defun gnuplot-context--guess-parametric-p (&optional start)
-  "Guess whether the command beginning at START is in parametric mode.
-
-Searches backward in current buffer for an \"(un)set parametric\"
-command."
-  (save-excursion
-    (and start (goto-char start))
-    (catch 'result
-      (while
-          (search-backward-regexp "reset\\|set\\s-+parametric" (point-min) t)
-        (gnuplot--beginning-of-command)
-        (cond ((looking-at "reset\\|unset\\s-+parametric") (throw 'result nil))
-              ((looking-at "set\\s-+parametric") (throw 'result t))))
-      nil)))
-
-(define-minor-mode gnuplot-context-sensitive-mode
-  "Use context-sensitive completion and help in `gnuplot-mode'.
-
-When context-sensitive mode is enabled, `gnuplot-mode' tries to
-provide more useful completions and help suggestions for built-in
-keywords and functions by parsing each command as you type.  It
-attempts to take into account Gnuplot's many abbreviated
-keywords.  For example, with point at the end of a line reading
-\"plot \\='datafile\\=' w \", typing \\[completion-at-point] will pop
-up a list of plotting styles.
-
-Key bindings:
-
-\\[completion-at-point] will complete the keyword at point based
-on its context in the command. To make keyword completion work on
-pressing TAB, set `tab-always-indent' to `complete'.
-
-\\[gnuplot-context-info-at-point] will try to find the most relevant
-Gnuplot info node for the construction at point, prompting for a
-node name if nothing is found.
-
-\\[gnuplot-context-help-at-point] will pop up a brief summary of the
-syntax at point in the minibuffer. To have one-line syntax
-summaries appear in the echo area as you type, toggle
-`eldoc-mode'.
-
-To choose whether to use this mode by default in Gnuplot buffers,
-customize the variable
-`gnuplot-use-context-sensitive-completion'."
-  :interactive (gnuplot-mode gnuplot-comint-mode)
-  :keymap
-  `((,(kbd "C-c C-/") . gnuplot-context-help-at-point)
-    (,(kbd "C-c C-d") . gnuplot-context-info-at-point))
-  (unless (derived-mode-p 'gnuplot-mode 'gnuplot-comint-mode)
-    (message "Gnuplot context-sensitive mode works only in Gnuplot-mode buffers")
-    (setq gnuplot-context-sensitive-mode nil))
-  (if gnuplot-context-sensitive-mode
-      (progn
-        (remove-hook 'completion-at-point-functions #'gnuplot-completion-at-point-info-look t)
-        (add-hook 'completion-at-point-functions #'gnuplot-context-completion-at-point nil t)
-        (add-hook 'eldoc-documentation-functions #'gnuplot-context-eldoc-function nil 'local))
-    (add-hook 'completion-at-point-functions #'gnuplot-completion-at-point-info-look nil t)
-    (remove-hook 'completion-at-point-functions #'gnuplot-context-completion-at-point t)
-    (remove-hook 'eldoc-documentation-functions #'gnuplot-context-eldoc-function t)))
-
-(provide 'gnuplot-context)
-;;; gnuplot-context.el ends here
diff --git a/elpa/gnuplot-20250724.1531/gnuplot-eldoc.el b/elpa/gnuplot-20250724.1531/gnuplot-eldoc.el
deleted file mode 100644
index 0425ffe9..00000000
--- a/elpa/gnuplot-20250724.1531/gnuplot-eldoc.el
+++ /dev/null
@@ -1,631 +0,0 @@
-;;; gnuplot-eldoc.el -- Eldoc documentation strings for gnuplot-mode -*- lexical-binding: t -*-
-;;; Automatically generated by doc2texi.el on Sun, 01 June 2025
-
-;;;; This file is generated automatically from the Gnuplot
-;;;; documentation by `doc2texi.el', part of the Gnuplot distribution.
-;;;; It is not intended to be edited manually.  See docs/gnuplot.doc
-;;;; in the gnuplot source tree (available from
-;;;; gnuplot.sourcefourge.net) for the original.
-
-;; This file is covered by the Gnuplot licensing terms:
-
-;; Copyright 1986 - 1993, 1998, 2004   Thomas Williams, Colin Kelley
-;;
-;; Permission to use, copy, and distribute this software and its
-;; documentation for any purpose with or without fee is hereby granted,
-;; provided that the above copyright notice appear in all copies and
-;; that both that copyright notice and this permission notice appear
-;; in supporting documentation.
-;;
-;; Permission to modify the software is granted, but not the right to
-;; distribute the complete modified source code.  Modifications are to
-;; be distributed as patches to the released version.  Permission to
-;; distribute binaries produced by compiling modified sources is granted,
-;; provided you
-;;   1. distribute the corresponding source modifications from the
-;;    released version in the form of a patch file along with the binaries,
-;;   2. add special version identification to distinguish your version
-;;    in addition to the base release version number,
-;;   3. provide your name and address as the primary contact for the
-;;    support of your modified version, and
-;;   4. retain our contact information in regard to use of the base
-;;    software.
-;; Permission to distribute the released version of the source code along
-;; with corresponding source modifications in the form of a patch file is
-;; granted with same provisions 2 through 4 for binary distributions.
-;;
-;; This software is provided "as is" without express or implied warranty
-;; to the extent permitted by applicable law.
-
-(eval-when-compile (defvar gnuplot-eldoc-hash nil))
-(setq gnuplot-eldoc-hash (let ((tbl (make-hash-table :test 'equal)) (alist '(("x11" "set terminal x11 {<n> | window \"<string>\"} [more ...]" "set terminal x11 {<n> | window \"<string>\"}
-                 {title \"<string>\"}
-                 {{no}enhanced} {font <fontspec>}
-                 {linewidth LW}
-                 {{no}persist} {{no}raise} {{no}ctrlq}
-                 {{no}replotonresize}
-                 {close}
-                 {size XX,YY} {position XX,YY}
-set terminal x11 {reset}") ("wxt" "set term wxt {<n>} [more ...]" "set term wxt {<n>}
-             {size <width>,<height>} {position <x>,<y>}
-             {background <rgb_color> | nobackground}
-             {{no}enhanced}
-             {font <font>} {fontscale <scale>}
-             {title \"title\"}
-             {linewidth <lw>} {butt|rounded|square}
-             {dashlength <dl>}
-             {{no}persist}
-             {{no}raise}
-             {{no}ctrl}
-             {close}") ("windows" "set terminal windows {<n>} [more ...]" "set terminal windows {<n>}
-                     {color | monochrome}
-                     {solid | dashed}
-                     {rounded | butt}
-                     {enhanced | noenhanced}
-                     {font <fontspec>}
-                     {fontscale <scale>}
-                     {linewidth <scale>}
-                     {pointscale <scale>}
-                     {background <rgb color>}
-                     {title \"Plot Window Title\"}
-                     {{size | wsize} <width>,<height>}
-                     {position <x>,<y>}
-                     {docked {layout <rows>,<cols>} | standalone}
-                     {close}") ("tpic" "set terminal tpic <pointsize> <linewidth> <interval>") ("tkcanvas" "set terminal tkcanvas {tcl | perl | perltkx | python | ruby | rexx} [more ...]" "set terminal tkcanvas {tcl | perl | perltkx | python | ruby | rexx}
-                      {standalone | input}
-                      {interactive}
-                      {rounded | butt}
-                      {nobackground | background <rgb color>}
-                      {{no}rottext}
-                      {size <width>,<height>}
-                      {{no}enhanced}
-                      {externalimages | pixels}") ("tgif" "set terminal tgif {portrait | landscape | default} {<[x,y]>} [more ...]" "set terminal tgif {portrait | landscape | default} {<[x,y]>}
-                  {monochrome | color}
-                  {{linewidth | lw} <LW>}
-                  {solid | dashed}
-                  {font \"<fontname>{,<fontsize>}\"}") ("tek40" "set terminal sixeltek {<fontsize>} {mono|color|colors <n>} {size <x>,<y>} [more ...]" "set terminal sixeltek {<fontsize>} {mono|color|colors <n>} {size <x>,<y>}
-                      {animate}") ("svg" "set terminal svg {size <x>,<y> {|fixed|dynamic}} [more ...]" "set terminal svg {size <x>,<y> {|fixed|dynamic}}
-                 {mouse} {standalone | jsdir <dirname>}
-                 {name <plotname>}
-                 {font \"<fontname>{,<fontsize>}\"} {{no}enhanced}
-                 {fontscale <multiplier>}
-                 {rounded|butt|square} {solid|dashed} {linewidth <lw>}
-                 {background <rgb_color>}") ("regis" "set terminal regis {4 | 16}\"") ("pstricks" "set terminal pstricks [more ...]" "set terminal pstricks
-               {unit | size <XX>{unit},<YY>{unit}}
-               {standalone | input}
-               {blacktext | colortext | colourtext}
-               {linewidth <lw>} {rounded | butt}
-               {pointscale <ps>}
-               {psarrows | gparrows}
-               {background <rgbcolor>}
-               {pstricks | pdftricks2}") ("pdf" "set terminal pdf {monochrome|color|colour} [more ...]" "set terminal pdf {monochrome|color|colour}
-                 {{no}enhanced}
-                 {fname \"<font>\"} {fsize <fontsize>}
-                 {font \"<fontname>{,<fontsize>}\"} {fontscale <scale>}
-                 {linewidth <lw>} {rounded|butt}
-                 {dl <dashlength>}}
-                 {size <XX>{unit},<YY>{unit}}") ("dospc" "set terminal dospc [more ...]" "set terminal dospc
-    {{no}{enhanced}}
-    {fontscale <scale>} {pointsize <scale>} {linewidth <scale}
-    {background <rgbcolor>}") ("pbm" "set terminal pbm {<fontsize>} {<mode>} {size <x>,<y>}") ("mif" "set terminal mif {color | colour | monochrome} {polyline | vectors} [more ...]" "set terminal mif {color | colour | monochrome} {polyline | vectors}
-                 {help | ?}") ("mp" "set term mp {color | colour | monochrome} [more ...]" "set term mp {color | colour | monochrome}
-            {solid | dashed}
-            {notex | tex | latex}
-            {magnification <magsize>}
-            {psnfss | psnfss-version7 | nopsnfss}
-            {prologues <value>}
-            {a4paper}
-            {amstex}
-            {\"<fontname> {,<fontsize>}\"} ") ("lua" "set terminal lua <target name> | \"<file name>\" [more ...]" "set terminal lua <target name> | \"<file name>\"
-                    {<script_args> ...}
-                    {help}") ("latex" "set terminal {latex | emtex} {default | {courier|roman} {<fontsize>}} [more ...]" "set terminal {latex | emtex} {default | {courier|roman} {<fontsize>}}
-             {size <XX>{unit}, <YY>{unit}} {rotate | norotate}
-             {color | monochrome}") ("imagen" "set terminal imagen {<fontsize>} {portrait | landscape} [more ...]" "set terminal imagen {<fontsize>} {portrait | landscape}
-                    {[<horiz>,<vert>]}") ("hppj" "set terminal hppj {FNT5X9 | FNT9X17 | FNT13X25}") ("hpljii" "set terminal hpljii | hpdj {<res>}") ("hpgl" "set terminal hpgl {<number_of_pens>} {eject} {fontscale <scale>}") ("hp500c" "set terminal hp500c {<res>} {<comp>}") ("gpic" "set terminal gpic {<x> <y>}") ("ggi" "set terminal ggi [acceleration <integer>] [[mode] {mode}]") ("png_" "set terminal png  [more ...]" "set terminal png 
-       {{no}enhanced}
-       {{no}transparent} {{no}interlace}
-       {{no}truecolor} {rounded|butt}
-       {linewidth <lw>} {dashlength <dl>}
-       {tiny | small | medium | large | giant}
-       {font \"<face> {,<pointsize>}\"} {fontscale <scale>}
-       {size <x>,<y>} {{no}crop}
-       {background <rgb_color>}") ("fig" "set terminal fig {monochrome | color} [more ...]" "set terminal fig {monochrome | color}
-                 {small | big | size <xsize>{in|cm},<ysize>{in|cm}}
-                 {landscape | portrait}
-                 {pointsmax <max_points>}
-                 {font \"<fontname>{,<fontsize>}\"} {fontsize <size>}
-                 {textnormal | {textspecial texthidden textrigid}}
-                 {{linewidth|lw} <multiplier>}") ("epson_180dpi" "set terminal dpu414 {small | medium | large} {normal | draft}") ("epson_180dpi" "set terminal nec_cp6 {monochrome | colour | draft}") ("emf" "set terminal emf {color | monochrome} [more ...]" "set terminal emf {color | monochrome}
-                 {enhanced {noproportional}}
-                 {rounded | butt}
-                 {linewidth <LW>} {dashlength <DL>}
-                 {size XX,YY} {background <rgb_color>}
-                 {font \"<fontname>{,<fontsize>}\"}
-                 {fontscale <scale>}") ("eepic" "set terminal eepic {default} {color|monochrome|dashed} [more ...]" "set terminal eepic {default} {color|monochrome|dashed}
-                   {rotate} {size XX,YY}
-                   {small|tiny|<fontsize>}") ("dumb" "set terminal dumb {size <xchars>,<ychars>} {[no]feed} [more ...]" "set terminal dumb {size <xchars>,<ychars>} {[no]feed}
-                  {aspect <htic>{,<vtic>}}
-                  {[no]enhanced}
-                  {fillchar {solid|\"<char>\"}}
-                  {[no]attributes}
-                  {mono|ansi|ansi256|ansirgb}") ("svga" "set terminal svga {font \"<fontname>\"} [more ...]" "set terminal svga {font \"<fontname>\"}
-                  {{no}enhanced}
-                  {background <rgb color>}
-                  {linewidth|lw <lw>}
-                  {pointscale|ps <scale>}
-                  {fontscale|fs <scale>}") ("corel" "set terminal corel {monochrome | color} {\"<font>\" {<fontsize>}} [more ...]" "set terminal corel {monochrome | color} {\"<font>\" {<fontsize>}}
-                   {<xsize> <ysize> {<linewidth> }}") ("context" "set term context {default} [more ...]" "set term context {default}
-        {defaultsize | size <scale> | size <xsize>{in|cm}, <ysize>{in|cm}}
-        {input | standalone}
-        {timestamp | notimestamp}
-        {noheader | header \"<header>\"}
-        {color | colour | monochrome}
-        {rounded | mitered | beveled} {round | butt | squared}
-        {dashed | solid} {dashlength | dl <dl>}
-        {linewidth | lw <lw>}
-        {fontscale <fontscale>}
-        {mppoints | texpoints}
-        {inlineimages | externalimages}
-        {defaultfont | font \"{<fontname>}{,<fontsize>}\"}") ("cgm" "set terminal cgm {color | monochrome} {solid | dashed} {{no}rotate} [more ...]" "set terminal cgm {color | monochrome} {solid | dashed} {{no}rotate}
-                 {<mode>} {width <plot_width>} {linewidth <line_width>}
-                 {font \"<fontname>,<fontsize>\"}
-                 {background <rgb_color>}") ("canvas" "set terminal canvas {size <xsize>, <ysize>} {background <rgb_color>} [more ...]" "set terminal canvas {size <xsize>, <ysize>} {background <rgb_color>}
-                    {font {<fontname>}{,<fontsize>}} | {fsize <fontsize>}
-                    {{no}enhanced} {linewidth <lw>}
-                    {rounded | butt | square}
-                    {dashlength <dl>}
-                    {standalone {mousing} | name '<funcname>'}
-                    {jsdir 'URL/for/javascripts'}
-                    {title '<some string>'}") ("be" "set terminal be {reset} {<n>}") ("aqua" "set terminal aqua {<n>} {title \"<wintitle>\"} {size <x> <y>} [more ...]" "set terminal aqua {<n>} {title \"<wintitle>\"} {size <x> <y>}
-                  {font \"<fontname>{,<fontsize>}\"}
-                  {linewidth <lw>}\"}
-                  {{no}enhanced} {solid|dashed} {dl <dashlength>}}") ("aifm" "set terminal aifm {color|monochrome} {\"<fontname>\"} {<fontsize>}") ("While" "while (<expr>) { [more ...]" "while (<expr>) {
-    <commands>
-}") ("warn" "warn \"message\"") ("vfill" "vfill  FILE using x:y:z:radius:(<expression>) [more ...]" "vfill  FILE using x:y:z:radius:(<expression>)
-vgfill FILE using x:y:z:radius:(<expression>)") ("vclear" "vclear {$gridname}") ("linetype_" "unset linetype N") ("toggle" "toggle {<plotno> | \"plottitle\" | all}") ("test" "test {terminal | palette}") ("system_" "system \"command string\" [more ...]" "system \"command string\"
-! command string
-output = system(\"command string\")
-show variable GPVAL_SYSTEM") ("stats_(Statistical_Summary)" "stats {<ranges>} 'filename' {matrix | using N{:M}} {name 'prefix'} {{no}output} [more ...]" "stats {<ranges>} 'filename' {matrix | using N{:M}} {name 'prefix'} {{no}output}
-stats $voxelgridname {name 'prefix'}") ("voxel-grid" "splot $voxelgridname with {dots|points} {above <threshold>} ... [more ...]" "splot $voxelgridname with {dots|points} {above <threshold>} ...
-splot $voxelgridname with isosurface {level <threshold>} ...") ("matrix" "plot 'file' matrix every {<column_incr>} [more ...]" "plot 'file' matrix every {<column_incr>}
-                         {:{<row_incr>}
-                           {:{<start_column>}
-                             {:{<start_row>}
-                               {:{<end_column>}
-                                 {:<end_row>}}}}}") ("matrix" "sparse matrix=(cols,rows) origin=(x0,y0) dx=<delx> dy=<dely>") ("data-file" "splot '<file_name>' {binary <binary list>} [more ...]" "splot '<file_name>' {binary <binary list>}
-                    {{nonuniform|sparse} matrix}
-                    {index <index list>}
-                    {every <every list>}
-                    {using <using list>}") ("splot" "splot {<ranges>} [more ...]" "splot {<ranges>}
-      {<iteration>}
-      <function> | {{<file name> | <datablock name>} {datafile-modifiers}}
-                 | <voxelgridname>
-                 | keyentry
-      {<title-spec>} {with <style>}
-      {, {definitions{,}} <function> ...}") ("show_variables" "show variables      # show variables that do not begin with GPVAL_ [more ...]" "show variables      # show variables that do not begin with GPVAL_
-show variables all  # show all variables including those beginning GPVAL_
-show variables NAME # show only variables beginning with NAME") ("show_palette" "show palette [more ...]" "show palette
-show palette palette {<ncolors>} {{float | int | hex}}
-show palette gradient
-show palette rgbformulae
-test palette") ("show_functions" "show functions") ("zeroaxis" "set {x|x2|y|y2|z}zeroaxis { {linestyle | ls <line_style>} [more ...]" "set {x|x2|y|y2|z}zeroaxis { {linestyle | ls <line_style>}
-                           | {linetype | lt <line_type>}
-                             {linewidth | lw <line_width>}
-                             {linecolor | lc <colorspec>}
-                             {dashtype | dt <dashtype>} }
-unset {x|x2|y|y2|z}zeroaxis
-show {x|y|z}zeroaxis") ("zero" "set zero <expression> [more ...]" "set zero <expression>
-show zero") ("xyplane" "set xyplane at <zvalue> [more ...]" "set xyplane at <zvalue>
-set xyplane relative <frac>
-set ticslevel <frac>        # equivalent to set xyplane relative
-show xyplane") ("xtics_list" "set xtics {add} (\"label1\" <pos1> <level1>, \"label2\" <pos2> <level2>, ...)") ("xtics_series" "set xtics <incr> [more ...]" "set xtics <incr>
-set xtics <start>, <incr>, <end>") ("xtics" "set xtics {axis | border} {{no}mirror} [more ...]" "set xtics {axis | border} {{no}mirror}
-          {in | out} {scale {default | <major> {,<minor>}}}
-          {{no}rotate {by <ang>}} {offset <offset> | nooffset}
-          {left | right | center | autojustify}
-          {add}
-          {  autofreq
-           | <incr>
-           | <start>, <incr> {,<end>}
-           | ({\"<label>\"} <pos> {<level>} {,{\"<label>\"}...) }
-          {format \"formatstring\"} {font \"name{,<size>}\"} {{no}enhanced}
-          { numeric | timedate | geographic }
-          {{no}logscale}
-          { rangelimited }
-          { textcolor <colorspec> }
-unset xtics
-show xtics") ("xrange" "set xrange [{{<min>}:{<max>}}] {{no}reverse} {{no}writeback} {{no}extend} [more ...]" "set xrange [{{<min>}:{<max>}}] {{no}reverse} {{no}writeback} {{no}extend}
-           | restore
-show xrange") ("xmtics" "set xmtics [more ...]" "set xmtics
-unset xmtics
-show xmtics") ("xlabel" "set xlabel {\"<label>\"} {offset <offset>} {font \"<font>{,<size>}\"} [more ...]" "set xlabel {\"<label>\"} {offset <offset>} {font \"<font>{,<size>}\"}
-           {textcolor <colorspec>} {{no}enhanced}
-           {rotate by <degrees> | rotate parallel | norotate}
-show xlabel") ("xdtics" "set xdtics [more ...]" "set xdtics
-unset xdtics
-show xdtics") ("xdata" "set xdata {time} [more ...]" "set xdata {time}
-show xdata") ("walls" "set walls [more ...]" "set walls
-set wall {x0|y0|z0|x1|y1} {<fillstyle>} {fc <fillcolor>}") ("vxrange" "Establishes the range of x coordinates spanned by the active voxel grid. [more ...]" "Establishes the range of x coordinates spanned by the active voxel grid.
-Analogous commands `set vyrange` and `set vzrange` exist for the other two
-dimensions of the voxel grid.  If no explicit ranges have been set prior to
-the first `vclear`, `vfill`, or `voxel(x,y,z) = ` command, vmin and vmax
-will be copied from the current values of `xrange`.") ("vrange" "The range of the parametric variables u and v is useful in two contexts. [more ...]" "The range of the parametric variables u and v is useful in two contexts.
-1) `splot` in parametric mode. See `set parametric`, `set isosamples`.
-2) generating 2-dimension sampled data for either `plot` or `splot` using the
-pseudofile \"++\". See `sampling 2D`.") ("projection" "set view projection {xy|xz|yz}") ("view" "set view <rot_x>{,{<rot_z>}{,{<scale>}{,<scale_z>}}} [more ...]" "set view <rot_x>{,{<rot_z>}{,{<scale>}{,<scale_z>}}}
-set view map {scale <scale>}
-set view projection {xy|xz|yz}
-set view {no}equal {xy|xyz}
-set view azimuth <angle>
-show view") ("vgrid" "set vgrid $gridname {size N} [more ...]" "set vgrid $gridname {size N}
-unset vgrid $gridname
-show vgrid") ("version" "show version {long}") ("urange" "The range of the parametric variables u and v is useful in two contexts. [more ...]" "The range of the parametric variables u and v is useful in two contexts.
-1) `splot` in parametric mode. See `set parametric`, `set isosamples`.
-2) generating 2-dimension sampled data for either `plot` or `splot` using the
-pseudofile \"++\". See `sampling 2D`.") ("trange" "The range of the parametric variable t is useful in three contexts.") ("title_" "set title {\"<title-text>\"} {offset <offset>} {font \"<font>{,<size>}\"} [more ...]" "set title {\"<title-text>\"} {offset <offset>} {font \"<font>{,<size>}\"}
-          {{textcolor | tc} {<colorspec> | default}} {{no}enhanced}
-show title") ("timefmt" "set timefmt \"<format string>\" [more ...]" "set timefmt \"<format string>\"
-show timefmt") ("timestamp" "set timestamp {\"<format>\"} {top|bottom} {{no}rotate} [more ...]" "set timestamp {\"<format>\"} {top|bottom} {{no}rotate}
-              {offset <xoff>{,<yoff>}} {font \"<fontspec>\"}
-              {textcolor <colorspec>}
-unset timestamp
-show timestamp") ("tics" "set tics {axis | border} {{no}mirror} [more ...]" "set tics {axis | border} {{no}mirror}
-         {in | out} {front | back}
-         {{no}rotate {by <ang>}} {offset <offset> | nooffset}
-         {left | right | center | autojustify}
-         {format \"formatstring\"} {font \"name{,<size>}\"} {{no}enhanced}
-         { textcolor <colorspec> }
-set tics scale {default | <major> {,<minor>}}
-unset tics
-show tics") ("terminal" "set terminal {<terminal-type> | push | pop} [more ...]" "set terminal {<terminal-type> | push | pop}
-show terminal") ("table" "set table {\"outfile\" | $datablock} {append} [more ...]" "set table {\"outfile\" | $datablock} {append}
-          {separator {whitespace|tab|comma|\"<char>\"}}
-plot <whatever>
-unset table") ("surface_" "set surface {implicit|explicit} [more ...]" "set surface {implicit|explicit}
-unset surface
-show surface") ("set_style_watchpoint" "set style watchpoint nolabels [more ...]" "set style watchpoint nolabels
-set style watchpoint labels {label-options}") ("set_style_textbox" "set style textbox {<boxstyle-index>} [more ...]" "set style textbox {<boxstyle-index>}
-          {opaque|transparent} {fillcolor <color>}
-          {{no}border {linecolor <colorspec>}}{linewidth <lw>}
-          {margins <xmargin>,<ymargin>}") ("set_style_spiderplot" "set style spiderplot [more ...]" "set style spiderplot
-          {fillstyle <fillstyle-properties>}
-          {<line-properties> | <point-properties>}") ("set_style_parallelaxis" "set style parallelaxis {front|back} {line-properties}") ("set_style_ellipse" "set style ellipse {units xx|xy|yy} [more ...]" "set style ellipse {units xx|xy|yy}
-                  {size {graph|screen} <a>, {{graph|screen} <b>}}
-                  {angle <angle>}
-                  {clip|noclip}") ("set_style_rectangle" "set style rectangle {front|back} {lw|linewidth <lw>} [more ...]" "set style rectangle {front|back} {lw|linewidth <lw>}
-                    {fillcolor <colorspec>} {fs <fillstyle>}") ("set_style_circle" "set style circle {radius {graph|screen} <R>} [more ...]" "set style circle {radius {graph|screen} <R>}
-                 {{no}wedge}
-                 {clip|noclip}") ("set_style_line" "set style line <index> default [more ...]" "set style line <index> default
-set style line <index> {{linetype  | lt} <line_type> | <colorspec>}
-                       {{linecolor | lc} <colorspec>}
-                       {{linewidth | lw} <line_width>}
-                       {{pointtype | pt} <point_type>}
-                       {{pointsize | ps} <point_size>}
-                       {{pointinterval | pi} <interval>}
-                       {{pointnumber | pn} <max_symbols>}
-                       {{dashtype | dt} <dashtype>}
-                       {palette}
-unset style line
-show style line") ("set_style_function" "set style function <plotting-style> [more ...]" "set style function <plotting-style>
-show style function") ("set_style_fill" "set style fill {empty [more ...]" "set style fill {empty
-                | {transparent} solid {<density>}
-                | {transparent} pattern {<n>}}
-               {border {lt} {lc <colorspec>} | noborder}") ("set_style_data" "set style data <plotting-style> [more ...]" "set style data <plotting-style>
-show style data") ("boxplot_" "set style boxplot {range <r> | fraction <f>} [more ...]" "set style boxplot {range <r> | fraction <f>}
-                  {{no}outliers} {pointtype <p>}
-                  {candlesticks | financebars}
-                  {medianlinewidth <width>}
-                  {separation <x>}
-                  {labels off | auto | x | x2}
-                  {sorted | unsorted}") ("set_style_arrow" "set style arrow <index> default [more ...]" "set style arrow <index> default
-set style arrow <index> {nohead | head | backhead | heads}
-                        {size <length>,<angle>{,<backangle>} {fixed}}
-                        {filled | empty | nofilled | noborder}
-                        {front | back}
-                        { {linestyle | ls <line_style>}
-                          | {linetype | lt <line_type>}
-                            {linewidth | lw <line_width}
-                            {linecolor | lc <colorspec>}
-                            {dashtype | dt <dashtype>} }
-unset style arrow
-show style arrow") ("style" "set style arrow <n> <arrowstyle> [more ...]" "set style arrow <n> <arrowstyle>
-set style boxplot <boxplot style options>
-set style circle radius <size> {clip|noclip}
-set style ellipse size <size> units {xy|xx|yy} {clip|noclip}
-set style fill <fillstyle>
-set style histogram <histogram style options>
-set style line <n> <linestyle>
-set style rectangle <object options> <linestyle> <fillstyle>
-set style textbox {<n>} {opaque|transparent} {{no}border} {fillcolor}
-set style watchpoint labels <label options>") ("style" "set style function <style> [more ...]" "set style function <style>
-set style data <style>
-show style function
-show style data") ("size" "set size {{no}square | ratio <r> | noratio} {<xscale>,<yscale>} [more ...]" "set size {{no}square | ratio <r> | noratio} {<xscale>,<yscale>}
-show size") ("samples" "set samples <samples_1> {,<samples_2>} [more ...]" "set samples <samples_1> {,<samples_2>}
-show samples") ("rgbmax" "set rgbmax {1.0 | 255} [more ...]" "set rgbmax {1.0 | 255}
-unset rgbmax") ("print_" "set print [more ...]" "set print
-set print \"-\"
-set print \"<filename>\" [append]
-set print \"|<shell_command>\"
-set print $datablock [append]") ("polar_grid" "set polar grid {<theta_segments>, <radial_segments>} [more ...]" "set polar grid {<theta_segments>, <radial_segments>}
-               { qnorm {<power>} | gauss | cauchy | exp | box | hann }
-               { kdensity } { scale <scale> }
-               {theta [min:max]} {r [min:max]}") ("polar" "set polar [more ...]" "set polar
-set polar grid <grid options>
-unset polar
-show polar") ("pointsize" "set pointsize <multiplier> [more ...]" "set pointsize <multiplier>
-show pointsize") ("clipping" "set pm3d {clip | clip1in | clip4in} [more ...]" "set pm3d {clip | clip1in | clip4in}
-set pm3d {no}clipcb") ("lighting" "set pm3d lighting {primary <frac>} {specular <frac>} {spec2 <frac>} [more ...]" "set pm3d lighting {primary <frac>} {specular <frac>} {spec2 <frac>}
-set pm3d spotlight {rgb <color>} {rot_x <angle>} {rot_z <angle>}
-                   {Phong <value>} {default}") ("pixmap_from_colormap" "set pixmap <index> colormap <name>") ("pixmap" "set pixmap <index> {\"filename\" | colormap <name>} [more ...]" "set pixmap <index> {\"filename\" | colormap <name>}
-           at <position>
-           {width <w> | height <h> | size <w>,<h>}
-           {front|back|behind} {center}
-show pixmaps
-unset pixmaps
-unset pixmap <index>") ("paxis" "set paxis <axisno> {range <range-options> | tics <tic-options>} [more ...]" "set paxis <axisno> {range <range-options> | tics <tic-options>}
-set paxis <axisno> label <label-options> { offset <radial-offset> }
-show paxis <axisno> {range | tics}") ("parametric_" "set parametric [more ...]" "set parametric
-unset parametric
-show parametric") ("defined" "set palette  defined { ( <gray1> <color1> {, <grayN> <colorN>}... ) }") ("palette__" "set palette [more ...]" "set palette
-set palette {
-           { gray | color }
-           { gamma <gamma> }
-           {   rgbformulae <r>,<g>,<b>
-             | defined { ( <gray1> <color1> {, <grayN> <colorN>}... ) }
-             | file '<filename>' {datafile-modifiers}
-             | colormap <colormap-name> 
-             | functions <R>,<G>,<B>
-           }
-           { cubehelix {start <val>} {cycles <val>} {saturation <val>} }
-           { viridis }
-           { model { RGB | CMY | HSV {start <radians>} } }
-           { positive | negative }
-           { nops_allcF | ps_allcF }
-           { maxcolors <maxcolors> }
-         }") ("overflow" "set overflow {float | NaN | undefined} [more ...]" "set overflow {float | NaN | undefined}
-unset overflow") ("output" "set output {\"<filename>\"} [more ...]" "set output {\"<filename>\"}
-unset output
-show output") ("origin" "set origin <x-origin>,<y-origin>") ("offsets" "set offsets <left>, <right>, <top>, <bottom> [more ...]" "set offsets <left>, <right>, <top>, <bottom>
-unset offsets
-show offsets") ("polygon" "set object <index> polygon [more ...]" "set object <index> polygon
-    from <position> to <position> ... {to <position>}") ("circle" "set object <index> circle {at|center} <position> size <radius> [more ...]" "set object <index> circle {at|center} <position> size <radius>
-    {arc [<begin>:<end>]} {no{wedge}}
-    {<other-object-properties>}") ("ellipse" "set object <index> ellipse {at|center} <position> size <w>,<h> [more ...]" "set object <index> ellipse {at|center} <position> size <w>,<h>
-    {angle <orientation>} {units xy|xx|yy}
-    {<other-object-properties>}") ("rectangle" "set object <index> rectangle [more ...]" "set object <index> rectangle
-    {from <position> {to|rto} <position> |
-     center <position> size <w>,<h> |
-     at <position> size <w>,<h>}") ("object" "set object <index> [more ...]" "set object <index>
-    <object-type> <object-properties>
-    {front|back|behind|depthorder}
-    {clip|noclip}
-    {fc|fillcolor <colorspec>} {fs <fillstyle>}
-    {default} {lw|linewidth <width>} {dt|dashtype <dashtype>}
-unset object <index>") ("nonlinear" "set nonlinear <axis> via f(axis) inverse g(axis) [more ...]" "set nonlinear <axis> via f(axis) inverse g(axis)
-unset nonlinear <axis>") ("mxtics_time" "set mxtics time <N> {seconds|minutes|hours|days|weeks|months|years}") ("mxtics" "set mxtics <freq> [more ...]" "set mxtics <freq>
-set mxtics default
-set mxtics time <N> <units>
-unset mxtics
-show mxtics") ("multiplot" "set multiplot [more ...]" "set multiplot
-    { title <page title> {font <fontspec>} {enhanced|noenhanced} }
-    { layout <rows>,<cols>
-      {rowsfirst|columnsfirst} {downwards|upwards}
-      {scale <xscale>{,<yscale>}} {offset <xoff>{,<yoff>}}
-      {margins <left>,<right>,<bottom>,<top>}
-      {spacing <xspacing>{,<yspacing>}}
-    }
-set multiplot {next|previous}
-unset multiplot") ("mouseformat" "set mouse mouseformat i [more ...]" "set mouse mouseformat i
-set mouse mouseformat \"custom format\"
-set mouse mouseformat function string_valued_function(x, y)") ("mouse" "set mouse {doubleclick <ms>} {nodoubleclick} [more ...]" "set mouse {doubleclick <ms>} {nodoubleclick}
-          {{no}zoomcoordinates}
-          {zoomfactors <xmultiplier>, <ymultiplier>}
-          {noruler | ruler {at x,y}}
-          {polardistance{deg|tan} | nopolardistance}
-          {format <string>}
-          {mouseformat <int> | <string> | function <f(x,y)>}
-          {{no}labels {\"labeloptions\"}}
-          {{no}zoomjump} {{no}verbose}
-unset mouse") ("monochrome" "set monochrome {linetype N <linetype properties>}") ("margin" "set lmargin {{at screen} <margin>} [more ...]" "set lmargin {{at screen} <margin>}
-set rmargin {{at screen} <margin>}
-set tmargin {{at screen} <margin>}
-set bmargin {{at screen} <margin>}
-set margins <left>, <right>, <bottom>, <top>
-show margin") ("mapping" "set mapping {cartesian | spherical | cylindrical}") ("logscale" "set logscale <axes> {<base>} [more ...]" "set logscale <axes> {<base>}
-unset logscale <axes>
-show logscale") ("locale" "set locale {\"<locale>\"}") ("loadpath" "set loadpath {\"pathlist1\" {\"pathlist2\"...}} [more ...]" "set loadpath {\"pathlist1\" {\"pathlist2\"...}}
-show loadpath") ("link" "set link {x2 | y2} {via <expression1> inverse <expression2>} [more ...]" "set link {x2 | y2} {via <expression1> inverse <expression2>}
-unset link") ("label" "set label {<tag>} {\"<label text>\"} {at <position>} [more ...]" "set label {<tag>} {\"<label text>\"} {at <position>}
-          {left | center | right}
-          {norotate | rotate {by <degrees>}}
-          {font \"<name>{,<size>}\"}
-          {noenhanced}
-          {front | back}
-          {textcolor <colorspec>}
-          {point <pointstyle> | nopoint}
-          {offset <offset>}
-          {nobox} {boxed {bs <boxstyle>}}
-          {hypertext}
-unset label {<tag>}
-show label") ("jitter" "set jitter {overlap <yposition>} {spread <factor>} {wrap <limit>} [more ...]" "set jitter {overlap <yposition>} {spread <factor>} {wrap <limit>}
-           {swarm|square|vertical}") ("isotropic" "set isotropic [more ...]" "set isotropic
-unset isotropic") ("isosurface_" "set isosurface {mixed|triangles} [more ...]" "set isosurface {mixed|triangles}
-set isosurface {no}insidecolor <n>") ("isosamples" "set isosamples <iso_1> {,<iso_2>} [more ...]" "set isosamples <iso_1> {,<iso_2>}
-show isosamples") ("history_" "set history {size <N>} {quiet|numbers} {full|trim} {default}") ("hidden3d" "set hidden3d {defaults} | [more ...]" "set hidden3d {defaults} |
-             { {front|back}
-               {{offset <offset>} | {nooffset}}
-               {trianglepattern <bitpattern>}
-               {{undefined <level>} | {noundefined}}
-               {{no}altdiagonal}
-               {{no}bentover} }
-unset hidden3d
-show hidden3d") ("grid" "set grid {{no}{m}xtics} {{no}{m}ytics} {{no}{m}ztics} [more ...]" "set grid {{no}{m}xtics} {{no}{m}ytics} {{no}{m}ztics}
-         {{no}{m}x2tics} {{no}{m}y2tics} {{no}{m}rtics}
-         {{no}{m}cbtics}
-         {polar {<angle>}}
-         {layerdefault | front | back}
-         {{no}vertical}
-         {<line-properties-major> {, <line-properties-minor>}}
-unset grid
-show grid") ("format__" "set format {<axes>} {\"<format-string>\"} {numeric|timedate|geographic} [more ...]" "set format {<axes>} {\"<format-string>\"} {numeric|timedate|geographic}
-show format") ("fontpath" "set fontpath \"/directory/where/my/fonts/live\" [more ...]" "set fontpath \"/directory/where/my/fonts/live\"
-set term postscript fontfile <filename>") ("fit_" "set fit {nolog | logfile {\"<filename>\"|default}} [more ...]" "set fit {nolog | logfile {\"<filename>\"|default}}
-        {{no}quiet|results|brief|verbose}
-        {{no}errorvariables}
-        {{no}covariancevariables}
-        {{no}errorscaling}
-        {{no}prescale}
-        {maxiter <value>|default}
-        {limit <epsilon>|default}
-        {limit_abs <epsilon_abs>}
-        {start-lambda <value>|default}
-        {lambda-factor <value>|default}
-        {script {\"<command>\"|default}}
-        {v4 | v5}
-unset fit
-show fit") ("errorbars" "set errorbars {small | large | fullwidth | <size>} {front | back} [more ...]" "set errorbars {small | large | fullwidth | <size>} {front | back}
-              {line-properties}
-unset errorbars
-show errorbars") ("encoding" "set encoding {<value>} [more ...]" "set encoding {<value>}
-set encoding locale
-show encoding") ("dummy" "set dummy {<dummy-var>} {,<dummy-var>} [more ...]" "set dummy {<dummy-var>} {,<dummy-var>}
-show dummy") ("dgrid3d" "set dgrid3d {<rows>} {,{<cols>}} splines [more ...]" "set dgrid3d {<rows>} {,{<cols>}} splines
-set dgrid3d {<rows>} {,{<cols>}} qnorm {<norm>}
-set dgrid3d {<rows>} {,{<cols>}} {gauss | cauchy | exp | box | hann}
-                {kdensity} {<dx>} {,<dy>}
-unset dgrid3d
-show dgrid3d") ("decimalsign" "set decimalsign {<value> | locale {\"<locale>\"}} [more ...]" "set decimalsign {<value> | locale {\"<locale>\"}}
-unset decimalsign
-show decimalsign") ("set_datafile_binary" "set datafile binary <binary list> [more ...]" "set datafile binary <binary list>
-show datafile binary
-show datafile
-unset datafile") ("set_datafile_commentschars" "set datafile commentschars {\"<string>\"} [more ...]" "set datafile commentschars {\"<string>\"}
-show datafile commentschars
-unset commentschars") ("set_datafile_separator" "set datafile separator {whitespace | tab | comma | \"<chars>\"}") ("set_datafile_missing" "set datafile missing \"<string>\" [more ...]" "set datafile missing \"<string>\"
-set datafile missing NaN
-show datafile missing
-unset datafile") ("contourfill_" "set contourfill auto N          # split zrange evenly into N slices [more ...]" "set contourfill auto N          # split zrange evenly into N slices
-set contourfill ztics           # slice at each z axis major tick
-set contourfill cbtics          # slice at each cb axis major tick
-set contourfill {palette | firstlinetype N}") ("contour" "set contour {base | surface | both} [more ...]" "set contour {base | surface | both}
-unset contour
-show contour") ("cntrparam" "set cntrparam { { linear [more ...]" "set cntrparam { { linear
-                | cubicspline
-                | bspline
-                | points <n>
-                | order <n>
-                | levels { <n>
-                           | auto {<n>}
-                           | discrete <z1> {,<z2>{,<z3>...}}
-                           | incremental <start>, <incr> {,<end>}
-                         }
-                  {{un}sorted}
-                  {firstlinetype N}
-                }
-              }
-show contour") ("cntrlabel" "set cntrlabel {format \"format\"} {font \"font\"} [more ...]" "set cntrlabel {format \"format\"} {font \"font\"}
-set cntrlabel {start <int>} {interval <int>}
-set cntrlabel onecolor") ("clip" "set clip {points|one|two|radial} [more ...]" "set clip {points|one|two|radial}
-unset clip {points|one|two|radial}
-show clip") ("colorsequence" "set colorsequence {default|classic|podo}") ("colormap" "set colormap new <colormap-name> [more ...]" "set colormap new <colormap-name>
-set colormap <colormap-name> range [<min>:<max>]
-show colormaps") ("boxwidth" "set boxwidth {<width>} {absolute|relative} [more ...]" "set boxwidth {<width>} {absolute|relative}
-show boxwidth") ("border" "set border {<integer>} [more ...]" "set border {<integer>}
-           {front | back | behind}
-           {linestyle | ls <line_style>}
-           {linetype | lt <line_type>} {linewidth | lw <line_width>}
-           {linecolor | lc <colorspec>} {dashtype | dt <dashtype>}
-           {polar}
-unset border
-show border") ("autoscale" "set autoscale {<axis>{|min|max|fixmin|fixmax|fix} | fix | keepfix} [more ...]" "set autoscale {<axis>{|min|max|fixmin|fixmax|fix} | fix | keepfix}
-set autoscale noextend
-unset autoscale {<axis>}
-show autoscale") ("arrow" "set arrow {<tag>} from <position> to <position> [more ...]" "set arrow {<tag>} from <position> to <position>
-set arrow {<tag>} from <position> rto <position>
-set arrow {<tag>} from <position> length <coord> angle <ang>
-set arrow <tag> arrowstyle | as <arrow_style>
-set arrow <tag> {nohead | head | backhead | heads}
-                {size <headlength>,<headangle>{,<backangle>}} {fixed}
-                {filled | empty | nofilled | noborder}
-                {front | back}
-                {linestyle | ls <line_style>}
-                {linetype | lt <line_type>}
-                {linewidth | lw <line_width>}
-                {linecolor | lc <colorspec>}
-                {dashtype | dt <dashtype>}") ("angles" "set angles {degrees | radians} [more ...]" "set angles {degrees | radians}
-show angles") ("save" "save  {functions | variables | terminal | set | fit | datablocks} [more ...]" "save  {functions | variables | terminal | set | fit | datablocks}
-      '<filename>' {append}") ("return" "return <expression>") ("raise" "raise {plot_window_id} [more ...]" "raise {plot_window_id}
-lower {plot_window_id}") ("print" "print <expression> {, <expression>, ...}") ("with" "with <style> { {linestyle | ls <line_style>} [more ...]" "with <style> { {linestyle | ls <line_style>}
-               | {{linetype  | lt <line_type>}
-                  {linewidth | lw <line_width>}
-                  {linecolor | lc <colorspec>}
-                  {pointtype | pt <point_type>}
-                  {pointsize | ps <point_size>}
-                  {arrowstyle | as <arrowstyle_index>}
-                  {fill | fs <fillstyle>} {fillcolor | fc <colorspec>}
-                  {nohidden3d} {nocontours} {nosurface}
-                  {palette}}
-             }") ("title" "title <text> | notitle [<ignored text>] [more ...]" "title <text> | notitle [<ignored text>]
-title columnheader | title columnheader(N)
-      {at {beginning|end}} {{no}enhanced}") ("for_loops_in_plot_command" "plot for [<variable> = <start> : <end> {:<increment>}] [more ...]" "plot for [<variable> = <start> : <end> {:<increment>}]
-plot for [<variable> in \"string of words\"]") ("ranges" "[{<dummy-var>=}{{<min>}:{<max>}}] [more ...]" "[{<dummy-var>=}{{<min>}:{<max>}}]
-[{{<min>}:{<max>}}]") ("using" "plot 'file' using <entry> {:<entry> {:<entry> ...}} {'format'}") ("smooth" "smooth {unique | frequency | fnormal | cumulative | cnormal [more ...]" "smooth {unique | frequency | fnormal | cumulative | cnormal
-       | csplines | acsplines | mcsplines  bezier | sbezier
-       | path
-       | kdensity {bandwidth} {period}
-       | unwrap}") ("index" "plot 'file' index { <m>{:<n>{:<p>}} | \"<name>\" }") ("filters" "plot 'DATA' using <XCOL> {:<YCOL>} bins{=<NBINS>} [more ...]" "plot 'DATA' using <XCOL> {:<YCOL>} bins{=<NBINS>}
-     {binrange [<LOW>:<HIGH>]} {binwidth=<width>}
-     {binvalue={sum|avg}}") ("every" "plot 'file' every {<point_incr>} [more ...]" "plot 'file' every {<point_incr>}
-                    {:{<block_incr>}
-                      {:{<start_point>}
-                        {:{<start_block>}
-                          {:{<end_point>}
-                            {:<end_block>}}}}}") ("csv_files" "set datafile separator {whitespace | tab | comma | \"chars\"}") ("data" "plot '<file_name>' {binary <binary list>} [more ...]" "plot '<file_name>' {binary <binary list>}
-                   {{nonuniform|sparse} matrix}
-                   {index <index list> | index \"<name>\"}
-                   {every <every list>}
-                   {skip <number-of-lines>}
-                   {using <using list>}
-                   {convexhull} {concavehull}
-                   {smooth <option>}
-                   {bins <options>}
-                   {mask}
-                   {volatile} {zsort} {noautoscale}") ("general" "plot '<file_name>' {binary <binary list>} ... [more ...]" "plot '<file_name>' {binary <binary list>} ...
-splot '<file_name>' {binary <binary list>} ...") ("plot" "plot {<ranges>} <plot-element> {, <plot-element>, <plot-element>}") ("pause" "pause <time> {\"<string>\"} [more ...]" "pause <time> {\"<string>\"}
-pause mouse {<endcondition>}{, <endcondition>} {\"<string>\"}
-pause mouse close") ("local" "local foo = <expression> [more ...]" "local foo = <expression>
-local array foo[size]") ("load" "load \"<input-file>\" [more ...]" "load \"<input-file>\"
-load $datablock") ("import" "import func(x[,y,z,...]) from \"sharedobj[:symbol]\"") ("if" "if (<condition>) { <commands>; [more ...]" "if (<condition>) { <commands>;
-       <commands>
-       <commands>
-} else if (<condition>) {
-       <commands>
-} else {
-       <commands>
-}") ("fit" "fit {<ranges>} <expression> [more ...]" "fit {<ranges>} <expression>
-    '<datafile>' {datafile-modifiers}
-    {{unitweights} | {y|xy|z}error | errors <var1>{,<var2>,...}}
-    via '<parameter file>' | <var1>{,<var2>,...}") ("Do" "do for <iteration-spec> { [more ...]" "do for <iteration-spec> {
-     <commands>
-     <commands>
-}") ("cd" "cd '<directory-name>'") ("Zerrorfill" "splot DATA using 1:2:3:4[:5] with zerrorfill {fc|fillcolor <colorspec>} [more ...]" "splot DATA using 1:2:3:4[:5] with zerrorfill {fc|fillcolor <colorspec>}
-           {lt|linetype <n>} {<line properties>}") ("sectors" "plot DATA {using specifier} {units xy | units xx | units yy}") ("parallelaxes" "set style data parallelaxes [more ...]" "set style data parallelaxes
-plot $DATA using col1{:varcol1} {at <xpos>} {<line properties}, \\
-     $DATA using col2, ...") ("hsteps" "plot <data> with hsteps [more ...]" "plot <data> with hsteps
-                    {forward|backward}
-                    {baseline|pillars|link|nolink}
-                    {{above|below} y=<baseline>}
-                    {offset <y-offset>}") ("newhistogram" "newhistogram {\"<title>\" {font \"name,size\"} {tc <colorspec>}} [more ...]" "newhistogram {\"<title>\" {font \"name,size\"} {tc <colorspec>}}
-             {lt <linetype>} {fs <fillstyle>} {at <x-coord>}") ("ellipses" "plot <data> with ellipses {units [xx|xy|yy]}") ("contourfill" "splot f(x,y) with contourfill {at base} {fillstyle <style>}") ("Watchpoints_" "plot FOO watch {x|y|z|F(x,y)} = <value> [more ...]" "plot FOO watch {x|y|z|F(x,y)} = <value>
-plot FOO watch mouse") ("bind" "bind {allwindows} [<key-sequence>] [\"<gnuplot commands>\"] [more ...]" "bind {allwindows} [<key-sequence>] [\"<gnuplot commands>\"]
-bind <key-sequence> \"\"
-reset bind") ("dashtype" "dashtype N          # predefined dashtype invoked by number [more ...]" "dashtype N          # predefined dashtype invoked by number
-dashtype \"pattern\"  # string containing a combination of the characters
-                    # dot (.) hyphen (-) underscore(_) and space.
-dashtype (s1,e1,s2,e2,s3,e3,s4,e4)  # dash pattern specified by 1 to 4
-                    # numerical pairs <solid length>, <emptyspace length>") ("colorspec" "... {linecolor | lc} {\"colorname\" | <colorspec> | <n>} [more ...]" "... {linecolor | lc} {\"colorname\" | <colorspec> | <n>}
-... {textcolor | tc} {<colorspec> | {linetype | lt} <n>}
-... {fillcolor | fc} {<colorspec> | linetype <n> | linestyle <n>}") ("Time_functions" "time = weekdate_cdc( year, week [, day] )") ("Time_functions" "time = weekdate_iso( year, week [, day] )")))) (while alist (puthash (caar alist) (cdar alist) tbl) (setq alist (cdr alist))) tbl))
-(provide 'gnuplot-eldoc)
-;;; gnuplot-eldoc.el ends here
diff --git a/elpa/gnuplot-20250724.1531/gnuplot-gui.el b/elpa/gnuplot-20250724.1531/gnuplot-gui.el
deleted file mode 100644
index 756c0bdc..00000000
--- a/elpa/gnuplot-20250724.1531/gnuplot-gui.el
+++ /dev/null
@@ -1,1625 +0,0 @@
-;;;; gnuplot-gui.el -- GUI interface to setting options in gnuplot-mode -*- lexical-binding: t -*-
-
-;; Copyright (C) 1998-2000 Bruce Ravel
-
-;; Author: Bruce Ravel <ravel@phys.washington.edu>
-
-;; This file is not part of GNU Emacs.
-
-;; This program is free software: you can redistribute it and/or modify
-;; it under the terms of the GNU General Public License as published by
-;; the Free Software Foundation, either version 3 of the License, or
-;; (at your option) any later version.
-
-;; This program is distributed in the hope that it will be useful,
-;; but WITHOUT ANY WARRANTY; without even the implied warranty of
-;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-;; GNU General Public License for more details.
-
-;; You should have received a copy of the GNU General Public License
-;; along with this program.  If not, see <https://www.gnu.org/licenses/>.
-
-;;; Commentary:
-
-;; This file provides a graphical user interface to setting arguments
-;; to gnuplot commands.  Positioning point near a command and invoking
-;; `gnuplot-gui-set-options-and-insert' (C-c C-c or shift-mouse-2)
-;; will pop open a frame with widgets for setting the various
-;; arguments appropriate the the item that was near point.  The goal
-;; is to provide point-and-click functionality to gnuplot-mode.
-
-;;; To do:
-
-;; Widgets I need:
-;; -- 'position: two or three comma separated numbers used to denote a
-;;               position or a tic start/end/increment (see arrow,
-;;               need a prefix)
-;; -- 'modifier: colon separated fields used for datafile modifiers
-;;
-;; command types which are currently unsupported or contain mistakes
-;; -- unsupported: cntrparam
-;; -- plot, splot, fit: rather lame
-;; -- label: position information missing
-;; -- label: font string handled in overly simple manner
-;; -- hidden3d: not really suited to 'list, but all options are exclusive...
-;; -- pointstyle argument to "set label"
-;;
-;; overall:
-;; -- continuation lines (ugh!)
-;; -- multiple frames end up displaying same window after setting options
-
-;;; Code:
-
-(require 'gnuplot)
-(require 'wid-edit)
-
-
-;;; customizable variables
-
-(defgroup gnuplot-gui nil
-  "Graphical interface to setting arguments in gnuplot scrips."
-  :prefix "gnuplot-gui-"
-  :group 'gnuplot)
-
-(defcustom gnuplot-gui-popup-flag nil
-  "Non-nil means to open arguments pop-ups automatically.
-This would be done after menu insertion of Gnuplot commands."
-  :type 'boolean)
-
-(defvar gnuplot-gui-frame nil
-  "Frame used to hold the buffer for setting options.")
-
-(defcustom gnuplot-gui-frame-parameters
-  '((height . 18)
-    (width . 65)
-    (user-position . t)
-    (top . 150)
-    (left . 150)
-    (border-width . 0)
-    (menu-bar-lines . 0)
-    (unsplittable . t))
-  "Frame parameters for the input run-time display frame in Emacs."
-  :type '(repeat (sexp :tag "Parameter:")))
-
-(defcustom gnuplot-gui-fontname-list
-  '(" " "\"Helvetica\"" "\"Times-Roman\"")
-  "List of known font names.
-These *must* be quoted, like so \"\\\"Helvetica\\\"\".  This allows
-for fonts with names like \"\\\"Arial Bold Italic\\\"\" to be treated
-as single entries in the menu-buttons.  And it is really important that
-the first entry in the list be a blank string."
-  :type '(repeat (string :tag "Font name:")))
-
-;; some global variables
-(defvar gnuplot-gui-current-frame nil)
-(defvar gnuplot-gui-current-buffer nil)
-(defvar gnuplot-gui-current-buffer-point nil)
-(defvar gnuplot-gui-alist nil)
-(defvar gnuplot-gui-current-string nil)
-
-
-;;; various tools for handling data structures and text in the buffer
-
-;; tools for accessing the elements of the lists in `gnuplot-gui-all-types'
-(defsubst gnuplot-gui-type-tag     (obj) (elt obj 0))
-(defsubst gnuplot-gui-type-symbol  (obj) (elt obj 1))
-(defsubst gnuplot-gui-type-default (obj) (elt obj 2))
-(defsubst gnuplot-gui-type-prefix  (obj) (elt obj 3)) ; also 'range seperator
-(defsubst gnuplot-gui-type-fourth  (obj) (elt obj 4))
-(defsubst gnuplot-gui-type-list    (obj) (cddr obj))
-
-(defun gnuplot-gui-this-word ()
-  "Return the word under point."
-  (let ((begin (save-excursion (beginning-of-line) (point-marker)))
-        (end   (save-excursion (end-of-line)       (point-marker))))
-    (save-excursion
-      (or (looking-at "\\<") (= (current-column) 0) (forward-word -1))
-      (if (> (point) begin) (setq begin (point-marker)))
-      (forward-word 1)
-      (if (> (point) end) (goto-char end))
-      (buffer-substring-no-properties begin (point)))))
-
-
-;;; data structures containing regarding options in Gnuplot 3.7
-
-;; various constants used for options that take the same sorts of arguments
-(defconst gnuplot-gui-mtics-list
-  '(("FREQUENCY"   'number " ")
-    ("DEFAULT"     'list " " "default")))
-(defconst gnuplot-gui-data-list
-  '(("DATA TYPE"   'list " " "time")))
-(defconst gnuplot-gui-label-list
-  '(("LABEL"       'string " ")
-    ("POSITION"    'position " " "" 2)
-    ("FONTNAME"    'list " " gnuplot-gui-fontname-list)
-    ("FONTSIZE"    'fontsize " ")))
-(defconst gnuplot-gui-range-list
-  '(("RANGE"       'range (" " . " ") ":")
-    ("REVERSE"     'list " " "reverse" "noreverse")
-    ("WRITEBACK"   'list " " "writeback" "nowriteback")))
-(defconst gnuplot-gui-tics-list
-  '(("WHERE"       'list " " "axis" "border")
-    ("MIRROR"      'list " " "mirror" "nomirror")
-    ("ROTATE"      'list " " "rotate" "norotate")
-    ("SERIES"      'position " " "" 3)
-    ("LABEL ARRAY" 'labels () )))
-(defconst gnuplot-gui-zeroaxis-list
-  '(("LINETYPE"    'number " ")))
-
-(defvar gnuplot-gui-terminal-types nil
-  "Associated list of terminal descriptions.
-See the doc-string for `gnuplot-gui-all-types'.")
-(setq gnuplot-gui-terminal-types
-      (list (cons "aifm"
-                  '(("COLOR"     'list " " "monochrome" "gray" "color")
-                    ("FONTNAME"  'list " " gnuplot-gui-fontname-list)
-                    ("FONTSIZE"  'fontsize " ")))
-            (cons "cgm"
-                  '(("MODE"      'list   " " "landscape" "portrait" "default")
-                    ("COLOR"     'list   " " "color" "monochrome")
-                    ("ROTATION"  'list   " " "rotate" "norotate")
-                    ("WIDTH"     'number " " "width")
-                    ("LINEWIDTH" 'number " " "linewidth")
-                    ("FONTNAME"  'list   " " "\"Arial\"" "\"Arial Italic\""
-                     "\"Arial Bold\"" "\"Arial Bold Italic\""
-                     "\"Times Roman\"" "\"Times Roman Italic\""
-                     "\"Times Roman Bold\"" "\"Times Roman Bold Italic\""
-                     "\"Helvetica\"" "\"Roman\"")
-                    ("FONTSIZE"  'fontsize " ")))
-            (cons "corel"
-                  '(("COLOR"            'list " " "default" "color" "monochrome")
-                    ("FONTNAME"         'list " " "\"SwitzerlandLight\""
-                     "\"Helvetica\"" "\"Times-Roman\"")
-                    ("FONTSIZE "        'number " ")
-                    ("X-SIZE   "        'number " ")
-                    ("Y-SIZE   "        'number " ")
-                    ("LINEWIDTH"        'number " ")))
-            (cons "dumb"
-                  '(("LINEFEED"         'list   " " "feed" "nofeed")
-                    ("X-SIZE"           'number " ")
-                    ("Y-SIZE"           'number " ")))
-            (cons "emf"
-                  '(("COLOR"            'list " " "color" "monochrome")
-                    ("LINE"             'list " " "solid" "dashed")
-                    ("FONTNAME"         'string " ")
-                    ("FONTSIZE"         'number " ")))
-            (cons "emtex"
-                  '(("FONTNAME"         'list     " " "courier" "roman")
-                    ("FONTSIZE"         'fontsize " ")))
-            (cons "fig"
-                  '(("COLOR"            'list   " " "color" "monochrome")
-                    ("FRAMESIZE"        'list   " " "small" "big")
-                    ("POINTSMAX"        'number " " "pointsmax")
-                    ("ORIENTATION"      'list   " " "landscape" "portrait")
-                    ("UNITS"            'list   " " "metric" "inches")
-                    ("FONT SIZE"        'number " " "fontsize")
-                    ("SIZE"             'pair   (" " . " ") "size")
-                    ("LINE THICKNESS"   'number " " "thickness")
-                    ("LAYER DEPTH"      'number " " "depth")))
-            (cons "hp500c"
-                  '(("RESOLUTION"       'list " " "75" "100" "150" "300")
-                    ("COMPRESSION"      'list " " "rle" "tiff")))
-            (cons "hpgl"
-                  '(("PENS"             'number " ")
-                    ("EJECT"            'list   " " "eject")))
-            (cons "hpdj"
-                  '(("RESOLUTION"       'list " " "75" "100" "150" "300")))
-            (cons "hpljii"
-                  '(("RESOLUTION"       'list " " "75" "100" "150" "300")))
-            (cons "hppj"
-                  '(("FONT"             'list " " "FNT9X17" "FNT5X9" "FNT13X25")))
-            (cons "imagen"
-                  '(("FONT SIZE"        'number " ")
-                    ("LAYOUT"           'list   " " "portrait" "landscape")
-                    ("NUMBER OF GRAPHS" 'range (" " . " ") ",")))
-            (cons "gpic"
-                  '(("X ORIGIN"         'number " ")
-                    ("Y ORIGIN"         'number " " ",")))
-            (cons "latex"
-                  '(("FONTNAME"         'list " " "courier" "roman")
-                    ("FONTSIZE"         'fontsize " ")))
-            (cons "mif"
-                  '(("COLOUR"           'list " " "colour" "monochrome")
-                    ("LINETYPE"         'list " " "polyline" "vectors")))
-            (cons "nec-cp6"
-                  '(("MODE"             'list " " "monochrome" "colour" "draft")))
-            (cons "pbm"
-                  '(("SIZE"      'list " " "small" "medium" "large")
-                    ("COLOR"     'list " " "monochrome" "gray" "color")))
-            (cons "pcl5L"
-                  '(("MODE"      'list " " "landscape" "portrait")
-                    ("FONTNAME"  'list " " "stick" "univers" "cg_times")
-                    ("FONTSIZE"  'fontsize " ")))
-            (cons "png"
-                  '(("SIZE"      'list " " "small" "medium" "large")
-                    ("COLOR"     'list " " "monochrome" "gray" "color")))
-            (cons "postscript"
-                  '(("MODE"      'list " " "landscape" "portrait" "eps" "default")
-                    ("ENHANCED"  'list " " "enhanced" "noenhanced")
-                    ("COLOR"     'list " " "color" "monochrome")
-                    ("SOLID"     'list " " "solid" "dashed")
-                    ("DUPLEXING" 'list " " "defaultplex" "simplex" "duplex")
-                    ("FONTNAME"  'list " " gnuplot-gui-fontname-list)
-                    ("FONTSIZE"  'fontsize " ")))
-            (cons "pslatex"
-                  '(("COLOR"     'list " " "monochrome" "color")
-                    ("DASHED"    'list " " "dashed")
-                    ("ROTATION"  'list " " "rotate" "norotate")
-                    ("AUXFILE"   'list " " "auxfile")))
-            (cons "pstex"
-                  '(("COLOR"     'list " " "monochrome" "color")
-                    ("DASHED"    'list " " "dashed")
-                    ("ROTATION"  'list " " "rotate" "norotate")
-                    ("AUXFILE"   'list " " "auxfile")))
-            (cons "pstricks"
-                  '(("HACK TEXT"        'list " " "hacktext" "nohacktext")
-                    ("PLOT SCALING"     'list " " "nounit" "unit")))
-            (cons "regis"
-                  '(("COLOR DEPTH"      'list "4" "16")))
-            (cons "tgif"
-                  '(("LAYOUT"           'list   " " "portrait" "landscape")
-                    ("NUMBER OF GRAPHS" 'range (" " . " ") ",")
-                    ("LINE TYPE"        'list " " "solid" "dashed")
-                    ("FONTNAME"         'list " " gnuplot-gui-fontname-list)
-                    ("FONTSIZE"         'fontsize " ")))
-            (cons "tpic"
-                  '(("POINTSIZE"        'number " ")
-                    ("LINEWIDTH"        'number " ")
-                    ("INTERVAL "        'number " ")))
-            (cons "vgagl"       ; for pm3d patch (also persist, raise in x11)
-                  '(("BACKGROUND"       'position  " " "background" 3)
-                    ("INTERPOLATION"    'list " " "uniform" "interpolate")
-                    ("DUMP"             'file " ")
-                    ("MODE"             'string  " " "")))
-            (cons "x11"
-                  '(("RESET"            'list " " "reset")
-                    ("TERMINAL NUMBER"  'number " ")
-                    ("PERSIST"          'list " " "persist" "nopersist")
-                    ("RAISE"            'list " " "raise" "noraise"))) ))
-
-(defvar gnuplot-gui-terminal-list nil)
-(setq gnuplot-gui-terminal-list
-      (append (list " ") (mapcar 'car gnuplot-gui-terminal-types)))
-
-(defvar gnuplot-gui-set-types nil
-  "Associated list of set option descriptions.
-See the doc-string for `gnuplot-gui-all-types'.")
-(setq gnuplot-gui-set-types
-      (list (cons "angles"
-                  '(("UNITS" 'list " " "degrees" "radians")))
-            (cons "arrow"
-                  '(("TAG"       'tag " ")
-                    ("FROM"      'position " " "from" 3)
-                    ("TO"        'position " " "to" 3)
-                    ("HEAD"      'list " " "head" "nohead")
-                    ("LINESTYLE" 'number " " "ls")
-                    ("LINETYPE " 'number " " "lt")
-                    ("LINEWIDTH" 'number " " "lw")))
-            (cons "noarrow"
-                  '(("TAG" 'tag " ")))
-            (cons "autoscale"
-                  '(("AXIS" 'list " " "x" "y" "z" "x2" "y2" "xy"
-                     "xmin" "ymin" "zmin" "x2min" "y2min" "xymin"
-                     "xmax" "ymax" "zmax" "x2max" "y2max" "xymax")))
-            (cons "noautoscale"
-                  '(("AXIS" 'list " " "x" "y" "z" "x2" "y2" "xy"
-                     "xmin" "ymin" "zmin" "x2min" "y2min" "xymin"
-                     "xmax" "ymax" "zmax" "x2max" "y2max" "xymax")))
-            (cons "bar"
-                  '(("SIZE" 'list " " "small" "large")))
-            (cons "border"
-                  '(("BORDER CODE" 'number " ")
-                    ("LINE STYLE"  'list   " " "lines"
-                     "dots" "points" "linespoints")
-                    ("LINESTYLE"   'number " " "ls")
-                    ("LINETYPE"    'number " " "lt")
-                    ("LINEWIDTH"   'number " " "lw")))
-            (cons "boxwidth"
-                  '(("WIDTH" 'number " ")))
-            (cons "clabel"
-                  '(("FORMAT" 'format " ")))
-            (cons "clip"
-                  '(("CLIP TYPE" 'list " " "points" "one" "two")))
-            (cons "noclip"
-                  '(("CLIP TYPE" 'list " " "points" "one" "two")))
-            ;;(cons "cntrparam"
-            ;;  '(("INTERPOLATION" 'list " " "linear" "cubicspline" "bspline")
-            ;;    ("POINTS" 'number " " "points")
-            ;;    ("ORDER"  'number " " "order")))
-            (cons "contour"
-                  '(("WHERE"     'list " " "base" "surface" "both")))
-            (cons "dgrid3d"
-                  '(("ROW,COLUMN,NORM" 'position " " "" 3)))
-            (cons "encoding"
-                  '(("ENCODING" 'list " " "default" "iso_8859_1"
-                     "cp850" "cp437")))
-            (cons "format"
-                  '(("AXIS"   'list " " "x" "y" "z" "xy" "x2" "y2")
-                    ("FORMAT" 'format  " ")))
-            (cons "dummy"
-                  '(("VAR 1" 'string " " "")
-                    ("VAR 2" 'string " " ",")))
-            (cons "grid"
-                  '(("XTICS"  'list " " "xtics" "mxtics" "noxtics" "nomxtics")
-                    ("YTICS"  'list " " "ytics" "mytics" "noytics" "nomytics")
-                    ("ZTICS"  'list " " "ztics" "mztics" "noztics" "nomztics")
-                    ("X2TICS" 'list " " "x2tics" "mx2tics" "nox2tics" "nomx2tics")
-                    ("Y2TICS" 'list " " "y2tics" "my2tics" "noy2tics" "nomy2tics")
-                    ("POLAR"  'number " " "polar")
-                    ("MAJOR LINETYPE" 'number " ")
-                    ("MINOR LINETYPE" 'number " ")))
-            (cons "hidden3d"
-                  '(("ALGORITHM" 'list " " "defaults"
-                     "offset"
-                     "nooffset"
-                     ;;"trianglepattern  # bitpattern between 0 and 7"
-                     "trianglepattern 0" "trianglepattern 1"
-                     "trianglepattern 2" "trianglepattern 3"
-                     "trianglepattern 4" "trianglepattern 5"
-                     "trianglepattern 6" "trianglepattern 7"
-                     ;;"undefined        # level between 0 and 3"
-                     "undefined 0" "undefined 1" "undefined 2" "undefined 3"
-                     "noundefined" "altdiagonal" "noaltdiagonal"
-                     "bentover" "nobentover")))
-            (cons "historysize"
-                  '(("SIZE" 'number " ")))
-            (cons "isosamples"
-                  '(("ISO_U LINES" 'number " ")
-                    ("ISO_V LINES" 'number " " ",")))
-            (cons "key"
-                  '(("LOCATION"      'list " " "left" "right" "top" "bottom"
-                     "outside" "below")
-                    ("POSITION"      'position  " " "" 3)
-                    ("JUSTIFICATION" 'list " " "Left" "Right")
-                    ("REVERSE"       'list " " "reverse" "noreverse")
-                    ("SAMPLE LENGTH" 'number " " "samplen")
-                    ("SPACING"       'number " " "spacing")
-                    ("WIDTH"         'number " " "width")
-                    ("TITLE"         'string " " "title ")
-                    ("BOX LINETYPE"  'number " " "box") ;; linetype data
-                    ("NOBOX"         'list   " " "nobox")))
-            (cons "label"
-                  '(("TAG" 'tag " ")
-                    ("LABEL TEXT" 'string " ")
-                    ("POSITION"   'position " " "at" 3)
-                    ;; first, second, graph, screen
-                    ("JUSTIFICATION" 'list " " "left" "right" "center")
-                    ("ROTATE"        'list " " "rotate" "norotate")
-                    ("FONT"          'string " " "font"))) ;; font "name,size"
-            (cons "nolabel"
-                  '(("TAG"        'tag " ")))
-            (cons "linestyle"
-                  '(("TAG      "  'tag " ")
-                    ("LINE STYLE" 'list " " "boxerrorbars" "boxes"
-                     "boxxyerrorbars" "candlesticks" "dots"
-                     "financebars" "fsteps" "histeps" "impulses"
-                     "lines" "linespoints" "points" "steps" "vector"
-                     "xerrorbars" "xyerrorbars" "yerrorbars")
-                    ("LINETYPE " 'number " " "lt")
-                    ("LINEWIDTH" 'number " " "lw")
-                    ("POINTTYPE" 'number " " "pt")
-                    ("POINTSIZE" 'number " " "ps")))
-            (cons "locale"
-                  '(("LOCALE" 'string " ")))
-            (cons "logscale"
-                  '(("AXIS" 'list " " "x" "y" "z" "xy" "xz" "yz" "xyz"
-                     "x2" "y2")
-                    ("BASE" 'number " ")))
-            (cons "nologscale"
-                  '(("AXIS" 'list " " "x" "y" "z" "xy" "xz" "yz" "xyz"
-                     "x2" "y2")))
-            (cons "mapping"
-                  '(("COORDINATE SYSTEM" 'list " " "cartesian" "spherical"
-                     "cylindrical")))
-                                        ; _margin
-            (cons "bmargin"
-                  '(("BOTTOM MARGIN" 'number " ")))
-            (cons "lmargin"
-                  '(("LEFT MARGIN"   'number " ")))
-            (cons "rmargin"
-                  '(("RIGHT MARGIN"  'number " ")))
-            (cons "tmargin"
-                  '(("TOP MARGIN"    'number " ")))
-
-            (cons "missing"
-                  '(("CHARACTER" 'string " " 1)))
-                                        ; m_tics
-            (cons "mxtics"  gnuplot-gui-mtics-list)
-            (cons "mytics"  gnuplot-gui-mtics-list)
-            (cons "mztics"  gnuplot-gui-mtics-list)
-            (cons "mx2tics" gnuplot-gui-mtics-list)
-            (cons "my2tics" gnuplot-gui-mtics-list)
-
-                                        ; pm3d additions
-            (cons "mouse"
-                  '(("DOUBLECLICK"     'number " " "doubleclick")
-                    ("ZOOM"            'list   " " "zoomcoordinates" "nozoomcoordinates")
-                    ("POLAR"           'list   " " "polarcoordinates" "nopolarcoordinates")
-                    ("FORMAT"          'string " " "format")
-                    ("CLIPBOARDFORMAT" 'string " " "clipboardformat")
-                    ("MOUSEFORMAT"     'string " " "mouseformat")
-                    ("LABELS"          'list   " " "labels" "nolabels")
-                    ("LABELOPTIONS"    'string " " "labeloptions")
-                    ("ZOOMJUMP"        'list   " " "zoomjump" "nozoomjump")
-                    ("VERBOSE"         'list   " " "verbose" "noverbose")))
-            (cons "palette"
-                  '(("COLOR"       'list     " " "gray" "color")
-                    ("RGBFORMULAE" 'position " " "rgbformulae" 3)
-                    ("PARITY"      'list     " " "positive" "negative")
-                    ("FORMULAE"    'list     " " "nops_allcF" "ps_allcF")
-                    ("MAXCOLORS"   'number   " ")
-                    ("COLOR_BOX"   'list     " " "nocb" "cbdefault" "cbuser")
-                    ("ORIENTATION" 'list     " " "cbvertical" "cbhorizontal")
-                    ("ORIGIN"      'position " " "origin" 2)
-                    ("SIZE"        'position " " "size" 2)
-                    ("BORDER"      'number   " ")
-                    ("NOBORDER"    'list     " " "bdefault" "noborder")))
-            (cons "pm3d"
-                  '(("AT"         'list*  " " "b" "s" "t" "bs" "bt" "st" "bst")
-                    ("SCANS"      'list   " " "scansautomatic" "scansforward" "scansbackward")
-                    ("FLUSH"      'list*  " " "begin" "center" "end")
-                    ("CLIP"       'list   " " "clip1in" "clip4in")
-                    ("ZRANGE"     'range (" " . " ") ":")
-                    ("HIDDEN3D"   'number " ")
-                    ("NOHIDDEN3D" 'list   " " "nohidden3d")
-                    ("FILLING"    'list   " " "transparent" "solid")
-                    ("MAP"        'list   " " "map")))
-
-            (cons "offsets"
-                  '(("LEFT  " 'number " ")
-                    ("RIGHT " 'number " " ",")
-                    ("TOP   " 'number " " ",")
-                    ("BOTTOM" 'number " " ",")))
-            (cons "origin"
-                  '(("X ORIGIN"   'number " ")
-                    ("Y ORIGIN"   'number " " ",")))
-            (cons "output"
-                  '(("FILENAME"   'file " ")))
-            (cons "pointsize"
-                  '(("MULTIPLIER" 'number " ")))
-            (cons "samples"
-                  '(("2D PLOT"    'number " ")
-                    ("3D PLOT"    'number " " ",")))
-            (cons "size"
-                  '(("ASPECT"           'list " " "square" "nosquare"
-                     "ratio" "noratio")
-                    ("X-SCALE OR RATIO" 'number " ")
-                    ("Y-SCALE"          'number " " ",")))
-            (cons "style"
-                  '(("DATA TYPE"  'list " " "data" "function")
-                    ("PLOT STYLE" 'list " " "boxerrorbars" "boxes"
-                     "boxxyerrorbars" "candlesticks" "dots"
-                     "financebars" "fsteps" "histeps" "impulses"
-                     "lines" "linespoints" "points" "steps" "vector"
-                     "xerrorbars" "xyerrorbars" "yerrorbars")))
-            (cons "terminal"
-                  '(("TERMINAL TYPE" 'list " " gnuplot-gui-terminal-list)))
-            (cons "tics"
-                  '(("DIRECTION"  'list " " "in" "out")))
-            (cons "ticslevel"
-                  '(("RELATIVE HEIGHT" 'number " ")))
-            (cons "ticscale"
-                  '(("MAJOR" 'number " ")
-                    ("MINOR" 'number " ")))
-            (cons "timestamp"
-                  '(("FORMAT STRING" 'format " ")
-                    ("WHERE"         'list " " "top" "bottom")
-                    ("ROTATE"        'list " " "rotate" "norotate")
-                    ("X-OFFSET"      'number " ")
-                    ("Y-OFFSET"      'number " " ",")
-                    ("FONTNAME"      'list " " gnuplot-gui-fontname-list)))
-            (cons "timefmt"
-                  '(("FORMAT STRING" 'string " ")))
-            (cons "title"
-                  '(("TITLE" 'string " ")))
-            (cons "view"
-                  '(("X-ROTATION" 'number " ")
-                    ("Z-ROTATION" 'number " " ",")
-                    ("SCALE"      'number " " ",")
-                    ("Z-SCALE"    'number " " ",")))
-            ;; ("SCALE" 'position " " "," 4)
-                                        ; _data
-            (cons "xdata"      gnuplot-gui-data-list)
-            (cons "ydata"      gnuplot-gui-data-list)
-            (cons "zdata"      gnuplot-gui-data-list)
-            (cons "x2data"     gnuplot-gui-data-list)
-            (cons "y2data"     gnuplot-gui-data-list)
-                                        ; _label
-            (cons "xlabel"     gnuplot-gui-label-list)
-            (cons "ylabel"     gnuplot-gui-label-list)
-            (cons "zlabel"     gnuplot-gui-label-list)
-            (cons "x2label"    gnuplot-gui-label-list)
-            (cons "y2label"    gnuplot-gui-label-list)
-                                        ; _range, note that the [] syntax for
-                                        ;         the writeback argument is
-                                        ;         not properly supported
-            (cons "xrange"     gnuplot-gui-range-list)
-            (cons "yrange"     gnuplot-gui-range-list)
-            (cons "zrange"     gnuplot-gui-range-list)
-            (cons "x2range"    gnuplot-gui-range-list)
-            (cons "y2range"    gnuplot-gui-range-list)
-            (cons "trange"     gnuplot-gui-range-list)
-            (cons "rrange"     gnuplot-gui-range-list)
-            (cons "urange"     gnuplot-gui-range-list)
-            (cons "vrange"     gnuplot-gui-range-list)
-                                        ; _tics
-            (cons "xtics"      gnuplot-gui-tics-list)
-            (cons "ytics"      gnuplot-gui-tics-list)
-            (cons "ztics"      gnuplot-gui-tics-list)
-            (cons "x2tics"     gnuplot-gui-tics-list)
-            (cons "y2tics"     gnuplot-gui-tics-list)
-                                        ; zeroaxis
-            (cons "zeroaxis"   gnuplot-gui-zeroaxis-list)
-            (cons "xzeroaxis"  gnuplot-gui-zeroaxis-list)
-            (cons "yzeroaxis"  gnuplot-gui-zeroaxis-list)
-            (cons "y2zeroaxis" gnuplot-gui-zeroaxis-list)
-            (cons "x2zeroaxis" gnuplot-gui-zeroaxis-list)
-
-            (cons "zero"
-                  '(("THRESHOLD" 'number " ")))))
-
-(defvar gnuplot-gui-command-types nil
-  "Associated list of command descriptions.
-See the doc-string for `gnuplot-gui-all-types'.")
-(setq gnuplot-gui-command-types
-      (list (cons "cd"
-                  '(("FILENAME"       'file   " ")))
-            (cons "call"
-                  '(("INPUT FILE"     'file   " ")
-                    ("PARAMETER LIST" 'string " ")))
-            (cons "load"
-                  '(("INPUT FILE"     'file   " ")))
-            (cons "pause"
-                  '(("TIME"           'number " ")
-                    ("MESSAGE"        'string " ")))
-            (cons "print"
-                  '(("EXPRESSION"     'string " ")))
-            (cons "save"
-                  '(("SAVE"           'list   " " "functions" "variables" "set")
-                    ("FILE"           'file   " ")))
-            (cons "update"
-                  '(("INITIAL FILE"   'file   " " t)
-                    ("UPDATED FILE"   'file   " " t))) ))
-
-(defcustom gnuplot-gui-plot-splot-fit-style 'simple
-  "Control the complexity of the GUI display for plot, splot, and fit.
-The values are \\='simple, which causes a limited set of plot, splot, or
-fit options to be displayed, and \\='complete, which attempts to display
-all options.  The \\='complete setting is prone to making errors when
-parsing values already in the script buffer."
-  :type '(radio (const :tag "Simple listing"   simple)
-                (const :tag "Complete listing" complete)))
-
-(defconst gnuplot-gui-plot-simple-list
-  '(("X RANGE"     'range (" " . " ") ":")
-    ("Y RANGE"     'range (" " . " ") ":")
-    ("DATA FILE"   'file   " ")
-    ("THRU"        'string* " " "thru")
-    ("USING"       'modifier " ")
-    ("TITLE"       'string " ")
-    ("WITH"        'list* " " "boxerrorbars" "boxes"
-     "boxxyerrorbars" "candlesticks" "dots" "financebars"
-     "fsteps" "histeps" "impulses" "lines" "linespoints"
-     "points" "steps" "vector" "xerrorbars" "xyerrorbars"
-     "yerrorbars")))
-(defconst gnuplot-gui-plot-full-list
-  '(;;("T RANGE"     'range (" " . " ") ":")
-    ("X RANGE"     'range (" " . " ") ":")
-    ("Y RANGE"     'range (" " . " ") ":")
-    ("xa"          'text   "\t---------------------")
-    ("FUNCTION"    'string " ")
-    ("xc"          'text   "   or")
-    ("DATA FILE"   'file   " ")
-    ("INDEX"       'modifier " ")
-    ("EVERY"       'modifier " ")
-    ("THRU"        'string* " " "thru")
-    ("USING"       'modifier " ")
-    ("SMOOTH"      'list* " " "unique" "csplines" "acsplines"
-     "bezier" "sbezier")
-    ;; datafile modifiers
-    ("AXES"        'list* " " "x1y1" "x2y2" "x1y2" "x2y1")
-    ("TITLE"       'string " ")
-    ("NOTITLE"     'list   " " "notitle")
-    ("xf"          'text   "\t---------------------")
-    ("xi"          'text   "Select a standard plotting style")
-    ("WITH"        'list* " " "boxerrorbars" "boxes"
-     "boxxyerrorbars" "candlesticks" "dots" "financebars"
-     "fsteps" "histeps" "impulses" "lines" "linespoints"
-     "points" "steps" "vector" "xerrorbars" "xyerrorbars"
-     "yerrorbars")
-    ("xo"          'text   "     or a previously defined style")
-    ("LINE STYLE " 'number " " "ls")
-    ("xr"          'text   "     or specify a style in-line")
-    ("LINE TYPE  " 'number " " "lt")
-    ("LINE WIDTH " 'number " " "lw")
-    ("POINT TYPE " 'number " " "pt")
-    ("POINT STYLE" 'number " " "ps")))
-(defconst gnuplot-gui-splot-simple-list
-  '(("DATA FILE"   'file   " ")
-    ("TITLE"       'string " ")
-    ("WITH"        'list* " " "lines" "linespoints" "points" "dots" "impulses")))
-(defconst gnuplot-gui-splot-full-list
-  '(;;("U RANGE"     'range (" " . " ") ":")
-    ;;("V RANGE"     'range (" " . " ") ":")
-    ("X RANGE"     'range (" " . " ") ":")
-    ("Y RANGE"     'range (" " . " ") ":")
-    ("Z RANGE"     'range (" " . " ") ":")
-    ("xa"          'text   "\t---------------------")
-    ("FUNCTION"    'string " ")
-    ("xc"          'text   "   or")
-    ("DATA FILE"   'file   " ")
-    ("INDEX"       'modifier " ")
-    ("EVERY"       'modifier " ")
-    ("THRU"        'string* " " "thru")
-    ("USING"       'modifier " ")
-    ("SMOOTH"      'list* " " "unique" "csplines" "acsplines"
-     "bezier" "sbezier")
-    ("TITLE"       'string " ")
-    ("NOTITLE"     'list   " " "notitle")
-    ("WITH"        'list* " " "lines" "linespoints" "points" "dots" "impulses")))
-(defconst gnuplot-gui-fit-simple-list
-  '(("FUNCTION"     'string* " " "")
-    ("DATA FILE"    'file    " ")
-    ("VIA (params)" 'string* " " "via") ))
-(defconst gnuplot-gui-fit-full-list
-  '(("X RANGE"      'range  (" " . " ") ":")
-    ("Y RANGE"      'range  (" " . " ") ":")
-    ("xa"           'text    "----- fitting functionn and file --------")
-    ("FUNCTION"     'string* " " "")
-    ("DATA FILE"    'file    " ")
-    ("xb"           'text    "----- datafile modifiers ----------------")
-    ("INDEX"        'modifier " ")
-    ("EVERY"        'modifier " ")
-    ("THRU"         'string* " " "thru")
-    ("USING"        'modifier " ")
-    ("SMOOTH"       'list* " " "unique" "csplines" "acsplines"
-     "bezier" "sbezier")
-    ("xc"           'text    "----- parameters (file or parameters) ---")
-    ("VIA (file)"   'string  " " "via")
-    ("VIA (params)" 'string* " " "via") ))
-
-(defvar gnuplot-gui-plot-splot-fit nil
-  "Associated list of plot, splot, and fit descriptions.
-See the doc-string for `gnuplot-gui-all-types'.")
-(setq gnuplot-gui-plot-splot-fit
-      (list (cons "plot"  (if (equal gnuplot-gui-plot-splot-fit-style 'complete)
-                              gnuplot-gui-plot-full-list
-                            gnuplot-gui-plot-simple-list))
-            (cons "splot" (if (equal gnuplot-gui-plot-splot-fit-style 'complete)
-                              gnuplot-gui-splot-full-list
-                            gnuplot-gui-splot-simple-list))
-            (cons "fit"   (if (equal gnuplot-gui-plot-splot-fit-style 'complete)
-                              gnuplot-gui-fit-full-list
-                            gnuplot-gui-fit-simple-list))) )
-
-(defvar gnuplot-gui-test-type nil)
-(setq gnuplot-gui-test-type
-      (list (cons "test"
-                  '(("TAG"      'tag      " ")
-                    ("LIST"     'list     " " "1" "2" "3")
-                    ("LIST*"    'list*    " " "1" "2" "3")
-                    ("NUMBER"   'number   " " "number")
-                    ("RANGE"    'range   (" " . " ") ":")
-                    ("PAIR"     'pair    (" " . " ") "pair")
-                    ("LABELS"   'labels   ())
-                    ("FILE"     'file     " ")
-                    ("TEXT"     'text     "this is text")
-                    ("STRING"   'string   " ")
-                    ("STRING*"  'string*  " " "string*")
-                    ("FORMAT"   'format   " ")
-                    ("POSITION" 'position " " "at" 3)
-                    ("FONTSIZE" 'fontsize " ") ))))
-
-(defvar gnuplot-gui-all-types nil
-  "Associated list of terminal, set option, and command arguments.
-
-Each entry in the list is a cons cell of the form
-      (OPTION . ALIST)
-where OPTION is one of the recognized options in Gnuplot, either a
-command, something that is set, or a terminal type.  Only those
-commands, set options, and terminal types that actually take arguments
-are in this associated list.
-
-ALIST is itself an associated list where each entry is of the form:
-
-      (TAG TYPE DEFAULT REST)
-
-TAG is the name used on the widget and indicates one of the options
-for this command, set option, or terminal type.
-
-TYPE is one of
-     \\='list       a menu-list of strings
-     \\='list*      a menu-list of strings with a prefix
-     \\='number     a number with an optional prefix
-     \\='tag        like number but must be the first argument
-     \\='fontsize   like number but must be the last argument
-     \\='range      a pair of numbers like [#,#] or [#:#]
-     \\='pair       a pair of numbers with no punctuation and a prefix
-     \\='file       a quoted string and a file browser
-     \\='string     a quoted string with an optional prefix
-     \\='string*    an unquoted string with a prefix
-     \\='format     a quoted string and an info-link to (gnuplot)format
-     \\='labels     an array as needed for xtics, ytics, etc
-     \\='position   2 or 3 comma separated numbers with an optional prefix
-
-DEFAULT is the default value for this option.  Note that the default
-for \\='range and \\='pair is a cons cell and the default for \\='labels is a
-list.  For most things, the best choice of DEFAULT is a string of
-white space or a cons cell of two strings of white space.  Strings of
-white space are better defaults than empty strings or nil.
-
-The value of REST depends upon TYPE:
-
-  For \\='list &    REST is the list of options that will go into the
-      \\='list*       menu-button.  This can also be a symbol which
-                   evaluates to a list containing the options to go into
-                   the menu-button.  This list variable must contain the
-                   DEFAULT.
-  For \\='number    REST is the prefix string (if it exists) for that number.
-  For \\='range     REST is the separator, \":\" for plot ranges and
-                   \",\" for plot dimensions (see for example the tgif
-                   terminal type)
-  For \\='string &  REST may a number denoting the width of the editable-text
-      \\='string*     field or it may be a string denoting a prefix.  By
-                   default, the width is half the width of the frame
-                   and there is no prefix.  It may be useful to
-                   specify \"1\" when the input is a single character
-                   as in \"set missing\".
-  For \\='file      REST determines the label placed before the file insertion
-                   field.  If non-nil, then TAG is used.  If nil, then
-                   the default \"File\" is used.
-  For \\='position  REST is the prefix and the number of comma separated numbers
-  For others     REST is not used.
-
-Here is an example entry for the png terminal type:
-
-  (cons \"png\"
-    \\='((\"SIZE\"  \\='list \" \" \"small\" \"medium\" \"large\")
-      (\"COLOR\" \\='list \" \" \"monochrome\" \"gray\" \"color\")))
-
-This alist is formed at load time by appending together
-`gnuplot-gui-terminal-types', `gnuplot-gui-set-types' and
-`gnuplot-gui-command-types'.")
-
-(setq gnuplot-gui-all-types (append gnuplot-gui-terminal-types
-                                    gnuplot-gui-set-types
-                                    gnuplot-gui-command-types
-                                    gnuplot-gui-plot-splot-fit
-                                    gnuplot-gui-test-type))
-
-(defun gnuplot-gui-swap-simple-complete ()
-  (interactive nil gnuplot-mode)
-  (setq gnuplot-gui-plot-splot-fit-style
-        (if (equal gnuplot-gui-plot-splot-fit-style 'complete)
-            'simple 'complete))
-  (if (equal gnuplot-gui-plot-splot-fit-style 'complete)
-      (progn
-        (setcdr (assoc "plot"  gnuplot-gui-all-types) gnuplot-gui-plot-full-list)
-        (setcdr (assoc "splot" gnuplot-gui-all-types) gnuplot-gui-splot-full-list)
-        (setcdr (assoc "fit"   gnuplot-gui-all-types) gnuplot-gui-fit-full-list))
-    (setcdr (assoc "plot"  gnuplot-gui-all-types) gnuplot-gui-plot-simple-list)
-    (setcdr (assoc "splot" gnuplot-gui-all-types) gnuplot-gui-splot-simple-list)
-    (setcdr (assoc "fit"   gnuplot-gui-all-types) gnuplot-gui-fit-simple-list))
-  (message "Using %s lists for plot, splot, and fit."
-           gnuplot-gui-plot-splot-fit-style) )
-
-
-;;; user interface to the widget-y stuff
-
-(defun gnuplot-gui-get-frame-param (param)
-  (cdr (assoc param gnuplot-gui-frame-parameters)))
-
-(defun gnuplot-gui-set-frame-param (param value)
-  (setcdr (assoc param gnuplot-gui-frame-parameters) value))
-
-(defun gnuplot-gui-set-options-and-insert (&optional event)
-  "Insert arguments using a GUI interface.
-Determine contents of current line and set up the appropriate GUI
-frame.  Bound to \\[gnuplot-gui-set-options-and-insert]
-Note that \"cntrparam\" is not currently supported."
-  (interactive (list last-nonmenu-event) gnuplot-mode)
-  (save-excursion
-    (if event (mouse-set-point event))
-    (let ((begin  (gnuplot--point-at-beginning-of-command))
-          (end    (save-excursion (end-of-line)       (point-marker)))
-          (termin (concat "\\(,\\s-*" (regexp-quote "\\") "\\|;\\)"))
-          (set nil) (term nil))
-      (save-excursion
-        ;; there can be more then one command per line
-        (when (re-search-forward termin end "to_limit")
-          (backward-char (length (match-string 1)))
-          (setq end (point-marker)))
-        (goto-char begin)
-        (skip-syntax-forward "-" end)
-        ;; various constructions are recognized here. at the end of this
-        ;; cond, point should be just after the word whose arguments are
-        ;; to be set
-        (cond ((looking-at "set\\s-+")
-               (setq set t)
-               (goto-char (match-end 0))
-               (if (looking-at "\\sw+") (goto-char (match-end 0)))
-               (when (string-match "^ter" (gnuplot-gui-this-word)) ; terminal?
-                 (setq term t)
-                 (forward-word 1))
-               (when (string-match "^\\(da\\|fu\\)" (gnuplot-gui-this-word))
-                 (unless (looking-at "\\s-+st")
-                   (insert " style") (forward-word 1))
-                 (forward-word 1)))
-              ((looking-at (concat "\\(cd\\|ca\\|lo\\|pa\\|pr\\|sa\\|u\\)"
-                                   "\\w*"
-                                   "[\\s-\\']"))
-               (forward-word 1))
-              ;;(goto-char (match-end 0)))
-              (t
-               (forward-word 1)))
-        (if (> (point) end) (goto-char end))
-        (let* ((w (gnuplot-gui-this-word))
-               (wd (try-completion w gnuplot-gui-all-types))
-               (word "") wrd list)
-          (cond ((equal wd t)                     (setq word w))
-                ((equal wd nil)                   (setq word w))
-                ((assoc wd gnuplot-gui-all-types) (setq word wd))
-                (t                                (setq wd nil)))
-          (cond ((equal (string-match "^\\s-*$" w) 0)
-                 (message "Blank line"))
-                ((and wd (stringp word))
-                 (gnuplot-gui-correct-command word set term begin)
-                 (setq gnuplot-gui-alist nil
-                       gnuplot-gui-current-string
-                       (buffer-substring-no-properties (point) end))
-                 (gnuplot-gui-set-alist word gnuplot-gui-current-string)
-                 (let* ((old-height (gnuplot-gui-get-frame-param 'height))
-                        (old-top    (gnuplot-gui-get-frame-param 'top)))
-                   (when (or
-                          (and (equal gnuplot-gui-plot-splot-fit-style 'complete)
-                               (cl-member word '("plot" "splot" "fit")
-                                          :test 'equal))
-                          (equal word "test"))
-                     (gnuplot-gui-set-frame-param 'height 32)
-                     (gnuplot-gui-set-frame-param 'top    50))
-                   (gnuplot-gui-prompt-for-frame word)
-                   (when (or
-                          (and (equal gnuplot-gui-plot-splot-fit-style 'complete)
-                               (cl-member word '("plot" "splot" "fit")
-                                          :test 'equal))
-                          (equal word "test"))
-                     (gnuplot-gui-set-frame-param 'height old-height)
-                     (gnuplot-gui-set-frame-param 'top    old-top)) ))
-                ((setq wrd (car (all-completions w '(("cntrparam")))))
-                 (message
-                  "Setting arguments for %S is currently unsuported in gnuplot-mode"
-                  wrd))
-                ((setq list (all-completions w gnuplot-gui-all-types))
-                 (message "%S could be one of %S" w list))
-                (t
-                 (message
-                  "%S is not a gnuplot command which takes options" w)))) ))))
-
-(defun gnuplot-gui-toggle-popup ()
-  (interactive nil gnuplot-mode)
-  (setq gnuplot-gui-popup-flag (not gnuplot-gui-popup-flag))
-  (message (if gnuplot-gui-popup-flag
-               "Argument popup will appear after insertions."
-             "Argument popup will no longer appear after insertions.")))
-
-(defalias 'gnuplot-gui-y-n 'y-or-n-p)
-
-(defun gnuplot-gui-correct-command (word set term begin)
-  "Check syntax of set command and terminal specifications.
-WORD is the item being set.  SET and TERM are non-nil if the words
-\"set\" and \"terminal\" were found preceding WORD in the buffer.
-BEGIN is the beginning of the command."
-  (save-excursion
-    (cond ((assoc word gnuplot-gui-terminal-types)
-           (when (and (not (and set term))
-                      (gnuplot-gui-y-n
-                       (format
-                        "%S must be preceded by \"set terminal\".  Add it? "
-                        word)))
-             (backward-word 1)
-             (let ((e (point-marker)))
-               (goto-char begin)
-               (skip-syntax-forward "-" e)
-               (delete-region (point) e)
-               (insert "set terminal "))))
-          ((assoc word gnuplot-gui-set-types)
-           (when (and (not set)
-                      (gnuplot-gui-y-n
-                       (format
-                        "%S must be preceded by \"set\".  Add \"set\"? " word)))
-             (backward-word 1)
-             (let ((e (point-marker)))
-               (goto-char begin)
-               (skip-syntax-forward "-" e)
-               (delete-region (point) e)
-               (insert "set "))))))
-  (message nil))
-
-
-;;; handle the actual arguments
-
-(defun gnuplot-gui-fix-arg-list (list)
-  "Correct the result of splitting `gnuplot-gui-current-string'.
-LIST is the split string.  This removes empty and all-blank strings
-from the list and concatenates the strings that are part of a quoted
-argument, for example an axis label or a font name.  It also replaces
-bounding single quotes with double quotes, since double quotes are
-used in `gnuplot-gui-all-types'."
-  (let (fixed-list quote quoted)    ; remove blanks
-    (setq list (cl-remove "\\s-+" list :test 'string-match)
-          list (cl-remove ""      list :test 'equal))
-    (while list             ; concatinate parts of quoted string
-      (if (not (string-match "^\\([\]\[()'\"]\\)" (car list)))
-          (setq fixed-list (append fixed-list (list (car list))))
-        (setq quote (match-string 1 (car list))
-              quoted (car list))
-        (if (equal quote "[") (setq quote "]"))
-        (if (equal quote "(") (setq quote ")"))
-        (while (and list
-                    (or (equal (length quoted) 1)
-                        (not (string-match (concat (regexp-quote quote) "$")
-                                           quoted))))
-          (setq quoted (concat quoted " " (cadr list))
-                list (cdr list)))
-        (if (equal quote "'")
-            (setq quoted (concat "\"" (substring quoted 1))
-                  quoted (concat (substring quoted 0 -1) "\"")))
-        (setq fixed-list (append fixed-list (list quoted))))
-      (setq list (cdr list)) )
-    fixed-list))
-
-(defun gnuplot-gui-set-alist (word string)
-  "Set defaults for arguments, using text from buffer if appropriate.
-WORD is the Gnuplot expression whose arguments are being set.  STRING
-is text from the buffer containing the previous values for WORD's
-arguments."
-  (let ((alist    (cdr (assoc word gnuplot-gui-all-types)))
-        (arg-list (gnuplot-gui-fix-arg-list (split-string string)) ))
-    ;; arg-list contains the arguments taken from the buffer
-    (setq gnuplot-gui-alist nil)
-    (while alist
-      (let* ((list      (car alist))
-             (tag       (gnuplot-gui-type-tag     list))
-             (symbol    (eval (gnuplot-gui-type-symbol list)))
-             (default   (gnuplot-gui-type-default list))
-             (prefix    (gnuplot-gui-type-prefix  list))
-             (values    (gnuplot-gui-type-list    list))
-             (this-cons (cond ((stringp default) (cons tag default))
-                              ((consp default) ; set cons valued default w/care
-                               (cons tag (cons (car default) (cdr default))))
-                              (t (cons tag default))))
-             (temp-list arg-list) )
-        ;;(message "%S" temp-list)  ; want to lop values off arg-list
-                                        ; as they are found
-        (if (symbolp (cadr values))
-            (setq values (symbol-value (cadr values))))
-        ;; check if an argument of this type is in arg-list
-        ;; set the current cons cell if it is
-        (while temp-list
-          (cond
-           ;; ---------------------------- list
-           ((cl-member symbol '(list list*) :test 'equal)
-            (let* ((case-fold-search nil)
-                   (match-cons (cl-member (concat "^" (car temp-list))
-                                          values :test 'string-match)))
-              (if (and (car match-cons) ; " " may be first elem. of list
-                       (not (equal " " (car match-cons))))
-                  (setq this-cons (cons tag (car match-cons))
-                        arg-list (cl-remove (car temp-list) arg-list
-                                            :test 'equal :count 1)
-                        temp-list nil)
-                (setq temp-list (cdr temp-list)))))
-           ;; ---------------------------- tag (first number in list)
-           ((equal symbol 'tag)
-            (if (string-match "^[-0-9.]+$" (car arg-list))
-                (setq this-cons (cons  tag (car arg-list))
-                      temp-list nil)
-              (setq temp-list (cdr temp-list))) )
-           ;; ---------------------------- fontsize (last number in list)
-           ((equal symbol 'fontsize)
-            (if (string-match "^[-0-9.]+$" (car (last arg-list)))
-                (setq this-cons (cons  tag (car (last arg-list)))
-                      temp-list nil)
-              (setq temp-list (cdr temp-list))) )
-           ;; ---------------------------- number with prefix
-           ((equal symbol 'number)
-            (cond ((and (equal prefix (car temp-list))
-                        (string-match "^[-0-9.]+$" (cadr temp-list)))
-                   (setq this-cons (cons tag (cadr temp-list))
-                         arg-list (cl-remove (car temp-list) arg-list
-                                             :test 'equal :count 1)
-                         arg-list (cl-remove (cadr temp-list) arg-list
-                                             :test 'equal :count 1)
-                         temp-list nil))
-                  ;; --------------------- number without prefix
-                  ((and (not prefix)
-                        (string-match "^[-0-9.]+$" (car temp-list)))
-                   (setq this-cons (cons tag (car temp-list))
-                         arg-list (cl-remove (car temp-list) arg-list
-                                             :test 'equal :count 1)
-                         temp-list nil))
-                  (t
-                   (setq temp-list (cdr temp-list)))))
-           ;; ---------------------------- pair with prefix
-           ((equal symbol 'pair)
-            (if (and (equal prefix (car temp-list))
-                     (string-match "^[-0-9.]+$" (cadr temp-list)))
-                (let ((this-car (cadr temp-list))
-                      (this-cdr (if (string-match "^[-0-9.]+$" (cl-caddr temp-list))
-                                    (cl-caddr temp-list) "")))
-                  (setq this-cons (cons tag (cons this-car this-cdr))
-                        temp-list nil))
-              (setq temp-list (cdr temp-list))))
-           ;; ---------------------------- range
-           ((equal symbol 'range)
-            (if (string-match (concat "\\[\\s-*" ; opening bracket
-                                      "\\([^:, \t]*\\)" ; first argument
-                                      "\\s-*[:,]\\s-*" ; separator
-                                      "\\([^\] \t]*\\)" ; second argument
-                                      "\\s-*\\]") ; closing bracket
-                              (car temp-list))
-                (setq this-cons
-                      (cons tag (cons (match-string 1 (car temp-list))
-                                      (match-string 2 (car temp-list))))
-                      arg-list (cl-remove (car temp-list) arg-list
-                                          :test 'equal :count 1)
-                      temp-list nil)
-              (setq temp-list (cdr temp-list)) ))
-           ;; ---------------------------- labels
-           ((equal symbol 'labels)
-            (if (string-match (concat "(" ; opening paren
-                                      "\\([^\)]*\\)" ; string
-                                      ")") ; closing paren
-                              (car temp-list))
-                (let* ((list (split-string (car temp-list) "[ \t(),]+"))
-                       (list (cl-remove "" list :test 'equal))
-                       (return ()))
-                  (while list
-                    (if (string-match "['\"]\\([^'\"]*\\)['\"]" (car list))
-                        (setq return (append return
-                                             (list (match-string 1 (car list))))
-                              list (cdr list)
-                              return (append return (list (car list))) )
-                      (setq return (append return (list "" (car list)))))
-                    (setq list (cdr list)) )
-                  (setq this-cons (cons tag return)
-                        arg-list (cl-remove (car temp-list) arg-list
-                                            :test 'equal :count 1)
-                        temp-list nil))
-              (setq temp-list (cdr temp-list))) )
-           ;; ---------------------------- string, file, format
-           ((cl-member symbol '(string file format) :test 'equal)
-            (if (string-match (concat "['\"]" ; opening quote
-                                      "\\([^'\"]*\\)" ; string
-                                      "['\"]") ; closing quote
-                              (car temp-list))
-                (setq this-cons (cons tag (match-string 0 (car temp-list)))
-                      arg-list (cl-remove (car temp-list) arg-list
-                                          :test 'equal :count 1)
-                      temp-list nil)
-              (setq temp-list (cdr temp-list)) ))
-           ;; ---------------------------- string*
-           ((equal symbol 'string*)
-            (if (equal prefix (car temp-list))
-                (setq this-cons (cons tag (cadr temp-list))
-                      arg-list (cl-remove (car temp-list) arg-list
-                                          :test 'equal :count 1)
-                      arg-list (cl-remove (cadr temp-list) arg-list
-                                          :test 'equal :count 1)
-                      temp-list nil)
-              (setq temp-list (cdr temp-list)) ) )
-           ;; ---------------------------- other or unknown
-           (t
-            (setq temp-list nil))))
-        (setq gnuplot-gui-alist
-              (append gnuplot-gui-alist (list this-cons))))
-      (setq alist (cdr alist))) ))
-
-(defun gnuplot-gui-post-process-alist (type)
-  "A few types need some additional processing.
-\\='range, \\='pair, and \\='labels are cons or list valued and need to b made
-into strings.  This is called right before inserting the arguments
-into the buffer.  TYPE is the object whose arguments are being set."
-  (let ((alist gnuplot-gui-alist)
-        (types (cdr (assoc type gnuplot-gui-all-types))) )
-    (while alist  ;; loop thru alist looking for tyeps needing post-processing
-      (let* ((list   (assoc (caar alist) types))
-             (value  (cdr (assoc (caar alist) gnuplot-gui-alist)))
-             (prefix (gnuplot-gui-type-prefix list))
-             (symb   (gnuplot-gui-type-symbol list)) )
-        (cond
-         ;;-------------------------- flat text
-         ((equal (eval symb) 'text)
-          (setcdr (assoc (caar alist) gnuplot-gui-alist) ""))
-         ;;-------------------------- range [#:#] or [#,#]
-         ((equal (eval symb) 'range)
-          (if (and (string-match "^\\s-*$" (car value))
-                   (string-match "^\\s-*$" (cdr value)))
-              (setcdr (assoc (caar alist) gnuplot-gui-alist) "")
-            (setcdr (assoc (caar alist) gnuplot-gui-alist)
-                    (concat "[" (car value) prefix (cdr value) "]")) ) )
-         ;;-------------------------- pair
-         ((equal (eval symb) 'pair)
-          (if (and (string-match "^\\s-*$" (car value))
-                   (string-match "^\\s-*$" (cdr value)))
-              (setcdr (assoc (caar alist) gnuplot-gui-alist) "")
-            (setcdr (assoc (caar alist) gnuplot-gui-alist)
-                    (concat prefix " " (car value) " " (cdr value) )) ) )
-         ;;-------------------------- labels
-         ((equal (eval symb) 'labels)
-          (if (consp value)
-              (let ((word "") (list value))
-                (while list
-                  (if (string-match "^\\s-*$" (car list))
-                      (setq word (concat word (format "%s, " (cadr list))))
-                    (setq word (concat word (format "%S %s, " (car list)
-                                                    (cadr list)))))
-                  (setq list (cddr list)) )
-                (setq value (concat "(" (substring word 0 -2) ")")))
-            (setq value "") )
-          (setcdr (assoc (caar alist) gnuplot-gui-alist) value) ))
-
-        (setq alist (cdr alist))) )))
-
-
-;;; GUI frames
-
-(defun gnuplot-gui-prompt-for-frame (&optional option save-frame)
-  (setq option (or option (completing-read "Option: " gnuplot-gui-all-types
-                                           nil t nil t)))
-  (gnuplot-gui-make-frame
-   option (cdr (assoc option gnuplot-gui-all-types)) save-frame) )
-
-(defgroup gnuplot-gui-faces nil
-  "Text faces used by `gnuplot-gui'."
-  :prefix "gnuplot-gui-"
-  :group 'gnuplot-gui)
-
-(defface gnuplot-gui-error-face '((((class color) (background light))
-                                   (:foreground "grey30"))
-                                  (((class color) (background dark))
-                                   (:foreground "grey70")))
-  "Face used to display message about unknown widget types.")
-
-(defface gnuplot-gui-flat-text-face '((((class color) (background light))
-                                       (:foreground "MediumBlue"))
-                                      (((class color) (background dark))
-                                       (:foreground "LightSteelBlue")))
-  "Face used to display message about unknown widget types.")
-
-(defun gnuplot-gui-make-frame (item alist &optional save-frame)
-  "Open the frame and populate it with widgets.
-ITEM is the object for which arguments are being set.  ALIST is
-the alist of arguments for ITEM taken from `gnuplot-gui-all-types'.
-SAVE-FRAME is non-nil when the widgets are being reset."
-  (unless save-frame
-    (setq gnuplot-gui-current-frame (selected-frame)
-          gnuplot-gui-current-buffer (current-buffer)
-          gnuplot-gui-current-buffer-point (point-marker))
-    (unless (frame-live-p gnuplot-gui-frame)
-      (setq gnuplot-gui-frame (make-frame gnuplot-gui-frame-parameters)))
-    (select-frame gnuplot-gui-frame)
-    ;;(set-frame-position gnuplot-gui-frame 150 150) ;; so herky-jerky
-    (set-mouse-position gnuplot-gui-frame 0 0))
-  (kill-buffer (get-buffer-create "*Gnuplot GUI*"))
-  (switch-to-buffer (get-buffer-create "*Gnuplot GUI*"))
-  (kill-all-local-variables)
-  (modify-frame-parameters (selected-frame)
-                           '((title . "Set Gnuplot Options")))
-  (widget-insert "\nSet options for \"" item "\"  ")
-  (let (tag help val)
-    (cond ((string-match "^[xyz]2?tics" item)
-           (setq tag  "info on tic labels"
-                 help "Open a frame displaying the info entry for tic labels"
-                 val  "xtics"))
-          ((string-match "^no" item)
-           (setq tag  (concat "info on " (substring item 2))
-                 help (format "Open a frame displaying the info entry for %S"
-                              item)
-                 val  item))
-          (t
-           (setq tag  (concat "info on " item)
-                 help (format "Open a frame displaying the info entry for %S"
-                              item)
-                 val  item)))
-    (widget-create 'gnuplot-gui-info-link :tag tag :help-echo help :value val))
-
-  (widget-insert "\n\n")
-  (while alist
-    (let* ((this    (car   alist))
-           (tag     (gnuplot-gui-type-tag    this))
-           (wtype   (gnuplot-gui-type-symbol this))
-           (prefix  (gnuplot-gui-type-prefix this))
-           (default (cdr (assoc tag gnuplot-gui-alist)))
-           (list    (gnuplot-gui-type-list   this)))
-      (if (symbolp (cadr list))
-          (setq list (symbol-value (cadr list))))
-      (widget-insert "\t")      ; insert the appropriate widget
-      (cond
-       ;;------------------------------ list, list* ------------
-       ((cl-member (eval wtype) '(list list*) :test 'equal)
-        (let ((starred (if (equal (eval wtype) 'list*) t nil)))
-          (gnuplot-gui-menu-choice tag default list starred)))
-       ;;------------------------------ number, tag, fontsize --
-       ((cl-member (eval wtype) '(number tag fontsize) :test 'equal)
-        (gnuplot-gui-number tag default prefix))
-       ;;------------------------------ position ---------------
-       ;;------------------------------ range, pair ------------
-       ((cl-member (eval wtype) '(range pair) :test 'equal)
-        (let ((is-range (equal (eval wtype) 'range)))
-          (gnuplot-gui-range tag default prefix is-range)))
-       ;;------------------------------ string, string* --------
-       ((cl-member (eval wtype) '(string string*) :test 'equal)
-        (let ((starred (if (equal (eval wtype) 'string) nil t)))
-          (gnuplot-gui-string tag default prefix starred)))
-       ;;------------------------------ format -----------------
-       ((equal (eval wtype) 'format)
-        (gnuplot-gui-format tag default))
-       ;;------------------------------ file -------------------
-       ((equal (eval wtype) 'file)
-        (gnuplot-gui-file tag default prefix))
-       ;;------------------------------ labels -----------------
-       ((equal (eval wtype) 'labels)
-        (gnuplot-gui-labels tag default))
-       ;;------------------------------ text -------------------
-       ((equal (eval wtype) 'text)
-        (let ((str (gnuplot-gui-type-default this)))
-          (put-text-property 0 (length str) 'face 'gnuplot-gui-flat-text-face str)
-          (widget-insert str "\n")))
-       ;;------------------------------ unknown ----------------
-       (t
-        (let ((str (concat "<" (downcase tag) "> ('"
-                           (symbol-name (eval wtype))
-                           " arguments are not yet supported)\n")))
-          (put-text-property 0 (length str) 'face 'gnuplot-gui-error-face str)
-          (widget-insert str)) )))
-    (setq alist (cdr alist)))
-  ;; insert control buttons: [Set options]   [Reset]   [Clear]   [Cancel]
-  (widget-insert "\n\t")
-  (widget-create 'push-button
-                 :value "Set options"
-                 :doc item
-                 :button-face 'gnuplot-gui-button-face
-                 :help-echo "Push this button to set options"
-                 :notify
-                 (lambda (widget &rest _ignore)
-                   (kill-buffer (get-buffer-create "*Gnuplot GUI*"))
-                   (delete-frame)
-                   (select-frame gnuplot-gui-current-frame)
-                   (switch-to-buffer gnuplot-gui-current-buffer)
-                   (goto-char gnuplot-gui-current-buffer-point)
-                   (gnuplot-gui-post-process-alist
-                    (widget-get widget :doc))
-                   (let ((alist gnuplot-gui-alist) marker
-                         (eol (save-excursion (end-of-line) (point-marker) )) )
-                     (if (re-search-forward ";" eol "to_limit")
-                         (backward-char 1))
-                     (delete-region gnuplot-gui-current-buffer-point (point-marker))
-                     (delete-horizontal-space)
-                     (setq marker (point-marker))
-                     (while alist
-                       (let ((val (cdar alist)))
-                         (if (string-match "^\\s-+$" val) ()
-                           (if (string-match "^['\"]\\(.*\\)['\"]$" val)
-                               (setq val (concat gnuplot-quote-character
-                                                 (match-string 1 val)
-                                                 gnuplot-quote-character)))
-                           (insert (format " %s" val))))
-                       (setq alist (cdr alist)))
-                     (setq eol (point-marker))
-                     (goto-char marker)
-                     (while (< (point) eol) ; a few odd cases
-                       (unless (looking-at (concat "[" (regexp-quote "(")
-                                                   (regexp-quote "*") ",]"))
-                         (just-one-space))
-                       (forward-sexp)))
-                   (delete-horizontal-space)
-                   (if (equal "terminal" (widget-get widget :doc))
-                       (gnuplot-gui-set-options-and-insert)) ))
-  (widget-insert "   ")
-  (widget-create 'push-button :value "Reset"
-                 :help-echo "Push this button to reset all values"
-                 :button-face 'gnuplot-gui-button-face
-                 :doc item
-                 :notify
-                 (lambda (widget &rest _ignore)
-                   (let ((word (widget-get widget :doc)))
-                     (gnuplot-gui-set-alist word gnuplot-gui-current-string)
-                     (gnuplot-gui-prompt-for-frame word t))))
-  (widget-insert "   ")
-  (widget-create 'push-button :value "Clear"
-                 :help-echo "Push this button to clear all values"
-                 :button-face 'gnuplot-gui-button-face
-                 :doc item
-                 :notify
-                 (lambda (widget &rest _ignore)
-                   (let* ((word (widget-get widget :doc))
-                          (alist (cdr (assoc word gnuplot-gui-all-types))))
-                     (while alist
-                       (setcdr (assoc (gnuplot-gui-type-tag (car alist))
-                                      gnuplot-gui-alist)
-                               (gnuplot-gui-type-default (car alist)))
-                       (setq alist (cdr alist)))
-                     (gnuplot-gui-prompt-for-frame word t))) )
-  (widget-insert "   ")
-  (widget-create 'push-button :value "Cancel"
-                 :help-echo "Quit setting options and dismiss frame"
-                 :button-face 'gnuplot-gui-button-face
-                 :notify (lambda (_widget &rest _ignore)
-                           (kill-buffer (get-buffer-create "*Gnuplot GUI*"))
-                           (setq gnuplot-gui-alist nil
-                                 gnuplot-gui-current-string nil)
-                           (delete-frame)
-                           (select-frame gnuplot-gui-current-frame)))
-  (goto-char (point-min))
-  (use-local-map widget-keymap)
-  (widget-setup))
-
-
-;;; widgets
-
-(defface gnuplot-gui-menu-face '((((class color) (background light))
-                                  (:bold t :foreground "darkolivegreen"))
-                                 (((class color) (background dark))
-                                  (:bold t :foreground "seagreen"))
-                                 (t
-                                  (:italic t)))
-  "Face used for menu-buttons.")
-(defface gnuplot-gui-button-face '((((class color) (background light))
-                                    (:bold t :foreground "sienna"))
-                                   (((class color) (background dark))
-                                    (:bold t :foreground "tan"))
-                                   (t
-                                    (:italic t)))
-  "Face used for push-buttons.")
-(defface gnuplot-gui-labels-face '((((class color) (background light))
-                                    (:bold t :foreground "darkslateblue"))
-                                   (((class color) (background dark))
-                                    (:bold t :foreground "lightslateblue"))
-                                   (t
-                                    (:italic t)))
-  "Face used for insert and delete button in the labels widget.")
-
-(defun gnuplot-gui-menu-choice (item default list &optional starred)
-  "Create a menu widget for the Gnuplot GUI.
-ITEM is the object whose arguments are set by this widget, DEFAULT
-is the default argument value, LIST contains the items for the pop-up
-menu.  STARRED is true if this a \\='list* widget."
-  (let ((widget
-         (apply 'widget-create
-                'menu-choice :value default :tag item :doc starred
-                :button-face 'gnuplot-gui-menu-face
-                :button-prefix "[" :button-suffix "]"
-                :help-echo (format "Mouse-2 to view the %S menu" (downcase item))
-                :notify
-                (lambda (widget &rest _ignore)
-                  (let ((lab (if (widget-get widget :doc)
-                                 (concat (downcase (widget-get widget :tag)) " ")
-                               "" )))
-                    (setcdr (assoc (widget-get widget :tag) gnuplot-gui-alist)
-                            (if (equal (widget-value widget) " ") ""
-                              (format "%s%s" lab (widget-value widget))) )))
-                (mapcar (lambda (x) (list 'item :value x))
-                        list))))
-    (widget-value-set widget default)
-    (if (and starred (not (string-match "^\\s-*$" default)))
-        (setcdr (assoc item gnuplot-gui-alist)
-                (format "%s %s" (downcase item) default)))
-    widget))
-
-(defun gnuplot-gui-number (item default &optional prefix)
-  "Create a number widget for the Gnuplot GUI.
-ITEM is the object whose arguments are set by this widget, DEFAULT
-is the default value for the widget, PREFIX is a text string preceding
-the numerical argument."
-  (let ((help-label (or prefix (downcase item))))
-    (widget-insert (capitalize item) ": ")
-    (widget-create 'editable-field
-                   :size 2 :tag item :value default :doc prefix
-                   :help-echo (format "Insert new value of %S here" help-label)
-                   :notify (lambda (widget &rest _ignore)
-                             (let ((val (widget-value widget))
-                                   (pre (concat (widget-get widget :doc) " ")))
-                               (setcdr (assoc (widget-get widget :tag)
-                                              gnuplot-gui-alist)
-                                       (if (string-match
-                                            "^\\s-*[-0-9.*]+\\s-*$" val)
-                                           (format "%s%s" pre val) "") )))))
-  (unless (string-match "^\\s-*$" default)
-    (setcdr (assoc item gnuplot-gui-alist) (format "%s %s" prefix default)))
-  (widget-insert " " (make-string (- 40 (current-column)) ?.)
-                 " (numeric value)\n"))
-
-(defun gnuplot-gui-string (item default &optional width_or_prefix starred)
-  "Create a string widget for the Gnuplot GUI.
-ITEM is the object whose arguments are set by this widget, DEFAULT is
-the default value for the widget, and WIDTH_OR_PREFIX is the width of
-the text entry field (which defaults to half the frame width) or the
-prefix for the string.  STARRED is t if quotes are not to be used."
-  (let ((help-label (downcase item)) width (prefix "") (pp ""))
-    (cond ((stringp width_or_prefix)
-           (setq prefix width_or_prefix
-                 pp prefix)
-           (if starred (setq prefix (concat prefix "_star"))) )
-          ((numberp width_or_prefix)
-           (setq width width_or_prefix)))
-    (setq width (or width (/ (frame-width) 2)))
-    (if (string-match "^['\"]" default)
-        (setq default (replace-match "" nil nil default)))
-    (if (string-match "['\"]$" default)
-        (setq default (replace-match "" nil nil default)))
-    (widget-insert (capitalize item) ": ")
-    (widget-create
-     'editable-field
-     :size width :tag item :doc prefix :value default
-     :help-echo (format "Insert new value of %S here" help-label)
-     :notify (lambda (widget &rest _ignore)
-               (let ((val (widget-value widget))
-                     (q gnuplot-quote-character)
-                     (p (widget-get widget :doc)) )
-                 (setcdr (assoc (widget-get widget :tag) gnuplot-gui-alist)
-                         (if (string-match "^\\s-*$" val)
-                             ""
-                           (progn
-                             (if (string-match "_star$" p)
-                                 (setq p (concat (substring p 0 -5) " ")
-                                       q ""))
-                             (if (string-match "^\\s-+" val)
-                                 (setq val (replace-match "" nil nil val)))
-                             (if (string-match "\\s-+$" val)
-                                 (setq val (replace-match "" nil nil val)))
-                             (format "%s%s%s%s" p q val q)))))))
-    (unless (string-match "^\\s-*$" default)
-      (setcdr (assoc item gnuplot-gui-alist) (format "%s %s" pp default)))
-    (widget-insert "\n")))
-
-(defun gnuplot-gui-format (item default)
-  "Create a string widget for the Gnuplot GUI.
-ITEM is the object whose arguments are set by this widget, DEFAULT is
-the default value for the widget, and WIDTH_OR_PREFIX is the width of
-the text entry field (which defaults to half the frame width) or the
-prefix for the string."
-  (if (string-match "^['\"]" default)
-      (setq default (replace-match "" nil nil default)))
-  (if (string-match "['\"]$" default)
-      (setq default (replace-match "" nil nil default)))
-  (widget-insert (capitalize item) ": ")
-  (widget-create 'editable-field
-                 :size (/ (frame-width) 3) :tag item :value default
-                 :help-echo (format "Insert new format string here")
-                 :notify (lambda (widget &rest _ignore)
-                           (let ((val (widget-value widget)))
-                             (setcdr (assoc (widget-get widget :tag)
-                                            gnuplot-gui-alist)
-                                     (format "%s%s%s"
-                                             gnuplot-quote-character
-                                             val
-                                             gnuplot-quote-character)))))
-  (widget-insert "   ")
-  (widget-create 'gnuplot-gui-info-link
-                 :tag (concat "info on format")
-                 :help-echo "Open a frame displaying the info entry for format"
-                 :value "format")
-  (widget-insert "\n"))
-
-;; swiped from widget-color-complete
-(defun gnuplot-gui-file-completion (widget)
-  "Complete the filename in WIDGET."
-  (let* ((str (buffer-substring-no-properties (widget-field-start widget)
-                                              (point)))
-         (file (or (file-name-nondirectory str) ""))
-         (dir  (or (file-name-directory str) "./"))
-         (val  (file-name-completion file dir)) )
-    (cond ((eq val t)
-           (message "Exact match"))
-          ((null val)
-           (error "Can't find completion for \"%s\"" str))
-          ((not (string-equal str val))
-           (insert (substring val (length file))))
-          (t
-           (message "Making completion list...")
-           (let ((list (file-name-all-completions file dir)))
-             (with-output-to-temp-buffer "*Completions*"
-               (display-completion-list list)))
-           (message "Making completion list...done")))))
-
-(defun gnuplot-gui-file (item default &optional tag)
-  "Create a file widget for the Gnuplot GUI.
-ITEM is the object whose arguments is set by this widget, DEFAULT is
-the default value for the argument.  TAG is non-nil if ITEM rather than
-\"File:\" is to be used as the tag."
-  (setq tag (if tag (capitalize item) "File"))
-  (if (string-match "^['\"]" default)
-      (setq default (replace-match "" nil nil default)))
-  (if (string-match "['\"]$" default)
-      (setq default (replace-match "" nil nil default)))
-  (let ((widg (widget-create
-               'file
-               :value default :tag tag
-               :size (- (/ (frame-width) 2) 3)
-               :doc item :help-echo "Insert a filename here"
-               :complete 'gnuplot-gui-file-completion
-               :notify
-               (lambda (widget &rest _ignore)
-                 (setcdr (assoc (widget-get widget :doc) gnuplot-gui-alist)
-                         (format "%s%s%s" gnuplot-quote-character
-                                 (widget-value widget)
-                                 gnuplot-quote-character)) )) ))
-    (widget-insert " ")
-    (widget-create
-     'push-button :value "Browse"
-     :doc item :help-echo "Browse directories for a filename."
-     :parent widg
-     :notify (lambda (widget &rest _ignore)
-               (let ((fname (file-relative-name (read-file-name "File: ")
-                                                default-directory))
-                     (q gnuplot-quote-character))
-                 (widget-value-set (widget-get widget :parent) fname)
-                 (setcdr (assoc (widget-get widget :doc) gnuplot-gui-alist)
-                         (format "%s%s%s" q fname q))
-                 (widget-setup))))
-    (widget-insert "\n")))
-
-(defun gnuplot-gui-labels (item default)
-  "Create a labels widget for the Gnuplot GUI.
-ITEM is the object whose arguments is set by this widget, DEFAULT is
-the default value for the argument."
-  (widget-create
-   '(editable-list
-     (list :inline t :tag "Tic label"
-           (string :tag "label" :size 10
-                   :help-echo "Enter the tic label here" )
-           (string :tag "  position" :size 10
-                   :help-echo "Enter an expression for the tic location here" )))
-   :tag (capitalize item)
-   :value default
-   :format "%{%t%}:\n%v\t  %i\n"
-   :entry-format "\t  %i %d %v\n"
-   :button-face 'gnuplot-gui-labels-face
-   :notify (lambda (widget &rest _ignore)
-             (setcdr (assoc (upcase (widget-get widget :tag))
-                            gnuplot-gui-alist)
-                     (widget-value widget)))))
-
-(defun gnuplot-gui-range (item default separator is-range)
-  "Create a range or pair widget for the Gnuplot GUI.
-ITEM is the object whose arguments are set by this widget, DEFAULT is
-the default value for the widget, SEPARATOR is a text string preceding
-the numerical argument, or the prefix for a pair operator.  IS-RANGE
-is non-nil if this is a \\='range widget."
-  (widget-insert (capitalize item) ": ")
-  (if is-range (widget-insert "["))
-  (widget-create 'editable-field
-                 :size 4 :tag item :value (car default)
-                 :help-echo (format "Insert the first value of the %S here"
-                                    (downcase item))
-                 :notify (lambda (widget &rest _ignore)
-                           (setcar (cdr (assoc (widget-get widget :tag)
-                                               gnuplot-gui-alist))
-                                   (format "%s" (widget-value widget)))))
-  (if is-range (widget-insert separator) (widget-insert "  "))
-  (widget-create 'editable-field
-                 :size 4 :tag item :value (cdr default)
-                 :help-echo (format "Insert the second value of the %S here"
-                                    (downcase item))
-                 :notify (lambda (widget &rest _ignore)
-                           (setcdr (cdr (assoc (widget-get widget :tag)
-                                               gnuplot-gui-alist))
-                                   (format "%s" (widget-value widget)))))
-  (if is-range (widget-insert "]"))
-  (widget-insert " " (make-string (- 39 (current-column)) ?.)
-                 " (numeric values)\n"))
-
-;; suppress compiler warning
-;;(eval-when-compile (defun gnuplot-info-lookup-symbol (sym mode)))
-(define-widget 'gnuplot-gui-info-link 'info-link
-  "A link to an info file for the Gnuplot GUI."
-  :action '(lambda (widget &optional event)
-             (let ((gnuplot-info-display 'frame))
-               (when (eq gnuplot--info-keywords 'pending)
-                 (gnuplot--setup-info-look))
-               (gnuplot-info-lookup-symbol (widget-value widget)
-                                           'gnuplot-mode))))
-
-(provide 'gnuplot-gui)
-;;; gnuplot-gui.el ends here
diff --git a/elpa/gnuplot-20250724.1531/gnuplot-pkg.el b/elpa/gnuplot-20250724.1531/gnuplot-pkg.el
deleted file mode 100644
index 18b68a0e..00000000
--- a/elpa/gnuplot-20250724.1531/gnuplot-pkg.el
+++ /dev/null
@@ -1,11 +0,0 @@
-;; -*- no-byte-compile: t; lexical-binding: nil -*-
-(define-package "gnuplot" "20250724.1531"
-  "Major-mode and interactive frontend for gnuplot."
-  '((emacs  "28.1")
-    (compat "30"))
-  :url "https://github.com/emacs-gnuplot/gnuplot"
-  :commit "43e9674b869475b1c2a32f045c167673eb2faae0"
-  :revdesc "43e9674b8694"
-  :keywords '("data" "gnuplot" "plotting")
-  :maintainers '(("Maxime Tréca" . "maxime@gmail.com")
-                 ("Daniel Mendler" . "mail@daniel-mendler.de")))
diff --git a/elpa/gnuplot-20250724.1531/gnuplot.el b/elpa/gnuplot-20250724.1531/gnuplot.el
deleted file mode 100644
index 7d749478..00000000
--- a/elpa/gnuplot-20250724.1531/gnuplot.el
+++ /dev/null
@@ -1,1888 +0,0 @@
-;;; gnuplot.el --- Major-mode and interactive frontend for gnuplot -*- lexical-binding: t -*-
-
-;; Copyright (C) 1998, 2011 Phil Type and Bruce Ravel, 1999-2012 Bruce Ravel
-
-;; Author:           Jon Oddie, Bruce Ravel, Phil Type
-;; Maintainer:       Maxime Tréca <maxime@gmail.com>, Daniel Mendler <mail@daniel-mendler.de>
-;; Created:          1998
-;; Package-Version: 20250724.1531
-;; Package-Revision: 43e9674b8694
-;; Keywords:         data gnuplot plotting
-;; URL:              https://github.com/emacs-gnuplot/gnuplot
-;; Package-Requires: ((emacs "28.1") (compat "30"))
-
-;; This file is not part of GNU Emacs.
-
-;; This program is free software: you can redistribute it and/or modify
-;; it under the terms of the GNU General Public License as published by
-;; the Free Software Foundation, either version 3 of the License, or
-;; (at your option) any later version.
-
-;; This program is distributed in the hope that it will be useful,
-;; but WITHOUT ANY WARRANTY; without even the implied warranty of
-;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-;; GNU General Public License for more details.
-
-;; You should have received a copy of the GNU General Public License
-;; along with this program.  If not, see <https://www.gnu.org/licenses/>.
-
-;;; Commentary:
-
-;; This is a major mode for composing gnuplot scripts and displaying
-;; their results using gnuplot.  It supports features of recent Gnuplot
-;; versions (5.0 and up), but should also work fine with older
-;; versions.
-;;
-;; Gnuplot-mode includes context-sensitive support for keyword
-;; completion and, optionally, eldoc-mode help text.  See the
-;; commentary in gnuplot-context.el for more information.  If you
-;; don't find it useful, it can be turned off by customizing
-;; `gnuplot-context-sensitive-mode'.
-
-;;; Acknowledgements:
-
-;;    David Batty          numerous corrections
-;;    Laurent Bonnaud      suggestions regarding font-lock rules
-;;    Markus Dickebohm     suggested `gnuplot-send-line-and-forward'
-;;    Stephen Eglan        suggested the use of info-look and various fixes
-;;    Robert Fenk          suggested respecting continuation lines
-;;    Michael Karbach      suggested trimming the gnuplot process buffer
-;;    Alex Chan Libchen    suggested font-lock for plotting words
-;;    Kuang-Yu Liu         pointed out buggy dependence on font-lock
-;;    Hrvoje Niksic        help with defcustom arguments for insertions
-;;    Andreas Rechtsteiner pointed out problem with C-c C-v
-;;    Michael Sanders      help with the info-look interface
-;;    Jinwei Shen          suggested functionality in comint buffer
-;;    Michael M. Tung      prompted me to add pm3d support
-;;    Holger Wenzel        suggested using `gnuplot-keywords-when'
-;;    Wolfgang Zocher      pointed out problem with gnuplot-mode + speedbar
-;;    Jon Oddie            indentation, inline images, context mode
-;;    Lars Hecking         gnuplot distribution and installation materials
-;;    Maxime F. Treca      package update, XEmacs deprecation
-;;    Daniel Mendler       package update, support for recent Emacs
-
-;;; Code:
-
-(require 'compat)
-(require 'cl-lib)
-(require 'comint)
-(require 'info)
-(require 'info-look)
-
-(defgroup gnuplot nil
-  "Gnuplot-mode for Emacs."
-  :prefix "gnuplot-"
-  :group 'processes
-  :group 'applications
-  :link '(emacs-library-link :tag "Lisp File" "gnuplot.el")
-  :link '(url-link :tag "Homepage" "https://github.com/emacs-gnuplot/gnuplot/")
-  :link '(info-link :tag "Info Manual" "(gnuplot)")
-  :link '(emacs-commentary-link :tag "Commentary" "gnuplot.el"))
-
-(defcustom gnuplot-program "gnuplot"
-  "The name of the gnuplot executable."
-  :type 'string)
-
-(defcustom gnuplot-program-args nil
-  "Whitespace-separated flags to pass to the gnuplot executable."
-  :type 'string)
-
-(defcustom gnuplot-process-name "gnuplot"
-  "Name given to the gnuplot buffer and process."
-  :type 'string)
-
-(defcustom gnuplot-gnuplot-buffer "plot.gp"
-  "The name of the gnuplot scratch buffer opened by `gnuplot-make-buffer'."
-  :type 'string)
-
-(defcustom gnuplot-display-process 'window
-  "This controls how the gnuplot process buffer is displayed.
-The values are
-   \\='frame    display gnuplot process in a separate frame
-   \\='window   display gnuplot process in this frame but in another window
-   nil       `gnuplot-process' is in the current frame but not displayed"
-  :type '(radio (const :tag "Separate frame"  frame)
-                (const :tag "Separate window" window)
-                (const :tag "Not displayed"   nil)))
-
-(defcustom gnuplot-info-display 'window
-  "Determines how `gnuplot-info-lookup-symbol' displays the info file.
-The values are
-   \\='frame    display info file in a separate frame
-   \\='window   display info file in another window
-   nil       display info file in the current window"
-  :type '(radio (const :tag "Separate frame"  frame)
-                (const :tag "Separate window" window)
-                (const :tag "This window"     nil)))
-
-(defcustom gnuplot-echo-command-line-flag
-  (not (string-match "msvc" (emacs-version)))
-  "Non-nil means the gnuplot subprocess echoes any input.
-This sets the fall-back value of `comint-process-echoes'.
-If `gnuplot-mode' cannot figure out what version number of gnuplot
-this is, then the value of this variable will be used for
-`comint-process-echos'.  It seems that gnuplot 3.5 wants this to be
-nil and 3.7 wants it to be t.  If lines that you send to gnuplot from
-the `gnuplot-mode' buffer are not appearing at the gnuplot prompt in
-the process buffer, try toggling it.  Also see the document string for
-`comint-process-echos'.  If you change this, kill the gnuplot process
-and start it again."
-  :type 'boolean)
-
-(defcustom gnuplot-delay 0.02
-  "Amount of time to delay before sending a new line to gnuplot.
-This is needed so that the the line is not written in the gnuplot
-buffer in advance of its prompt.  Increase this number if the
-prompts and lines are displayed out of order."
-  :type 'number)
-
-(defcustom gnuplot-buffer-max-size 1000
-  "The maximum size in lines of the gnuplot process buffer.
-Each time text is written in the gnuplot process buffer, lines are
-trimmed from the beginning of the buffer so that the buffer is this
-many lines long.  The lines are deleted after the most recent lines
-were interpretted by gnuplot.  Setting to 0 turns off this feature."
-  :type 'integer)
-
-(defcustom gnuplot-quote-character "\'"
-  "Quotation character used for inserting quoted strings.
-Gnuplot can use single or double quotes.  If you prefer to have the
-filename insertion function never insert quotes for you, set this
-to the empty string."
-  :type '(radio (const :tag "double quote"  "\"")
-                (const :tag "single quote"  "\'")
-                (const :tag "none"          ""  )))
-
-(defcustom gnuplot-basic-offset 4
-  "Number of columns to indent lines inside a do- or if-else-block.
-
-This applies only to new-style do- and if-statements using
-braces.  Commands continued over a linebreak using a backslash
-are always indented to line up with the second word on the line
-beginning the continued command."
-  :type 'integer)
-
-(defvar gnuplot-context-sensitive-mode nil)
-(autoload 'gnuplot-context-sensitive-mode "gnuplot-context")
-(autoload 'gnuplot-gui-set-options-and-insert "gnuplot-gui" nil '(gnuplot-mode))
-(autoload 'gnuplot-gui-swap-simple-complete "gnuplot-gui" nil '(gnuplot-mode))
-(autoload 'gnuplot-gui-toggle-popup "gnuplot-gui" nil '(gnuplot-mode))
-
-(defcustom gnuplot-use-context-sensitive-completion t
-  "Non-nil if `gnuplot-context-sensitive-mode' should be enabled by default.
-
-In context-sensitive mode, `gnuplot-mode' parses the current
-command line to provide smarter completion and documentation
-suggestions."
-  :type 'boolean
-  :set (lambda (sym value)
-         (set sym value)
-         (cond
-          (value
-           (add-hook 'gnuplot-mode-hook #'gnuplot-context-sensitive-mode nil nil)
-           (add-hook 'gnuplot-comint-mode-hook #'gnuplot-context-sensitive-mode nil nil))
-          (t
-           (remove-hook 'gnuplot-mode-hook #'gnuplot-context-sensitive-mode)
-           (remove-hook 'gnuplot-comint-mode-hook #'gnuplot-context-sensitive-mode)))
-         (dolist (buffer (buffer-list))
-           (with-current-buffer buffer
-             (when (derived-mode-p 'gnuplot-mode 'gnuplot-comint-mode)
-               (gnuplot-context-sensitive-mode (if value 1 0))))))
-  :link '(emacs-commentary-link "gnuplot-context"))
-
-(defun gnuplot--set-display-mode (variable value &rest _args)
-  "Customize :set function for `gnuplot-inline-image-mode'.
-Set VARIABLE to VALUE.  ARGS is optional args."
-  (if (and (eq variable 'gnuplot-inline-image-mode)
-           value
-           (not (display-images-p)))
-      (progn
-        (message "Displaying images is not supported.")
-        (set variable nil))
-    (set variable value))
-  (gnuplot--setup-comint-for-image-mode))
-
-(defcustom gnuplot-inline-image-mode (and (display-graphic-p)
-                                          (image-type-available-p 'png)
-                                          'inline)
-  "Whether to display Gnuplot output in Emacs.
-
-Possible values are nil, `inline' and `dedicated'.
-
-When this is nil, Gnuplot output is handled outside of Emacs in
-the normal way.  Otherwise, Emacs attempts to capture Gnuplot's
-output and display it in a buffer.  Output is inserted inline in
-the Gnuplot interaction buffer it this is `inline', in a
-separate dedicated buffer if it is `dedicated'.
-
-Use Customize to set this variable, or the commands
-`gnuplot-external-display-mode', `gnuplot-inline-display-mode',
-and `gnuplot-dedicated-display-mode'."
-  :type '(radio
-          (const :tag "No" nil)
-          (const :tag "In Comint buffer" inline)
-          (const :tag "In dedicated buffer" dedicated))
-  :initialize #'custom-initialize-default
-  :set #'gnuplot--set-display-mode)
-
-(defcustom gnuplot-image-format "png"
-  "Image format to use for displaying images within Emacs.
-
-This will be sent directly to Gnuplot as a command of the form
-\"set terminal <FORMAT>\".  Common values are \"png\" and
-\"svg\".
-
-This only has an effect when `gnuplot-inline-image-mode' is
-non-nil."
-  :type 'string
-  :initialize #'custom-initialize-default
-  :set #'gnuplot--set-display-mode)
-
-(defcustom gnuplot-image-buffer "*gnuplot image*"
-  "Buffer name for dedicated gnuplot image output."
-  :type 'string)
-
-(defcustom gnuplot-hidden-output-buffer " *gnuplot hidden*"
-  "Buffer name for hidden gnuplot output.
-Send commands to GNUPLOT silently & without generating an extra prompt."
-  :type 'string)
-
-
-;;; customizable hooks
-
-(defgroup gnuplot-hooks nil
-  "Hook variables used by `gnuplot-mode'."
-  :prefix "gnuplot-"
-  :group 'gnuplot)
-
-(defcustom gnuplot-mode-hook nil
-  "Hook run when `gnuplot-mode' is entered."
-  :type 'hook)
-
-(defcustom gnuplot-after-plot-hook (list #'gnuplot-trim-comint-buffer)
-  "Hook run after gnuplot plots something.
-This is the last thing done by the functions for plotting a line, a
-region, a buffer, or a file."
-  :type 'hook)
-
-(defcustom gnuplot-comint-mode-hook nil
-  "Hook run after setting up the gnuplot buffer in `gnuplot-comint-mode'."
-  :type 'hook)
-
-
-
-;;; --- insertions variables and menus
-
-(defgroup gnuplot-insertions nil
-  "Insert commands into gnuplot-scripts from a pull-down menu."
-  :prefix "gnuplot-insertions-"
-  :group 'gnuplot)
-
-(defvar gnuplot--insertions-menu nil
-  "Menu for insertions in `gnuplot-mode'.
-
-The insertions menu is composed of several sub-menus.  The variables
-describing the sub-menus are:
-  `gnuplot-insertions-adornments'
-  `gnuplot-insertions-plot-options'
-  `gnuplot-insertions-terminal'
-  `gnuplot-insertions-x-axis'
-  `gnuplot-insertions-y-axis'
-  `gnuplot-insertions-z-axis'
-  `gnuplot-insertions-x2-axis'
-  `gnuplot-insertions-y2-axis'
-  `gnuplot-insertions-parametric-plots'
-  `gnuplot-insertions-polar-plots'
-  `gnuplot-insertions-surface-plots'
-These variables can be customized by the user.  For example, there are
-many terminal types which are not in the terminal submenu but which
-may be compiled into your copy of gnuplot.
-
-Each of these variables is a list whose first element is a string and
-all the rest are vectors as described in the document string for
-`easy-menu-define'.  The callback used throughout these menus is
-`gnuplot-insert' which inserts the appropriate set expression and,
-optionally, looks up that item in the gnuplot info file.
-
-The easiest way to customize the submenus is to use the custom
-package.  Just type \\[gnuplot-customize] and follow your nose.
-
-You can also add new items to any of these sub-menus by adding to the
-`with-eval-after-load' blocks in your .emacs file.  Here is an example of
-adding the \"regis\" terminal type to the terminal sub-menu:
-
- (with-eval-after-load \\='gnuplot
-      (setq gnuplot-insertions-terminal
-            (append gnuplot-insertions-terminal
-                    (list
-                     [\"regis\"
-                      (gnuplot-insert \"set terminal regis\")
-                       t]))))")
-
-(defcustom gnuplot-insertions-show-help-flag nil
-  "Non-nil means to display certain help messages automatically.
-These messages are shown after menu insertion of gnuplot commands."
-  :type 'boolean)
-
-(defcustom gnuplot-insertions-menu-flag t
-  "Non-nil means to place the insertion menu in the menubar.
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type 'boolean)
-
-(defvar gnuplot-insertions-top
-  '("insert set expression" "---")
-  "Top part of insertions menu.
-See the document string for `gnuplot--insertions-menu'")
-
-(defcustom gnuplot-insertions-adornments ; this is icky...
-  '("adornments"
-    ["arrow"       (gnuplot-insert "set arrow ")          t]
-    ["bar"         (gnuplot-insert "set bar")             t]
-    ["border"      (gnuplot-insert "set border")          t]
-    ["boxwidth"    (gnuplot-insert "set boxwidth ")       t]
-    ["format"      (gnuplot-insert "set format ")         t]
-    ["grid"        (gnuplot-insert "set grid")            t]
-    ["key"         (gnuplot-insert "set key ")            t]
-    ["label"       (gnuplot-insert "set label ")          t]
-    ["pointsize"   (gnuplot-insert "set pointsize ")      t]
-    ["samples"     (gnuplot-insert "set samples ")        t]
-    ["size"        (gnuplot-insert "set size ")           t]
-    ["style"       (gnuplot-insert "set style ")          t]
-    ["tics"        (gnuplot-insert "set tics ")           t]
-    ["timefmt"     (gnuplot-insert "set timefmt ")        t]
-    ["timestamp"   (gnuplot-insert "set timestamp ")      t]
-    ["title"       (gnuplot-insert "set title ")          t]
-    ["zeroaxis"    (gnuplot-insert "set zeroaxis")        t])
-
-  "Adornments submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defcustom gnuplot-insertions-plot-options
-  '("plot options"
-    ["autoscale"  (gnuplot-insert "set autoscale ")          t]
-    ["clip"       (gnuplot-insert "set clip ")               t]
-    ["encoding"   (gnuplot-insert "set encoding ")           t]
-    ["locale"     (gnuplot-insert "set locale ")             t]
-    ["logscale"   (gnuplot-insert "set logscale ")           t]
-    ["multiplot"  (gnuplot-insert "set multiplot")           t]
-    ["missing"    (gnuplot-insert "set missing \"\"")        t]
-    ["palette"    (gnuplot-insert "set palette ")            t]
-    ["pm3d"       (gnuplot-insert "set pm3d ")               t]
-    ["offsets"    (gnuplot-insert "set offsets ")            t]
-    ["output"     (gnuplot-insert "set output ")             t]
-    ["zero"       (gnuplot-insert "set zero ")               t])
-  "Plot options submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defcustom gnuplot-insertions-terminal
-  '("terminal"
-    ["eepic"      (gnuplot-insert "set terminal eepic")      t]
-    ["fig"        (gnuplot-insert "set terminal fig")        t]
-    ["gpic"       (gnuplot-insert "set terminal gpic")       t]
-    ["latex"      (gnuplot-insert "set terminal latex")      t]
-    ["linux"      (gnuplot-insert "set terminal linux")      t]
-    ["pbm"        (gnuplot-insert "set terminal pbm")        t]
-    ["png"        (gnuplot-insert "set terminal png")        t]
-    ["postscript" (gnuplot-insert "set terminal postscript") t]
-    ["pslatex"    (gnuplot-insert "set terminal pslatex")    t]
-    ["table"      (gnuplot-insert "set terminal table")      t]
-    ["tek40xx"    (gnuplot-insert "set terminal tek40xx")    t]
-    ["tkcanvas"   (gnuplot-insert "set terminal tkcanvas")   t]
-    ["tpic"       (gnuplot-insert "set terminal tpic")       t]
-    ["vgagl"      (gnuplot-insert "set terminal vgagl")      t]         ; for pm3d patch
-    ["vttek"      (gnuplot-insert "set terminal vttek")      t]
-    ["x11"        (gnuplot-insert "set terminal x11")        t])
-  "Terminal submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defcustom gnuplot-insertions-x-axis
-  '("x-axis"
-    ["xdata"      (gnuplot-insert "set xdata ")              t]
-    ["xlabel"     (gnuplot-insert "set xlabel ")             t]
-    ["xrange"     (gnuplot-insert "set xrange [:]")          t]
-    ["xtics"      (gnuplot-insert "set xtics ")              t]
-    ["mxtics"     (gnuplot-insert "set mxtics ")             t]
-    ["xzeroaxis"  (gnuplot-insert "set xzeroaxis ")          t]
-    ["xdtics"     (gnuplot-insert "set xdtics ")             t]
-    ["xmtics"     (gnuplot-insert "set xmtics ")             t])
-  "X-axis submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defcustom gnuplot-insertions-x2-axis
-  '("x2-axis"
-    ["x2data"     (gnuplot-insert "set xdata ")              t]
-    ["x2label"    (gnuplot-insert "set xlabel ")             t]
-    ["x2range"    (gnuplot-insert "set xrange [:]")          t]
-    ["x2tics"     (gnuplot-insert "set xtics ")              t]
-    ["mx2tics"    (gnuplot-insert "set mxtics ")             t]
-    ["x2zeroaxis" (gnuplot-insert "set xzeroaxis ")          t]
-    ["x2dtics"    (gnuplot-insert "set xdtics ")             t]
-    ["x2mtics"    (gnuplot-insert "set xmtics ")             t])
-  "X2-axis submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defcustom gnuplot-insertions-y-axis
-  '("y-axis"
-    ["ydata"      (gnuplot-insert "set ydata ")              t]
-    ["ylabel"     (gnuplot-insert "set ylabel ")             t]
-    ["ymtics"     (gnuplot-insert "set ymtics ")             t]
-    ["yrange"     (gnuplot-insert "set yrange [:]")          t]
-    ["ytics"      (gnuplot-insert "set ytics ")              t]
-    ["yzeroaxis"  (gnuplot-insert "set yzeroaxis ")          t]
-    ["ydtics"     (gnuplot-insert "set ydtics ")             t]
-    ["mytics"     (gnuplot-insert "set mytics ")             t])
-  "Y-axis submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defcustom gnuplot-insertions-y2-axis
-  '("y2-axis"
-    ["y2data"     (gnuplot-insert "set ydata ")              t]
-    ["y2label"    (gnuplot-insert "set ylabel ")             t]
-    ["y2range"    (gnuplot-insert "set yrange [:]")          t]
-    ["y2tics"     (gnuplot-insert "set ytics ")              t]
-    ["my2tics"    (gnuplot-insert "set mytics ")             t]
-    ["y2zeroaxis"  (gnuplot-insert "set yzeroaxis ")         t]
-    ["y2mtics"    (gnuplot-insert "set ymtics ")             t]
-    ["y2dtics"    (gnuplot-insert "set ydtics ")             t])
-  "Y2-axis submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defcustom gnuplot-insertions-z-axis
-  '("z-axis"
-    ["zdata"      (gnuplot-insert "set zdata ")              t]
-    ["zlabel"     (gnuplot-insert "set zlabel ")             t]
-    ["zrange"     (gnuplot-insert "set zrange [:]")          t]
-    ["ztics"      (gnuplot-insert "set ztics ")              t]
-    ["mztics"     (gnuplot-insert "set mztics ")             t]
-    ["zdtics"     (gnuplot-insert "set zdtics ")             t]
-    ["zmtics"     (gnuplot-insert "set zmtics ")             t])
-  "Z-axis submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defcustom gnuplot-insertions-parametric-plots
-  '("parametric plots"
-    ["parametric" (gnuplot-insert "set parametric")          t]
-    ["isosamples" (gnuplot-insert "set isosamples ")         t]
-    ["dummy"      (gnuplot-insert "set dummy ")              t]
-    ["trange"     (gnuplot-insert "set trange [:]")          t]
-    ["urange"     (gnuplot-insert "set urange [:]")          t]
-    ["vrange"     (gnuplot-insert "set vrange [:]")          t])
-  "Parametric plots submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defcustom gnuplot-insertions-polar-plots
-  '("polar plots"
-    ["polar"      (gnuplot-insert "set polar")               t]
-    ["angles"     (gnuplot-insert "set angles ")             t]
-    ["rrange"     (gnuplot-insert "set rrange [:]")          t])
-  "Polar plots submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defcustom gnuplot-insertions-surface-plots
-  '("surface plots"
-    ["clabel"     (gnuplot-insert "set clabel ")             t]
-    ["cntrparam"  (gnuplot-insert "set cntrparam ")          t]
-    ["contour"    (gnuplot-insert "set contour")             t]
-    ["dgrid3d"    (gnuplot-insert "set dgrid3d ")            t]
-    ["hidden3d"   (gnuplot-insert "set hidden3d ")           t]
-    ["mapping"    (gnuplot-insert "set mapping ")            t]
-    ["surface"    (gnuplot-insert "set surface ")            t]
-    ["view"       (gnuplot-insert "set view ")               t])
-  "Surface plots submenu in the insertions menu.
-See the document string for `gnuplot--insertions-menu'
-Changing this will not effect a change in any currently existing
-`gnuplot-mode' buffer.  You will see the change the next time you
-create a `gnuplot-mode' buffer."
-  :type '(list (string :tag "Title")
-               (repeat :inline t
-                       (vector (string   :tag "Name")
-                               (function :tag "Callback")
-                               (boolean  :tag "Enabled" t)))))
-
-(defvar gnuplot-insertions-bottom
-  '("---"
-    ["Display of info with insertion" gnuplot-toggle-info-display
-     :style toggle :selected gnuplot-insertions-show-help-flag]
-    ["Display GUI popup with insertion" gnuplot-gui-toggle-popup
-     :active t
-     :style toggle :selected gnuplot-gui-popup-flag])
-  "Bottom part of the insertions menu.
-This part contains the toggle buttons for displaying info or
-opening an argument-setting popup.")
-
-(defvar gnuplot-recently-sent nil
-  "This is a record of the most recent kind of text sent to gnuplot.
-It takes as its value nil, `line', `region', `buffer', or `file'.  It is
-useful for functions included in `gnuplot-after-plot-hook'.")
-
-(defvar gnuplot-buffer nil
-  "The name of the buffer displaying the gnuplot process.")
-
-(defvar gnuplot-process nil
-  "Variable holding the process handle.")
-
-(defvar gnuplot--comint-recent-buffer nil
-  "The most recently plotted gnuplot script buffer.
-This is used by the function that plot from the comint buffer.  It is
-reset every time something is plotted from a script buffer.")
-
-(defvar gnuplot--process-frame nil
-  "The frame for displaying the gnuplot process.
-This is used when `gnuplot-display-process' is equal to `frame'.")
-
-(defvar gnuplot--info-frame nil)
-
-;; with info-look, there is no need to carry this list around -- it
-;; can be generated on the fly appropriate to the currently installed
-;; version of gnuplot.info
-(defvar gnuplot--info-keywords 'pending
-  "A list of keywords used in GNUPLOT.
-These are set by `gnuplot--set-keywords-list' from the values in
-`info-lookup-cache'.")
-
-
-;;; --- key bindings and menus
-
-(defvar-keymap gnuplot-mode-map
-  :doc "Keymap used by `gnuplot-mode'."
-  :parent prog-mode-map
-  "C-c C-b"     #'gnuplot-send-buffer-to-gnuplot
-  "C-c C-o"     #'gnuplot-gui-set-options-and-insert
-  "C-c C-e"     #'gnuplot-show-comint-buffer
-  "C-c C-f"     #'gnuplot-send-file-to-gnuplot
-  "C-c C-d"     #'gnuplot-info-lookup-symbol
-  "C-c C-i"     #'gnuplot-insert-filename
-  "C-c C-j"     #'gnuplot-forward-script-line
-  "C-c C-k"     #'gnuplot-kill-comint-buffer
-  "C-c C-l"     #'gnuplot-send-line-to-gnuplot
-  "C-c C-n"     #'gnuplot-negate-option
-  "C-c C-r"     #'gnuplot-send-region-to-gnuplot
-  "C-M-x"       #'gnuplot-send-line-to-gnuplot
-  "C-c C-v"     #'gnuplot-send-line-and-forward
-  "C-c C-z"     #'gnuplot-customize
-  "}"           #'gnuplot-electric-insert
-  "M-TAB"       #'completion-at-point
-  "S-<mouse-2>" #'gnuplot-gui-set-options-and-insert)
-
-(defvar gnuplot--display-options-menu
-  (cl-flet ((make-image-setter (type)
-              `[,(concat (upcase type) " images")
-                (lambda () (interactive) (gnuplot-set-image-format ,type))
-                :style toggle
-                :selected (eq gnuplot-image-format ,type)]))
-    `("Display plot output"
-      ["Externally" gnuplot-external-display-mode
-       :style toggle
-       :selected (null gnuplot-inline-image-mode)]
-      ["In Comint buffer" gnuplot-inline-display-mode
-       :active (display-images-p)
-       :style toggle
-       :selected (eq gnuplot-inline-image-mode 'comint)]
-      ["In dedicated buffer" gnuplot-dedicated-display-mode
-       :style toggle
-       :selected (eq gnuplot-inline-image-mode 'dedicated)]
-      "---"
-      ,@(mapcar #'make-image-setter (list "png" "jpeg" "svg"))
-      ["Other image type..." gnuplot-set-image-format])))
-
-(easy-menu-define gnuplot-mode-menu gnuplot-mode-map
-  "Menu used in `gnuplot-mode'."
-  `("Gnuplot"
-    ["Send line to gnuplot"             gnuplot-send-line-to-gnuplot   t]
-    ["Send line & move forward"         gnuplot-send-line-and-forward (not (eobp))]
-    ["Send region to gnuplot"           gnuplot-send-region-to-gnuplot
-     (gnuplot--mark-active)]
-    ["Send buffer to gnuplot"           gnuplot-send-buffer-to-gnuplot t]
-    ["Send file to gnuplot"             gnuplot-send-file-to-gnuplot t]
-    "---"
-    ,gnuplot--display-options-menu
-    ["Contextual completion and help"   gnuplot-context-sensitive-mode
-     :style toggle
-     :selected gnuplot-context-sensitive-mode]
-    ["Echo area help (eldoc-mode)" eldoc-mode
-     :active gnuplot-context-sensitive-mode
-     :style toggle
-     :selected eldoc-mode]
-    "---"
-    ["Insert filename at point"         gnuplot-insert-filename t]
-    ["Negate set option"                gnuplot-negate-option t]
-    ["Keyword help"                     gnuplot-info-lookup-symbol]
-    ["Quick help for thing at point"    gnuplot-context-help-at-point
-     gnuplot-context-sensitive-mode]
-    ["Info documentation on thing at point"
-     gnuplot-context-info-at-point
-     gnuplot-context-sensitive-mode]
-    ["Show gnuplot process buffer"      gnuplot-show-comint-buffer t]
-    ["Set arguments at point"           gnuplot-gui-set-options-and-insert t]
-    ["Swap plot/splot/fit lists in GUI" gnuplot-gui-swap-simple-complete t]
-    "---"
-    ["Customize gnuplot"                gnuplot-customize t]
-    "---"
-    ["Kill gnuplot"                     gnuplot-kill-comint-buffer t]))
-
-
-;;; --- syntax colorization, syntax table
-
-(defvar gnuplot-mode-abbrev-table)
-(defvar gnuplot-mode-syntax-table
-  (let ((table (make-syntax-table)))
-    (modify-syntax-entry ?* "." table)
-    (modify-syntax-entry ?+ "." table)
-    (modify-syntax-entry ?- "." table)
-    (modify-syntax-entry ?/ "." table)
-    (modify-syntax-entry ?% "." table)
-    (modify-syntax-entry ?= "." table)
-    (modify-syntax-entry ?: "." table)
-    (modify-syntax-entry ?& "." table )
-    (modify-syntax-entry ?^ "." table )
-    (modify-syntax-entry ?| "." table )
-    (modify-syntax-entry ?& "." table )
-    (modify-syntax-entry ?? "." table )
-    (modify-syntax-entry ?~ "." table )
-    (modify-syntax-entry ?_ "w" table )
-    (modify-syntax-entry ?\" "." table)
-    (modify-syntax-entry ?\' "." table)
-    (modify-syntax-entry ?` "." table)
-    (modify-syntax-entry ?\\ "." table)
-
-    table)
-
-  "Syntax table in use in `gnuplot-mode' buffers.
-This is the same as the standard syntax table except that ` and _
-are word characters, and math operators are punctuation
-characters.")
-
-;; Macro to generate efficient regexps for keyword matching
-;;
-;; These regular expressions treat the gnuplot vocabulary as complete
-;; words.  Although gnuplot will recognise unique abbreviations, these
-;; regular expressions will not.
-(defmacro gnuplot--make-regexp (list)
-  "Macro to generate efficient regexps for keyword matching from LIST."
-  `(regexp-opt ,list 'words))
-
-;; Lists of gnuplot keywords for syntax coloring etc.
-(defvar gnuplot--keywords-builtin-functions
-  '("abs" "acosh" "acos" "arg" "asinh" "asin" "atan" "atanh" "atan2" "besj1"
-    "besj0" "besy1" "besy0" "ceil" "column" "cosh" "cos" "erfc" "erf" "exp"
-    "floor" "gamma" "ibeta" "igamma" "imag" "int" "inverf" "invnorm" "lgamma"
-    "log" "log10" "norm" "rand" "real" "sgn" "sinh" "sin" "sqrt" "tanh" "tan"
-    "tm_hour" "tm_mday" "tm_min" "tm_mon" "tm_sec" "tm_wday" "tm_yday" "tm_year"
-    "valid" "EllipticPi" "EllipticE" "EllipticK" "words" "word" "value"
-    "timecolumn" "substr" "strstrt" "strptime" "strlen" "stringcolumn"
-    "strftime" "sprintf" "lambertw" "gprintf" "exists" "defined" "columnhead")
-
-  "List of GNUPLOT built-in functions, as strings.
-
-These are highlighted using `font-lock-function-name-face'.")
-
-(defvar gnuplot--keywords-plotting
-  '("axes" "every" "index" "lw" "lt" "ls" "linestyle" "linetype" "linewidth"
-    "notitle" "pt" "ps" "pointsize" "pointtype" "smooth" "thru" "title" "using"
-    "with" "noautoscale" "volatile" "matrix" "nonuniform" "binary" "fillstyle"
-    "linecolor" "pointinterval" "nosurface" "nocontours" "nohidden3d")
-  "List of GNUPLOT keywords associated with plotting, as strings.
-
-These are highlighted using `font-lock-type-face'.
-This list does not include plotting styles -- for that, see
-`gnuplot--keywords-plotting-styles'")
-
-(defvar gnuplot--keywords-plotting-styles
-  '("boxerrorbars" "boxes" "boxxyerrorbars" "candlesticks" "dots" "errorbars"
-    "financebars" "fsteps" "histeps" "impulses" "lines" "linespoints" "points"
-    "steps" "vector" "xerrorbars" "xyerrorbars" "yerrorbars" "vectors"
-    "filledcurves" "labels" "rgbalpha" "rgbimage" "image" "circles" "pm3d"
-    "histograms" "xyerrorlines" "xerrorlines" "errorlines" "yerrorlines")
-
-  "List of GNUPLOT plotting styles, as strings.
-
-These are highlighted using `font-lock-function-name-face'.")
-
-(defvar gnuplot--keywords-misc
-  '("bind" "cd" "clear" "exit" "fit" "help" "history" "load" "pause" "print"
-    "pwd" "quit" "replot" "save" "set" "show" "unset" "if" "else" "do" "update"
-    "undefine" "test" "system" "raise" "lower" "eval" "shell" "reset" "reread"
-    "refresh" "call")
-  "List of GNUPLOT miscellaneous commands, as strings.
-
-These are highlighted using `font-lock-constant-face'.")
-
-(defvar gnuplot--keywords-negatable-options
-  '("arrow" "autoscale" "border" "clabel" "clip" "contour" "dgrid3d" "grid"
-    "hidden3d" "historysize" "key" "label" "linestyle" "logscale" "mouse"
-    "multiplot" "mx2tics" "mxtics" "my2tics" "mytics" "mztics" "offsets" "polar"
-    "surface" "timestamp" "title" "x2dtics" "x2mtics" "x2tics" "x2zeroaxis"
-    "xdtics" "xmtics" "xtics" "xzeroaxis" "y2dtics" "y2mtics" "y2tics"
-    "y2zeroaxis" "ydtics" "ymtics" "ytics" "yzeroaxis" "zdtics" "zmtics" "ztics"
-    "zzeroaxis")
-
-  "List of gnuplot options which can be negated using `gnuplot-negate-option'.")
-
-(defvar gnuplot--negatable-options-regexp
-  (gnuplot--make-regexp gnuplot--keywords-negatable-options))
-
-;; Set up colorization for gnuplot.
-(defvar gnuplot-font-lock-keywords
-  `(; stuff in brackets
-    ("\\[\\([^]]+\\)\\]" (1 'font-lock-constant-face))
-
-    ;; variable/function definitions
-    ("\\(\\(\\sw\\|\\s_\\)+\\s-*\\((\\s-*\\(\\sw\\|\\s_\\)*\\s-*\\(,\\s-*\\sw*\\)*\\s-*)\\)?\\s-*=\\)[^=]"
-     (1 'font-lock-variable-name-face))
-
-    ;; built-in function names
-    (,(gnuplot--make-regexp gnuplot--keywords-builtin-functions)
-     (0 'font-lock-function-name-face))
-
-    ;; reserved words associated with plotting
-    (,(gnuplot--make-regexp gnuplot--keywords-plotting)
-     (0 'font-lock-type-face))
-    (,(gnuplot--make-regexp gnuplot--keywords-plotting-styles)
-     (0 'font-lock-function-name-face))
-
-    ;; (s)plot -- also thing (s)plotted
-    ("\\<s?plot\\>" (0 'font-lock-keyword-face))
-    ;; ("\\<s?plot\\s-+\\([^'\" ]+\\)[) \n,\\\\]"
-    ;;  (1 'font-lock-variable-name-face))
-
-    ;; other common commands
-    (,(gnuplot--make-regexp gnuplot--keywords-misc)
-     (0 'font-lock-constant-face))
-    ("!.*$" (0 'font-lock-constant-face))))
-
-(defvar gnuplot-font-lock-defaults
-  '(gnuplot-font-lock-keywords
-    nil                           ; Use syntactic fontification
-    t                             ; Use case folding
-    nil                           ; No extra syntax
-    ;; calls `gnuplot--beginning-of-continuation'
-    ;; to find a safe place to begin syntactic highlighting
-    beginning-of-defun))
-
-;; Some corner cases in Gnuplot's comment and string syntax are
-;; difficult to handle accurately using Emacs's built-in syntax tables
-;; and parser:
-;;
-;; - strings can continue over several lines, but only by using a
-;;   backslash to escape the newline
-;;
-;; - double-quoted strings can contain escaped quotes, \", and escaped
-;;   backslashes, \\; but in single-quoted strings the quote is
-;;   escaped by doubling it, '', and backslash is only special at
-;;   end-of-line
-;;
-;; - either type of string can end at newline without needing a
-;; - closing delimiter
-;;
-;; - comments continue over continuation lines
-;;
-;; The following syntax-propertize rules should accurately mark string
-;; and comment boundaries using the "generic string fence" and
-;; "generic comment fence" syntax properties.
-(defalias 'gnuplot--syntax-propertize
-  (syntax-propertize-rules
-   ;; Double quoted strings
-   ((rx
-     (group "\"")
-     (* (or (seq "\\" anything)
-            (not (any "\"" "\n"))))
-     (group (or "\"" "\n" buffer-end)))
-    (1 "|") (2 "|"))
-
-   ;; Single quoted strings
-   ((rx
-     (group "'")
-     (* (or (seq "\\" "\n")
-            "''"
-            (not (any "'" "\n"))))
-     (group (or "'" "\n" buffer-end)))
-    (1 "|") (2 "|"))
-
-   ;; Comments
-   ((rx
-     (group "#")
-     (* (or (seq "\\" "\n")
-            any))
-     (or (group "\n") buffer-end))
-    (1 "!") (2 "!"))))
-
-(defun gnuplot--syntax-propertize-extend-region (start end)
-  "Expand the region to `syntax-propertize' for strings and comments.
-
-Region range is START to END.
-Ensures that the region being searched begins and ends outside of
-any lines continued with a backslash.
-
-This function is added to `syntax-propertize-extend-region-functions'
-in `gnuplot-mode' buffers."
-  (let ((continuation-start
-         (min start
-              (gnuplot--point-at-beginning-of-continuation start)))
-        (continuation-end
-         (max end
-              (gnuplot--point-at-end-of-continuation end))))
-    (if (and (= continuation-start start)
-             (= continuation-end end))
-        nil
-      (cons continuation-start continuation-end))))
-
-;; Parsing utilities to tell if we are inside a string or comment
-(defun gnuplot--in-string (&optional where)
-  "Return non-nil if the text at WHERE is within a string.
-
-If WHERE is omitted, defaults to text at point.
-This is a simple wrapper for `syntax-ppss'."
-  (save-excursion
-    (let ((parse-state (syntax-ppss where)))
-      (nth 3 parse-state))))
-
-(defun gnuplot--in-comment (&optional where)
-  "Return non-nil if the text at WHERE is within a comment.
-
-If WHERE is omitted, defaults to text at point.
-This is a simple wrapper for `syntax-ppss'."
-  (save-excursion
-    (let ((parse-state (syntax-ppss where)))
-      (nth 4 parse-state))))
-
-(defun gnuplot--in-string-or-comment (&optional where)
-  "Return non-nil if the text at WHERE is within a string or comment.
-
-If WHERE is omitted, defaults to text at point.
-This is a simple wrapper for `syntax-ppss'."
-
-  (save-excursion
-    (let ((parse-state (syntax-ppss where)))
-      (or (nth 3 parse-state)
-          (nth 4 parse-state)))))
-
-
-;;; --- functions for sending commands to gnuplot
-
-(defun gnuplot--split-string (string)
-  "Break STRING at each carriage return, returning a list of lines."
-  (let ((list ()) (line "") (index 0))
-    (while (< index (length string))
-      (if (char-equal (elt string index) ?\n)
-          (setq list (append list (list line))
-                line "")
-        (setq line (concat line (char-to-string (elt string index)))))
-      (setq index (1+ index)))
-    list))
-
-;; -- the calls to `sleep-for' are to allow enough time for gnuplot
-;;    to write to the buffer before the next line is inserted
-;; -- note that the input string is split into lines and each line is
-;;    sent to gnuplot individually.  this is a bit slow, but it puts
-;;    each line on the comint history.
-(defun gnuplot-send-string-to-gnuplot (string text)
-  "Sends STRING to the gnuplot program.
-If no gnuplot process exists, a new one is created.  TEXT indicates
-the type of text being sent to gnuplot and is typically one of
-nil, `line', `region', `buffer', or `file'.  TEXT may be useful for
-functions in `gnuplot-after-plot-hook'.  `gnuplot-after-plot-hook' is
-called by this function after all of STRING is sent to gnuplot."
-  (gnuplot--make-comint-buffer)         ; make sure a gnuplot buffer exists
-  (setq gnuplot--comint-recent-buffer (current-buffer))
-
-  ;; Create a gnuplot frame if needed
-  (when (and (equal gnuplot-display-process 'frame)
-             (not (frame-live-p gnuplot--process-frame)))
-    (let ((frame (selected-frame)))
-      (setq gnuplot--process-frame (make-frame))
-      (select-frame gnuplot--process-frame)
-      (switch-to-buffer gnuplot-buffer)
-      (delete-other-windows)
-      (select-frame frame)))
-
-  (let ((list (gnuplot--split-string string)))
-    (with-current-buffer (get-buffer gnuplot-buffer)
-      (goto-char (point-max))
-      ;; bruce asks: what is this next line for?
-      (set-marker (process-mark gnuplot-process) (point-marker))
-      (sleep-for (* 10 gnuplot-delay))
-      (while list
-        (insert (car list))
-        (comint-send-input)
-        (sleep-for gnuplot-delay)
-        (setq list (cdr list))
-        (goto-char (point-max))))
-
-    (cond ((equal gnuplot-display-process 'window)
-           (gnuplot--display-and-recenter-comint-buffer))
-          ((equal gnuplot-display-process 'frame)
-           ;;(raise-frame gnuplot--process-frame)
-           (with-selected-frame gnuplot--process-frame
-             (gnuplot--display-and-recenter-comint-buffer))))
-
-    (setq gnuplot-recently-sent text)
-    (run-hooks 'gnuplot-after-plot-hook)))
-
-(defun gnuplot--display-and-recenter-comint-buffer ()
-  "Make sure the gnuplot comint buffer is displayed.
-Move point to the end if necessary."
-  (save-selected-window
-    (select-window (display-buffer (get-buffer gnuplot-buffer)))
-    (goto-char (point-max))
-    (unless (pos-visible-in-window-p (point) (selected-window)) (recenter 5))))
-
-(defun gnuplot-send-region-to-gnuplot (&optional begin end text)
-  "Sends a selected region to the gnuplot program.
-If BEGIN and END are not specified, point and mark are used.  TEXT
-indicates the type of text being sent to gnuplot.  This will be
-`region' unless explicitly set by a function calling this one.  Other
-typical values are of nil, `line', `buffer', or `file'.  TEXT may be
-useful for function in `gnuplot-after-plot-hook'."
-  (interactive "r" gnuplot-mode)
-  (let (string (txt (or text 'region)))
-    (setq string (buffer-substring-no-properties begin end))
-    (unless (equal (substring string -1) "\n")
-      (setq string (concat string "\n")))
-    (gnuplot-send-string-to-gnuplot string txt)))
-
-(defun gnuplot-send-line-to-gnuplot ()
-  "Sends the current line to the gnuplot program.
-Respects continuation lines.
-This sets `gnuplot-recently-sent' to `line'."
-  (interactive nil gnuplot-mode)
-  (let (start end)
-    (save-excursion
-      ;; go to start of continued command, or beginning of line
-      ;; if this is not a continuation of a previous line
-      (gnuplot--beginning-of-continuation)
-      (setq start (point))
-      (end-of-line)
-      (while (save-excursion
-               (backward-char)
-               (looking-at "\\\\"))      ; go to end of last continuation line
-        (end-of-line 2))
-      (beginning-of-line 2)
-      (setq end (point)))
-    (unless (string-match "\\`\\s-*\\'"
-                          (buffer-substring-no-properties start end))
-      (gnuplot-send-region-to-gnuplot start end 'line))
-    end))
-
-;; I chose a very easy to type but slightly non-mnemonic key-binding
-;; for this (C-c C-v).  It seems like the kind of thing one would want
-;; to do repeatedly without incurring RSI. 8^)
-(defun gnuplot-send-line-and-forward (&optional num)
-  "Call `gnuplot-send-line-to-gnuplot' and move forward 1 line.
-You can use a numeric prefix to send more than one line.  Blank lines and
-lines with only comments are skipped when moving forward.
-NUM is optional arg."
-  (interactive "p" gnuplot-mode)
-  (let (end)
-    (while (> num 0)
-      (setq end (gnuplot-send-line-to-gnuplot))
-      (goto-char end)
-      (backward-char 1)
-      (gnuplot-forward-script-line 1)
-      (setq num (1- num)))))
-
-(defun gnuplot-send-line-and-newline ()
-  "Call `gnuplot-send-line-to-gnuplot' and insert a new line."
-  (interactive nil gnuplot-mode)
-  (end-of-line)
-  (gnuplot-send-line-to-gnuplot)
-  (insert "\n"))
-
-(defun gnuplot-forward-script-line (&optional num)
-  "Move forward my NUM script lines.
-Blank lines and commented lines are not included in the NUM count."
-  (interactive "p" gnuplot-mode)
-  (while (> num 0)
-    (and (not (eobp)) (forward-line 1))
-    (while (and (not (eobp))
-                (or (looking-at "^\\s-*$")
-                    (looking-at "^\\s-*#")))
-      (forward-line 1))
-    (setq num (1- num))))
-
-(defun gnuplot-send-buffer-to-gnuplot ()
-  "Sends the entire buffer to the gnuplot program.
-This sets `gnuplot-recently-sent' to `buffer'."
-  (interactive nil gnuplot-mode)
-  (gnuplot-send-region-to-gnuplot (point-min) (point-max) 'buffer))
-
-(defun gnuplot-send-file-to-gnuplot ()
-  "Sends a selected file to the gnuplot program using the \"load\" command.
-This sets `gnuplot-recently-sent' to `file'."
-  (interactive)
-  (let ((string (read-file-name "Name of file to send to gnuplot > " nil nil t)))
-    (setq string (concat "load '" (expand-file-name string) "'\n"))
-    (message "%S" string)
-    (gnuplot--make-comint-buffer)       ; make sure a gnuplot buffer exists
-    (gnuplot-send-string-to-gnuplot string 'file)))
-
-(defun gnuplot-plot-from-comint ()
-  "Send the contents of a script to gnuplot from the process buffer.
-This inserts the contents of the most recently used gnuplot script
-into the process buffer and sends those lines to gnuplot.  It does
-this by copying the script line by line."
-  (interactive nil gnuplot-comint-mode)
-  (unless (buffer-live-p gnuplot--comint-recent-buffer)
-    (error "Script buffer has been deleted"))
-  (let (string list (buffer (current-buffer)))
-    (set-buffer gnuplot--comint-recent-buffer)
-    (setq string (buffer-substring-no-properties (point-min) (point-max))
-          string (concat string "\n")
-          list   (gnuplot--split-string string))
-    (set-buffer buffer)
-    (while list
-      (insert (car list))
-      (comint-send-input)
-      (sleep-for gnuplot-delay)
-      (setq list (cdr list)))
-    (comint-send-input)))
-
-(defun gnuplot-save-and-plot-from-comint ()
-  "Send a current script to gnuplot from the process buffer.
-This sends the most recently used gnuplot script to gnuplot using the
-\"load\" command.  This function first saves the script buffer to a
-file, prompting for a filename if one is not associated with the script
-buffer.  Then it sends a load command to gnuplot using the name of the
-file visited by the script buffer."
-  (interactive nil gnuplot-comint-mode)
-  (unless (buffer-live-p gnuplot--comint-recent-buffer)
-    (error "Script buffer has been deleted"))
-  (let (fname)
-    (with-current-buffer gnuplot--comint-recent-buffer
-      (save-buffer)
-      (setq fname (buffer-file-name)))
-    (goto-char (point-max))
-    (insert (format "load '%s'" fname))
-    (comint-send-input)))
-
-(defun gnuplot-pop-to-recent-buffer ()
-  "Switch to the most recently-plotted gnuplot script buffer."
-  (interactive)
-  (when (buffer-live-p gnuplot--comint-recent-buffer)
-    (pop-to-buffer gnuplot--comint-recent-buffer)))
-
-(defun gnuplot-trim-comint-buffer ()
-  "Trim lines from the beginning of the *gnuplot* buffer.
-This keeps that buffer from growing excessively in size.  Normally,
-this function is attached to `gnuplot-after-plot-hook'"
-  (when (> gnuplot-buffer-max-size 0)
-    (with-current-buffer gnuplot-buffer
-      (let ((gnuplot-lines (count-lines (point-min) (point-max))))
-        (dotimes (_n (- gnuplot-lines gnuplot-buffer-max-size))
-          (goto-char (point-min))
-          (delete-region (line-beginning-position) (1+ (line-end-position))))
-        (goto-char (point-max))))))
-
-
-;;; --- functions controlling the gnuplot process
-
-(defvar-keymap gnuplot-comint-mode-map
-  :doc "Keymap used by `gnuplot-comint-mode'."
-  :parent comint-mode-map
-  "C-M-p"   #'gnuplot-plot-from-comint
-  "C-M-f"   #'gnuplot-save-and-plot-from-comint
-  "C-d"      #'gnuplot-delchar-or-maybe-eof
-  "M-TAB"    #'completion-at-point
-  "C-c C-d"  #'gnuplot-info-lookup-symbol
-  "C-c C-i"  #'gnuplot-insert-filename
-  "C-c C-n"  #'gnuplot-negate-option
-  "C-c C-z"  #'gnuplot-customize
-  "C-c C-e"  #'gnuplot-pop-to-recent-buffer)
-
-(easy-menu-define
-  gnuplot-comint-mode-menu gnuplot-comint-mode-map
-  "Menu used in `gnuplot-comint-mode'."
-  `("Gnuplot"
-    ["Plot most recent gnuplot buffer"          gnuplot-plot-from-comint
-     (buffer-live-p gnuplot--comint-recent-buffer)]
-    ["Save and plot most recent gnuplot buffer"         gnuplot-save-and-plot-from-comint
-     (buffer-live-p gnuplot--comint-recent-buffer)]
-    "---"
-    ,gnuplot--display-options-menu
-    ["Contextual completion and help"           gnuplot-context-sensitive-mode
-     :style toggle
-     :selected gnuplot-context-sensitive-mode]
-    ["Echo area help (eldoc-mode)" eldoc-mode
-     :active gnuplot-context-sensitive-mode
-     :style toggle
-     :selected eldoc-mode]
-    "---"
-    ["Insert filename at point"                         gnuplot-insert-filename t]
-    ["Negate set option"                        gnuplot-negate-option t]
-    ["Keyword help"                             gnuplot-info-lookup-symbol]
-    ["Quick help for thing at point"            gnuplot-context-help-at-point
-     gnuplot-context-sensitive-mode]
-    ["Info documentation on thing at point"
-     gnuplot-context-info-at-point
-     gnuplot-context-sensitive-mode]
-    ["Switch to recent gnuplot script buffer"   gnuplot-pop-to-recent-buffer
-     (buffer-live-p gnuplot--comint-recent-buffer)]
-    "---"
-    ["Customize gnuplot"                        gnuplot-customize t]
-    "---"
-    ["Kill gnuplot"                             gnuplot-kill-comint-buffer t]))
-
-;; Major mode `gnuplot-comint-mode' for the interaction buffer
-(define-derived-mode gnuplot-comint-mode comint-mode "Gnuplot interaction"
-  "Major mode for interacting with a gnuplot process in a buffer.
-
-This sets font-lock and keyword completion in the comint/gnuplot
-buffer."
-  :interactive nil
-  :syntax-table gnuplot-mode-syntax-table
-  :abbrev-table gnuplot-mode-abbrev-table
-
-  (setq-local font-lock-defaults gnuplot-font-lock-defaults
-              parse-sexp-lookup-properties t
-              syntax-propertize-function #'gnuplot--syntax-propertize)
-
-  (add-hook 'kill-buffer-hook #'gnuplot--close-down nil t)
-  (add-hook 'comint-output-filter-functions
-            #'comint-postoutput-scroll-to-bottom
-            nil t)
-  (add-hook 'comint-output-filter-functions
-            #'gnuplot--protect-prompt-fn
-            nil t)
-  (add-hook 'completion-at-point-functions #'gnuplot-completion-at-point-info-look nil t))
-
-(defun gnuplot--make-comint-buffer ()
-  "Switch to the gnuplot program buffer or create one if none exists."
-  (unless (and gnuplot-process (eq (process-status gnuplot-process) 'run)
-               (buffer-live-p gnuplot-buffer))
-    (setq gnuplot-buffer (apply #'make-comint gnuplot-process-name gnuplot-program nil
-                                (and gnuplot-program-args (split-string gnuplot-program-args)))
-          gnuplot-process (get-buffer-process gnuplot-buffer))
-    (set-process-query-on-exit-flag gnuplot-process nil)
-    (with-current-buffer gnuplot-buffer
-      (gnuplot-comint-mode)
-      (when gnuplot-inline-image-mode
-        (sleep-for (* 10 gnuplot-delay))
-        (gnuplot--setup-comint-for-image-mode)))))
-
-(defvar gnuplot--prompt-regexp
-  (regexp-opt '("gnuplot> " "multiplot> "))
-  "Regexp for recognizing the GNUPLOT prompt.")
-
-(defun gnuplot--protect-prompt-fn (_string)
-  "Prevent the Gnuplot prompt from being deleted or overwritten.
-STRING is the text as originally inserted in the comint buffer."
-  (save-excursion
-    (goto-char (point-max))
-    (beginning-of-line)
-    (let ((b (point)) e)
-      (when (re-search-forward gnuplot--prompt-regexp (point-max) t)
-        (setq e (point))
-        (put-text-property b e 'rear-nonsticky '(read-only intangible face))
-        (put-text-property b e 'intangible t)
-        ;;(put-text-property b e 'read-only t)
-        ))))
-
-(defun gnuplot--close-down ()
-  "Tidy up when deleting the gnuplot buffer."
-  (if (and gnuplot-process
-           (eq (process-status gnuplot-process) 'run))
-      (kill-process gnuplot-process))
-  (setq gnuplot-process nil
-        gnuplot-buffer nil))
-
-(defun gnuplot-delchar-or-maybe-eof (arg)
-  "Delete ARG characters forward, or (if at eob) send an EOF to subprocess.
-This is very similar to `comint-delchar-or-maybe-eof'."
-  (interactive "p" gnuplot-comint-mode)
-  (if (eobp)
-      (gnuplot-kill-comint-buffer)
-    (delete-char arg)))
-
-(defun gnuplot-kill-comint-buffer ()
-  "Kill the gnuplot process and its display buffers."
-  (interactive)
-  (if (and gnuplot-process
-           (eq (process-status gnuplot-process) 'run))
-      (kill-process gnuplot-process))
-  (when (and gnuplot-buffer (get-buffer gnuplot-buffer))
-    (if (one-window-p) ()
-      (delete-window (get-buffer-window gnuplot-buffer)))
-    (kill-buffer gnuplot-buffer))
-  (setq gnuplot-process nil
-        gnuplot-buffer nil))
-
-(defun gnuplot-show-comint-buffer ()
-  "Switch to the buffer containing the gnuplot process.
-When `gnuplot-display-process' is nil this will switch to
-the gnuplot process buffer.  When that variable is non-nil, the
-gnuplot process buffer will be displayed in a window."
-  (interactive)
-  (unless (and gnuplot-buffer (get-buffer gnuplot-buffer))
-    (gnuplot--make-comint-buffer))
-  (cond ((equal gnuplot-display-process 'window)
-         (switch-to-buffer-other-window gnuplot-buffer))
-        ((equal gnuplot-display-process 'frame)
-         (or (frame-live-p gnuplot--process-frame)
-             (setq gnuplot--process-frame (make-frame)))
-         (raise-frame gnuplot--process-frame)
-         (select-frame gnuplot--process-frame)
-         (switch-to-buffer gnuplot-buffer))
-        (t
-         (switch-to-buffer gnuplot-buffer))))
-
-
-;;; Support for displaying plotted images within Emacs
-
-(defvar gnuplot--inline-image-filename nil
-  "Name of the current Gnuplot output file.")
-
-(defun gnuplot-external-display-mode ()
-  "Display image in external."
-  (interactive nil gnuplot-mode gnuplot-comint-mode)
-  (gnuplot--set-display-mode 'gnuplot-inline-image-mode nil))
-
-(defun gnuplot-inline-display-mode ()
-  "Display image in inline."
-  (interactive nil gnuplot-mode gnuplot-comint-mode)
-  (gnuplot--set-display-mode 'gnuplot-inline-image-mode 'inline))
-
-(defun gnuplot-dedicated-display-mode ()
-  "Display image in dedicated."
-  (interactive nil gnuplot-mode gnuplot-comint-mode)
-  (gnuplot--set-display-mode 'gnuplot-inline-image-mode 'dedicated))
-
-(defun gnuplot-set-image-format (format)
-  "Display image in FORMAT."
-  (interactive "sGnuplot image format: " gnuplot-mode gnuplot-comint-mode)
-  (gnuplot--set-display-mode 'gnuplot-image-format format)
-  (unless gnuplot-inline-image-mode
-    (message "Setting will take effect when plots are displayed in Emacs")))
-
-(defun gnuplot--setup-comint-for-image-mode ()
-  "Setup comint for image."
-  (when (and (buffer-live-p gnuplot-buffer) (get-buffer-process gnuplot-buffer))
-    (with-current-buffer gnuplot-buffer
-      (if gnuplot-inline-image-mode
-          (progn
-            (gnuplot-send-hiding-output
-             (format "set terminal %s\n" gnuplot-image-format))
-            (gnuplot--inline-image-set-output)
-            (add-hook 'comint-output-filter-functions
-                      #'gnuplot--insert-inline-image-output nil t))
-        (gnuplot-send-hiding-output "set terminal pop\n")
-        (remove-hook 'comint-output-filter-functions
-                     #'gnuplot--insert-inline-image-output t)))))
-
-(defun gnuplot--inline-image-set-output ()
-  "Set Gnuplot's output file to `gnuplot--inline-image-filename'."
-  (let ((tmp (make-temp-file "gnuplot")))
-    (setq gnuplot--inline-image-filename tmp)
-    (gnuplot-send-hiding-output (format "set output '%s'\n" tmp))))
-
-(defvar gnuplot--inhibit-filter nil)
-
-(defun gnuplot--insert-inline-image-output (_string)
-  "Insert Gnuplot graphical output STRING in the gnuplot-comint buffer.
-
-Called via `comint-preoutput-filter-functions' hook when
-`gnuplot-inline-image-mode' is enabled.  Checks the status of the
-file `gnuplot--inline-image-filename'; if it exists and has
-nonzero size, inserts it as an inline image, stores a new
-temporary filename in `gnuplot--inline-image-filename', and
-updates Gnuplot with the appropriate \"set output\" command."
-  (unless gnuplot--inhibit-filter        ; Prevent recursively entering this filter
-    (let ((gnuplot--inhibit-filter t))   ; (causing an infinite loop)
-      (save-excursion
-        (goto-char (point-max))
-        (beginning-of-line)
-        (when (looking-at gnuplot--prompt-regexp)
-          (let* ((filename gnuplot--inline-image-filename)
-                 (size (nth 7 (file-attributes filename))))
-            (when (and size (> size 0))
-              (gnuplot-send-hiding-output "set output\n") ; Flush output file
-              (sit-for 0.1)             ; Hack: wait for Gnuplot IO to finish
-              (cl-ecase gnuplot-inline-image-mode
-                ((nil) nil)
-                (inline
-                  (ignore-errors
-                    (let ((image (create-image filename)))
-                      (beginning-of-line)
-                      (insert-image image)
-                      (insert "\n")
-                      (gnuplot--inline-image-set-output))))
-                (dedicated
-                 (with-current-buffer (get-buffer-create gnuplot-image-buffer)
-                   (let ((inhibit-read-only t))
-                     (erase-buffer)
-                     (insert-file-contents filename)
-                     (ignore-errors (normal-mode))
-                     (display-buffer (current-buffer))
-                     (gnuplot--inline-image-set-output))))))))))))
-
-(defun gnuplot-send-hiding-output (string)
-  "Send STRING to the running Gnuplot process invisibly."
-  (with-current-buffer gnuplot-buffer
-    (add-hook 'comint-preoutput-filter-functions
-              #'gnuplot--discard-output nil t))
-  (with-current-buffer (get-buffer-create gnuplot-hidden-output-buffer)
-    (erase-buffer))
-  (comint-send-string (get-buffer-process gnuplot-buffer) string))
-
-(defun gnuplot--discard-output (string)
-  "Temporary preoutput filter for hiding Gnuplot output & prompt.
-Accumulates output STRING in a buffer until it finds the next prompt,
-then removes itself from `comint-preoutput-filter-functions'."
-  (with-current-buffer
-      (get-buffer-create gnuplot-hidden-output-buffer)
-    (insert string)
-    (when (looking-back gnuplot--prompt-regexp (point-min))
-      (with-current-buffer gnuplot-buffer
-        (remove-hook 'comint-preoutput-filter-functions
-                     #'gnuplot--discard-output t))))
-  "")
-
-
-;;; --- miscellaneous functions: insert file name, indentation, negation
-
-(defun gnuplot-insert-filename ()
-  "Insert a filename at point, prompting for name in the minibuffer.
-This inserts a filename relative to the buffer's default directory.
-Uses completion and the value of `gnuplot-quote-character'.
-Bound to \\[gnuplot-insert-filename]"
-  (interactive nil gnuplot-mode gnuplot-comint-mode)
-  (insert gnuplot-quote-character
-          (file-relative-name (read-file-name "Filename > " "")
-                              default-directory)
-          gnuplot-quote-character))
-
-;; Adjust indentation for the line containing point
-(defun gnuplot-indent-line ()
-  "Set indentation in gnuplot buffer.
-For most lines, set indentation to previous level of indentation.
-Add additional indentation for continuation lines."
-  (interactive nil gnuplot-mode)
-  (let (indent)
-    (if (gnuplot--in-string (line-beginning-position))
-        ;; Continued strings begin at left margin
-        (setq indent 0)
-      (save-excursion
-        (if (gnuplot--continuation-line-p)
-            ;; This is a continuation line. Indent to the same level as
-            ;; the second word on the line beginning this command (i.e.,
-            ;; the first non-whitespace character after whitespace)
-            (progn
-              (gnuplot--beginning-of-continuation)
-              (back-to-indentation)
-              (re-search-forward "\\S-+\\s-+" (line-end-position) 'end-at-limit)
-              (setq indent (current-column)))
-
-          ;; Not a continuation line; indent according to block
-          ;; nesting depth
-          (save-excursion
-            (condition-case nil
-                (progn
-                  (beginning-of-line)
-                  (skip-syntax-forward "-" (line-end-position))
-                  (if (looking-at "\\s)") (forward-char))
-                  (backward-up-list)
-                  (gnuplot--beginning-of-continuation)
-                  (setq indent (+ gnuplot-basic-offset (current-indentation))))
-              (error
-               (setq indent 0)))))))
-
-    ;; Set indentation
-    (save-excursion
-      (indent-line-to indent))
-
-    ;; Move point after indentation when at beginning of line
-    (when (< (current-column) indent)
-      (move-to-column indent))))
-
-(defun gnuplot-electric-insert (BRACE)
-  "Adjust indentation on inserting a close BRACE.
-The blink-paren fix is stolen from cc-mode"
-  (interactive "*p" gnuplot-mode)
-  (let ((old-blink-paren blink-paren-function)
-        (blink-paren-function nil))
-    (self-insert-command BRACE)
-    (gnuplot-indent-line)
-    (when old-blink-paren (funcall old-blink-paren))))
-
-;;
-;; Functions for finding the start and end of continuation blocks
-;;
-
-;; Check if line containing point is a continuation
-(defun gnuplot--continuation-line-p ()
-  "Return t if the line containing point is a continuation of the previous line."
-  (save-excursion
-    (condition-case ()
-        (progn
-          (end-of-line 0)
-          (backward-char)
-          (looking-at "\\\\"))
-      (error nil))))
-
-;; Move point to start of continuation block
-(defun gnuplot--beginning-of-continuation ()
-  "Move point to the beginning of the continuation lines containing point.
-
-If not in a continuation line, move point to beginning of line."
-  (beginning-of-line)
-  (while (gnuplot--continuation-line-p)
-    (beginning-of-line 0)))
-
-;; Move point to end of continuation block
-(defun gnuplot--end-of-continuation ()
-  "Move point to the end of the continuation lines containing point.
-
-If there are no continuation lines, move point to `end-of-line'."
-  (end-of-line)
-  (unless (bobp)
-    (catch 'eob
-      (while (save-excursion (backward-char)
-                             (looking-at "\\\\"))
-        (end-of-line 2)
-        (if (eobp) (throw 'eob nil))))))
-
-;; Save-excursion wrappers for the above to return point at beginning
-;; or end of continuation
-(defun gnuplot--point-at-beginning-of-continuation (&optional pos)
-  "Return value of point at beginning of the continued block containing point.
-
-If there are no continuation lines, returns `line-beginning-position'.
-If specify POS, move POS befere execution."
-  (save-excursion
-    (when pos (goto-char pos))
-    (gnuplot--beginning-of-continuation)
-    (point)))
-
-(defun gnuplot--point-at-end-of-continuation (&optional pos)
-  "Return value of point at the end of the continued block containing point.
-
-If there are no continuation lines, returns `line-end-position'.
-If specify POS, move POS before execution."
-  (save-excursion
-    (when pos (goto-char pos))
-    (gnuplot--end-of-continuation)
-    (point)))
-
-(defun gnuplot--beginning-of-defun (&optional arg)
-  "We also treat a block of continuation lines as a `defun'.
-ARG is optional arg."
-  (unless arg (setq arg 1))
-  (if (> arg 0)
-      (catch 'bob               ; go to beginning of ARGth prev. defun
-        (dotimes (_n arg)
-          (when (= (point)
-                   (gnuplot--point-at-beginning-of-continuation))
-            (forward-line -1)
-            (if (bobp) (throw 'bob t))
-            (while (looking-at "^\\s-*$")
-              (forward-line -1)
-              (if (bobp) (throw 'bob t))))
-          (gnuplot--beginning-of-continuation))
-        t)
-
-    (catch 'eob                   ; find beginning of (-ARG)th following defun
-      (dotimes (_n (- arg))
-        (gnuplot--end-of-continuation)
-        (forward-line)
-        (if (eobp) (throw 'eob t))
-        (while (looking-at "^\\s-*$")
-          (forward-line)
-          (if (eobp) (throw 'eob t)))))))
-
-;; Movement to start or end of command, including multiple commands
-;; separated by semicolons
-(defun gnuplot--beginning-of-command ()
-  "Move point to beginning of command containing point."
-  (let ((limit (gnuplot--point-at-beginning-of-continuation)))
-    (while
-        (and
-         (search-backward ";" limit 'lim)
-         (gnuplot--in-string-or-comment)))
-    (skip-chars-forward ";")
-    (skip-syntax-forward "-")))
-
-(defun gnuplot--end-of-command ()
-  "Move point to end of command containing point."
-  (let ((limit (gnuplot--point-at-end-of-continuation)))
-    (while
-        (and
-         (search-forward ";" limit 'lim)
-         (gnuplot--in-string-or-comment)))
-    (skip-chars-backward ";")
-    (skip-syntax-backward "-")))
-
-(defun gnuplot--point-at-beginning-of-command ()
-  "Return position at the beginning of command containing point."
-  (save-excursion (gnuplot--beginning-of-command) (point)))
-
-(defun gnuplot--point-at-end-of-command ()
-  "Return position at the end of command containing point."
-  (save-excursion (gnuplot--end-of-command) (point)))
-
-(defun gnuplot-negate-option ()
-  "Append \"no\" to or remove \"no\" from the set option on the current line.
-This checks if the set option is one which has a negated form.
-
-Negatable options are defined in `gnuplot--keywords-negatable-options'."
-  (interactive nil gnuplot-mode gnuplot-comint-mode)
-  (let ((begin (gnuplot--point-at-beginning-of-command))
-        (end   (gnuplot--point-at-end-of-command))
-        (regex gnuplot--negatable-options-regexp))
-    (save-excursion
-      (goto-char begin)
-      (skip-syntax-forward "-" end)
-      (if (looking-at "\\(un\\)?set\\s-+")
-          (cond ((looking-at "unset")
-                 (delete-char 2))
-                ((looking-at (concat "set\\s-+\\(" regex "\\)"))
-                 (insert "un"))
-                (t
-                 (message "There is not a negatable set option on this line")))
-        (message "There is not a set option on this line")))))
-
-(defun gnuplot-customize ()
-  "Customize `gnuplot-mode'."
-  (interactive nil gnuplot-mode gnuplot-comint-mode)
-  (customize-group "gnuplot"))
-
-
-;;; --- help from the info file, keyword list + completion, insert function
-
-(defun gnuplot--setup-info-look ()
-  "Setup info-look in the gnuplot buffer.
-Also set the variable `gnuplot--info-keywords'."
-  ;; TODO Update info layout
-  (let ((doc-spec
-         '(("(gnuplot)Command_Index"   nil "[_a-zA-Z0-9]+")
-           ("(gnuplot)Options_Index"   nil "[_a-zA-Z0-9]+")
-           ("(gnuplot)Function_Index"  nil "[_a-zA-Z0-9]+")
-           ("(gnuplot)Terminal_Index"  nil "[_a-zA-Z0-9]+"))))
-    (info-lookup-add-help
-     :mode 'gnuplot-mode :topic 'symbol
-     :regexp "[a-zA-Z][_a-zA-Z0-9]*"
-     :doc-spec doc-spec)
-    (info-lookup-add-help
-     :mode 'gnuplot-comint-mode :topic 'symbol
-     :regexp "[a-zA-Z][_a-zA-Z0-9]*"
-     :doc-spec doc-spec))
-
-  (let ((there (bufferp (get-buffer "*info*"))))
-    (info-lookup-setup-mode 'symbol 'gnuplot-mode)
-    (or there (and (get-buffer "*info*") (kill-buffer "*info*")))
-    ;; why are these buffers here?  I think that the general
-    ;; user will not want them lying around
-    (and (get-buffer "info dir")    (kill-buffer "info dir"))
-    (and (get-buffer "info dir<2>") (kill-buffer "info dir<2>")))
-  (setq gnuplot--info-keywords (gnuplot--set-keywords-list)))
-
-(defun gnuplot--set-keywords-list ()
-  "Set `gnuplot--info-keywords' from `info-lookup-cache'.
-Return a list of keywords."
-  (let* ((list (cdr (assoc 'symbol info-lookup-cache)))
-         (list (cdr (cdr (assoc 'gnuplot-mode list))))
-         (list (car list))
-         (store ()) item)
-    (while list
-      (setq item (car (car list))
-            item (format "%s" item) ; keep this line for the sake of
-            store (append (list item) store) ; info-look.el w/o my patch
-            list  (cdr list)))
-    (delete "nil" store)
-    store ))
-
-
-;;;; Completion at point and Eldoc.
-
-;; There are two alternative completion-at-point mechanisms: the old
-;; one using info-look and the new one (enabled by default) which
-;; parses the command line to provide smarter completions.
-
-;; Older completion method using info-look
-(defun gnuplot-completion-at-point-info-look ()
-  "Return completions of keyword preceding point.
-
-Uses the cache of keywords generated by `info-lookup'.  See
-`gnuplot--setup-info-look'.  If non-nil, the return value is in the form
-\(BEGIN END COMPLETIONS) where BEGIN and END are buffer
-positions and COMPLETIONS is a list."
-
-  (when (eq gnuplot--info-keywords 'pending)
-    (gnuplot--setup-info-look))
-  (list (condition-case _err
-            (save-excursion (backward-sexp 1) (point))
-          (error (point)))
-        (point) gnuplot--info-keywords))
-
-
-(defun gnuplot-info-lookup-symbol (symbol &optional mode)
-  "Wrapper for `info-lookup-symbol'.
-Takes SYMBOL and MODE as arguments exactly as
-`info-lookup-symbol'.  After doing the info lookup, calls
-`gnuplot--adjust-info-display' to display the info buffer
-according to the value of `gnuplot-info-display'."
-  (interactive
-   (progn
-     (when (eq gnuplot--info-keywords 'pending)
-       (gnuplot--setup-info-look))
-     (info-lookup-interactive-arguments 'symbol))
-   gnuplot-mode gnuplot-comint-mode)
-  (when (eq gnuplot--info-keywords 'pending)
-    (gnuplot--setup-info-look))
-  (unless symbol (setq symbol "Commands"))
-  (save-window-excursion
-    (info-lookup-symbol symbol mode))
-  (gnuplot--adjust-info-display))
-
-(defun gnuplot--adjust-info-display ()
-  "Displays the *info* buffer in a window or frame.
-Specified by the value of `gnuplot-info-display'.
-If `gnuplot-info-display' is `window', then the window will be
-shrunk to the size of the info entry if it is smaller than half
-the height of the frame.
-
-The *info* buffer should already exist when this function is
-called."
-  (cl-case gnuplot-info-display
-    (window
-     (switch-to-buffer-other-window "*info*")
-     ;; Adjust window height only if the frame is split
-     ;; horizontally, so as not to mess up the minibuffer
-     ;; we can't use shrink-window-if-larger-than-buffer here
-     ;; because it doesn't work with Info mode's narrowing
-     (with-selected-window (get-buffer-window "*info*")
-       (unless (window-full-height-p)
-         (enlarge-window
-          (min (- (count-lines (point-min) (point-max)) (window-height) -1)
-               (- (/ (frame-height) 2) (window-height)))))))
-
-    (frame
-     (unless (frame-live-p gnuplot--info-frame)
-       (setq gnuplot--info-frame (make-frame)))
-     (select-frame gnuplot--info-frame)
-     (raise-frame gnuplot--info-frame)
-     (switch-to-buffer "*info*"))
-
-    (t
-     (switch-to-buffer "*info*"))))
-
-(defun gnuplot-insert (string)
-  "Insert STRING at point and display help for for STRING.
-Help is not shown if `gnuplot-insertions-show-help-flag' is nil.  The
-help shown is for STRING unless STRING begins with the word \"set\" or
-\"show\", in which case help is shown for the thing being set or
-shown."
-  (insert string)
-  (let ((topic string) term)
-    (when (string-match
-           "\\(set\\|show\\)[ \t]+\\([^ \t]+\\)\\(\\s-+\\([^ \t]+\\)\\)?"
-           string)
-      (setq topic (downcase (match-string 2 string))
-            term            (match-string 4 string))
-      (if (equal topic "terminal") (setq topic (downcase term))))
-    (cond ((bound-and-true-p gnuplot-gui-popup-flag)
-           (gnuplot-gui-set-options-and-insert))
-          (gnuplot-insertions-show-help-flag
-           (when (eq gnuplot--info-keywords 'pending)
-             (gnuplot--setup-info-look))
-           (gnuplot-info-lookup-symbol topic)))))
-
-(defun gnuplot-toggle-info-display ()
-  "Toggle info display."
-  (interactive nil gnuplot-mode)
-  (setq gnuplot-insertions-show-help-flag (not gnuplot-insertions-show-help-flag))
-  (message (if gnuplot-insertions-show-help-flag
-               "Help will be displayed after insertions."
-             "Help no longer displayed after insertions.")))
-
-(defun gnuplot--setup-insertions-menu ()
-  "Initial setup of insertions menu."
-  (when (and gnuplot-insertions-menu-flag (not gnuplot--insertions-menu))
-    (easy-menu-define gnuplot--insertions-menu gnuplot-mode-map
-      "Insertions menu used in Gnuplot-mode"
-      `("Insertions"
-        ,@gnuplot-insertions-top
-        ,gnuplot-insertions-adornments
-        ,gnuplot-insertions-plot-options
-        ,gnuplot-insertions-terminal
-        ,gnuplot-insertions-x-axis
-        ,gnuplot-insertions-y-axis
-        ,gnuplot-insertions-z-axis
-        ,gnuplot-insertions-x2-axis
-        ,gnuplot-insertions-y2-axis
-        ,gnuplot-insertions-parametric-plots
-        ,gnuplot-insertions-polar-plots
-        ,gnuplot-insertions-surface-plots
-        ,@gnuplot-insertions-bottom))))
-
-(defun gnuplot--mark-active ()
-  "Return non-nil if the mark is active and it is not equal to point."
-  (condition-case nil
-      (and (mark) (/= (mark) (point)))
-    (error nil)))
-
-
-;;; --- autoloaded functions: gnuplot-mode and gnuplot-make-buffer
-
-;;;###autoload
-(define-derived-mode gnuplot-mode prog-mode "Gnuplot"
-  "Major mode for editing and executing GNUPLOT scripts.
-This was written with version 4.6 of gnuplot in mind, but should
-work with newer and older versions.
-
-Report bugs at https://github.com/emacs-gnuplot/gnuplot/issues
-
-                            ------O------
-
-Gnuplot-mode includes two different systems for keyword completion and
-documentation lookup: a newer one, `gnuplot-context-sensitive-mode' ,
-which is enabled by default, and a older one which extracts keywords
-from gnuplot's Info file.  Both systems allow looking up documentation
-in the Info file.  With the context-sensitive mode active,
-`gnuplot-mode' can also provide Eldoc syntax hints as you type.
-
-                            ------O------
-
-There are several known shortcomings of `gnuplot-mode', version 0.5g
-and up.  Many of the shortcomings involve the graphical interface
-\(refered to as the GUI) to setting arguments to plot options.  Here is
-a list:
-
- 1.  Currently there is no way for `gnuplot-mode' to know if information
-     sent to gnuplot was correctly plotted.
- 2.  \"plot\", \"splot\", and \"fit\" are handled in the GUI, but are
-     a bit flaky.  Their arguments may not be read correctly from
-     existing text, and continuation lines (common for plot and splot)
-     are not supported.
- 3.  The GUI does not know how to read from continuation lines.
- 4.  Comma separated position arguments to plot options are
-     unsupported in the GUI.  Colon separated datafile modifiers (used
-     for plot, splot, and fit) are not supported either.  Arguments
-     not yet supported by the GUI generate messages printed in grey
-     text.
- 5.  The GUI handling of \"hidden3d\" is flaky and \"cntrparam\" is
-     unsupported."
-  (setq-local comment-start "# "
-              comment-end ""
-              comment-column 32
-              comment-start-skip "#[ \t]*"
-              indent-line-function #'gnuplot-indent-line
-              beginning-of-defun-function #'gnuplot--beginning-of-defun
-              end-of-defun-function #'gnuplot--end-of-continuation
-              syntax-propertize-function #'gnuplot--syntax-propertize
-              font-lock-defaults gnuplot-font-lock-defaults
-              font-lock-multiline t
-              parse-sexp-lookup-properties t
-              comint-process-echoes gnuplot-echo-command-line-flag)
-  (add-hook 'completion-at-point-functions #'gnuplot-completion-at-point-info-look nil t)
-  (add-hook 'syntax-propertize-extend-region-functions
-            #'gnuplot--syntax-propertize-extend-region nil t)
-  (setq gnuplot--comint-recent-buffer (current-buffer))
-  (gnuplot--setup-insertions-menu))
-
-;;;###autoload
-(defun gnuplot-make-buffer ()
-  "Open a new buffer in `gnuplot-mode'.
-When invoked, it switches to a new, empty buffer visiting no file
-and then starts `gnuplot-mode'.
-
-It is convenient to bind this function to a global key sequence.  For
-example, to make the F10 key open a gnuplot script buffer, put the
-following in your .emacs file:
-     (global-set-key [(f10)] \\='gnuplot-make-buffer)"
-  (interactive)
-  (switch-to-buffer gnuplot-gnuplot-buffer)
-  (gnuplot-mode))
-
-;;;###autoload
-(defun run-gnuplot ()
-  "Run an inferior Gnuplot process."
-  (interactive)
-  (gnuplot-show-comint-buffer))
-
-;;;###autoload
-(progn
-  (add-to-list 'auto-mode-alist '("\\.gp\\'" . gnuplot-mode))
-  (add-to-list 'interpreter-mode-alist '("gnuplot" . gnuplot-mode)))
-
-(provide 'gnuplot)
-;;; gnuplot.el ends here
diff --git a/elpa/gnuplot-20250724.1531/gnuplot.info b/elpa/gnuplot-20250724.1531/gnuplot.info
deleted file mode 100644
index f132fd30..00000000
--- a/elpa/gnuplot-20250724.1531/gnuplot.info
+++ /dev/null
@@ -1,26562 +0,0 @@
-This is gnuplot.info, produced by makeinfo version 6.8 from
-gnuplot.texi.
-
-INFO-DIR-SECTION Math
-START-INFO-DIR-ENTRY
-* GNUPLOT: (gnuplot).             An Interactive Plotting Program
-END-INFO-DIR-ENTRY
-
-
-File: gnuplot.info,  Node: Top,  Next: Gnuplot,  Prev: (dir),  Up: (dir)
-
-Master Menu
-***********
-
-                            GNUPLOT
-
-                 An Interactive Plotting Program
-                  Thomas Williams & Colin Kelley
-                     Version 5.0 organized by
-            Ethan A Merritt with help from many others
-
-        Copyright (C) 1986 - 1993, 1998, 2004   Thomas Williams, Colin Kelley
-                Copyright (C) 2004 - 2012  various authors
-
-            Mailing list for comments: gnuplot-info@lists.sourceforge.net
-          Mailing list for bug reports: gnuplot-bugs@lists.sourceforge.net
-
-              This manual was originally prepared by Dick Crawford
-                        Version 5.0 - March 2014
-
-
-     Major contributors (alphabetic order):
-
-* Menu:
-
-* Gnuplot::
-* Plotting_styles::
-* Commands::
-* Terminal_types::
-* Concept_Index::
-* Command_Index::
-* Options_Index::
-* Function_Index::
-* Terminal_Index::
-
-
-File: gnuplot.info,  Node: Gnuplot,  Next: Plotting_styles,  Prev: Top,  Up: Top
-
-1 Gnuplot
-*********
-
-bugs (https://sourceforge.net/p/gnuplot/bugs) &nbsp;&nbsp; feature
-requests (https://sourceforge.net/p/gnuplot/feature-requests)
-
-* Menu:
-
-* Copyright::
-* Introduction::
-* Seeking-assistance_/_Bugs::
-* New_features_in_version_6::
-* Differences_between_versions_5_and_6::
-* Demos_and_Online_Examples::
-* Batch/Interactive_Operation::
-* Canvas_size::
-* Command-line-editing::
-* Comments::
-* Coordinates::
-* Datastrings::
-* Enhanced_text_mode::
-* Environment::
-* Expressions::
-* Fonts::
-* Glossary::
-* inline_data_and_datablocks::
-* iteration::
-* linetypes::
-* layers::
-* mouse_input::
-* Persist::
-* Plotting::
-* Plugins::
-* Scope_of_variables::
-* Start-up_(initialization)::
-* String_constants::
-* Substitution_and_Command_line_macros::
-* Syntax::
-* Time/Date_data::
-* Watchpoints_::
-
-
-File: gnuplot.info,  Node: Copyright,  Next: Introduction,  Prev: Gnuplot,  Up: Gnuplot
-
-1.1 Copyright
-=============
-
-         Copyright (C) 1986 - 1993, 1998, 2004, 2007  Thomas Williams, Colin Kelley
-         Copyright (C) 2004-2024  various authors
-
-
-   Permission to use, copy, and distribute this software and its
-documentation for any purpose with or without fee is hereby granted,
-provided that the above copyright notice appear in all copies and that
-both that copyright notice and this permission notice appear in
-supporting documentation.
-
-   Permission to modify the software is granted, but not the right to
-distribute the complete modified source code.  Modifications are to be
-distributed as patches to the released version.  Permission to
-distribute binaries produced by compiling modified sources is granted,
-provided you
-       1. distribute the corresponding source modifications from the
-        released version in the form of a patch file along with the binaries,
-       2. add special version identification to distinguish your version
-        in addition to the base release version number,
-       3. provide your name and address as the primary contact for the
-        support of your modified version, and
-       4. retain our contact information in regard to use of the base software.
-
-   Permission to distribute the released version of the source code
-along with corresponding source modifications in the form of a patch
-file is granted with same provisions 2 through 4 for binary
-distributions.
-
-   This software is provided "as is" without express or implied warranty
-to the extent permitted by applicable law.
-
-           AUTHORS
-                   Original Software:
-                      Thomas Williams,  Colin Kelley.
-                   Gnuplot 2.0 additions:
-                      Russell Lang, Dave Kotz, John Campbell.
-                   Gnuplot 3.0 additions:
-                      Gershon Elber and many others.
-                   Gnuplot 4.0 and subsequent releases:
-                      See list of contributors at head of this document.
-
-
-
-File: gnuplot.info,  Node: Introduction,  Next: Seeking-assistance_/_Bugs,  Prev: Copyright,  Up: Gnuplot
-
-1.2 Introduction
-================
-
-'Gnuplot' is a portable command-line driven graphing utility for Linux,
-OS/2, MS Windows, macOS, VMS, and many other platforms.  The source code
-is copyrighted but freely distributed (i.e., you don't have to pay for
-it).  It was originally created to allow scientists and students to
-visualize mathematical functions and data interactively, but has grown
-to support many non-interactive uses such as web scripting.  It is also
-used as a plotting engine by third-party applications like Octave.
-Gnuplot has been supported and under active development since 1986.
-
-   Gnuplot can generate many types of plot in 2D and 3D. It can draw
-using lines, points, boxes, contours, vector fields, images, surfaces,
-and associated text.  It also supports specialized graphs such as heat
-maps, spider plots, polar projection, histograms, boxplots, bee swarm
-plots, and nonlinear coordinates.
-
-   Gnuplot supports many different types of output: interactive screen
-terminals (with mouse and hotkey input), direct output to pen plotters
-or modern printers, and output to many file formats (eps, emf, fig,
-jpeg, LaTeX, pdf, png, postscript, ...).  Gnuplot is easily extensible
-to include new output modes.  A recent example is support for webp
-animation.  Mouseable plots embedded in web pages can be generated using
-the svg or HTML5 canvas terminal drivers.
-
-   The command language of 'gnuplot' is case sensitive, i.e.  commands
-and function names written in lowercase are not the same as those
-written in capitals.  All command names may be abbreviated as long as
-the abbreviation is not ambiguous.  Any number of commands may appear on
-a line, separated by semicolons (;).  Strings may be set off by either
-single or double quotes, although there are some subtle differences.
-See 'syntax' and 'quotes' for more details.  Example:
-
-           set title "My First Plot";  plot 'data';  print "all done!"
-
-
-   Commands may extend over several input lines by ending each line but
-the last with a backslash (\).  The backslash must be the _last_
-character on each line.  The effect is as if the backslash and newline
-were not there.  That is, no white space is implied, nor is a comment
-terminated.  Therefore, commenting out a continued line comments out the
-entire command (see 'comments').  But note that if an error occurs
-somewhere on a multi-line command, the parser may not be able to locate
-precisely where the error is and in that case will not necessarily point
-to the correct line.
-
-   In this document, curly braces ({}) denote optional arguments and a
-vertical bar (|) separates mutually exclusive choices.  'Gnuplot'
-keywords or *note help:: topics are indicated by backquotes or
-'boldface' (where available).  Angle brackets (<>) are used to mark
-replaceable tokens.  In many cases, a default value of the token will be
-taken for optional arguments if the token is omitted, but these cases
-are not always denoted with braces around the angle brackets.
-
-   For built-in help on any topic, type *note help:: followed by the
-name of the topic or 'help ?'  to get a menu of available topics.
-
-   A large set of demo plots is available on the web page
-http://www.gnuplot.info/demo/ (http://www.gnuplot.info/demo/) When run
-from command line, gnuplot is invoked using the syntax
-           gnuplot {OPTIONS} file1 file2 ...
-
-   where file1, file2, etc.  are input files as in the 'load' command.
-Options interpreted by gnuplot may come anywhere on the line.  Files are
-executed in the order specified, as are commands supplied by the -e
-option, for example
-           gnuplot   file1.in   -e "reset"   file2.in
-
-
-   The special filename "-" is used to force reading from stdin.
-'Gnuplot' exits after the last file is processed.  If no load files are
-named, 'Gnuplot' takes interactive input from stdin.  See help
-'batch/interactive' for more details.  See 'command-line-options' for
-more details, or type
-           gnuplot --help
-
-
-   In sessions with an interactive plot window you can hit 'h' anywhere
-on the plot for help about 'hotkeys' and 'mousing' features.
-
-
-File: gnuplot.info,  Node: Seeking-assistance_/_Bugs,  Next: New_features_in_version_6,  Prev: Introduction,  Up: Gnuplot
-
-1.3 Seeking-assistance / Bugs
-=============================
-
-The canonical gnuplot home page can be found at http://www.gnuplot.info
-(http://www.gnuplot.info)
-
-   Before seeking help, please check file FAQ.pdf or the above website
-for a FAQ (Frequently Asked Questions) list.
-(http://www.gnuplot.info/faq/)
-
-   Another resource for help with specific plotting problems (not bugs)
-is
-               https://stackoverflow.com/questions/tagged/gnuplot
-
-
-   Bug reports and feature requests should be uploaded to the trackers
-at
-               https://sourceforge.net/p/gnuplot/_list/tickets
-
-   Please check previous reports to see if the bug you want to report
-has already been fixed in a newer version.
-
-   When reporting a bug or posting a question, please include full
-details of the gnuplot version, the terminal type, and the operating
-system.  A short self-contained script demonstrating the problem is very
-helpful.
-
-   Instructions for subscribing to gnuplot mailing lists may be found
-via the gnuplot development website
-http://sourceforge.net/projects/gnuplot
-(http://sourceforge.net/projects/gnuplot)
-
-   Please note that before you write to any of the gnuplot mailing lists
-you must first subscribe to the list.  This helps reduce the amount of
-spam.
-
-   The address for mailing to list members is:
-               gnuplot-info@lists.sourceforge.net
-
-
-   A mailing list for those interested in the development version of
-gnuplot is:
-               gnuplot-beta@lists.sourceforge.net
-
-
-
-File: gnuplot.info,  Node: New_features_in_version_6,  Next: Differences_between_versions_5_and_6,  Prev: Seeking-assistance_/_Bugs,  Up: Gnuplot
-
-1.4 New features in version 6
-=============================
-
-Version 6 is the latest major release in a history of gnuplot
-development dating back to 1986.  It follows major version 5 (2015) and
-subsequent minor version releases 5.2 (2017) and 5.4 (2020).
-Development continues in a separate unreleased branch in the project git
-repository on SourceForge.
-
-   Some features described in this document are present only if chosen
-and configured at the time gnuplot is compiled from source.  To
-determine what configuration options were used to build the particular
-copy of gnuplot you are running, type 'show version long'.
-
-* Menu:
-
-* Function_blocks_and_scoped_variables::
-* Special_and_complex-valued_functions::
-* New_plot_styles::
-* Hulls::
-* Named_palettes::
-* New_data_formats::
-* New_built-in_functions_and_array_operations::
-* Program_control_flow::
-* Multiplots::
-* New_terminals_and_terminal_options::
-* Watchpoints::
-* Week-date_time_support::
-* Other_new_features::
-* Brief_summary_of_features_introduced_in_version_5::
-
-
-File: gnuplot.info,  Node: Function_blocks_and_scoped_variables,  Next: Special_and_complex-valued_functions,  Prev: New_features_in_version_6,  Up: New_features_in_version_6
-
-1.4.1 Function blocks and scoped variables
-------------------------------------------
-
-This version of gnuplot introduces a mechanism for invoking a block of
-standard gnuplot commands as a callable function.  A function block can
-accept from 0 to 9 parameters and returns a value.  Function blocks can
-be used to calculate and assign a new value to a variable, to combine
-with other functions and operators, or to perform a repetitive task
-preparing data.  There are three components to this mechanism.  See
-'local', 'scope', 'function blocks', *note return::.
-   * The 'local' qualifier allows optional declaration of a variable or
-     array whose scope is limited to the duration of execution of the
-     program unit in which it is found.  These units currently include
-     execution of a 'load' or *note call:: statement, function block
-     evaluation, and the code block in curly brackets following an *note
-     if::, 'else', 'do for', or 'while' statement.  If the name of a
-     local variable duplicates the name of a global variable, the global
-     variable is shadowed until exit from the local scope.
-   * The 'function' command declares a named function block (effectively
-     an array of strings) containing gnuplot commands.  When the
-     function block is invoked, commands are executed successively until
-     the end of the block or until a *note return:: command is
-     encountered.
-   * The 'return <expression>' command terminates execution of a
-     function block.  The result of evaluating <expression> is returned
-     as the value of the function.  Anywhere outside a function block
-     *note return:: acts like *note exit::.
-
-   For an example of using this mechanism to define and plot a
-non-trivial function that is too complicated for a simple one-line
-definition 'f(x) = ...'  please see 'function_block.dem'
-(http://www.gnuplot.info/demo_6.0/function_block.html)
-
-
-File: gnuplot.info,  Node: Special_and_complex-valued_functions,  Next: New_plot_styles,  Prev: Function_blocks_and_scoped_variables,  Up: New_features_in_version_6
-
-1.4.2 Special and complex-valued functions
-------------------------------------------
-
-Gnuplot 6 provides an expanded set of complex-valued functions and
-updated versions of some functions that were present in earlier
-versions.
-   * New: Riemann zeta function with complex domain and range.  See
-     *note zeta::.
-   * Updated lower incomplete gamma function with improved domain and
-     precision.  Complex arguments accepted.  See 'igamma'.
-   * New upper incomplete gamma function (real arguments only).  See
-     *note uigamma::.
-   * Updated incomplete beta function with improved domain and
-     precision.  See 'ibeta'.
-   * New function for the inverse incomplete gamma function.  See
-     'invigamma'.
-   * New function for the inverse incomplete beta function.  See
-     'invibeta'.
-   * New complex function LambertW(z,k) returns the kth branch of
-     multivalued function W_k(z).  Note that the older function
-     lambertw(x) = real(LambertW( real(z), 0 )).  See *note LambertW::.
-   * New complex function lnGamma(z).  Note that existing function
-     lgamma(x) = real(lnGamma(real(z)).  See *note lnGamma::.
-   * Complex function conj(z) returns the complex conjugate of z.
-   * Synchrotron function F(x), see 'SynchrotronF'.
-   * acosh(z) domain extended to cover negative real axis.
-   * asin(z) asinh(z) improved precision for complex arguments.
-   * Predefined variable I = sqrt(-1) = {0,1} for convenience.  This is
-     useful because gnuplot does not accept {a,b} as a valid complex
-     constant but does accept (a + b*I) as a valid complex expression.
-
-   Additional special functions are supported if a suitable external
-library is found at build time.  See 'special_functions'.
-   * Complex Bessel functions Iν(z), Jν(z), Kν(z), Yν(z) of order ν
-     (real) with complex argument z.  See 'BesselK'.
-   * Complex Hankel functions H1ν(z), H2ν(z) of order ν with complex z.
-     See 'BesselH1'.
-   * Complex Airy functions Ai(z), Bi(z).
-   * Complex exponential integral of order n.  See 'expint'.
-   * Fresnel integrals C(x) and S(x).  See 'FresnelC'.
-   * Function 'VP_fwhm(sigma,gamma)' returns the full width at half
-     maximum of the Voigt profile.  See 'VP', 'VP_fwhm'.
-
-
-File: gnuplot.info,  Node: New_plot_styles,  Next: Hulls,  Prev: Special_and_complex-valued_functions,  Up: New_features_in_version_6
-
-1.4.3 New plot styles
----------------------
-
-   * The plot style 'with surface' works in 2D polar coordinates to
-     produce a solid-fill gridded representation of the plane, colored
-     by weighted contributions from an arbitrary set of input points.
-     This is analogous to the use of *note dgrid3d:: and style 'with
-     pm3d' to produce a 3D gridded surface.  See 'set polar grid' and
-     'polar heatmap'.
-   * New 2D plot style *note sectors:: is an alternative to generating a
-     full polar gridded surface.  For each input data point it generates
-     a single annular wedge in a conceptual polar grid.  Unlike polar
-     mode 'with surface' it can be used in either a polar or cartesian
-     coordinate graph.
-   * New 2D plot style *note hsteps:: allows construction of step-like
-     plots with a variety of representations in addition to those
-     offered by existing styles *note steps::, *note histeps::, *note
-     fsteps::, and *note fillsteps::.  See *note hsteps::.
-   * Plot style 'with lines' now has a filter option 'sharpen'.  This
-     filter detects spikes in a function plot that appear truncated in
-     the output because the peak lies between two x-coordinates at which
-     the function has been sampled.  It adds a new sample point at the
-     location of each such peak.  See *note filters::.
-   * Although it is not strictly speaking a new plot style, the
-     combination of the concave hull filter with along-path smoothing of
-     filled areas allows creation of 'blobby region' plots showing, for
-     example, the extents of overlapping data clusters.  See
-     'concavehull'.
-   * 3D plot style 'with pm3d' accepts an optional modifier 'zclip
-     [zmin:zmax]' that selects only a slice of the full surface.
-     Successive plots with incremental changes to the clipping limits
-     can be used to animate a cross-sectional cutaway view in 3D or to
-     create a filled area contour map.  This is automated by a new plot
-     style *note contourfill:: that is particularly useful in 2D
-     projection.  See *note contourfill::.
-
-   D polargrid 4 DB D windrose 1 D sectors 4 DB D sharpen 1 D iris 2 DB
-D contourfill 4 DB D logic_timing 1 D rank_sequence 1
-
-
-File: gnuplot.info,  Node: Hulls,  Next: Named_palettes,  Prev: New_plot_styles,  Up: New_features_in_version_6
-
-1.4.4 Hulls, masks, and smoothing
----------------------------------
-
-   * A cluster of 2D points can be replaced by its bounding polygon
-     using the new filter 'convexhull'.  A path-smoothed bounding curve
-     can be plotted as a filled area using "convexhull smooth path with
-     filledcurves".  See 'convexhull'.
-   * An alternative filter 'concavehull' generates a bounding polygon
-     that is not necessarily convex; instead it forms a χ-shape
-     determined by a characteristic length parameter that controls the
-     degree of concavity.  This essentially draws a blob around the data
-     points.  See 'concavehull'.
-   * A convex hull or other polygon can be used as a mask to display
-     only selected portions of a pm3d surface or an image plot.  See new
-     plot style 'with mask' (defines a mask) and keyword 'mask' (applies
-     the mask to a subsequent plot component).
-   * curve smoothing using along-path cubic splines suitable for closed
-     curves or for 2D curves that are not monotonic on x.  See 'smooth
-     path'.  This allows smoothing of hulls and masks.
-   * cubic spline smoothing of 3D lines.  See 'splot smooth csplines'
-   * Smoothing options apply to plotting *note filledcurves::
-     {above|below|between}.
-   * New keyword 'period' for smoothing periodic data.  See 'smooth
-     kdensity'.
-   D convex_hull 2 D mask_pm3d 3 D smooth_path 2
-
-
-File: gnuplot.info,  Node: Named_palettes,  Next: New_data_formats,  Prev: Hulls,  Up: New_features_in_version_6
-
-1.4.5 Named palettes
---------------------
-
-   * The current palette can be saved to a named colormap for future
-     use.  See *note colormap::.
-   * pm3d and image plots can specify a previously saved palette by
-     name.  This permits the use of multiple palettes in a single plot
-     command.  See *note palette::.
-   * Named palette colormaps can be manipulated as arrays of 32-bit ARGB
-     color values.  This permits addition of alpha-channel values or
-     other modifications not easily specified in a *note palette::
-     command.
-   * There is a new predefined color scheme *note viridis::.
-   * Palettes read from a file or datablock ('set palette file') may be
-     specified either using fractional color components or 24-bit packed
-     RGB values.
-   D named_palettes 4 D viridis 1
-
-
-File: gnuplot.info,  Node: New_data_formats,  Next: New_built-in_functions_and_array_operations,  Prev: Named_palettes,  Up: New_features_in_version_6
-
-1.4.6 New data formats
-----------------------
-
-   * The 'sparse matrix=(cols,rows)' option to 'plot' and 'splot'
-     generates a uniform pixel grid into which individual pixel values
-     may be loaded in any order.  This is useful for plotting heat maps
-     from incomplete data.  See 'sparse'.
-   * During input of non-uniform matrix data, column(0) now returns the
-     linear ordering of matrix elements.  I.e.  for element A[i,j] in an
-     MxN matrix A, column(0)/M gives the row index i, and column(0)%M
-     gives the column index j.
-
-
-File: gnuplot.info,  Node: New_built-in_functions_and_array_operations,  Next: Program_control_flow,  Prev: New_data_formats,  Up: New_features_in_version_6
-
-1.4.7 New built-in functions and array operations
--------------------------------------------------
-
-   * 'palette(z)' returns the current RGB palette color mapping z into
-     cbrange.
-   * 'rgbcolor("name")' returns the 32bit ARGB value for a named color.
-   * 'index( Array, element )' returns the first index 'i' for which
-     Array[i] is equal to element.  See *note arrays::.
-   * User-defined functions allow an array as a parameter.  Example:
-     dot(A,B) = sum [i=1:|A|] A[i]*B[i]
-   * Array slices are generated by appending a range to the array name.
-     Array[n] is single element.  Array[n:n+5] is a six element slice of
-     the original array.  See *note arrays::, 'slice'.
-   * 'split("string", "separator")' unpacks the fields in a string into
-     an array of strings.  See *note split::.
-   * 'join(array, "separator")' is the complement to *note split::.  It
-     concatenates the elements of a string array into a single string
-     with field separators.  See *note join::.
-   * 'stats <non-existent file>' yields a testable value.  See 'stats
-     test'.
-   * 'stats $vgrid' finds min/max/mean/stddev of voxels in grid
-
-
-File: gnuplot.info,  Node: Program_control_flow,  Next: Multiplots,  Prev: New_built-in_functions_and_array_operations,  Up: New_features_in_version_6
-
-1.4.8 Program control flow
---------------------------
-
-   * New syntax 'if ...  else if ...  else ...'
-   * XDG base directory conventions for configuration preferences are
-     supported.  The program reads initial commands from
-     $XDG_CONFIG_HOME/gnuplot/gnuplotrc.  Session command history is
-     saved to $XDG_STATE_HOME/gnuplot_history.  If these files are not
-     found, $HOME/.gnuplot and $HOME/.gnuplot_history are used as in
-     previous gnuplot versions.
-   * *note warnings:: suppresses output of warning messages to stderr.
-   * 'warn "message"' prints filename, line number and message to
-     stderr.
-   * Exception handling for the "fit" command.  Control always returns
-     to the next line of input, even in the case of fit errors.  On
-     return, FIT_ERROR is non-zero if an error occurred.  This allows
-     scripted recovery from a bad fit.  See 'fit error_recovery'.
-
-
-File: gnuplot.info,  Node: Multiplots,  Next: New_terminals_and_terminal_options,  Prev: Program_control_flow,  Up: New_features_in_version_6
-
-1.4.9 Multiplots
-----------------
-
-Commands executed during initial creation of a multiplot are now stored
-in a datablock $GPVAL_LAST_MULTIPLOT. They can be replayed by the new
-command *note remultiplot::.  Certain saved commands that would be
-problematic during replay are not reexecuted.  Note that the regenerated
-multiplot may not exactly match the original if graphics settings (axis
-ranges, logscale, etc) have changed in the interim.
-
-   The following sequence of commands will save both the original
-graphics state and the multiplot commands to a script file that can be
-reloaded later.
-
-          save "my_multiplot.gp"
-          set multiplot
-          ... various commands to generate the component plots ...
-          unset multiplot
-          set print "my_multiplot.gp" append
-          print $GPVAL_LAST_MULTIPLOT
-          unset print
-
-
-   * The *note replot:: command will check to see if the most recent
-     plot command was part of a completed multiplot.  If so, it will
-     execute *note remultiplot:: instead of reexecuting that single plot
-     command.
-   * EXPERIMENTAL. Replot requests generated by window events, mouse
-     events, or hot keys in a displayed multiplot will call *note
-     remultiplot:: if appropriate.  This means, for example, that you
-     can now resize a multiplot displayed on the screen.  However the
-     mouse coordinate readout and thus zoom/pan operations are still
-     based solely on the axis settings for the final component plot, as
-     was the case in earlier gnuplot versions.  Because the commands
-     stored in $GPVAL_LAST_MULTIPLOT may not be sufficient to recreate
-     the appropriate graphics settings for each component plot, mousing
-     in a multiplot may not act as you would like.  This will be
-     improved in the future.
-
-
-File: gnuplot.info,  Node: New_terminals_and_terminal_options,  Next: Watchpoints,  Prev: Multiplots,  Up: New_features_in_version_6
-
-1.4.10 New terminals and terminal options
------------------------------------------
-
-   * New terminals 'kittygd' and 'kittycairo' provide in-window graphics
-     for terminal emulators that support the kitty protocol.  Kitty is
-     an alternative to sixel graphics that offers full 24-bit RGB color.
-     See 'kittycairo'.
-   * New terminal 'block' for text-mode pseudo-graphics uses Unicode
-     block or Braille characters to offer improved resolution compared
-     to the 'dumb' or 'caca' terminals.
-   * New terminal 'webp' generates a single frame or an animation
-     sequence using webp encoding.  Frames are generated using pngcairo,
-     then encoded through the WebPAnimEncoder API exported by libwebp
-     and libwebpmux.
-   * Terminals that use the same window for text entry and graphical
-     display, including 'dumb', 'sixel', 'kitty', and 'block' now
-     respond to keyboard input during a 'pause mouse' command.  While
-     paused, they interpret keystrokes in the same way that a mousing
-     terminal would.  See 'pseudo-mousing'.  For example the
-     left/right/up/down arrow keys change the view angle of 3D plots and
-     perform incremental pan/zoom steps for 2D plots.
-
-
-File: gnuplot.info,  Node: Watchpoints,  Next: Week-date_time_support,  Prev: New_terminals_and_terminal_options,  Up: New_features_in_version_6
-
-1.4.11 Watchpoints
-------------------
-
-Watchpoints are target values associated with individual plots in a
-graph.  As that plot is drawn, each component line segment is monitored
-to see if its endpoints bracket the target value of a watchpoint
-coordinate (x, y, or z) or function f(x,y).  If a match is found, the
-[x,y] coordinates of the match point are saved for later use.  See *note
-watchpoints::.  Possible uses include
-   * Find the intersection points of two curves
-   * Find zeros of a function
-   * Find and notate where a dependent variable (y or z) or function
-     f(x,y) crosses a threshold value
-   * Use the mouse to track values along multiple plots simultaneously
-   D watchpoints 2
-
-
-File: gnuplot.info,  Node: Week-date_time_support,  Next: Other_new_features,  Prev: Watchpoints,  Up: New_features_in_version_6
-
-1.4.12 Week-date time support
------------------------------
-
-The Covid-19 pandemic that began in 2020 generated increased interest in
-plotting epidemiological data, which is often tabulated using a "week
-date" reporting convention.  Deficiencies with gnuplot support for this
-convention were remedied and the support for week-date time was
-extended.
-   * Time specifier format %W has been brought into accord with the ISO
-     8601 week date standard.
-   * Time specifier format %U has been brought into accord with the
-     CDC/MMWR week date standard.
-   * New function 'tm_week(time, std)' returns ISO or CDC standard week
-     of year.
-   * New function 'weekdate_iso(year, week, day)' converts ISO standard
-     week date to calendar time.
-   * New function 'weekdate_cdc(year, week, day)' converts CDC standard
-     week date to calendar time.
-   D epi_data 1
-
-
-File: gnuplot.info,  Node: Other_new_features,  Next: Brief_summary_of_features_introduced_in_version_5,  Prev: Week-date_time_support,  Up: New_features_in_version_6
-
-1.4.13 Other new features
--------------------------
-
-   * 'Time units for setting major and minor tics.'  Both major and
-     minor tics along a time axis now accept tic intervals given in
-     units of minutes/hours/days/weeks/months/years.  See 'set xtics',
-     'set mxtics time'.
-   * The character sequence $# in a 'using' specifier evaluates to the
-     total number of columns available in the current line of data.  For
-     example 'plot FOO using 0:(column($# - 1))' plots the last-but-one
-     field of each row.
-   * keyword 'binvalue=avg' plots the average, rather than the sum, of
-     binned data.
-   * 'set colorbox bottom' places a horizontal color box underneath the
-     plot rather than a vertical box on the right.
-   * Improved rendering of intersecting pm3d surfaces - overlapping
-     surface tiles are split into two pieces along the line of
-     intersection so that tiles from one surface do not incorrectly
-     protrude though the other surface.
-   * User-controlled spotlight added to the pm3d lighting model.  See
-     'set pm3d spotlight'.
-   * New options to force total key width and number of columns.  See
-     'key layout'.
-   * 'set pm3d border retrace' draws a border around each pm3d
-     quadrangle in the same color as the filled area.  In principle this
-     should have no visible effect, but it prevents some display modes
-     like glitchy pdf or postscript viewers from introducing aliasing
-     artifacts.
-   * *note isotropic:: adjusts the axis scaling in both 2D and 3D plots
-     such that the x, y, and z axes all have the same scale.
-   * Change: Text rotation angle is not limited to integral degrees.
-   * Special (non-numerical) linetypes 'lt nodraw', 'lt black', 'lt
-     background' See 'special_linetypes'.
-   * Data-driven color assignments in histogram plots.  See 'histograms
-     colors'.
-   * The position of the key box can be manually tweaked by specifying
-     an offset to be added to whatever position the program would
-     otherwise use.  See 'set key offset'.
-   * A keyentry with text but no plot style can be used to generate a
-     secondary title in the key spanning the entire width of the key.
-     For example
-              `plot A, keyentry "left-justified text" left, B`
-
-     This can also be used to create a key with two columns of text by
-     providing both a text string and a title.  See 'keyentry'.
-
-
-File: gnuplot.info,  Node: Brief_summary_of_features_introduced_in_version_5,  Prev: Other_new_features,  Up: New_features_in_version_6
-
-1.4.14 Brief summary of features introduced in version 5
---------------------------------------------------------
-
-* Menu:
-
-* Features_introduced_in_5.4::
-* Features_introduced_in_5.2::
-* Features_introduced_in_5.0::
-
-
-File: gnuplot.info,  Node: Features_introduced_in_5.4,  Next: Features_introduced_in_5.2,  Prev: Brief_summary_of_features_introduced_in_version_5,  Up: Brief_summary_of_features_introduced_in_version_5
-
-1.4.14.1 Features introduced in 5.4
-...................................
-
-   * Expressions and functions use 64-bit integer arithmetic.  See
-     'integer'
-   * 2D plot styles *note polygons::, *note spiderplot::, 'arrows'
-   * 3D plot styles *note boxes::, *note circles::, *note polygons::,
-     *note isosurface:: and other representations of gridded voxel data
-   * Data preprocessing filter 'zsort'
-   * Construction of customized keys using 'keyentry'
-   * New LaTeX terminal pict2e supersedes older terminals 'latex',
-     'emtex', 'eepic', and 'tpic'.  The older terminals are no longer
-     built by default
-   * 'set pixmap' imports a png/jpeg/gif image as a pixmap that can be
-     scaled and positioned anywhere in a plot or on the page
-   * Enhanced text mode accepts \U+xxxx (xxxx is a 4 or 5 character
-     hexadecimal) as representing a Unicode code point that is converted
-     to the corresponding UTF-8 byte sequence on output
-   * Revised syntax for *note parallelaxes:: allows convenient iteration
-     inside the plot command, similar to plot styles 'histogram' and
-     *note spiderplot::
-
-
-File: gnuplot.info,  Node: Features_introduced_in_5.2,  Next: Features_introduced_in_5.0,  Prev: Features_introduced_in_5.4,  Up: Brief_summary_of_features_introduced_in_version_5
-
-1.4.14.2 Features introduced in 5.2
-...................................
-
-   * Nonlinear coordinate systems (see *note nonlinear::)
-   * Automated binning of data (see 'bins')
-   * 2D beeswarm plots.  See *note jitter::
-   * 3D plot style 'zerrorfill'
-   * 3D lighting model provides shading and specular highlighted (see
-     *note lighting::).
-   * Array data type, associated commands and operators.  See *note
-     arrays::.
-   * New terminals 'sixelgd', 'domterm'
-   * New format descriptors tH tM tS handle relative times (interval
-     lengths).  See 'time_specifiers'.
-
-
-File: gnuplot.info,  Node: Features_introduced_in_5.0,  Prev: Features_introduced_in_5.2,  Up: Brief_summary_of_features_introduced_in_version_5
-
-1.4.14.3 Features introduced in 5.0
-...................................
-
-   * Terminal independent dash types.
-   * The default sequence of colors used for successive elements in a
-     plot is more easily distinguished by users with color-vision
-     defects.
-   * New plot types *note parallelaxes::, *note table::.
-   * Hypertext labels activated by a mouse-over event.
-   * Explicit sampling ranges in 2D and 3D function plots and
-     pseudofiles '+' and '++'.
-   * Plugin support through new command *note import:: that attaches a
-     user-defined function name to a function provided by an external
-     shared object.
-
-
-File: gnuplot.info,  Node: Differences_between_versions_5_and_6,  Next: Demos_and_Online_Examples,  Prev: New_features_in_version_6,  Up: Gnuplot
-
-1.5 Differences between versions 5 and 6
-========================================
-
-Some changes introduced in version 5 could cause certain scripts written
-for earlier versions of gnuplot to fail or to behave differently.  There
-are very few such changes in version 6.
-
-* Menu:
-
-* Plot_style_details::
-* Deprecated_syntax::
-
-
-File: gnuplot.info,  Node: Plot_style_details,  Next: Deprecated_syntax,  Prev: Differences_between_versions_5_and_6,  Up: Differences_between_versions_5_and_6
-
-1.5.1 Plot style details
-------------------------
-
-Apart from adding entirely new plot styles, version 6 also makes a few
-tweaks to existing plot styles.
-   * More terminals (png/jpeg/sixel/kitty) scale the size of a "dot" by
-     the current line width.  Some other terminals already did this.
-   * Plot styles that draw error bars place a gap at the position of the
-     data point.  The size of the gap is controlled by *note
-     pointintervalbox::.
-   * Multiplots can now be redrawn or rescaled (see 'new multiplots').
-     Because of this it is no longer possible to read in-line data from
-     pseudofile '-'.  Use a data block instead.
-
-
-File: gnuplot.info,  Node: Deprecated_syntax,  Prev: Plot_style_details,  Up: Differences_between_versions_5_and_6
-
-1.5.2 Deprecated syntax
------------------------
-
-Deprecated in version 5.4, removed in 6.0
-           # use of a file containing *note reread:: to perform iteration
-           N = 0;  load "file-containing-reread";
-           file content:
-               N = N+1
-               plot func(N,x)
-               pause -1
-               if (N<5) reread
-
-   Current equivalent
-           do for [N=1:5] {
-               plot func(N, x)
-               pause -1
-           }
-
-
-   Deprecated in version 5.4, removed in 6.0
-           set dgrid3d ,,foo     # no keyword to indicate meaning of foo
-
-   Current equivalent
-           set dgrid3d qnorm foo # (example only; qnorm is not the only option)
-
-
-   Deprecated in version 5.0, not present in 6.0 unless built with
-configuration optione -enable-backward-compatibility
-           set style increment user
-
-   Current equivalent
-           use "set linetype" to redefine a convenient range of linetypes
-           explicit use of "linestyle N" or "linestyle variable"
-
-
-   Deprecated in version 5.0, removed in 6.0
-           set clabel
-
-   Current equivalent
-           `set clabel "format"` is replaced by `set cntrlabel format "format"`.
-           *note clabel:: is replaced by `set cntrlabel onecolor`.
-
-
-   Deprecated in version 5.0, removed in 6.0
-           show palette fit2rgbformulae
-
-
-
-File: gnuplot.info,  Node: Demos_and_Online_Examples,  Next: Batch/Interactive_Operation,  Prev: Differences_between_versions_5_and_6,  Up: Gnuplot
-
-1.6 Demos and Online Examples
-=============================
-
-The 'gnuplot' distribution contains a collection of examples in the
-'demo' directory.  You can browse on-line versions of these examples
-produced by the png, svg, and canvas terminals at
-http://gnuplot.info/demos (http://gnuplot.info/demos/) The commands that
-produced each demo plot are shown next to the plot, and the
-corresponding gnuplot script can be downloaded to serve as a model for
-generating similar plots.
-
-
-File: gnuplot.info,  Node: Batch/Interactive_Operation,  Next: Canvas_size,  Prev: Demos_and_Online_Examples,  Up: Gnuplot
-
-1.7 Batch/Interactive Operation
-===============================
-
-'Gnuplot' may be executed in either batch or interactive modes, and the
-two may even be mixed together.
-
-   Command-line arguments are assumed to be either program options or
-names of files containing 'gnuplot' commands.  Each file or command
-string will be executed in the order specified.  The special filename
-"-" is indicates that commands are to be read from stdin.  'Gnuplot'
-exits after the last file is processed.  If no load files and no command
-strings are specified, 'gnuplot' accepts interactive input from stdin.
-
-* Menu:
-
-* command_line_options::
-* Examples::
-
-
-File: gnuplot.info,  Node: command_line_options,  Next: Examples,  Prev: Batch/Interactive_Operation,  Up: Batch/Interactive_Operation
-
-1.7.1 command line options
---------------------------
-
-Gnuplot accepts the following options on the command line
-          -V, --version
-          -h, --help
-          -p, --persist
-          -d, --default-settings
-          -s, --slow
-          -e  "command1; command2; ..."
-          -c  scriptfile ARG1 ARG2 ...
-
-
-   -p tells the program not to close any remaining interactive plot
-windows when the program exits.
-
-   -d tells the program not to execute any private or system
-initialization (see 'initialization').
-
-   -s tells the program to wait for slow font initialization on startup.
-Otherwise it prints an error and continues with bad font metrics.
-
-   -e "command" tells gnuplot to execute that single command before
-continuing.
-
-   -c is equivalent to -e "call scriptfile ARG1 ARG2 ...".  See *note
-call::.
-
-
-File: gnuplot.info,  Node: Examples,  Prev: command_line_options,  Up: Batch/Interactive_Operation
-
-1.7.2 Examples
---------------
-
-To launch an interactive session:
-           gnuplot
-
-
-   To execute two command files "input1" and "input2" in batch mode:
-           gnuplot input1 input2
-
-
-   To launch an interactive session after an initialization file
-"header" and followed by another command file "trailer":
-           gnuplot header - trailer
-
-
-   To give 'gnuplot' commands directly in the command line, using the
-"-persist" option so that the plot remains on the screen afterwards:
-           gnuplot -persist -e "set title 'Sine curve'; plot sin(x)"
-
-
-   To set user-defined variables a and s prior to executing commands
-from a file:
-           gnuplot -e "a=2; s='file.png'" input.gpl
-
-
-
-File: gnuplot.info,  Node: Canvas_size,  Next: Command-line-editing,  Prev: Batch/Interactive_Operation,  Up: Gnuplot
-
-1.8 Canvas size
-===============
-
-This documentation uses the term "canvas" to mean the full drawing area
-available for positioning the plot and associated elements like labels,
-titles, key, etc.  NB: For information about the HTML5 canvas terminal
-see 'set term canvas'.
-
-   'set term <terminal_type> size <XX>, <YY>' controls the size of the
-output file, or "canvas".  By default, the plot will fill this canvas.
-
-   'set size <XX>, <YY>' scales the plot itself relative to the size of
-the canvas.  Scale values less than 1 will cause the plot to not fill
-the entire canvas.  Scale values larger than 1 will cause only a portion
-of the plot to fit on the canvas.  Please be aware that setting scale
-values larger than 1 may cause problems.
-
-   Example:
-
-           set size 0.5, 0.5
-           set term png size 600, 400
-           set output "figure.png"
-           plot "data" with lines
-
-
-   These commands produce an output file "figure.png" that is 600 pixels
-wide and 400 pixels tall.  The plot will fill the lower left quarter of
-this canvas.
-
-   Note: In early versions of gnuplot some terminal types used *note
-size:: to control the size of the output canvas.  This was deprecated in
-version 4.
-
-
-File: gnuplot.info,  Node: Command-line-editing,  Next: Comments,  Prev: Canvas_size,  Up: Gnuplot
-
-1.9 Command-line-editing
-========================
-
-Command-line editing and command history are supported using either an
-external gnu readline library, an external BSD libedit library, or a
-built-in equivalent.  This choice is a configuration option at the time
-gnuplot is built.
-
-   The editing commands of the built-in version are given below.  Please
-note that the action of the DEL key is system-dependent.  The gnu
-readline and BSD libedit libraries have their own documentation.
-
-           `Line-editing`:
-
-
-           ^B    moves back a single character.
-           ^F    moves forward a single character.
-           ^A    moves to the beginning of the line.
-           ^E    moves to the end of the line.
-           ^H    deletes the previous character.
-           DEL   deletes the current character.
-           ^D    deletes current character, sends EOF if the line is empty.
-           ^K    deletes from current position to the end of line.
-           ^L    redraws line in case it gets trashed.
-           ^U    deletes the entire line.
-           ^W    deletes previous word.
-           ^V    inhibits the interpretation of the following key as editing command.
-           TAB   performs filename-completion.
-
-
-           `History`:
-
-
-           ^P    moves back through history.
-           ^N    moves forward through history.
-           ^R    starts a backward-search.
-
-
-
-File: gnuplot.info,  Node: Comments,  Next: Coordinates,  Prev: Command-line-editing,  Up: Gnuplot
-
-1.10 Comments
-=============
-
-The comment character '#' may appear almost anywhere in a command line,
-and 'gnuplot' will ignore the rest of that line.  A '#' does not have
-this effect inside a quoted string.  Note that if a commented line ends
-in '\' then the subsequent line is also treated as part of the comment.
-
-   See also 'set datafile commentschars' for specifying a comment
-character for data files.
-
-
-File: gnuplot.info,  Node: Coordinates,  Next: Datastrings,  Prev: Comments,  Up: Gnuplot
-
-1.11 Coordinates
-================
-
-The commands 'set arrow', 'set key', 'set label' and *note object::
-allow you to draw something at an arbitrary position on the graph.  This
-position is specified by the syntax:
-
-           {<system>} <x>, {<system>} <y> {,{<system>} <z>}
-
-
-   Each <system> can either be 'first', 'second', 'polar', 'graph',
-'screen', or 'character'.
-
-   'first' places the x, y, or z coordinate in the system defined by the
-left and bottom axes; 'second' places it in the system defined by the
-x2,y2 axes (top and right); 'graph' specifies the area within the
-axes--0,0 is bottom left and 1,1 is top right (for splot, 0,0,0 is
-bottom left of plotting area; use negative z to get to the base--see
-*note xyplane::); 'screen' specifies the screen area (the entire
-area--not just the portion selected by *note size::), with 0,0 at bottom
-left and 1,1 at top right.  'character' coordinates are used primarily
-for offsets, not absolute positions.  The 'character' vertical and
-horizontal size depend on the current font.
-
-   'polar' causes the first two values to be interpreted as angle theta
-and radius r rather than as x and y.  This could be used, for example,
-to place labels on a 2D plot in polar coordinates or a 3D plot in
-cylindrical coordinates.
-
-   If the coordinate system for x is not specified, 'first' is used.  If
-the system for y is not specified, the one used for x is adopted.
-
-   In some cases, the given coordinate is not an absolute position but a
-relative value (e.g., the second position in 'set arrow' ...  'rto').
-In most cases, the given value serves as difference to the first
-position.  If the given coordinate belongs to a log-scaled axis, a
-relative value is interpreted as multiplier.  For example,
-
-           set logscale x
-           set arrow 100,5 rto 10,2
-
-
-   plots an arrow from position 100,5 to position 1000,7 since the x
-axis is logarithmic while the y axis is linear.
-
-   If one (or more) axis is timeseries, the appropriate coordinate
-should be given as a quoted time string according to the *note timefmt::
-format string.  See *note xdata:: and *note timefmt::.  'Gnuplot' will
-also accept an integer expression, which will be interpreted as seconds
-relative to 1 January 1970.
-
-
-File: gnuplot.info,  Node: Datastrings,  Next: Enhanced_text_mode,  Prev: Coordinates,  Up: Gnuplot
-
-1.12 Datastrings
-================
-
-Data files may contain string data consisting of either an arbitrary
-string of printable characters containing no whitespace or an arbitrary
-string of characters, possibly including whitespace, delimited by double
-quotes.  The following line from a datafile is interpreted to contain
-four columns, with a text field in column 3:
-
-       1.000 2.000 "Third column is all of this text" 4.00
-
-
-   Text fields can be positioned within a 2-D or 3-D plot using the
-commands:
-
-       plot 'datafile' using 1:2:4 with labels
-       splot 'datafile' using 1:2:3:4 with labels
-
-
-   A column of text data can also be used to label the ticmarks along
-one or more of the plot axes.  The example below plots a line through a
-series of points with (X,Y) coordinates taken from columns 3 and 4 of
-the input datafile.  However, rather than generating regularly spaced
-tics along the x axis labeled numerically, gnuplot will position a tic
-mark along the x axis at the X coordinate of each point and label the
-tic mark with text taken from column 1 of the input datafile.
-
-       set xtics
-       plot 'datafile' using 3:4:xticlabels(1) with linespoints
-
-
-   There is also an option that will interpret the first entry in a
-column of input data (i.e.  the column heading) as a text field, and use
-it as the key title for data plotted from that column.  The example
-given below will use the first entry in column 2 to generate a title in
-the key box, while processing the remainder of columns 2 and 4 to draw
-the required line:
-
-       plot 'datafile' using 1:(f($2)/$4) with lines title columnhead(2)
-
-
-   Another example:
-
-       plot for [i=2:6] 'datafile' using i title "Results for ".columnhead(i)
-
-
-   This use of column headings is automated by *note columnheaders:: or
-'set key autotitle columnhead'.  See *note labels::, 'using xticlabels',
-*note title::, 'using', 'key autotitle'.
-
-
-File: gnuplot.info,  Node: Enhanced_text_mode,  Next: Environment,  Prev: Datastrings,  Up: Gnuplot
-
-1.13 Enhanced text mode
-=======================
-
-Many terminal types support an enhanced text mode in which additional
-formatting information can be embedded in the text string.  For example,
-"x^2" will write x-squared as we are used to seeing it, with a
-superscript 2.  This mode is selected by default when you set the
-terminal, but may be toggled afterward using "set termoption
-[no]enhanced", or disabled for individual strings as in 'set label "x_2"
-noenhanced'.
-
-   Note: For output to TeX-based terminals (e.g.  cairolatex, pict2e,
-pslatex, tikz) all text strings should instead use TeX/LaTeX syntax.
-See 'latex'.
-
-      Control      Examples        Explanation
-       ^           a^x             superscript
-       _           a_x             subscript
-       @           @x or a@^b_{cd} phantom box (occupies no width)
-       &           &{space}        inserts space of specified length
-       ~           ~a{.8-}         overprints '-' on 'a', raised by .8
-                                   times the current fontsize
-       {/Times abc}                print abc in font Times at current size
-       {/Times*2 abc}              print abc in font Times at twice current size
-       {/Times:Italic abc}         print abc in font Times with style italic
-       {/Arial:Bold=20 abc}        print abc in boldface Arial font size 20
-       \U+         \U+221E         Unicode point U+221E (INFINITY)
-
-
-   The markup control characters act on the following single character
-or bracketed clause.  The bracketed clause may contain a string of
-characters with no additional markup, e.g.  2^{10}, or it may contain
-additional markup that changes font properties.  Font specifiers MUST be
-preceded by a '/' character that immediately follows the opening '{'.
-If a font name contains spaces it must be enclosed in single or double
-quotes.
-
-   Examples: The first example illustrates nesting one bracketed clause
-inside another to produce a boldface A with an italic subscript i, all
-in the current font.  If the clause introduced by :Normal were omitted
-the subscript would be both italic and boldface.  The second example
-illustrates the same markup applied to font "Times New Roman" at 20
-point size.
-          {/:Bold A_{/:Normal{/:Italic i}}}
-          {/"Times New Roman":Bold=20 A_{/:Normal{/:Italic i}}}
-
-
-   The phantom box is useful for a@^b_c to align superscripts and
-subscripts but does not work well for overwriting a diacritical mark on
-a letter.  For that purpose it is much better to use an encoding (e.g.
-utf8) that contains letters with accents or other diacritical marks.
-See *note encoding::.  Since the box is non-spacing, it is sensible to
-put the shorter of the subscript or superscript in the box (that is,
-after the @).
-
-   Space equal in length to a string can be inserted using the '&'
-character.  Thus
-             'abc&{def}ghi'
-
-   would produce
-             'abc   ghi'.
-
-
-   The '~' character causes the next character or bracketed text to be
-overprinted by the following character or bracketed text.  The second
-text will be horizontally centered on the first.  Thus '~a/' will result
-in an 'a' with a slash through it.  You can also shift the second text
-vertically by preceding the second text with a number, which will define
-the fraction of the current fontsize by which the text will be raised or
-lowered.  In this case the number and text must be enclosed in brackets
-because more than one character is necessary.  If the overprinted text
-begins with a number, put a space between the vertical offset and the
-text ('~{abc}{.5 000}'); otherwise no space is needed ('~{abc}{.5--}').
-You can change the font for one or both strings ('~a{.5 /*.2 o}'--an 'a'
-with a one-fifth-size 'o' on top--and the space between the number and
-the slash is necessary), but you can't change it after the beginning of
-the string.  Neither can you use any other special syntax within either
-string.  Control characters must be escaped, e.g.  '~a{.8\^}' to print
-â.  See 'escape sequences' below.
-
-   Note that strings in double-quotes are parsed differently than those
-enclosed in single-quotes.  The major difference is that backslashes may
-need to be doubled when in double-quoted strings.
-
-   The file "ps_guide.ps" in the /docs/psdoc subdirectory of the gnuplot
-source distribution contains more examples of the enhanced syntax, as
-does the demo 'enhanced_utf8.dem'
-(http://www.gnuplot.info/demo/enhanced_utf8.html)
-
-* Menu:
-
-* escape_sequences::
-
-
-File: gnuplot.info,  Node: escape_sequences,  Prev: Enhanced_text_mode,  Up: Enhanced_text_mode
-
-1.13.1 escape sequences
------------------------
-
-The backslash character \ is used to escape single byte character codes
-or Unicode entry points.
-
-   The form \ooo (where ooo is a 3 character octal value) can be used to
-index a known character code in a specific font encoding.  For example
-the Adobe Symbol font uses a custom encoding in which octal 245
-represents the infinity symbol.  You could embed this in an enhanced
-text string by giving the font name and the character code "{/Symbol
-\245}".  This is mostly useful for the PostScript terminal, which cannot
-easily handle UTF-8 encoding.
-
-   You can specify a character by its Unicode code point as \U+hhhh,
-where hhhh is the 4 or 5 character hexadecimal code point.  For example
-the code point for the infinity symbol ∞ is \U+221E. This will be
-converted to a UTF-8 byte sequence on output if appropriate.  In a UTF-8
-environment this mechanism is not needed for printable special
-characters since they are handled in a text string like any other
-character.  However it is useful for combining forms or supplemental
-diacritical marks (e.g.  an arrow over a letter to represent a vector).
-See *note encoding::, 'utf8', and the online unicode demo.
-(http://www.gnuplot.info/demo_5.4/unicode.html)
-
-
-File: gnuplot.info,  Node: Environment,  Next: Expressions,  Prev: Enhanced_text_mode,  Up: Gnuplot
-
-1.14 Environment
-================
-
-A number of shell environment variables are understood by 'gnuplot'.
-None of these are required.
-
-   GNUTERM, if defined, is passed to "set term" on start-up.  This can
-be overridden by a system or personal initialization file (see
-'startup') and of course by later explicit 'set term' commands.
-Terminal options may be included.  E.g.
-          bash$ export GNUTERM="postscript eps color size 5in, 3in"
-
-
-   GNUHELP, if defined, sets the pathname of the HELP file
-(gnuplot.gih).
-
-   Initialization at start-up may search for configuration files
-$HOME/.gnuplot, and $XDG_CONFIG_HOME/gnuplot/gnuplotrc.  On MS-DOS,
-Windows and OS/2, files in GNUPLOT or USERPROFILE are searched.  For
-more details see 'startup'.
-
-   On Unix, PAGER is used as an output filter for help messages.
-
-   On Unix, SHELL is used for the *note shell:: command.  On MS-DOS and
-OS/2, COMSPEC is used.
-
-   FIT_SCRIPT may be used to specify a 'gnuplot' command to be executed
-when a fit is interrupted--see *note fit::.  FIT_LOG specifies the
-default filename of the logfile maintained by fit.
-
-   GNUPLOT_LIB may be used to define additional search directories for
-data and command files.  The variable may contain a single directory
-name, or a list of directories separated by a platform-specific path
-separator, eg.  ':' on Unix, or ';' on DOS/Windows/OS/2 platforms.  The
-contents of GNUPLOT_LIB are appended to the *note loadpath:: variable,
-but not saved with the *note save:: and 'save set' commands.
-
-   Several gnuplot terminal drivers access TrueType fonts via the gd
-library (see 'fonts').  For these terminals GDFONTPATH and
-GNUPLOT_DEFAULT_GDFONT may affect font selection.
-
-   The postscript terminal uses its own font search path.  It is
-controlled by the environmental variable GNUPLOT_FONTPATH.
-
-   GNUPLOT_PS_DIR is used by the postscript driver to search for
-external prologue files.  Depending on the build process, gnuplot
-contains either a built-in copy of those files or a default hardcoded
-path.  You can use this variable to have the postscript terminal use
-custom prologue files rather than the default prologue files.  See
-'postscript prologue'.
-
-
-File: gnuplot.info,  Node: Expressions,  Next: Fonts,  Prev: Environment,  Up: Gnuplot
-
-1.15 Expressions
-================
-
-In general, any mathematical expression accepted by C, FORTRAN, Pascal,
-or BASIC is valid.  The precedence of these operators is determined by
-the specifications of the C programming language.  White space (spaces
-and tabs) is ignored inside expressions.
-
-   Note that gnuplot uses both "real" and "integer" arithmetic, like
-FORTRAN and C. Integers are entered as "1", "-10", etc; reals as "1.0",
-"-10.0", "1e1", 3.5e-1, etc.  The most important difference between the
-two forms is in division: division of integers truncates: 5/2 = 2;
-division of reals does not: 5.0/2.0 = 2.5.  In mixed expressions,
-integers are "promoted" to reals before evaluation: 5/2e0 = 2.5.  The
-result of division of a negative integer by a positive one may vary
-among compilers.  Try a test like "print -5/2" to determine if your
-system always rounds down (-5/2 yields -3) or always rounds toward zero
-(-5/2 yields -2).
-
-   The integer expression "1/0" may be used to generate an "undefined"
-flag, which causes a point to be ignored.  Or you can use the
-pre-defined variable NaN to achieve the same result.  See 'using' for an
-example.
-
-   Gnuplot can also perform simple operations on strings and string
-variables.  For example, the expression ("A" .  "B" eq "AB") evaluates
-as true, illustrating the string concatenation operator and the string
-equality operator.
-
-   A string which contains a numerical value is promoted to the
-corresponding integer or real value if used in a numerical expression.
-Thus ("3" + "4" == 7) and (6.78 == "6.78") both evaluate to true.  An
-integer, but not a real or complex value, is promoted to a string if
-used in string concatenation.  A typical case is the use of integers to
-construct file names or other strings; e.g.  ("file" .  4 eq "file4") is
-true.
-
-   Substrings can be specified using a postfixed range descriptor
-[beg:end].  For example, "ABCDEF"[3:4] == "CD" and "ABCDEF"[4:*] ==
-"DEF" The syntax "string"[beg:end] is exactly equivalent to calling the
-built-in string-valued function substr("string",beg,end), except that
-you cannot omit either beg or end from the function call.
-
-* Menu:
-
-* Complex_values::
-* Constants::
-* Functions::
-* operators::
-* summation::
-* Gnuplot-defined_variables::
-* User-defined_variables_and_functions::
-* arrays::
-
-
-File: gnuplot.info,  Node: Complex_values,  Next: Constants,  Prev: Expressions,  Up: Expressions
-
-1.15.1 Complex values
----------------------
-
-Arithmetic operations and most built-in functions support the use of
-complex arguments.  Complex constants are expressed as {<real>,<imag>},
-where <real> and <imag> must be numerical constants.  Thus {0,1}
-represents 'i'.  The program predefines a variable I = {0,1} on entry
-that can be used to generate complex values in terms of other variables.
-Thus 'x + y*I' is a valid expression but '{x,y}' is not.  The real and
-imaginary components of complex value z can be extracted as real(z) and
-imag(z).  The modulus is given by abs(z).  The phase angle is given by
-arg(z).
-
-   Gnuplot's 2D and 3D plot styles expect real values; to plot a
-complex-valued function f(z) with non-zero imaginary components you must
-plot the real or imaginary component, or the modulus or phase.  For
-example to represent the modulus and phase of a function f(z) with
-complex argument and complex result it is possible to use the height of
-the surface to represent modulus and use the color to represent the
-phase.  It is convenient to use a color palette in HSV space with
-component H (hue), running from 0 to 1, mapped to the range of the phase
-returned by arg(z), [-π:π], so that the color wraps when the phase angle
-does.  By default this would be at H = 0 (red).  You can change this
-with the 'start' keyword in *note palette:: so that some other value of
-H is mapped to 0.  The example shown starts and wraps at H = 0.3
-(green).  See *note defined::, *note arg::, *note angles::.
-
-          set palette model HSV start 0.3 defined (0 0 1 1, 1 1 1 1)
-          set cbrange [-pi:pi]
-          set cbtics ("-π" -pi, "π" pi)
-          set pm3d corners2color c1
-          E0(z) = exp(-z)/z
-          I = {0,1}
-          splot '++' using 1:2:(abs(E0(x+I*y))):(arg(E0(x+I*y))) with pm3d
-
-
-
-File: gnuplot.info,  Node: Constants,  Next: Functions,  Prev: Complex_values,  Up: Expressions
-
-1.15.2 Constants
-----------------
-
-Integer constants are interpreted via the C library routine strtoll().
-This means that constants beginning with "0" are interpreted as octal,
-and constants beginning with "0x" or "0X" are interpreted as
-hexadecimal.
-
-   Floating point constants are interpreted via the C library routine
-atof().
-
-   Complex constants are expressed as {<real>,<imag>}, where <real> and
-<imag> must be numerical constants.  For example, {0,1} represents 'i'
-itself; {3,2} represents 3 + 2i.  The curly braces are explicitly
-required here.  The program predefines a variable I = {0,1} on entry
-that can be used to avoid typing the explicit form.  For example '3 +
-2*I' is the same as '{3,2}', with the advantage that it can be used with
-variable coefficient for the imaginary component.  Thus 'x + y*I' is a
-valid expression but '{x,y}' is not.
-
-   String constants consist of any sequence of characters enclosed
-either in single quotes or double quotes.  The distinction between
-single and double quotes is important.  See 'quotes'.
-
-   Examples:
-          1 -10 0xffaabb        # integer constants
-          1.0 -10. 1e1 3.5e-1   # floating point constants
-          {1.2, -3.4}           # complex constant
-          "Line 1\nLine 2"      # string constant (\n is expanded to newline)
-          '123\na\456'          # string constant (\ and n are ordinary characters)
-
-
-
-File: gnuplot.info,  Node: Functions,  Next: operators,  Prev: Constants,  Up: Expressions
-
-1.15.3 Functions
-----------------
-
-Arguments to math functions in 'gnuplot' can be integer, real, or
-complex unless otherwise noted.  Functions that accept or return angles
-(e.g.  sin(x)) treat angle values as radians, but this may be changed to
-degrees using the command *note angles::.
-
-* Menu:
-
-* abs::
-* acos::
-* acosh::
-* airy::
-* arg::
-* asin::
-* asinh::
-* atan::
-* atan2::
-* atanh::
-* besj0::
-* besj1::
-* besjn::
-* besy0::
-* besy1::
-* besyn::
-* besi0::
-* besi1::
-* besin::
-* cbrt::
-* conj::
-* cos::
-* cosh::
-* EllipticK::
-* EllipticE::
-* EllipticPi::
-* erf::
-* erfc::
-* exp::
-* gamma::
-* inverf::
-* imag::
-* invnorm::
-* lambertw::
-* lgamma::
-* lngamma::
-* log::
-* log10::
-* norm::
-* rand::
-* real::
-* sgn::
-* Sign::
-* sin::
-* sinh::
-* sqrt::
-* tan::
-* tanh::
-* voigt::
-* cerf::
-* cdawson::
-* faddeeva::
-* erfi::
-* Voigt_Profile::
-* gprintf::
-* sprintf::
-* strlen::
-* strstrt::
-* substr::
-* split::
-* join::
-* strftime::
-* strptime::
-* system::
-* trim::
-* word::
-* words::
-* exists::
-* hsv2rgb::
-* palette::
-* rgbcolor::
-* voxel::
-* integer_conversion_functions_(int_floor_ceil_round)::
-* elliptic_integrals::
-* Complex_Airy_functions::
-* Complex_Bessel_functions::
-* Expint::
-* Fresnel_integrals_FresnelC(x)_and_FresnelS(x)::
-* Gamma::
-* Igamma::
-* Invigamma::
-* Ibeta::
-* Invibeta::
-* LambertW::
-* lnGamma::
-* Random_number_generator::
-* Special_functions_with_complex_arguments::
-* Synchrotron_function::
-* Time_functions::
-* uigamma::
-* using_specifier_functions::
-* value::
-* Counting_and_extracting_words::
-* zeta::
-
-
-File: gnuplot.info,  Node: abs,  Next: acos,  Prev: Functions,  Up: Functions
-
-1.15.3.1 abs
-............
-
-The 'abs(x)' function returns the absolute value of its argument.  The
-returned value is of the same type as the argument.
-
-   For complex arguments, abs(x) is defined as the length of x in the
-complex plane [i.e., sqrt(real(x)**2 + imag(x)**2) ].  This is also
-known as the norm or complex modulus of x.
-
-
-File: gnuplot.info,  Node: acos,  Next: acosh,  Prev: abs,  Up: Functions
-
-1.15.3.2 acos
-.............
-
-The 'acos(x)' function returns the arc cosine (inverse cosine) of its
-argument.  'acos' returns its argument in radians or degrees, as
-selected by *note angles::.
-
-
-File: gnuplot.info,  Node: acosh,  Next: airy,  Prev: acos,  Up: Functions
-
-1.15.3.3 acosh
-..............
-
-The 'acosh(x)' function returns the inverse hyperbolic cosine of its
-argument in radians or degrees, as selected by *note angles::.
-
-
-File: gnuplot.info,  Node: airy,  Next: arg,  Prev: acosh,  Up: Functions
-
-1.15.3.4 airy
-.............
-
-The 'airy(x)' function returns the value of the Airy function Ai(x) of
-its argument.  The function Ai(x) is that solution of the equation y" -
-x y = 0 which is everywhere finite.  If the argument is complex, its
-imaginary part is ignored.
-
-
-File: gnuplot.info,  Node: arg,  Next: asin,  Prev: airy,  Up: Functions
-
-1.15.3.5 arg
-............
-
-The 'arg(x)' function returns the phase of a complex number in radians
-or degrees, as selected by *note angles::.
-
-
-File: gnuplot.info,  Node: asin,  Next: asinh,  Prev: arg,  Up: Functions
-
-1.15.3.6 asin
-.............
-
-The 'asin(x)' function returns the arc sin (inverse sin) of its
-argument.  'asin' returns its argument in radians or degrees, as
-selected by *note angles::.
-
-
-File: gnuplot.info,  Node: asinh,  Next: atan,  Prev: asin,  Up: Functions
-
-1.15.3.7 asinh
-..............
-
-The 'asinh(x)' function returns the inverse hyperbolic sin of its
-argument in radians or degrees, as selected by *note angles::.
-
-
-File: gnuplot.info,  Node: atan,  Next: atan2,  Prev: asinh,  Up: Functions
-
-1.15.3.8 atan
-.............
-
-The 'atan(x)' function returns the arc tangent (inverse tangent) of its
-argument.  'atan' returns its argument in radians or degrees, as
-selected by *note angles::.
-
-
-File: gnuplot.info,  Node: atan2,  Next: atanh,  Prev: atan,  Up: Functions
-
-1.15.3.9 atan2
-..............
-
-The 'atan2(y,x)' function returns the arc tangent (inverse tangent) of
-the ratio of the real parts of its arguments.  *note atan2:: returns its
-argument in radians or degrees, as selected by *note angles::, in the
-correct quadrant.
-
-
-File: gnuplot.info,  Node: atanh,  Next: besj0,  Prev: atan2,  Up: Functions
-
-1.15.3.10 atanh
-...............
-
-The 'atanh(x)' function returns the inverse hyperbolic tangent of its
-argument in radians or degrees, as selected by *note angles::.
-
-
-File: gnuplot.info,  Node: besj0,  Next: besj1,  Prev: atanh,  Up: Functions
-
-1.15.3.11 besj0
-...............
-
-The 'besj0(x)' function returns the J0th Bessel function of its
-argument.  *note besj0:: expects its argument to be in radians.
-
-
-File: gnuplot.info,  Node: besj1,  Next: besjn,  Prev: besj0,  Up: Functions
-
-1.15.3.12 besj1
-...............
-
-The 'besj1(x)' function returns the J1st Bessel function of its
-argument.  *note besj1:: expects its argument to be in radians.
-
-
-File: gnuplot.info,  Node: besjn,  Next: besy0,  Prev: besj1,  Up: Functions
-
-1.15.3.13 besjn
-...............
-
-The 'besjn(n,x)' functions returns the Jn Bessel function of x in
-radians.
-
-
-File: gnuplot.info,  Node: besy0,  Next: besy1,  Prev: besjn,  Up: Functions
-
-1.15.3.14 besy0
-...............
-
-The 'besy0(x)' function returns the Y0th Bessel function of its
-argument.  *note besy0:: expects its argument to be in radians.
-
-
-File: gnuplot.info,  Node: besy1,  Next: besyn,  Prev: besy0,  Up: Functions
-
-1.15.3.15 besy1
-...............
-
-The 'besy1(x)' function returns the Y1st Bessel function of its
-argument.  *note besy1:: expects its argument to be in radians.
-
-
-File: gnuplot.info,  Node: besyn,  Next: besi0,  Prev: besy1,  Up: Functions
-
-1.15.3.16 besyn
-...............
-
-The 'besyn(n,x)' functions returns the Yn Bessel function of x in
-radians.
-
-
-File: gnuplot.info,  Node: besi0,  Next: besi1,  Prev: besyn,  Up: Functions
-
-1.15.3.17 besi0
-...............
-
-The 'besi0(x)' function is the modified Bessel function or order 0.
-*note besi0:: expects its argument to be in radians.
-
-
-File: gnuplot.info,  Node: besi1,  Next: besin,  Prev: besi0,  Up: Functions
-
-1.15.3.18 besi1
-...............
-
-The 'besi1(x)' function is the modified Bessel function or order 1.
-*note besi1:: expects its argument to be in radians.
-
-
-File: gnuplot.info,  Node: besin,  Next: cbrt,  Prev: besi1,  Up: Functions
-
-1.15.3.19 besin
-...............
-
-'besin(n,x)' is the modified Bessel function or order n for integer n
-and x in radians.
-
-
-File: gnuplot.info,  Node: cbrt,  Next: conj,  Prev: besin,  Up: Functions
-
-1.15.3.20 cbrt
-..............
-
-'cbrt(x)' returns the cube root of x.  If x is not real, returns NaN.
-
-   'ceil(x)' returns the smallest integer not less than the real part of
-x.  Outside the domain |x|<2^52 ceil(x) returns NaN.
-
-
-File: gnuplot.info,  Node: conj,  Next: cos,  Prev: cbrt,  Up: Functions
-
-1.15.3.21 conj
-..............
-
-The 'conj(x)' function returns the complex conjugate x.  conj( {r, i} )
-= {r, -i}
-
-
-File: gnuplot.info,  Node: cos,  Next: cosh,  Prev: conj,  Up: Functions
-
-1.15.3.22 cos
-.............
-
-The 'cos(x)' function returns the cosine of its argument.  'cos' accepts
-its argument in radians or degrees, as selected by *note angles::.
-
-
-File: gnuplot.info,  Node: cosh,  Next: EllipticK,  Prev: cos,  Up: Functions
-
-1.15.3.23 cosh
-..............
-
-The 'cosh(x)' function returns the hyperbolic cosine of its argument.
-*note cosh:: expects its argument to be in radians.
-
-
-File: gnuplot.info,  Node: EllipticK,  Next: EllipticE,  Prev: cosh,  Up: Functions
-
-1.15.3.24 EllipticK
-...................
-
-The 'EllipticK(k)' function returns the complete elliptic integral of
-the first kind.  See 'elliptic integrals' for more details.
-
-
-File: gnuplot.info,  Node: EllipticE,  Next: EllipticPi,  Prev: EllipticK,  Up: Functions
-
-1.15.3.25 EllipticE
-...................
-
-The 'EllipticE(k)' function returns the complete elliptic integral of
-the second kind.  See 'elliptic integrals' for more details.
-
-
-File: gnuplot.info,  Node: EllipticPi,  Next: erf,  Prev: EllipticE,  Up: Functions
-
-1.15.3.26 EllipticPi
-....................
-
-The 'EllipticPi(n,k)' function returns the complete elliptic integral of
-the third kind.  See 'elliptic integrals' for more details.
-
-
-File: gnuplot.info,  Node: erf,  Next: erfc,  Prev: EllipticPi,  Up: Functions
-
-1.15.3.27 erf
-.............
-
-The 'erf(x)' function returns the error function of the real part of its
-argument.  If the argument is a complex value, the imaginary component
-is ignored.  See *note cerf::, *note erfc::, *note inverf::, and *note
-norm::.
-
-
-File: gnuplot.info,  Node: erfc,  Next: exp,  Prev: erf,  Up: Functions
-
-1.15.3.28 erfc
-..............
-
-The 'erfc(x)' function returns 1.0 - the error function of the real part
-of its argument.  If the argument is a complex value, the imaginary
-component is ignored.  See *note cerf::, 'erf', *note inverf::, and
-*note norm::.
-
-
-File: gnuplot.info,  Node: exp,  Next: gamma,  Prev: erfc,  Up: Functions
-
-1.15.3.29 exp
-.............
-
-The 'exp(x)' function returns 'e' raised to the power of x, which can be
-an integer, real, or complex value.
-
-   'floor(x)' returns the largest integer not greater than the real part
-of x.  Outside the domain |x|<2^52 floor(x) returns NaN.
-
-
-File: gnuplot.info,  Node: gamma,  Next: inverf,  Prev: exp,  Up: Functions
-
-1.15.3.30 gamma
-...............
-
-The 'gamma(x)' function returns the gamma function of the real part of
-its argument.  For integer n, gamma(n+1) = n!.  If the argument is a
-complex value, the imaginary component is ignored.  For complex
-arguments see *note lnGamma::.
-
-
-File: gnuplot.info,  Node: inverf,  Next: imag,  Prev: gamma,  Up: Functions
-
-1.15.3.31 inverf
-................
-
-The 'inverf(x)' function returns the inverse error function of the real
-part of its argument.  See 'erf' and *note invnorm::.
-
-
-File: gnuplot.info,  Node: imag,  Next: invnorm,  Prev: inverf,  Up: Functions
-
-1.15.3.32 imag
-..............
-
-The 'imag(x)' function returns the imaginary part of its argument as a
-real number.
-
-   int(x) returns the integer part of its argument, truncated toward
-zero.
-
-
-File: gnuplot.info,  Node: invnorm,  Next: lambertw,  Prev: imag,  Up: Functions
-
-1.15.3.33 invnorm
-.................
-
-The 'invnorm(x)' function returns the inverse cumulative normal
-(Gaussian) distribution function of the real part of its argument.  See
-*note norm::.
-
-
-File: gnuplot.info,  Node: lambertw,  Next: lgamma,  Prev: invnorm,  Up: Functions
-
-1.15.3.34 lambertw
-..................
-
-The 'lambertw(x)' function returns the value of the principal branch
-(k=0) of Lambert's W function, which is defined by the equation
-(W(x)*exp(W(x))=x.  x must be a real number with x >= -exp(-1).
-
-
-File: gnuplot.info,  Node: lgamma,  Next: lngamma,  Prev: lambertw,  Up: Functions
-
-1.15.3.35 lgamma
-................
-
-The 'lgamma(x)' function returns the natural logarithm of the gamma
-function of the real part of its argument.  If the argument is a complex
-value, the imaginary component is ignored.  For complex values use
-lnGamma(z).
-
-
-File: gnuplot.info,  Node: lngamma,  Next: log,  Prev: lgamma,  Up: Functions
-
-1.15.3.36 lngamma
-.................
-
-The 'lnGamma(x)' function returns the natural logarithm of the gamma
-function.  This implementation uses a Lanczos approximation valid over
-the entire complex plane.  The imaginary component of the result is
-phase-shifted to yield a continuous surface everywhere except the
-negative real axis.
-
-
-File: gnuplot.info,  Node: log,  Next: log10,  Prev: lngamma,  Up: Functions
-
-1.15.3.37 log
-.............
-
-The 'log(x)' function returns the natural logarithm (base 'e') of its
-argument.  See *note log10::.
-
-
-File: gnuplot.info,  Node: log10,  Next: norm,  Prev: log,  Up: Functions
-
-1.15.3.38 log10
-...............
-
-The 'log10(x)' function returns the logarithm (base 10) of its argument.
-
-
-File: gnuplot.info,  Node: norm,  Next: rand,  Prev: log10,  Up: Functions
-
-1.15.3.39 norm
-..............
-
-The 'norm(x)' function returns the cumulative normal (Gaussian)
-distribution function of the real part of its argument.  See *note
-invnorm::, 'erf' and *note erfc::.
-
-
-File: gnuplot.info,  Node: rand,  Next: real,  Prev: norm,  Up: Functions
-
-1.15.3.40 rand
-..............
-
-The 'rand(x)' function returns a pseudo random number in the interval
-(0:1).  See 'random' for more details.
-
-
-File: gnuplot.info,  Node: real,  Next: sgn,  Prev: rand,  Up: Functions
-
-1.15.3.41 real
-..............
-
-The 'real(x)' function returns the real part of its argument.
-
-   'round(x)' returns the integer nearest to the real part of x.
-Outside the domain |x|<2^52 round(x) returns NaN.
-
-
-File: gnuplot.info,  Node: sgn,  Next: Sign,  Prev: real,  Up: Functions
-
-1.15.3.42 sgn
-.............
-
-The 'sgn(x)' function returns 1 if its argument is positive, -1 if its
-argument is negative, and 0 if its argument is 0.  If the argument is a
-complex value, the imaginary component is ignored.
-
-
-File: gnuplot.info,  Node: Sign,  Next: sin,  Prev: sgn,  Up: Functions
-
-1.15.3.43 Sign
-..............
-
-The 'Sign(x)' function returns 0 if its argument is zero, otherwise it
-returns the complex value Sign(x) = x/|x|.
-
-
-File: gnuplot.info,  Node: sin,  Next: sinh,  Prev: Sign,  Up: Functions
-
-1.15.3.44 sin
-.............
-
-The 'sin(x)' function returns the sine of its argument.  'sin' expects
-its argument to be in radians or degrees, as selected by *note angles::.
-
-
-File: gnuplot.info,  Node: sinh,  Next: sqrt,  Prev: sin,  Up: Functions
-
-1.15.3.45 sinh
-..............
-
-The 'sinh(x)' function returns the hyperbolic sine of its argument.
-*note sinh:: expects its argument to be in radians.
-
-
-File: gnuplot.info,  Node: sqrt,  Next: tan,  Prev: sinh,  Up: Functions
-
-1.15.3.46 sqrt
-..............
-
-The 'sqrt(x)' function returns the square root of its argument.  If the
-x is a complex value, this always returns the root with positive real
-part.
-
-
-File: gnuplot.info,  Node: tan,  Next: tanh,  Prev: sqrt,  Up: Functions
-
-1.15.3.47 tan
-.............
-
-The 'tan(x)' function returns the tangent of its argument.  'tan'
-expects its argument to be in radians or degrees, as selected by *note
-angles::.
-
-
-File: gnuplot.info,  Node: tanh,  Next: voigt,  Prev: tan,  Up: Functions
-
-1.15.3.48 tanh
-..............
-
-The 'tanh(x)' function returns the hyperbolic tangent of its argument.
-*note tanh:: expects its argument to be in radians.
-
-
-File: gnuplot.info,  Node: voigt,  Next: cerf,  Prev: tanh,  Up: Functions
-
-1.15.3.49 voigt
-...............
-
-The function 'voigt(x,y)' returns an approximation to the Voigt/Faddeeva
-function used in spectral analysis.  The approximation is accurate to
-one part in 10^4.  If the libcerf library is available, the re_w_of_z()
-routine is used to provide a more accurate value.  Note that voigt(x,y)
-= real(faddeeva( x + y*{0,1} )).
-
-
-File: gnuplot.info,  Node: cerf,  Next: cdawson,  Prev: voigt,  Up: Functions
-
-1.15.3.50 cerf
-..............
-
-'cerf(z)' is the complex version of the error function erf(x) Requires
-external library libcerf.
-
-
-File: gnuplot.info,  Node: cdawson,  Next: faddeeva,  Prev: cerf,  Up: Functions
-
-1.15.3.51 cdawson
-.................
-
-'cdawson(z)' returns Dawson's Integral evaluated for the complex
-argument z.  cdawson(z) = sqrt(pi)/2 * exp(-z^2) * erfi(z) Requires
-external library libcerf.
-
-
-File: gnuplot.info,  Node: faddeeva,  Next: erfi,  Prev: cdawson,  Up: Functions
-
-1.15.3.52 faddeeva
-..................
-
-'faddeeva(z)' returns the scaled complex complementary error function
-faddeeva(z) = exp(-z^2) * erfc(-i*z) This corresponds to Eqs 7.1.3 and
-7.1.4 of Abramowitz and Stegun.  Requires external library libcerf.
-
-
-File: gnuplot.info,  Node: erfi,  Next: Voigt_Profile,  Prev: faddeeva,  Up: Functions
-
-1.15.3.53 erfi
-..............
-
-Imaginary error function erfi(x) = -i * erf(ix) Requires external
-library libcerf.
-
-
-File: gnuplot.info,  Node: Voigt_Profile,  Next: gprintf,  Prev: erfi,  Up: Functions
-
-1.15.3.54 Voigt Profile
-.......................
-
-'VP(x,sigma,gamma)' corresponds to the Voigt profile defined by
-convolution of a Gaussian G(x;sigma) with a Lorentzian L(x;gamma).
-'VP_fwhm(sigma,gamma)' gives the full width at half maximum value of
-this function.
-
-
-File: gnuplot.info,  Node: gprintf,  Next: sprintf,  Prev: Voigt_Profile,  Up: Functions
-
-1.15.3.55 gprintf
-.................
-
-'gprintf("format",x)' applies gnuplot's own format specifiers to the
-single variable x and returns the resulting string.  If you want
-standard C-language format specifiers, you must instead use
-'sprintf("format",x)'.  See 'format specifiers'.
-
-
-File: gnuplot.info,  Node: sprintf,  Next: strlen,  Prev: gprintf,  Up: Functions
-
-1.15.3.56 sprintf
-.................
-
-'sprintf("format",var1,var2,...)'  applies standard C-language format
-specifiers to multiple arguments and returns the resulting string.  If
-you want to use gnuplot's own format specifiers, you must instead call
-'gprintf()'.  For information on sprintf format specifiers, please see
-standard C-language documentation or the unix sprintf man page.
-
-
-File: gnuplot.info,  Node: strlen,  Next: strstrt,  Prev: sprintf,  Up: Functions
-
-1.15.3.57 strlen
-................
-
-'strlen("string")' returns the number of characters in a string taking
-into account the current encoding.  If the current encoding supports
-multibyte characters (SJIS UTF8), this may be less than the number of
-bytes in the string.  If the string contains multibyte UTF8 characters
-but the current encoding is set to something other than UTF8,
-strlen("utf8string") will return a value that is larger than the actual
-number of characters.
-
-
-File: gnuplot.info,  Node: strstrt,  Next: substr,  Prev: strlen,  Up: Functions
-
-1.15.3.58 strstrt
-.................
-
-'strstrt("string","key")' searches for the character string "key" in
-"string" and returns the index to the first character of "key".  If
-"key" is not found, it returns 0.  Similar to C library function strstr
-except that it returns an index rather than a string pointer.
-strstrt("hayneedlestack","needle") = 4.  This function is aware of utf8
-encoding, so strstrt("αβγ","β") returns 2.
-
-
-File: gnuplot.info,  Node: substr,  Next: split,  Prev: strstrt,  Up: Functions
-
-1.15.3.59 substr
-................
-
-'substr("string",beg,end)' returns the substring consisting of
-characters beg through end of the original string.  This is exactly
-equivalent to the expression "string"[beg:end] except that you do not
-have the option of omitting beg or end.
-
-
-File: gnuplot.info,  Node: split,  Next: join,  Prev: substr,  Up: Functions
-
-1.15.3.60 split
-...............
-
-'split("string", "sep")' uses the character sequence in "sep" as a field
-separator to split the content of "string" into individual fields.  It
-returns an array of strings, each corresponding to one field of the
-original string.  The second parameter "sep" is optional.  If "sep" is
-omitted or if it contains a single space character the fields are split
-by any amount of whitespace (space, tab, formfeed, newline, return).
-Otherwise the full sequence of characters in "sep" must be matched.  For
-examples, see 'counting_words'.
-
-
-File: gnuplot.info,  Node: join,  Next: strftime,  Prev: split,  Up: Functions
-
-1.15.3.61 join
-..............
-
-'join(array, "sep")' concatenates the string elements of an array into a
-single string containing fields delimited by the character sequence in
-"sep".  Non-string array elements generate an empty field.  For
-examples, see 'counting_words'.
-
-
-File: gnuplot.info,  Node: strftime,  Next: strptime,  Prev: join,  Up: Functions
-
-1.15.3.62 strftime
-..................
-
-'strftime("timeformat",t)' applies the timeformat specifiers to the time
-t given in seconds since the year 1970.  See 'time_specifiers' and *note
-strptime::.
-
-
-File: gnuplot.info,  Node: strptime,  Next: system,  Prev: strftime,  Up: Functions
-
-1.15.3.63 strptime
-..................
-
-'strptime("timeformat",s)' reads the time from the string s using the
-timeformat specifiers and converts it into seconds since the year 1970.
-See 'time_specifiers' and *note strftime::.
-
-
-File: gnuplot.info,  Node: system,  Next: trim,  Prev: strptime,  Up: Functions
-
-1.15.3.64 system
-................
-
-'system("command")' executes "command" using the standard shell and
-returns the resulting character stream from stdout as string variable.
-One optional trailing newline is ignored.
-
-   This can be used to import external functions into gnuplot scripts
-using 'f(x) = real(system(sprintf("somecommand %f", x)))'.
-
-
-File: gnuplot.info,  Node: trim,  Next: word,  Prev: system,  Up: Functions
-
-1.15.3.65 trim
-..............
-
-'trim(" padded string ")' returns the original string stripped of
-leading and trailing whitespace.  This is useful for string comparisons
-of input data fields that may contain extra whitespace.  For example
-          plot FOO using 1:( trim(strcol(3)) eq "A" ? $2 : NaN )
-
-
-
-File: gnuplot.info,  Node: word,  Next: words,  Prev: trim,  Up: Functions
-
-1.15.3.66 word
-..............
-
-'word("string",n)' returns the nth word in string.  For example,
-'word("one two three",2)' returns the string "two".
-
-
-File: gnuplot.info,  Node: words,  Next: exists,  Prev: word,  Up: Functions
-
-1.15.3.67 words
-...............
-
-'words("string")' returns the number of words in string.  For example,
-'words(" a b c d")' returns 4.
-
-   The 'tm_hour(t)' function interprets its argument as a time, in
-seconds from 1 Jan 1970.  It returns the hour (an integer in the range
-0-23) as a real.
-
-   The 'tm_mday(t)' function interprets its argument as a time, in
-seconds from 1 Jan 1970.  It returns the day of the month (an integer in
-the range 1-31) as a real.
-
-   The 'tm_min(t)' function interprets its argument as a time, in
-seconds from 1 Jan 1970.  It returns the minute (an integer in the range
-0-59) as a real.
-
-   The 'tm_mon(t)' function interprets its argument as a time, in
-seconds from 1 Jan 1970.  It returns the month (an integer in the range
-0-11) as a real.
-
-   The 'tm_sec(t)' function interprets its argument as a time, in
-seconds from 1 Jan 1970.  It returns the second (an integer in the range
-0-59) as a real.
-
-   The 'tm_wday(t)' function interprets its argument as a time, in
-seconds from 1 Jan 1970.  It returns the day of the week (Sun..Sat) as
-an integer (0..6).
-
-   The 'tm_yday(t)' function interprets its argument as a time, in
-seconds from 1 Jan 1970.  It returns the day of the year (an integer in
-the range 0-365) as a real.
-
-   The 'tm_year(t)' function interprets its argument as a time, in
-seconds from 1 Jan 1970.  It returns the year (an integer) as a real.
-
-
-File: gnuplot.info,  Node: exists,  Next: hsv2rgb,  Prev: words,  Up: Functions
-
-1.15.3.68 exists
-................
-
-The argument to 'exists()' is a string constant or a string variable; if
-the string contains the name of a defined variable, the function returns
-1.  Otherwise the function returns 0.
-
-
-File: gnuplot.info,  Node: hsv2rgb,  Next: palette,  Prev: exists,  Up: Functions
-
-1.15.3.69 hsv2rgb
-.................
-
-The 'hsv2rgb(h,s,v)' function converts HSV (Hue/Saturation/Value)
-triplet to an equivalent RGB value.
-
-
-File: gnuplot.info,  Node: palette,  Next: rgbcolor,  Prev: hsv2rgb,  Up: Functions
-
-1.15.3.70 palette
-.................
-
-'palette(z)' returns the 24 bit RGB representation of the palette color
-      mapped to z given the current extremes of cbrange.
-
-
-
-File: gnuplot.info,  Node: rgbcolor,  Next: voxel,  Prev: palette,  Up: Functions
-
-1.15.3.71 rgbcolor
-..................
-
-'rgbcolor("name")' returns an integer containing the 32 bit alpha + RGB
-color value of a named color or a string of the form "0xAARRGGBB" or
-"#AARRGGBB". If the string is not recognized as a color description the
-function returns 0.  This can be used to read a color name from a data
-file or to add an alpha channel to a named color in the upper byte of
-the returned value.  See *note colorspec::.
-
-
-File: gnuplot.info,  Node: voxel,  Next: integer_conversion_functions_(int_floor_ceil_round),  Prev: rgbcolor,  Up: Functions
-
-1.15.3.72 voxel
-...............
-
-The function voxel(x,y,z) returns the value of the voxel in the
-currently active grid that contains the point (x,y,z).  It may also be
-used on the left side of an assignment statement to set the value of
-that voxel.  E.g.  voxel(x,y,z) = 0.0 See 'splot voxel-grids', *note
-vgrid::.
-
-
-File: gnuplot.info,  Node: integer_conversion_functions_(int_floor_ceil_round),  Next: elliptic_integrals,  Prev: voxel,  Up: Functions
-
-1.15.3.73 integer conversion functions (int floor ceil round)
-.............................................................
-
-Gnuplot integer variables are stored with 64 bits of precision if that
-is supported by the platform.
-
-   Gnuplot complex and real variables are on most platforms stored in
-IEEE754 binary64 (double) floating point representation.  Their
-precision is limited to 53 bits, corresponding to roughly 16 significant
-digits.
-
-   Therefore integers with absolute value larger than 2^53 cannot be
-uniquely represented in a floating point variable.  I.e.  for large N
-the operation int(real(N)) may return an integer near but not equal to
-N.
-
-   Furthermore, functions that convert from a floating point value to an
-integer by truncation may not yield the expected value if the operation
-depends on more than 15 significant digits of precision even if the
-magnitude is small.  For example int(log10(0.1)) returns 0 rather than
--1 because the floating point representation is equivalent to
--0.999999999999999...  See also *note overflow::.
-
-   'int(x)' returns the integer part of its argument, truncated toward
-zero.  If |x| > 2^63, i.e.  too large to represent as an integer, NaN is
-returned.  If |x| > 2^52 the return value will lie within a range of
-neighboring integers that cannot be distinguished due to limited
-floating point precision.  See 'integer conversion'.
-
-   'floor(x)' returns the largest integer not greater than the real part
-of x.  If |x| > 2^52 the true value cannot be uniquely determined; in
-this case the return value is NaN. See 'integer conversion'.
-
-   'ceil(x)' returns the smallest integer not less than the real part of
-x.  If |x| > 2^52 the true value cannot be uniquely determined; in this
-case the return value is NaN. See 'integer conversion'.
-
-   'round(x)' returns the integer nearest to the real part of x.  If |x|
-> 2^52 the true value cannot be uniquely determined; in this case the
-return value is NaN. See 'integer conversion'.
-
-
-File: gnuplot.info,  Node: elliptic_integrals,  Next: Complex_Airy_functions,  Prev: integer_conversion_functions_(int_floor_ceil_round),  Up: Functions
-
-1.15.3.74 elliptic integrals
-............................
-
-The 'EllipticK(k)' function returns the complete elliptic integral of
-the first kind, i.e.  the definite integral between 0 and pi/2 of the
-function '(1 - k^2*sin^2(θ))^(-0.5)'.  The domain of 'k' is -1 to 1
-(exclusive).
-
-   The 'EllipticE(k)' function returns the complete elliptic integral of
-the second kind, i.e.  the definite integral between 0 and pi/2 of the
-function '(1 - k^2*sin^2(θ))^0.5'.  The domain of 'k' is -1 to 1
-(inclusive).
-
-   The 'EllipticPi(n,k)' function returns the complete elliptic integral
-of the third kind, i.e.  the definite integral between 0 and pi/2 of the
-function '(1 - k^2*sin^2(θ))^(-0.5) / (1 - n*sin^2(θ))'.  The parameter
-'n' must be less than 1, while 'k' must lie between -1 and 1
-(exclusive).  Note that by definition EllipticPi(0,k) == EllipticK(k)
-for all possible values of 'k'.
-
-   Elliptic integral algorithm: B.C.Carlson 1995, Numerical Algorithms
-10:13-26.
-
-
-File: gnuplot.info,  Node: Complex_Airy_functions,  Next: Complex_Bessel_functions,  Prev: elliptic_integrals,  Up: Functions
-
-1.15.3.75 Complex Airy functions
-................................
-
-'Ai(z)' and 'Bi(z)' are the Airy functions of complex argument z,
-computed in terms of the modified Bessel functions K and I. Supported
-via an external library containing routines by Donald E. Amos, Sandia
-National Laboratories, SAND85-1018 (1985).
-
-
-File: gnuplot.info,  Node: Complex_Bessel_functions,  Next: Expint,  Prev: Complex_Airy_functions,  Up: Functions
-
-1.15.3.76 Complex Bessel functions
-..................................
-
-'BesselJ(nu,z)' is the Bessel function of the first kind J_nu for real
-argument nu and complex argument z.  Supported via external library
-containing routines by Donald E. Amos, Sandia National Laboratories,
-SAND85-1018 (1985).
-
-   'BesselY(nu,z)' is the Bessel function of the second kind Y_nu for
-real argument nu and complex argument z.  Supported via external library
-containing routines by Donald E. Amos, Sandia National Laboratories,
-SAND85-1018 (1985).
-
-   'BesselI(nu,z)' is the modified Bessel function of the first kind
-I_nu for real argument nu and complex argument z.  Supported via
-external library containing routines by Donald E. Amos, Sandia National
-Laboratories, SAND85-1018 (1985).
-
-   'BesselK(nu,z)' is the modified Bessel function of the second kind
-K_nu for real argument nu and complex argument z.  Supported via
-external library containing routines by Donald E. Amos, Sandia National
-Laboratories, SAND85-1018 (1985).
-
-   'BesselH1(nu,z)' and 'BesselH2(nu,z)' are the Hankel functions of the
-first and second kind
-         H1(nu,z) = J(nu,z) + iY(nu,z)
-         H2(nu,z) = J(nu,z) - iY(nu,z)
-
-   for real argument nu and complex argument z.  Supported via external
-library containing routines by Donald E. Amos, Sandia National
-Laboratories, SAND85-1018 (1985).
-
-
-File: gnuplot.info,  Node: Expint,  Next: Fresnel_integrals_FresnelC(x)_and_FresnelS(x),  Prev: Complex_Bessel_functions,  Up: Functions
-
-1.15.3.77 Expint
-................
-
-'expint(n,z)' returns the exponential integral of order n, where n is an
-integer >= 0.  This is the integral from 1 to infinity of t^(-n) e^(-tz)
-dt.
-
-   If your copy of gnuplot was built with support for complex functions
-from the Amos library, then for n>0 the evaluation uses Amos routine
-cexint [Amos 1990 Algorithm 683, ACM Trans Math Software 16:178].  In
-this case z may be any complex number with -pi < arg(z) <= pi.
-expint(0,z) is calculated as exp(-z)/z.
-
-   If Amos library support is not present, z is limited to real values z
->= 0.
-
-
-File: gnuplot.info,  Node: Fresnel_integrals_FresnelC(x)_and_FresnelS(x),  Next: Gamma,  Prev: Expint,  Up: Functions
-
-1.15.3.78 Fresnel integrals FresnelC(x) and FresnelS(x)
-.......................................................
-
-The cosine and sine Fresnel integrals are calculated using their
-relationship to the complex error function erf(z).  Due to dependence on
-erf(z), these functions are only available if libcerf library support is
-present.
-
-
-File: gnuplot.info,  Node: Gamma,  Next: Igamma,  Prev: Fresnel_integrals_FresnelC(x)_and_FresnelS(x),  Up: Functions
-
-1.15.3.79 Gamma
-...............
-
-'gamma(x)' returns the gamma function of the real part of its argument.
-For integer n, gamma(n+1) = n!.  If the argument is a complex value, the
-imaginary component is ignored.  For complex arguments see *note
-lnGamma::.
-
-
-File: gnuplot.info,  Node: Igamma,  Next: Invigamma,  Prev: Gamma,  Up: Functions
-
-1.15.3.80 Igamma
-................
-
-'igamma(a, z)' returns the lower incomplete gamma function P(a, z),
-[Abramowitz and Stegun (6.5.1); NIST DLMF 8.2.4].  If complex function
-support is present a and z may be complex values; real(a) > 0; For the
-complementary upper incomplete gamma function, see *note uigamma::.
-
-   One of four algorithms is used depending on a and z.  Case (1) When a
-is large (>100) and (z-a)/a is small (<0.2) use Gauss-Legendre
-quadrature with coefficients from Numerical Recipes 3rd Edition section
-6.2, Press et al (2007).  Case (2) When z > 1 and z > (a+2) use a
-continued fraction following Shea (1988) J. Royal Stat.  Soc.  Series C
-(Applied Statistics) 37:466-473.  Case (3) When z < 0 and a < 75 and
-imag(a) == 0 use the series from Abramowitz & Stegun (6.5.29).
-Otherwise (Case 4) use Pearson's series expansion.
-
-   Note that convergence is poor in some regions of the full domain.  If
-the chosen algorithm does not converge to within 1.E-14 the function
-returns NaN and prints a warning.
-
-   If no complex function support is present the domain is limited to
-real arguments a > 0, z >= 0.
-
-
-File: gnuplot.info,  Node: Invigamma,  Next: Ibeta,  Prev: Igamma,  Up: Functions
-
-1.15.3.81 Invigamma
-...................
-
-The inverse incomplete gamma function 'invigamma(a,p)' returns the value
-z such that p = igamma(a,z).  p is limited to (0;1].  a must be a
-positive real number.  The implementation in gnuplot has relative
-accuracy that ranges from 1.e-16 for a<1 to 5.e-6 for a = 1.e10.
-Convergence may fail for a < 0.005.
-
-
-File: gnuplot.info,  Node: Ibeta,  Next: Invibeta,  Prev: Invigamma,  Up: Functions
-
-1.15.3.82 Ibeta
-...............
-
-'ibeta(a,b,x)' returns the normalized lower incomplete beta integral of
-real arguments a,b > 0, x in [0:1].
-
-   If the arguments are complex, the imaginary components are ignored.
-The implementation in gnuplot uses code from the Cephes library [Moshier
-1989, "Methods and Programs for Mathematical Functions", Prentice-Hall].
-
-
-File: gnuplot.info,  Node: Invibeta,  Next: LambertW,  Prev: Ibeta,  Up: Functions
-
-1.15.3.83 Invibeta
-..................
-
-The inverse incomplete beta function 'invibeta(a,b,p)' returns the value
-z such that p = ibeta(a,b,z).  a, b are limited to positive real values
-and p is in the interval [0,1].  Note that as a, b approach zero
-invibeta() approaches 1.0 and its relative accuracy is limited by
-floating point precision.
-
-
-File: gnuplot.info,  Node: LambertW,  Next: lnGamma,  Prev: Invibeta,  Up: Functions
-
-1.15.3.84 LambertW
-..................
-
-Lambert W function with complex domain and range.  LambertW( z, k )
-returns the kth branch of the function W defined by the equation W(z) *
-exp(W(z)) = z.  The complex value is obtained using Halley's method as
-described by Corless et al [1996], Adv.  Comp.  Math 5:329.  The nominal
-precision is 1.E-13 but convergence can be poor very close to
-discontinuities, e.g.  branch points.
-
-
-File: gnuplot.info,  Node: lnGamma,  Next: Random_number_generator,  Prev: LambertW,  Up: Functions
-
-1.15.3.85 lnGamma
-.................
-
-lnGamma(z) returns the natural log of the gamma function with complex
-domain and range.  Implemented using 14 term approximation following
-Lanczos [1964], SIAM JNA 1:86-96.  The imaginary component of the result
-is phase-shifted to yield a continuous surface everywhere except the
-negative real axis.
-
-
-File: gnuplot.info,  Node: Random_number_generator,  Next: Special_functions_with_complex_arguments,  Prev: lnGamma,  Up: Functions
-
-1.15.3.86 Random number generator
-.................................
-
-The function 'rand()' produces a sequence of pseudo-random numbers
-between 0 and 1 using an algorithm from P. L'Ecuyer and S. Cote,
-"Implementing a random number package with splitting facilities", ACM
-Transactions on Mathematical Software, 17:98-111 (1991).
-
-           rand(0)     returns a pseudo random number in the open interval (0:1)
-                       generated from the current value of two internal
-                       32-bit seeds.
-           rand(-1)    resets both seeds to a standard value.
-           rand(x)     for integer 0 < x < 2^31-1 sets both internal seeds
-                       to x.
-           rand({x,y}) for integer 0 < x,y < 2^31-1 sets seed1 to x and
-                       seed2 to y.
-
-
-
-File: gnuplot.info,  Node: Special_functions_with_complex_arguments,  Next: Synchrotron_function,  Prev: Random_number_generator,  Up: Functions
-
-1.15.3.87 Special functions with complex arguments
-..................................................
-
-Some special functions with complex domain are provided through external
-libraries.  If your copy of gnuplot was not configured to link against
-these libraries then it will support only the real domain or will not
-provide the function at all.
-
-   Functions requiring libcerf (http://apps.jcns.fz-juelich.de/libcerf)
-depend on configuration option '-with-libcerf'.  This is the default.
-See *note cerf::, *note cdawson::, *note faddeeva::, *note erfi::, 'VP',
-and 'VP_fwhm'.
-
-   Complex Airy, Bessel, and Hankel functions of real order nu and
-complex arguments require a library containing routines implemented by
-Douglas E. Amos, Sandia National Laboratories, SAND85-1018 (1985).
-These routines may be found in netlib (http://netlib.sandia.gov) or in
-libopenspecfun (https://github.com/JuliaLang/openspecfun).  The
-corresponding configuration option is '-with-amos=<library directory>'.
-See 'Ai', 'Bi', 'BesselJ', 'BesselY', 'BesselI', 'BesselK', 'Hankel'.
-The complex exponential integral is provided by netlib or libamos but
-not by libopenspecfun.  See 'expint'.
-
-
-File: gnuplot.info,  Node: Synchrotron_function,  Next: Time_functions,  Prev: Special_functions_with_complex_arguments,  Up: Functions
-
-1.15.3.88 Synchrotron function
-..............................
-
-The synchrotron function SynchrotronF(x) describes the power
-distribution spectrum of synchrotron radiation as a function of x given
-in units of the critical photon energy (i.e.  critical frequency vc).
-
-   Chebyshev coefficients for approximation accurate to 1.E-15 are taken
-from MacLead (2000) NuclInstMethPhysRes A443:540-545.
-
-
-File: gnuplot.info,  Node: Time_functions,  Next: uigamma,  Prev: Synchrotron_function,  Up: Functions
-
-1.15.3.89 Time functions
-........................
-
--- TIME --
-
-   The 'time(x)' function returns the current system time.  This value
-can be converted to a date string with the *note strftime:: function, or
-it can be used in conjunction with 'timecolumn' to generate relative
-time/date plots.  The type of the argument determines what is returned.
-If the argument is an integer, time() returns the current time as an
-integer, in seconds from the epoch date, 1 Jan 1970.  If the argument is
-real (or complex), the result is real as well.  If the argument is a
-string, it is assumed to be a format and it is passed to *note
-strftime:: to provide a formatted time string.  See also
-'time_specifiers' and *note timefmt::.
-
--- TIMECOLUMN --
-
-   'timecolumn(N,"timeformat")' reads string data starting at column N
-as a time/date value and uses "timeformat" to interpret this as "seconds
-since the epoch" to millisecond precision.  If no format parameter is
-given, the format defaults to the string from *note timefmt::.  This
-function is valid only in the 'using' specification of a plot or stats
-command.  See 'plot datafile using'.
-
--- TM_STRUCTURE --
-
-   Gnuplot stores time internally as a 64-bit floating point value
-representing seconds since the epoch date 1 Jan 1970.  In order to
-interpret this as a time or date it is converted to or from a POSIX
-standard structure 'struct_tm'.  Note that fractional seconds, if any,
-cannot be retrieved via tm_sec().  The components may be accessed
-individually using the functions
-   * 'tm_hour(t)' integer hour in the range 0-23
-   * 'tm_mday(t)' integer day of month in the range 1-31
-   * 'tm_min(t)' integer minute in the range 0-59
-   * 'tm_mon(t)' integer month of year in the range 0-11
-   * 'tm_sec(t)' integer second in the range 0-59
-   * 'tm_wday(t)' integer day of the week in the range 0
-     (Sunday)-6(Saturday)
-   * 'tm_yday(t)' integer day of the year the range 0-365
-   * 'tm_year(t)' integer year
-
--- TM_WEEK --
-
-   The 'tm_week(t, standard)' function interprets its first argument t
-as a time in seconds from 1 Jan 1970.  Despite the name of this function
-it does not report a field from the POSIX tm structure.
-
-   If standard = 0 it returns the week number in the ISO 8601 "week
-date" system.  This corresponds to gnuplot's %W time format.  If
-standard = 1 it returns the CDC epidemiological week number ("epi
-week").  This corresponds to gnuplot's %U time format.  For
-corresponding inverse functions that convert week dates to calendar time
-see 'weekdate_iso', 'weekdate_cdc'.
-
-   In brief, ISO Week 1 of year YYYY begins on the Monday closest to 1
-Jan YYYY. This may place it in the previous calendar year.  For example
-Tue 30 Dec 2008 has ISO week date 2009-W01-2 (2nd day of week 1 of
-2009).  Up to three days at the start of January may come before the
-Monday of ISO week 1; these days are assigned to the final week of the
-previous calendar year.  E.g.  Fri 1 Jan 2021 has ISO week date
-2020-W53-5.
-
-   The US Center for Disease Control (CDC) epidemiological week is a
-similar week date convention that differs from the ISO standard by
-defining a week as starting on Sunday, rather than on Monday.
-
--- WEEKDATE_ISO --
-
-   Syntax:
-          time = weekdate_iso( year, week [, day] )
-
-
-   This function converts from the year, week, day components of a date
-in ISO 8601 "week date" format to the calendar date as a time in seconds
-since the epoch date 1 Jan 1970.  Note that the nominal year in the week
-date system is not necessarily the same as the calendar year.  The week
-is an integer from 1 to 53.  The day parameter is optional.  If it is
-omitted or equal to 0 the time returned is the start of the week.
-Otherwise day is an integer from 1 (Monday) to 7 (Sunday).  See
-'tm_week' for additional information on an inverse function that
-converts from calendar date to week number in the ISO standard
-convention.
-
-   Example:
-          # Plot data from a file with column 1 containing ISO weeks
-          #     Week     cases  deaths
-          #     2020-05    432       1
-          calendar_date(w) = weekdate_iso( int(w[1:4]), int(w[6:7]) )
-          set xtics time format "%b\n%Y"
-          plot FILE using (calendar_date(strcol(1))) : 2   title columnhead
-
-
--- WEEKDATE_CDC --
-
-   Syntax:
-          time = weekdate_cdc( year, week [, day] )
-
-
-   This function converts from the year, week, day components of a date
-in the CDC/MMWR "epi week" format to the calendar date as a time in
-seconds since the epoch date 1 Jan 1970.  The CDC week date convention
-differs from the ISO week date in that it is defined in terms of each
-week running from day 1 = Sunday to day 7 = Saturday.  If the third
-parameter is 0 or is omitted, the time returned is the start of the
-week.  See 'tm_week' and 'weekdate_iso'.
-
-
-File: gnuplot.info,  Node: uigamma,  Next: using_specifier_functions,  Prev: Time_functions,  Up: Functions
-
-1.15.3.90 uigamma
-.................
-
-'uigamma(a, x)' returns the regularized upper incomplete gamma function
-Q(a, x), NIST DLMF eq 8.2.4 For the complementary lower incomplete gamma
-function P(a,x), see 'igamma'.  Q(a, x) + P(a, x) = 1.
-
-   The current implementation is from the Cephes library (Moshier 2000).
-The domain is restricted to real a>0, real x>=0.
-
-
-File: gnuplot.info,  Node: using_specifier_functions,  Next: value,  Prev: uigamma,  Up: Functions
-
-1.15.3.91 using specifier functions
-...................................
-
-These functions are valid only in the context of data input.  Usually
-this means use in an expression that provides an input field of the
-'using' specifier in a 'plot', 'splot', *note fit::, or 'stats' command.
-However the scope of the functions is actually the full clause of the
-plot command, including for example use of 'columnhead' in constructing
-the plot title.
-
--- COLUMN --
-
-   The 'column(x)' function may be used only in the 'using' specifier of
-a plot, splot, fit, or stats command.  It evaluates to the numerical
-value of the content of column x.  If the column is expected to hold a
-string, use instead stringcolumn(x) or timecolumn(x, "timeformat").  See
-'plot datafile using', 'stringcolumn', 'timecolumn'.
-
--- COLUMNHEAD --
-
-   The 'columnhead(x)' function may only be used as part of a plot,
-splot, or stats command.  It evaluates to a string containing the
-content of column x in the first line of a data file.  This is typically
-used to extract the column header for use in a plot title.  See 'plot
-datafile using'.  Example:
-          set datafile columnheader
-          plot for [i=2:4] DATA using 1:i title columnhead(i)
-
-
--- STRINGCOLUMN --
-
-   The 'stringcolumn(x)' function may be used only in the 'using'
-specification of a data plot or *note fit:: command.  It returns the
-content of column x as a string.  'strcol(x)' is shorthand for
-'stringcolumn(x)'.  If the string is to be interpreted as a time or
-date, use instead timecolumn(x, "timeformat").  See 'plot datafile
-using'.
-
--- VALID --
-
-   The 'valid(x)' function may be used only in expressions that are part
-of a 'using' specification.  It can be used to detect explicit NaN
-values or unexpected garbage in a field of the input stream, perhaps to
-substitute a default value or to prevent further arithmetic operations
-using NaN. Both "missing" and NaN (not-a-number) data values are
-considered to be invalid, but it is important to note that if the
-program recognizes that a field is truly missing or contains a "missing"
-flag then the input line is discarded before the expression invoking
-valid() would be called.  See 'plot datafile using', 'missing'.
-
-   Example:
-          # Treat an unrecognized bin value as contributing some constant
-          # prior expectation to the bin total rather than ignoring it.
-          plot DATA using 1 : (valid(2) ? $2 : prior) smooth unique
-
-
-
-File: gnuplot.info,  Node: value,  Next: Counting_and_extracting_words,  Prev: using_specifier_functions,  Up: Functions
-
-1.15.3.92 value
-...............
-
-B = value("A") is effectively the same as B = A, where A is the name of
-a user-defined variable.  This is useful when the name of the variable
-is itself held in a string variable.  See 'user-defined variables'.  It
-also allows you to read the name of a variable from a data file.  If the
-argument is a numerical expression, value() returns the value of that
-expression.  If the argument is a string that does not correspond to a
-currently defined variable, value() returns NaN.
-
-
-File: gnuplot.info,  Node: Counting_and_extracting_words,  Next: zeta,  Prev: value,  Up: Functions
-
-1.15.3.93 Counting and extracting words
-.......................................
-
-'word("string",n)' returns the nth word in string.  For example,
-'word("one two three",2)' returns the string "two".
-
-   'words("string")' returns the number of words in string.  For
-example, 'words(" a b c d")' returns 4.
-
-   Words must be separated by whitespace; if you need to extract
-individual fields from a string that are separated by some other
-character, use instead *note split::.
-
-   The 'word' and *note words:: functions provide limited support for
-quoted strings, both single and double quotes can be used:
-           print words("\"double quotes\" or 'single quotes'")   # 3
-
-   A starting quote must either be preceded by a white space, or start
-the string.  This means that apostrophes in the middle or at the end of
-words are considered as parts of the respective word:
-           print words("Alexis' phone doesn't work") # 4
-
-   Escaping quote characters is not supported.  If you want to keep
-certain quotes, the respective section must be surrounded by the other
-kind of quotes:
-           s = "Keep \"'single quotes'\" or '\"double quotes\"'"
-           print word(s, 2) # 'single quotes'
-           print word(s, 4) # "double quotes"
-
-   Note, that in this last example the escaped quotes are necessary only
-for the string definition.
-
-   'split("string", "sep")' uses the character sequence in "sep" as a
-field separator to split the content of "string" into individual fields.
-It returns an array of strings, each corresponding to one field of the
-original string.  The second parameter "sep" is optional.  If "sep" is
-omitted or if it contains a single space character the fields are split
-by any amount of whitespace (space, tab, formfeed, newline, return).
-Otherwise the full sequence of characters in "sep" must be matched.
-
-   The three examples below each produce an array [ "A", "B", "C", "D" ]
-         t1 = split( "A B C D" )
-         t2 = split( "A B C D", " ")
-         t3 = split( "A;B;C;D", ";")
-
-
-   However the command
-         t4 = split( "A;B; C;D", "; " )
-
-   produces an array containing only two strings [ "A;B", "C;D" ]
-because the two-character field separator sequence "; " is found only
-once.
-
-   Note: Breaking the string into an array of single characters using an
-empty string for sep is not currently implemneted.  You can instead
-accomplish this using single character substrings: Array[i] =
-"string"[i:i]
-
-   'join(array, "sep")' concatenates the string elements of an array
-into a single string containing fields delimited by the character
-sequence in "sep".  Non-string array elements generate an empty field.
-The complementary operation *note split:: break extracts fields from a
-string to create an array.  Example:
-         array A = ["A", "B", , 7, "E"]
-         print join(A,";")
-               A;B;;;E
-
-
-   'trim(" padded string ")' returns the original string stripped of
-leading and trailing whitespace.  This is useful for string comparisons
-of input data fields that may contain extra whitespace.  For example
-          plot FOO using 1:( trim(strcol(3)) eq "A" ? $2 : NaN )
-
-
-
-File: gnuplot.info,  Node: zeta,  Prev: Counting_and_extracting_words,  Up: Functions
-
-1.15.3.94 zeta
-..............
-
-zeta(s) is the Riemann zeta function with complex domain and range.
-
-   This implementation uses the polynomial series described in algorithm
-3 of P. Borwein [2000] Canadian Mathematical Society Conference
-Proceedings.  The nominal precision is 1.e-16 over the complex plane.
-However note that this does not guarantee that non-trivial zeros of the
-zeta function will evaluate exactly to 0.
-
-
-File: gnuplot.info,  Node: operators,  Next: summation,  Prev: Functions,  Up: Expressions
-
-1.15.4 operators
-----------------
-
-The operators in 'gnuplot' are the same as the corresponding operators
-in the C programming language, except that all operators accept integer,
-real, and complex arguments, unless otherwise noted.  The ** operator
-(exponentiation) is supported, as in FORTRAN.
-
-   Operator precedence is the same as in Fortran and C. As in those
-languages, parentheses may be used to change the order of operation.
-Thus -2**2 = -4, but (-2)**2 = 4.
-
-* Menu:
-
-* Unary::
-* Binary::
-* Ternary::
-
-
-File: gnuplot.info,  Node: Unary,  Next: Binary,  Prev: operators,  Up: operators
-
-1.15.4.1 Unary
-..............
-
-The following is a list of all the unary operators:
-
-         Symbol      Example    Explanation
-           -           -a          unary minus
-           +           +a          unary plus (no-operation)
-           ~           ~a        * one's complement
-           !           !a        * logical negation
-           !           a!        * factorial
-           $           $3        * data column in `using` specifier
-           ||          |A|         cardinality of array A
-
-   (*) Starred explanations indicate that the operator requires an
-integer argument.
-
-   The factorial operator returns an integer when N! is sufficiently
-small (N <= 20 for 64-bit integers).  It returns a floating point
-approximation for larger values of N.
-
-   The cardinality operator |...| returns the number of elements |A| in
-array A. It returns the number of data lines |$DATA| when applied to
-datablock $DATA.
-
-
-File: gnuplot.info,  Node: Binary,  Next: Ternary,  Prev: Unary,  Up: operators
-
-1.15.4.2 Binary
-...............
-
-The following is a list of all the binary operators:
-
-         Symbol       Example      Explanation
-           **          a**b          exponentiation
-           *           a*b           multiplication
-           /           a/b           division
-           %           a%b         * modulo
-           +           a+b           addition
-           -           a-b           subtraction
-           ==          a==b          equality
-           !=          a!=b          inequality
-           <           a<b           less than
-           <=          a<=b          less than or equal to
-           >           a>b           greater than
-           >=          a>=b          greater than or equal to
-           <<          0xff<<1       left shift unsigned
-           >>          0xff>>2       right shift unsigned
-           &           a&b         * bitwise AND
-           ^           a^b         * bitwise exclusive OR
-           |           a|b         * bitwise inclusive OR
-           &&          a&&b        * logical AND
-           ||          a||b        * logical OR
-           =           a = b         assignment
-           ,           (a,b)         serial evaluation
-           .           A.B           string concatenation
-           eq          A eq B        string equality
-           ne          A ne B        string inequality
-
-   (*) Starred explanations indicate that the operator requires integer
-arguments.  Capital letters A and B indicate that the operator requires
-string arguments.
-
-   Logical AND (&&) and OR (||) short-circuit the way they do in C. That
-is, the second '&&' operand is not evaluated if the first is false; the
-second '||' operand is not evaluated if the first is true.
-
-   Serial evaluation occurs only in parentheses and is guaranteed to
-proceed in left to right order.  The value of the rightmost
-subexpression is returned.
-
-
-File: gnuplot.info,  Node: Ternary,  Prev: Binary,  Up: operators
-
-1.15.4.3 Ternary
-................
-
-There is a single ternary operator:
-
-         Symbol       Example      Explanation
-           ?:          a?b:c     ternary operation
-
-
-   The ternary operator behaves as it does in C. The first argument (a),
-which must be an integer, is evaluated.  If it is true (non-zero), the
-second argument (b) is evaluated and returned; otherwise the third
-argument (c) is evaluated and returned.
-
-   The ternary operator is very useful both in constructing piecewise
-functions and in plotting points only when certain conditions are met.
-
-   Examples:
-
-   Plot a function that is to equal sin(x) for 0 <= x < 1, 1/x for 1 <=
-x < 2, and undefined elsewhere:
-           f(x) = 0<=x && x<1 ? sin(x) : 1<=x && x<2 ? 1/x : 1/0
-           plot f(x)
-
-   Note that 'gnuplot' quietly ignores undefined values when plotting,
-so the final branch of the function (1/0) will produce no plottable
-points.  Note also that f(x) will be plotted as a continuous function
-across the discontinuity if a line style is used.  To plot it
-discontinuously, create separate functions for the two pieces.
-
-   For data in a file, plot the average of the data in columns 2 and 3
-against the datum in column 1, but only if the datum in column 4 is
-non-negative:
-
-           plot 'file' using 1:( $4<0 ? 1/0 : ($2+$3)/2 )
-
-
-   For an explanation of the 'using' syntax, please see 'plot datafile
-using'.
-
-
-File: gnuplot.info,  Node: summation,  Next: Gnuplot-defined_variables,  Prev: operators,  Up: Expressions
-
-1.15.5 summation
-----------------
-
-A summation expression has the form
-           sum [<var> = <start> : <end>] <expression>
-
-   <var> is treated as an integer variable that takes on successive
-integral values from <start> to <end>.  For each of these, the current
-value of <expression> is added to a running total whose final value
-becomes the value of the summation expression.  Examples:
-           print sum [i=1:10] i
-               55.
-           # Equivalent to plot 'data' using 1:($2+$3+$4+$5+$6+...)
-           plot 'data' using 1 : (sum [col=2:MAXCOL] column(col))
-
-   It is not necessary that <expression> contain the variable <var>.
-Although <start> and <end> can be specified as variables or expressions,
-their value cannot be changed dynamically as a side-effect of carrying
-out the summation.  If <end> is less than <start> then the value of the
-summation is zero.
-
-
-File: gnuplot.info,  Node: Gnuplot-defined_variables,  Next: User-defined_variables_and_functions,  Prev: summation,  Up: Expressions
-
-1.15.6 Gnuplot-defined variables
---------------------------------
-
-Gnuplot maintains a number of read-only variables that reflect the
-current internal state of the program and the most recent plot.  These
-variables begin with the prefix "GPVAL_".  Examples include GPVAL_TERM,
-GPVAL_X_MIN, GPVAL_X_MAX, GPVAL_Y_MIN. Type 'show variables all' to
-display the complete list and current values.  Values related to axes
-parameters (ranges, log base) are values used during the last plot, not
-those currently 'set'.
-
-   Example: To calculate the fractional screen coordinates of the point
-[X,Y]
-          GRAPH_X = (X - GPVAL_X_MIN) / (GPVAL_X_MAX - GPVAL_X_MIN)
-          GRAPH_Y = (Y - GPVAL_Y_MIN) / (GPVAL_Y_MAX - GPVAL_Y_MIN)
-          SCREEN_X = GPVAL_TERM_XMIN + GRAPH_X * (GPVAL_TERM_XMAX - GPVAL_TERM_XMIN)
-          SCREEN_Y = GPVAL_TERM_YMIN + GRAPH_Y * (GPVAL_TERM_YMAX - GPVAL_TERM_YMIN)
-          FRAC_X = SCREEN_X * GPVAL_TERM_SCALE / GPVAL_TERM_XSIZE
-          FRAC_Y = SCREEN_Y * GPVAL_TERM_SCALE / GPVAL_TERM_YSIZE
-
-
-   The read-only variable GPVAL_ERRNO is set to a non-zero value if any
-gnuplot command terminates early due to an error.  The most recent error
-message is stored in the string variable GPVAL_ERRMSG. Both GPVAL_ERRNO
-and GPVAL_ERRMSG can be cleared using the command 'reset errors'.
-
-   Interactive terminals with 'mouse' functionality maintain read-only
-variables with the prefix "MOUSE_".  See 'mouse variables' for details.
-
-   The *note fit:: mechanism uses several variables with names that
-begin "FIT_".  It is safest to avoid using such names.  When using 'set
-fit errorvariables', the error for each fitted parameter will be stored
-in a variable named like the parameter, but with "_err" appended.  See
-the documentation on *note fit:: and *note fit:: for details.
-
-   See 'user-defined variables', 'reset errors', 'mouse variables', and
-*note fit::.
-
-
-File: gnuplot.info,  Node: User-defined_variables_and_functions,  Next: arrays,  Prev: Gnuplot-defined_variables,  Up: Expressions
-
-1.15.7 User-defined variables and functions
--------------------------------------------
-
-New user-defined variables and functions of one through twelve variables
-may be declared and used anywhere, including on the 'plot' command
-itself.
-
-   User-defined function syntax:
-           <func-name>( <dummy1> {,<dummy2>} ... {,<dummy12>} ) = <expression>
-
-
-   where <expression> is defined in terms of <dummy1> through <dummy12>.
-This form of function definition is limited to a single line.  More
-complicated multi-line functions can be defined using the function block
-mechanism (new in this version).  See 'function blocks'.
-
-   User-defined variable syntax:
-           <variable-name> = <constant-expression>
-
-
-   Examples:
-           w = 2
-           q = floor(tan(pi/2 - 0.1))
-           f(x) = sin(w*x)
-           sinc(x) = sin(pi*x)/(pi*x)
-           delta(t) = (t == 0)
-           ramp(t) = (t > 0) ? t : 0
-           min(a,b) = (a < b) ? a : b
-           comb(n,k) = n!/(k!*(n-k)!)
-           len3d(x,y,z) = sqrt(x*x+y*y+z*z)
-           plot f(x) = sin(x*a), a = 0.2, f(x), a = 0.4, f(x)
-
-
-           file = "mydata.inp"
-           file(n) = sprintf("run_%d.dat",n)
-
-
-   The final two examples illustrate a user-defined string variable and
-a user-defined string function.
-
-   Note that the variables 'pi' (3.14159...)  and *note NaN:: (IEEE "Not
-a Number") are already defined.  You can redefine these to something
-else if you really need to.  The original values can be recovered by
-setting:
-
-           NaN = GPVAL_NaN
-           pi  = GPVAL_pi
-
-
-   Other variables may be defined under various gnuplot operations like
-mousing in interactive terminals or fitting; see 'gnuplot-defined
-variables' for details.
-
-   You can check for existence of a given variable V by the exists("V")
-expression.  For example
-           a = 10
-           if (exists("a")) print "a is defined"
-           if (!exists("b")) print "b is not defined"
-
-
-   Valid names are the same as in most programming languages: they must
-begin with a letter, but subsequent characters may be letters, digits,
-or "_".
-
-   Each function definition is made available as a special string-valued
-variable with the prefix 'GPFUN_'.
-
-   Example:
-           set label GPFUN_sinc at graph .05,.95
-
-
-   See *note functions::, *note functions::, 'gnuplot-defined
-variables', *note macros::, *note value::.
-
-
-File: gnuplot.info,  Node: arrays,  Prev: User-defined_variables_and_functions,  Up: Expressions
-
-1.15.8 arrays
--------------
-
-Arrays are implemented as indexed lists of user variables.  The elements
-in an array are not limited to a single type of variable.  Arrays must
-be created explicitly before being referenced.  The size of an array
-cannot be changed after creation.  Array elements are initially
-undefined unless they are provided in the array declaration.  In most
-places an array element can be used instead of a named user variable.
-
-   The cardinality (number of elements) of array A is given by the
-expression |A|.
-
-   Examples:
-          array A[6]
-          A[1] = 1
-          A[2] = 2.0
-          A[3] = {3.0, 3.0}
-          A[4] = "four"
-          A[6] = A[2]**3
-          array B[6] = [ 1, 2.0, A[3], "four", , B[2]**3 ]
-          array C = split("A B C D E F")
-
-
-          do for [i=1:6] { print A[i], B[i] }
-              1 1
-              2.0 2.0
-              {3.0, 3.0} {3.0, 3.0}
-              four four
-              <undefined> <undefined>
-              8.0 8.0
-
-
-   Note: Arrays and variables share the same namespace.  For example,
-assignment of a string to a variable named FOO will destroy any
-previously created array with name FOO.
-
-   The name of an array can be used in a 'plot', 'splot', *note fit::,
-or 'stats' command.  This is equivalent to providing a file in which
-column 1 holds the array index (from 1 to size), column 2 holds the
-value of real(A[i]) and column 3 holds the value of imag(A[i]).
-
-   Example:
-          array A[200]
-          do for [i=1:200] { A[i] = sin(i * pi/100.) }
-          plot A title "sin(x) in centiradians"
-
-
-   When plotting the imaginary component of complex array values, it may
-be referenced either as imag(A[$1]) or as $3.  These two commands are
-equivalent
-
-          plot A using (real(A[$1])) : (imag(A[$1]))
-          plot A using 2:3
-
-
-* Menu:
-
-* Array_functions::
-* Array_indexing::
-
-
-File: gnuplot.info,  Node: Array_functions,  Next: Array_indexing,  Prev: arrays,  Up: arrays
-
-1.15.8.1 Array functions
-........................
-
-Starting with gnuplot version 6, an array can be passed to a function or
-returned by a function.  For example a simple dot-product function
-acting on two equal-sized numerical arrays could be defined:
-
-          dot(A,B) = (|A| != |B|) ? NaN : sum [i=1:|A|] A[i] * B[i]
-
-
-   Built-in functions that return an array include the slice operation
-array[min:max] and the index retrieval function index(Array,value).
-
-          T = split("A B C D E F")
-          U = T[3:4]
-          print T
-             [ "A", "B", "C", "D", "E", "F" ]
-          print U
-             [ "C", "D" ]
-          print index( T, "D" )
-             4
-
-
-   Note that T and U in this example are now arrays, whether or not they
-had been previously declared.
-
-
-File: gnuplot.info,  Node: Array_indexing,  Prev: Array_functions,  Up: arrays
-
-1.15.8.2 Array indexing
-.......................
-
-Array indices run from 1 to N for an array with N elements.  Element i
-of array A is accessed by A[i].  The built-in function 'index(Array,
-<value>)' returns an integer i such that A[i] is equal to <value>, where
-<value> may be any expression that evaluates to a number (integer, real,
-or complex) or a string.  The array element must match in both type and
-value.  A return of 0 indicates that no match was found.
-
-         array A = [ 4.0, 4, "4" ]
-         print index( A, 4 )
-               2
-         print index( A, 2.+2. )
-               1
-         print index( A, "D4"[2:2] )
-               3
-
-
-
-File: gnuplot.info,  Node: Fonts,  Next: Glossary,  Prev: Expressions,  Up: Gnuplot
-
-1.16 Fonts
-==========
-
-Gnuplot does not provide any fonts of its own.  It relies on external
-font handling, the details of which unfortunately vary from one terminal
-type to another.  Brief documentation of font mechanisms that apply to
-more than one terminal type is given here.  For information on font use
-by other individual terminals, see the documentation for that terminal.
-
-   Although it is possible to include non-alphabetic symbols by
-temporarily switching to a special font, e.g.  the Adobe Symbol font,
-the preferred method is now to choose UTF-8 encoding and treat the
-symbol like any other character.  Alternatively you can specify the
-unicode entry point for the desired symbol as an escape sequence in
-enhanced text mode.  See *note encoding::, 'unicode', *note locale::,
-and 'escape sequences'.
-
-* Menu:
-
-* cairo_(pdfcairo::
-* gd_(png::
-* postscript__(also_encapsulated_postscript_*.eps)::
-
-
-File: gnuplot.info,  Node: cairo_(pdfcairo,  Next: gd_(png,  Prev: Fonts,  Up: Fonts
-
-1.16.1 cairo (pdfcairo, pngcairo, epscairo, wxt terminals)
-----------------------------------------------------------
-
-Some terminals, including all the cairo-based terminals, access fonts
-via the fontconfig system library.  Please see the fontconfig user
-manual.  (http://fontconfig.org/fontconfig-user.html) It is usually
-sufficient in gnuplot to request a font by a generic name and size,
-letting fontconfig substitute a similar font if necessary.  The
-following will probably all work:
-          set term pdfcairo font "sans,12"
-          set term pdfcairo font "Times,12"
-          set term pdfcairo font "Times-New-Roman,12"
-
-
-
-File: gnuplot.info,  Node: gd_(png,  Next: postscript__(also_encapsulated_postscript_*.eps),  Prev: cairo_(pdfcairo,  Up: Fonts
-
-1.16.2 gd (png, gif, jpeg, sixel terminals)
--------------------------------------------
-
-Font handling for the png, gif, jpeg, and sixelgd terminals is done by
-the libgd library.  At a minimum it provides five basic fonts named
-'tiny', 'small', 'medium', 'large', and 'giant' that cannot be scaled or
-rotated.  Use one of these keywords instead of the 'font' keyword.  E.g.
-          set term png tiny
-
-
-   On many systems libgd can also use generic font handling provided by
-the fontconfig tools (see 'fontconfig').  On most systems without
-fontconfig, libgd provides access to Adobe fonts (*.pfa *.pfb) and to
-TrueType fonts (*.ttf).  You must give the name of the font file, not
-the name of the font inside it, in the form "<face> {,<size>}".  <face>
-is either the full pathname to the font file, or the first part of a
-filename in one of the directories listed in the GDFONTPATH
-environmental variable.  That is, 'set term png font "Face"' will look
-for a font file named either <somedirectory>/Face.ttf or
-<somedirectory>/Face.pfa.  For example, if GDFONTPATH contains
-'/usr/local/fonts/ttf:/usr/local/fonts/pfa' then the following pairs of
-commands are equivalent
-          set term png font "arial"
-          set term png font "/usr/local/fonts/ttf/arial.ttf"
-          set term png font "Helvetica"
-          set term png font "/usr/local/fonts/pfa/Helvetica.pfa"
-
-   To request a default font size at the same time:
-          set term png font "arial,11"
-
-
-   If no specific font is requested in the "set term" command, gnuplot
-checks the environmental variable GNUPLOT_DEFAULT_GDFONT.
-
-
-File: gnuplot.info,  Node: postscript__(also_encapsulated_postscript_*.eps),  Prev: gd_(png,  Up: Fonts
-
-1.16.3 postscript (also encapsulated postscript *.eps)
-------------------------------------------------------
-
-PostScript font handling is done by the printer or viewing program.
-Gnuplot can create valid PostScript or encapsulated PostScript (*.eps)
-even if no fonts at all are installed on your computer.  Gnuplot simply
-refers to the font by name in the output file, and assumes that the
-printer or viewing program will know how to find or approximate a font
-by that name.
-
-   All PostScript printers or viewers should know about the standard set
-of Adobe fonts 'Times-Roman', 'Helvetica', 'Courier', and 'Symbol'.  It
-is likely that many additional fonts are also available, but the
-specific set depends on your system or printer configuration.  Gnuplot
-does not know or care about this; the output *.ps or *.eps files that it
-creates will simply refer to whatever font names you request.
-
-   Thus
-          set term postscript eps font "Times-Roman,12"
-
-   will produce output that is suitable for all printers and viewers.
-
-   On the other hand
-          set term postscript eps font "Garamond-Premier-Pro-Italic"
-
-   will produce a valid PostScript output file, but since it refers to a
-specialized font only some printers or viewers will be able to display
-the exact font that was requested.  Most will substitute a different
-font.
-
-   However, it is possible to embed a specific font in the output file
-so that all printers will be able to use it.  This requires that the a
-suitable font description file is available on your system.  Note that
-some font files require specific licensing if they are to be embedded in
-this way.  See 'postscript fontfile' for more detailed description and
-examples.
-
-
-File: gnuplot.info,  Node: Glossary,  Next: inline_data_and_datablocks,  Prev: Fonts,  Up: Gnuplot
-
-1.17 Glossary
-=============
-
-As 'gnuplot' has evolved over more than 30 years, the meaning of certain
-words used in commands and in the documentation may have diverged from
-current common usage.  This section explains how some of these terms are
-used in 'gnuplot'.
-
-   The term "terminal" refers to an output mode, not to the thing you
-are typing on.  For example, the command 'set terminal pdf' means that
-subsequent plotting commands will produce pdf ouput.  Usually you would
-want to accompany this with a 'set output "filename"' command to control
-where the pdf output is written.
-
-   A "page" or "screen" or "canvas" is the entire area addressable by
-'gnuplot'.  On a desktop it is a full window; on a plotter, it is a
-single sheet of paper.
-
-   When discussing data files, the term "record" denotes a single line
-of text in the file, that is, the characters between newline or
-end-of-record characters.  A "point" is the datum extracted from a
-single record.  A "block" of data is a set of consecutive records
-delimited by blank lines.  A line, when referred to in the context of a
-data file, is a subset of a block.  Note that the term "data block" may
-also be used to refer to a named block of inline data (see
-'datablocks').
-
-
-File: gnuplot.info,  Node: inline_data_and_datablocks,  Next: iteration,  Prev: Glossary,  Up: Gnuplot
-
-1.18 inline data and datablocks
-===============================
-
-There are two mechanisms for embedding data into a stream of gnuplot
-commands.  If the special filename '-' appears in a plot command, then
-the lines immediately following the plot command are interpreted as
-inline data.  See *note special-filenames::.  Data provided in this way
-can only be used once, by the plot command it follows.
-
-   The second mechanism defines a named data block as a here-document.
-The named data is persistent and may be referred to by more than one
-plot command.  Example:
-          $Mydata << EOD
-          11 22 33 first line of data
-          44 55 66 second line of data
-          # comments work just as in a data file
-          77 88 99
-          EOD
-          stats $Mydata using 1:3
-          plot $Mydata using 1:3 with points, $Mydata using 1:2 with impulses
-
-
-   Data block names must begin with a $ character, which distinguishes
-them from other types of persistent variables.  The end-of-data
-delimiter (EOD in the example) may be any sequence of alphanumeric
-characters.
-
-   For a parallel mechanism that stores executable commands rather than
-data in a named block, see 'function blocks'.
-
-   The storage associated with named data blocks can be released using
-'undefine' command.  'undefine $*' frees all named data and function
-blocks at once.
-
-
-File: gnuplot.info,  Node: iteration,  Next: linetypes,  Prev: inline_data_and_datablocks,  Up: Gnuplot
-
-1.19 iteration
-==============
-
-gnuplot supports command iteration and block-structured if/else/while/do
-constructs.  See *note if::, 'while', and 'do'.  Simple iteration is
-possible inside 'plot' or 'set' commands.  See 'plot for'.  General
-iteration spanning multiple commands is possible using a block construct
-as shown below.  For a related new feature, see the *note summation::
-expression type.  Here is an example using several of these new syntax
-features:
-           set multiplot layout 2,2
-           fourier(k, x) = sin(3./2*k)/k * 2./3*cos(k*x)
-           do for [power = 0:3] {
-               TERMS = 10**power
-               set title sprintf("%g term Fourier series",TERMS)
-               plot 0.5 + sum [k=1:TERMS] fourier(k,x) notitle
-           }
-           unset multiplot
-
-
-   Iteration is controlled by an iteration specifier with syntax
-
-          for [<var> in "string of N elements"]
-
-
-   or
-
-          for [<var> = <start> : <end> { : <increment> }]
-
-
-   In the first case <var> is a string variable that successively
-evaluates to single-word substrings 1 to N of the string in the
-iteration specifier.  In the second case <start>, <end>, and <increment>
-are integers or integer expressions.
-
-   The scope of the iteration variable is private to that iteration.
-See 'scope'.  You cannot permanently change the value of the iteration
-variable inside the iterated clause.  If the iteration variable has a
-value prior to iteration, that value will be retained or restored at the
-end of the iteration.  For example, the following commands will print 1
-2 3 4 5 6 7 8 9 10 A.
-
-          i = "A"
-          do for [i=1:10] { print i; i=10; }
-          print i
-
-
-
-File: gnuplot.info,  Node: linetypes,  Next: layers,  Prev: iteration,  Up: Gnuplot
-
-1.20 linetypes, colors, and styles
-==================================
-
-In very old gnuplot versions, each terminal type provided a set of
-distinct "linetypes" that could differ in color, in thickness, in
-dot/dash pattern, or in some combination of color and dot/dash.  These
-colors and patterns were not guaranteed to be consistent across
-different terminal types although most used the color sequence
-red/green/blue/magenta/cyan/yellow.  You can select this old behaviour
-via the command 'set colorsequence classic', but by default gnuplot now
-uses a terminal-independent sequence of 8 colors.
-
-   You can further customize the sequence of linetype properties
-interactively or in an initialization file.  See 'set linetype'.
-Several sample initialization files are provided in the distribution
-package.
-
-   The current linetype properties for a particular terminal can be
-previewed by issuing the 'test' command after setting the terminal type.
-
-   Successive functions or datafiles plotted by a single command will be
-assigned successive linetypes in the current default sequence.  You can
-override this for any individual function, datafile, or plot element by
-giving explicit line properties in the plot command.
-
-   Examples:
-
-          plot "foo", "bar"                 # plot two files using linetypes 1, 2
-          plot sin(x) linetype 4            # use linetype color 4
-
-
-   In general, colors can be specified using named colors, rgb (red,
-green, blue) components, hsv (hue, saturation, value) components, or a
-coordinate along the current pm3d palette.  The keyword 'linecolor' may
-be abbreviated to 'lc'.
-
-   Examples:
-
-          plot sin(x) lc rgb "violet"       # use one of gnuplot's named colors
-          plot sin(x) lc rgb "#FF00FF"      # explicit RGB triple in hexadecimal
-          plot sin(x) lc palette cb -45     # whatever color corresponds to -45
-                                            # in the current cbrange of the palette
-          plot sin(x) lc palette frac 0.3   # fractional value along the palette
-
-
-   See *note colorspec::, *note colornames::, 'hsv', *note palette::,
-*note cbrange::.  See also *note monochrome::.
-
-   Linetypes also have an associated dot-dash pattern although not all
-terminal types are capable of using it.  You can specify the dot-dash
-pattern independent of the line color.  See *note dashtype::.
-
-* Menu:
-
-* colorspec::
-* dashtype::
-* linestyles_vs_linetypes::
-* special_linetypes::
-
-
-File: gnuplot.info,  Node: colorspec,  Next: dashtype,  Prev: linetypes,  Up: linetypes
-
-1.20.1 colorspec
-----------------
-
-Many commands allow you to specify a linetype with an explicit color.
-
-   Syntax:
-
-           ... {linecolor | lc} {"colorname" | <colorspec> | <n>}
-           ... {textcolor | tc} {<colorspec> | {linetype | lt} <n>}
-           ... {fillcolor | fc} {<colorspec> | linetype <n> | linestyle <n>}
-
-
-   where <colorspec> has one of the following forms:
-
-           rgbcolor "colorname"    # e.g. "blue"
-           rgbcolor "0xRRGGBB"     # string containing hexadecimal constant
-           rgbcolor "0xAARRGGBB"   # string containing hexadecimal constant
-           rgbcolor "#RRGGBB"      # string containing hexadecimal in x11 format
-           rgbcolor "#AARRGGBB"    # string containing hexadecimal in x11 format
-           rgbcolor <integer val>  # integer value representing AARRGGBB
-           rgbcolor variable       # integer value is read from input file
-           palette frac <val>      # <val> runs from 0 to 1
-           palette cb <value>      # <val> lies within cbrange
-           palette z
-           palette <colormap>      # use named colormap rather than current palette
-           variable                # color index is read from input file
-           background or bgnd      # background color
-           black
-
-
-   The "<n>" is the linetype number the color of which is used, see
-'test'.
-
-   "colorname" refers to one of the color names built in to gnuplot.
-For a list of the available names, see *note colornames::.
-
-   Hexadecimal constants can be given in quotes as "#RRGGBB" or
-"0xRRGGBB", where RRGGBB represents the red, green, and blue components
-of the color and must be between 00 and FF. For example, magenta =
-full-scale red + full-scale blue could be represented by "0xFF00FF",
-which is the hexadecimal representation of (255 << 16) + (0 << 8) +
-(255).
-
-   "#AARRGGBB" represents an RGB color with an alpha channel
-(transparency) value in the high bits.  An alpha value of 0 represents a
-fully opaque color; i.e., "#00RRGGBB" is the same as "#RRGGBB". An alpha
-value of 255 (FF) represents full transparency.
-
-   For a callable function that converts any of these forms to a 32bit
-integer representation of the color, see 'expressions functions
-rgbcolor'.
-
-   The color palette is a linear gradient of colors that smoothly maps a
-single numerical value onto a particular color.  Two such mappings are
-always in effect.  'palette frac' maps a fractional value between 0 and
-1 onto the full range of the color palette.  'palette cb' maps the range
-of the color axis onto the same palette.  See *note cbrange::.  See also
-'set colorbox'.  You can use either of these to select a constant color
-from the current palette.
-
-   "palette z" maps the z value of each plot segment or plot element
-into the cbrange mapping of the palette.  This allows smoothly-varying
-color along a 3d line or surface.  It also allows coloring 2D plots by
-palette values read from an extra column of data (not all 2D plot styles
-allow an extra column).
-
-   There are two special color specifiers: 'background' (short form
-'bgnd') for background color and 'black'.
-
-* Menu:
-
-* background_color::
-* linecolor_variable::
-* palette_::
-* rgbcolor_variable::
-
-
-File: gnuplot.info,  Node: background_color,  Next: linecolor_variable,  Prev: colorspec,  Up: colorspec
-
-1.20.1.1 background color
-.........................
-
-Most terminals allow you to set an explicit background color for the
-plot.  The special linetype 'background' (short form 'bgnd') will draw
-in this color, and is also recognized as a color name.  Examples:
-          # This will erase a section of the canvas by writing over it in the
-          # background color
-          set term wxt background rgb "gray75"
-          set object 1 rectangle from x0,y0 to x1,y1 fillstyle solid fillcolor bgnd
-          # Draw an "invisible" line at y=0, erasing whatever was underneath
-          plot 0 lt background
-
-
-
-File: gnuplot.info,  Node: linecolor_variable,  Next: palette_,  Prev: background_color,  Up: colorspec
-
-1.20.1.2 linecolor variable
-...........................
-
-'lc variable' tells the program to use the value read from one column of
-the input data as a linetype index, and use the color belonging to that
-linetype.  This requires a corresponding additional column in the
-'using' specifier.  'ls variable' does the same except the value read
-from the input data stream is interpreted as the index of a linestyle
-rather than a linetype.  Text colors can be set similarly using 'tc
-variable'.
-
-   Examples:
-           # Use the third column of data to assign colors to individual points
-           plot 'data' using 1:2:3 with points lc variable
-
-
-           # A single data file may contain multiple sets of data, separated by two
-           # blank lines.  Each data set is assigned as index value (see *note index::)
-           # that can be retrieved via the `using` specifier `column(-2)`.
-           # See `pseudocolumns`.  This example uses to value in column -2 to
-           # draw each data set in a different line color.
-           plot 'data' using 1:2:(column(-2)) with lines lc variable
-
-
-
-File: gnuplot.info,  Node: palette_,  Next: rgbcolor_variable,  Prev: linecolor_variable,  Up: colorspec
-
-1.20.1.3 palette
-................
-
-Syntax
-           ... {lc|fc|tc} palette {z}
-           ... {lc|fc|tc} palette frac <fraction>
-           ... {lc|fc|tc} palette cb <fixed z-value>
-           ... fc palette <colormap>
-
-
-   The palette defines a range of colors with gray values between 0 and
-1.  'palette frac <fraction>' selects the color with gray value
-<fraction>.
-
-   'palette cb <z-value>' selects the single color whose fractional gray
-value is (z - cbmin) / (cbmax - cbmin).
-
-   *note palette:: and 'palette z' both map the z coordinate of the plot
-element being colored onto the current palette.  If z is outside cbrange
-it is by default mapped to palette fraction 0 or palette fraction 1.  If
-the option 'set pm3d noclipcb' is set, then quadrangles in a pm3d plot
-whose z values are out of range will not be drawn at all.
-
-   'fillcolor palette <colormap>' maps the z coordinate of a plot
-element onto a previously saved named colormap instead of using the
-current palette.  See *note colormap::.
-
-   If the colormap has a separate range associated with it, that range
-is used to map z values analogous to the use of cbrange to map the
-standard palette.  If there is no separate range for this colormap then
-cbrange is used.
-
-
-File: gnuplot.info,  Node: rgbcolor_variable,  Prev: palette_,  Up: colorspec
-
-1.20.1.4 rgbcolor variable
-..........................
-
-You can assign a separate color for each data point, line segment, or
-label in your plot.  'lc rgbcolor variable' tells the program to read
-RGB color information for each line in the data file.  This requires a
-corresponding additional column in the 'using' specifier.  The extra
-column is interpreted as a 24-bit packed RGB triple.  If the value is
-provided directly in the data file it is easiest to give it as a
-hexadecimal value (see 'rgbcolor').  Alternatively, the 'using'
-specifier can contain an expression that evaluates to a 24-bit RGB color
-as in the example below.  Text colors are similarly set using 'tc
-rgbcolor variable'.
-
-   Example:
-           # Place colored points in 3D at the x,y,z coordinates corresponding to
-           # their red, green, and blue components
-           rgb(r,g,b) = 65536 * int(r) + 256 * int(g) + int(b)
-           splot "data" using 1:2:3:(rgb($1,$2,$3)) with points lc rgb variable
-
-
-
-File: gnuplot.info,  Node: dashtype,  Next: linestyles_vs_linetypes,  Prev: colorspec,  Up: linetypes
-
-1.20.2 dashtype
----------------
-
-The dash pattern (*note dashtype::) is a separate property associated
-with each line, analogous to 'linecolor' or 'linewidth'.  It is not
-necessary to place the current terminal in a special mode just to draw
-dashed lines.  I.e.  the old command 'set term <termname>
-{solid|dashed}' is now ignored.
-
-   All lines have the property 'dashtype solid' unless you specify
-otherwise.  You can change the default for a particular linetype using
-the command 'set linetype' so that it affects all subsequent commands,
-or you can include the desired dashtype as part of the 'plot' or other
-command.
-
-   Syntax:
-           dashtype N          # predefined dashtype invoked by number
-           dashtype "pattern"  # string containing a combination of the characters
-                               # dot (.) hyphen (-) underscore(_) and space.
-           dashtype (s1,e1,s2,e2,s3,e3,s4,e4)  # dash pattern specified by 1 to 4
-                               # numerical pairs <solid length>, <emptyspace length>
-
-
-   Example:
-           # Two functions using linetype 1 but distinguished by dashtype
-           plot f1(x) with lines lt 1 dt solid, f2(x) with lines lt 1 dt 3
-
-
-   Some terminals support user-defined dash patterns in addition to
-whatever set of predefined dash patterns they offer.
-
-   Examples:
-          plot f(x) dt 3            # use terminal-specific dash pattern 3
-          plot f(x) dt ".. "        # construct a dash pattern on the spot
-          plot f(x) dt (2,5,2,15)   # numerical representation of the same pattern
-          set dashtype 11 (2,4,4,7) # define new dashtype to be called by index
-          plot f(x) dt 11           # plot using our new dashtype
-
-
-   If you specify a dash pattern using a string the program will convert
-this to a sequence of <solid>,<empty> pairs.  Dot "."  becomes (2,5),
-dash "-" becomes (10,10), underscore "_" becomes (20,10), and each space
-character " " adds 10 to the previous <empty> value.  The command *note
-dashtype:: will show both the original string and the converted
-numerical sequence.
-
-
-File: gnuplot.info,  Node: linestyles_vs_linetypes,  Next: special_linetypes,  Prev: dashtype,  Up: linetypes
-
-1.20.3 linestyles vs linetypes
-------------------------------
-
-A 'linestyle' is a temporary association of properties linecolor,
-linewidth, dashtype, and pointtype.  It is defined using the command
-'set style line'.  Once you have defined a linestyle, you can use it in
-a plot command to control the appearance of one or more plot elements.
-In other words, it is just like a linetype except for its lifetime.
-Whereas 'linetypes' are permanent (they last until you explicitly
-redefine them), 'linestyles' last until the next reset of the graphics
-state.
-
-   Examples:
-
-          # define a new line style with terminal-independent color cyan,
-          # linewidth 3, and associated point type 6 (a circle with a dot in it).
-          set style line 5 lt rgb "cyan" lw 3 pt 6
-          plot sin(x) with linespoints ls 5          # user-defined line style 5
-
-
-
-File: gnuplot.info,  Node: special_linetypes,  Prev: linestyles_vs_linetypes,  Up: linetypes
-
-1.20.4 special linetypes
-------------------------
-
-A few special (non-numerical) linetypes are recognized.
-
-   'lt black' specifies a solid black line.
-
-   'lt background' or 'lt bgnd' specifies a solid line with the
-background color of the current terminal.  See 'background'.
-
-   'lt nodraw' skips drawing the line altogether.  This is useful in
-conjunction with plot style *note linespoints::.  It allows you to
-suppress the line component of the plot while retaining point properties
-that are available only in this plot style.  For example
-          plot f(x) with linespoints lt nodraw pointinterval -3
-
-   will draw only every third point and will isolate it by placing a
-small circle of background color underneath it.  See *note
-linespoints::.  'lt nodraw' may also be used to suppress a particular
-set of lines that would otherwise be drawn automatically.  For example
-you could suppress certain contour levels in a contour plot by setting
-their linetype to 'nodraw'.
-
-
-File: gnuplot.info,  Node: layers,  Next: mouse_input,  Prev: linetypes,  Up: Gnuplot
-
-1.21 layers
-===========
-
-A gnuplot plot is built up by drawing its various components in a fixed
-order.  This order can be modified by assigning some components to a
-specific layer using the keywords 'behind', 'back', or 'front'.  For
-example, to replace the background color of the plot area you could
-define a colored rectangle with the attribute 'behind'.
-          set object 1 rectangle from graph 0,0 to graph 1,1 fc rgb "gray" behind
-
-   The order of drawing is
-          behind
-          back
-          the plot itself
-          the plot legend (`key`)
-          front
-
-   Within each layer elements are drawn in the order
-          grid, axis, and border elements
-          pixmaps in numerical order
-          objects (rectangles, circles, ellipses, polygons) in numerical order
-          labels in numerical order
-          arrows in numerical order
-
-   In the case of multiple plots on a single page (multiplot mode) this
-order applies separately to each component plot, not to the multiplot as
-a whole.
-
-   An exception to this is that several TeX-based terminals (e.g.
-pslatex, cairolatex) accumulate all text elements in one output stream
-and graphics in a separate output stream; the text and graphics are then
-combined to yield the final figure.  In general this leaves each text
-element either completely behind or completely in front of the graphics.
-
-
-File: gnuplot.info,  Node: mouse_input,  Next: Persist,  Prev: layers,  Up: Gnuplot
-
-1.22 mouse input
-================
-
-Many terminals allow interaction with the current plot using the mouse.
-Some also support the definition of hotkeys to activate pre-defined
-functions by hitting a single key while the mouse focus is in the active
-plot window.  It is even possible to combine mouse input with 'batch'
-command scripts, by invoking the command 'pause mouse' and then using
-the mouse variables returned by mouse clicking as parameters for
-subsequent scripted actions.  See 'bind' and 'mouse variables'.  See
-also the command 'set mouse'.
-
-* Menu:
-
-* bind::
-* Mouse_variables::
-
-
-File: gnuplot.info,  Node: bind,  Next: Mouse_variables,  Prev: mouse_input,  Up: mouse_input
-
-1.22.1 bind
------------
-
-Syntax:
-           bind {allwindows} [<key-sequence>] ["<gnuplot commands>"]
-           bind <key-sequence> ""
-           reset bind
-
-
-   The 'bind' allows defining or redefining a hotkey, i.e.  a sequence
-of gnuplot commands which will be executed when a certain key or key
-sequence is pressed while the driver's window has the input focus.  Note
-that 'bind' is only available if gnuplot was compiled with 'mouse'
-support and it is used by all mouse-capable terminals.  A user-specified
-binding supersedes any builtin bindings, except that <space> and 'q'
-cannot normally be rebound.  For an exception, see 'bind space'.
-
-   Mouse button bindings are only active in 2D plots.
-
-   You get the list of all hotkeys by typing 'show bind' or 'bind' or by
-typing the hotkey 'h' in the graph window.
-
-   Key bindings are restored to their default state by 'reset bind'.
-
-   Note that multikey-bindings with modifiers must be given in quotes.
-
-   Normally hotkeys are only recognized when the currently active plot
-window has focus.  'bind allwindows <key> ...'  (short form: 'bind all
-<key> ...')  causes the binding for <key> to apply to all gnuplot plot
-windows, active or not.  In this case gnuplot variable MOUSE_KEY_WINDOW
-is set to the ID of the originating window, and may be used by the bound
-command.
-
-   Examples:
-
-   - set bindings:
-
-         bind a "replot"
-         bind "ctrl-a" "plot x*x"
-         bind "ctrl-alt-a" 'print "great"'
-         bind Home "set view 60,30; replot"
-         bind all Home 'print "This is window ",MOUSE_KEY_WINDOW'
-
-
-   - show bindings:
-         bind "ctrl-a"          # shows the binding for ctrl-a
-         bind                   # shows all bindings
-         show bind              # show all bindings
-
-
-   - remove bindings:
-         bind "ctrl-alt-a" ""   # removes binding for ctrl-alt-a
-                                  (note that builtins cannot be removed)
-         reset bind             # installs default (builtin) bindings
-
-
-   - bind a key to toggle something:
-       v=0
-       bind "ctrl-r" "v=v+1;if(v%2)set term x11 noraise; else set term x11 raise"
-
-
-   Modifiers (ctrl / alt) are case insensitive, keys not:
-         ctrl-alt-a == CtRl-alT-a
-         ctrl-alt-a != ctrl-alt-A
-
-
-   List of modifiers (alt == meta):
-         ctrl, alt, shift (only valid for Button1 Button2 Button3)
-
-
-   List of supported special keys:
-
-        "BackSpace", "Tab", "Linefeed", "Clear", "Return", "Pause", "Scroll_Lock",
-        "Sys_Req", "Escape", "Delete", "Home", "Left", "Up", "Right", "Down",
-        "PageUp", "PageDown", "End", "Begin",
-
-
-        "KP_Space", "KP_Tab", "KP_Enter", "KP_F1", "KP_F2", "KP_F3", "KP_F4",
-        "KP_Home", "KP_Left", "KP_Up", "KP_Right", "KP_Down", "KP_PageUp",
-        "KP_PageDown", "KP_End", "KP_Begin", "KP_Insert", "KP_Delete", "KP_Equal",
-        "KP_Multiply", "KP_Add", "KP_Separator", "KP_Subtract", "KP_Decimal",
-        "KP_Divide",
-
-
-        "KP_1" - "KP_9", "F1" - "F12"
-
-
-   The following are window events rather than actual keys
-
-        "Button1" "Button2" "Button3" "Close"
-
-
-   See also help for 'mouse'.
-
-* Menu:
-
-* bind_space::
-
-
-File: gnuplot.info,  Node: bind_space,  Prev: bind,  Up: bind
-
-1.22.1.1 bind space
-...................
-
-If gnuplot was built with configuration option -enable-raise-console,
-then typing <space> in the plot window raises gnuplot's command window.
-Maybe.  In practice this is highly system-dependent.  This hotkey can be
-changed to ctrl-space by starting gnuplot as 'gnuplot -ctrlq', or by
-setting the XResource 'gnuplot*ctrlq'.
-
-
-File: gnuplot.info,  Node: Mouse_variables,  Prev: bind,  Up: mouse_input
-
-1.22.2 Mouse variables
-----------------------
-
-When 'mousing' is active, clicking in the active window will set several
-user variables that can be accessed from the gnuplot command line.  The
-coordinates of the mouse at the time of the click are stored in MOUSE_X
-MOUSE_Y MOUSE_X2 and MOUSE_Y2.  The mouse button clicked, and any
-meta-keys active at that time, are stored in MOUSE_BUTTON MOUSE_SHIFT
-MOUSE_ALT and MOUSE_CTRL. These variables are set to undefined at the
-start of every plot, and only become defined in the event of a mouse
-click in the active plot window.  To determine from a script if the
-mouse has been clicked in the active plot window, it is sufficient to
-test for any one of these variables being defined.
-
-           plot 'something'
-           pause mouse
-           if (exists("MOUSE_BUTTON")) call 'something_else'; \
-           else print "No mouse click."
-
-
-   It is also possible to track keystrokes in the plot window using the
-mousing code.
-
-           plot 'something'
-           pause mouse keypress
-           print "Keystroke ", MOUSE_KEY, " at ", MOUSE_X, " ", MOUSE_Y
-
-
-   When 'pause mouse keypress' is terminated by a keypress, then
-MOUSE_KEY will contain the ascii character value of the key that was
-pressed.  MOUSE_CHAR will contain the character itself as a string
-variable.  If the pause command is terminated abnormally (e.g.  by
-ctrl-C or by externally closing the plot window) then MOUSE_KEY will
-equal -1.
-
-   Note that after a zoom by mouse, you can read the new ranges as
-GPVAL_X_MIN, GPVAL_X_MAX, GPVAL_Y_MIN, and GPVAL_Y_MAX, see
-'gnuplot-defined variables'.
-
-
-File: gnuplot.info,  Node: Persist,  Next: Plotting,  Prev: mouse_input,  Up: Gnuplot
-
-1.23 Persist
-============
-
-Many gnuplot terminals (aqua, pm, qt, x11, windows, wxt, ...)  open
-separate display windows on the screen into which plots are drawn.  The
-'persist' option tells gnuplot to leave these windows open when the main
-program exits.  It has no effect on non-interactive terminal output.
-For example if you issue the command
-
-          gnuplot -persist -e 'plot sinh(x)'
-
-
-   gnuplot will open a display window, draw the plot into it, and then
-exit, leaving the display window containing the plot on the screen.  You
-can also specify 'persist' or 'nopersist' when you set a new terminal.
-
-          set term qt persist size 700,500
-
-
-   Depending on the terminal type, some mousing operations may still be
-possible in the persistent window.  However operations like zoom/unzoom
-that require redrawing the plot are not possible because the main
-program has exited.  If you want to leave a plot window open and fully
-mouseable after creating the plot, for example when running gnuplot from
-a script file rather than interactively, see 'pause mouse close'.
-
-
-File: gnuplot.info,  Node: Plotting,  Next: Plugins,  Prev: Persist,  Up: Gnuplot
-
-1.24 Plotting
-=============
-
-There are four 'gnuplot' commands which actually create a plot: 'plot',
-'splot', *note replot::, and *note refresh::.  Other commands control
-the layout, style, and content of the plot that will eventually be
-created.  'plot' generates 2D plots.  'splot' generates 3D plots
-(actually 2D projections, of course).  *note replot:: reexecutes the
-previous 'plot' or 'splot' command.  *note refresh:: is similar to *note
-replot:: but it reuses any previously stored data rather than rereading
-data from a file or input stream.
-
-   Each time you issue one of these four commands it will redraw the
-screen or generate a new page of output containing all of the currently
-defined axes, labels, titles, and all of the various functions or data
-sources listed in the original plot command.  If instead you need to
-place several complete plots next to each other on the same page, e.g.
-to make a panel of sub-figures or to inset a small plot inside a larger
-plot, use the command *note multiplot:: to suppress generation of a new
-page for each plot command.
-
-   Much of the general information about plotting can be found in the
-discussion of 'plot'; information specific to 3D can be found in the
-'splot' section.
-
-   'plot' operates in either rectangular or polar coordinates - see 'set
-polar'.  'splot' operates in Cartesian coordinates, but will accept
-azimuthal or cylindrical coordinates on input.  See *note mapping::.
-
-   'plot' also lets you use each of the four borders - x (bottom), x2
-(top), y (left) and y2 (right) - as an independent axis.  The *note
-axes:: option lets you choose which pair of axes a given function or
-data set is plotted against.  A full complement of 'set' commands exists
-to give you complete control over the scales and labeling of each axis.
-Some commands have the name of an axis built into their names, such as
-*note xlabel::.  Other commands have one or more axis names as options,
-such as 'set logscale xy'.  Commands and options controlling the z axis
-have no effect on 2D graphs.
-
-   'splot' can plot surfaces and contours in addition to points and/or
-lines.  See *note isosamples:: for information about defining the grid
-for a 3D function.  See *note datafile:: for information about the
-requisite file structure for 3D data.  For contours see 'set contour',
-*note cntrlabel::, and *note cntrparam::.
-
-   In 'splot', control over the scales and labels of the axes are the
-same as with 'plot' except that there is also a z axis and labeling the
-x2 and y2 axes is possible only for pseudo-2D plots created using 'set
-view map'.
-
-
-File: gnuplot.info,  Node: Plugins,  Next: Scope_of_variables,  Prev: Plotting,  Up: Gnuplot
-
-1.25 Plugins
-============
-
-The set of functions available for plotting or for evaluating
-expressions can be extended through a plugin mechanism that imports
-executable functions from a shared library.  For example, gnuplot
-versions through 5.4 did not provide a built-in implementation of the
-upper incomplete gamma function Q(a,x).  You could define an
-approximation directly in gnuplot like this:
-           Q(a,x) = 1. - igamma(a,x)
-
-   However this has inherently limited precision as igamma(a,x)
-approaches 1.  If you need a more accurate implementation, it would be
-better to provide one via a plugin (see below).  Once imported, the
-function can be used just as any other built-in or user-defined function
-in gnuplot.  See *note import::.
-
-   The gnuplot distribution includes source code and instructions for
-creating a plugin library in the directory demo/plugin.  You can modify
-the simple example file 'demo_plugin.c' by replacing one or more of the
-toy example functions with an implementation of the function you are
-interested in.  This could include invocation of functions from an
-external mathematical library.
-
-   The demo/plugin directory also contains source for a plugin that
-implements Q(a,x).  As noted above, this plugin allows earlier versions
-of gnuplot to provide the same function *note uigamma:: as version 6.
-          import Q(a,x) from "uigamma_plugin"
-          uigamma(a,x) = ((x<1 || x<a) ? 1.0-igamma(a,x) : Q(a,x))
-
-
-
-File: gnuplot.info,  Node: Scope_of_variables,  Next: Start-up_(initialization),  Prev: Plugins,  Up: Gnuplot
-
-1.26 Scope of variables
-=======================
-
-Gnuplot variables are global except in the special cases listed below.
-There is a single persistent list of active variables indexed by name.
-Assignment to a variable creates or replaces an entry in that list.  The
-only way to remove a variable from that list is the 'undefine' command.
-
-   Exception 1: The scope of the variable used in an iteration specifier
-is private to that iteration.  You cannot permanently change the value
-of the iteration variable inside the iterated clause.  If the iteration
-variable has a value prior to iteration, that value will be retained or
-restored at the end of the iteration.  For example, the following
-commands will print 1 2 3 4 5 6 7 8 9 10 A.
-
-          i = "A"
-          do for [i=1:10] { print i; i=10; }
-          print i
-
-
-   Exception 2: The parameter names used in defining a function are only
-placeholders for the actual values that will be provided when the
-function is called.  For example, any current or future values of x and
-y are not relevant to the definition shown here, but A must exist as a
-global variable when the function is later evaluated:
-
-          func(x,y) = A + (x+y)/2.
-
-
-   Exception 3: Variables declared with the 'local' command.  The
-'local' qualifier (new in version 6) allows optional declaration of a
-variable or array whose scope is limited to the execution of the code
-block in which it is found.  This includes 'load' and *note call::
-operations, evaluation of a function block, and the code in curly
-brackets that follows an *note if::, 'else', 'do for', or 'while'
-condition.  If the name of a local variable duplicates the name of a
-global variable, the global variable is shadowed until exit from the
-local scope.  EXPERIMENTAL: As currently implemented the scope of a
-local variable extends into functions called from the code block it was
-declared in; this includes *note call::, 'load', and function block
-invocation.  This will probably change in the future so that the scope
-is strictly confined to the declaring code block.
-
-
-File: gnuplot.info,  Node: Start-up_(initialization),  Next: String_constants,  Prev: Scope_of_variables,  Up: Gnuplot
-
-1.27 Start-up (initialization)
-==============================
-
-When gnuplot is run, it first looks for a system-wide initialization
-file 'gnuplotrc'.  The location of this file is determined when the
-program is built and is reported by *note loadpath::.  The program then
-looks in the user's HOME directory for a file called '.gnuplot' on
-Unix-like systems or 'GNUPLOT.INI' on other systems.  (OS/2 will look
-for it in the directory named in the environment variable 'GNUPLOT';
-Windows will use 'APPDATA'). On Unix-like systems gnuplot additionally
-checks for the file $XDG_CONFIG_HOME/gnuplot/gnuplotrc.
-
-
-File: gnuplot.info,  Node: String_constants,  Next: Substitution_and_Command_line_macros,  Prev: Start-up_(initialization),  Up: Gnuplot
-
-1.28 String constants, string variables, and string functions
-=============================================================
-
-In addition to string constants, most gnuplot commands also accept a
-string variable, a string expression, or a function that returns a
-string.  For example, the following four methods of creating a plot all
-result in the same plot title:
-
-           four = "4"
-           graph4 = "Title for plot #4"
-           graph(n) = sprintf("Title for plot #%d",n)
-
-
-           plot 'data.4' title "Title for plot #4"
-           plot 'data.4' title graph4
-           plot 'data.4' title "Title for plot #".four
-           plot 'data.4' title graph(4)
-
-
-   Since integers are promoted to strings when operated on by the string
-concatenation operator ('.'  character), the following method also
-works:
-
-           N = 4
-           plot 'data.'.N title "Title for plot #".N
-
-
-   In general, elements on the command line will only be evaluated as
-possible string variables if they are not otherwise recognizable as part
-of the normal gnuplot syntax.  So the following sequence of commands is
-legal, although probably should be avoided so as not to cause confusion:
-
-           plot = "my_datafile.dat"
-           title = "My Title"
-           plot plot title title
-
-
-* Menu:
-
-* substrings::
-* string_operators::
-* string_functions::
-* string_encoding::
-
-
-File: gnuplot.info,  Node: substrings,  Next: string_operators,  Prev: String_constants,  Up: String_constants
-
-1.28.1 substrings
------------------
-
-Substrings can be specified by appending a range specifier to any
-string, string variable, or string-valued function.  The range specifier
-has the form [begin:end], where begin is the index of the first
-character of the substring and end is the index of the last character of
-the substring.  The first character has index 1.  The begin or end
-fields may be empty, or contain '*', to indicate the true start or end
-of the original string.  Thus str[:] and str[*:*] both describe the full
-string str.  Example:
-          eos = strlen(file)
-          if (file[eos-3:*] eq ".dat") {
-              set output file[1:eos-4] . ".png"
-              plot file
-          }
-
-
-   There is also an equivalent function 'substr( string, begin, end )'.
-
-
-File: gnuplot.info,  Node: string_operators,  Next: string_functions,  Prev: substrings,  Up: String_constants
-
-1.28.2 string operators
------------------------
-
-Three binary operators require string operands: the string concatenation
-operator ".", the string equality operator "eq" and the string
-inequality operator "ne".  The following example will print TRUE.
-
-          if ("A"."B" eq "AB") print "TRUE"
-
-
-
-File: gnuplot.info,  Node: string_functions,  Next: string_encoding,  Prev: string_operators,  Up: String_constants
-
-1.28.3 string functions
------------------------
-
-Gnuplot provides several built-in functions that operate on strings.
-General formatting functions: see *note gprintf:: *note sprintf::.  Time
-formatting functions: see *note strftime:: *note strptime::.  String
-manipulation: see *note split::, 'substr' *note strstrt:: *note trim::
-'word' *note words::.
-
-
-File: gnuplot.info,  Node: string_encoding,  Prev: string_functions,  Up: String_constants
-
-1.28.4 string encoding
-----------------------
-
-Gnuplot's built-in string manipulation functions are sensitive to utf-8
-encoding (see *note encoding::).  For example
-
-      set encoding utf8
-      utf8string = "αβγ"
-      strlen(utf8string) returns 3 (number of characters, not number of bytes)
-      utf8string[2:2] evaluates to "β"
-      strstrt(utf8string,"β") evaluates to 2
-
-
-
-File: gnuplot.info,  Node: Substitution_and_Command_line_macros,  Next: Syntax,  Prev: String_constants,  Up: Gnuplot
-
-1.29 Substitution and Command line macros
-=========================================
-
-When a command line to gnuplot is first read, i.e.  before it is
-interpreted or executed, two forms of lexical substitution are
-performed.  These are triggered by the presence of text in backquotes
-(ascii character 96) or preceded by @ (ascii character 64).
-
-* Menu:
-
-* Substitution_of_system_commands_in_backquotes::
-* Substitution_of_string_variables_as_macros::
-* String_variables::
-
-
-File: gnuplot.info,  Node: Substitution_of_system_commands_in_backquotes,  Next: Substitution_of_string_variables_as_macros,  Prev: Substitution_and_Command_line_macros,  Up: Substitution_and_Command_line_macros
-
-1.29.1 Substitution of system commands in backquotes
-----------------------------------------------------
-
-Command-line substitution is specified by a system command enclosed in
-backquotes.  This command is spawned and the output it produces replaces
-the backquoted text on the command line.  Exit status of the system
-command is returned in variables GPVAL_SYSTEM_ERRNO and
-GPVAL_SYSTEM_ERRMSG.
-
-   Note: Internal carriage-return ('\r') and newline ('\n') characters
-are not stripped from the substituted string.
-
-   Command-line substitution can be used anywhere on the 'gnuplot'
-command line except inside strings delimited by single quotes.
-
-   For example, these will generate labels with the current time and
-userid:
-           set label "generated on `date +%Y-%m-%d` by `whoami`" at 1,1
-           set timestamp "generated on %Y-%m-%d by `whoami`"
-
-
-   This creates an array containing the names of files in the current
-directory:
-           FILES = split( "`ls -1`" )
-
-
-
-File: gnuplot.info,  Node: Substitution_of_string_variables_as_macros,  Next: String_variables,  Prev: Substitution_of_system_commands_in_backquotes,  Up: Substitution_and_Command_line_macros
-
-1.29.2 Substitution of string variables as macros
--------------------------------------------------
-
-The character @ is used to trigger substitution of the current value of
-a string variable into the command line.  The text in the string
-variable may contain any number of lexical elements.  This allows string
-variables to be used as command line macros.  Only string constants may
-be expanded using this mechanism, not string-valued expressions.  For
-example:
-
-           style1 = "lines lt 4 lw 2"
-           style2 = "points lt 3 pt 5 ps 2"
-           range1 = "using 1:3"
-           range2 = "using 1:5"
-           plot "foo" @range1 with @style1, "bar" @range2 with @style2
-
-
-   The line containing @ symbols is expanded on input, so that by the
-time it is executed the effect is identical to having typed in full
-
-           plot "foo" using 1:3 with lines lt 4 lw 2, \
-                "bar" using 1:5 with points lt 3 pt 5 ps 2
-
-
-   The function exists() may be useful in connection with macro
-evaluation.  The following example checks that C can safely be expanded
-as the name of a user-defined variable:
-
-           C = "pi"
-           if (exists(C)) print C," = ", @C
-
-
-   Macro expansion does not occur inside either single or double quotes.
-However macro expansion does occur inside backquotes.
-
-   Macro expansion is handled as the very first thing the interpreter
-does when looking at a new line of commands and is only done once.
-Therefore, code like the following will execute correctly:
-
-          A = "c=1"
-          @A
-
-
-   but this line will not, since the macro is defined on the same line
-and will not be expanded in time
-
-          A = "c=1"; @A   # will not expand to c=1
-
-
-   Macro expansion inside a bracketed iteration occurs before the loop
-is executed; i.e.  @A will always act as the original value of A even if
-A itself is reassigned inside the loop.
-
-   For execution of complete commands the *note evaluate:: command may
-also be handy.
-
-
-File: gnuplot.info,  Node: String_variables,  Prev: Substitution_of_string_variables_as_macros,  Up: Substitution_and_Command_line_macros
-
-1.29.3 String variables, macros, and command line substitution
---------------------------------------------------------------
-
-The interaction of string variables, backquotes and macro substitution
-is somewhat complicated.  Backquotes do not block macro substitution, so
-
-           filename = "mydata.inp"
-           lines = ` wc --lines @filename | sed "s/ .*//" `
-
-
-   results in the number of lines in mydata.inp being stored in the
-integer variable lines.  And double quotes do not block backquote
-substitution, so
-
-           mycomputer = "`uname -n`"
-
-
-   results in the string returned by the system command 'uname -n' being
-stored in the string variable mycomputer.
-
-   However, macro substitution is not performed inside double quotes, so
-you cannot define a system command as a macro and then use both macro
-and backquote substitution at the same time.
-
-            machine_id = "uname -n"
-            mycomputer = "`@machine_id`"  # doesn't work!!
-
-
-   This fails because the double quotes prevent @machine_id from being
-interpreted as a macro.  To store a system command as a macro and
-execute it later you must instead include the backquotes as part of the
-macro itself.  This is accomplished by defining the macro as shown
-below.  Notice that the sprintf format nests all three types of quotes.
-
-           machine_id = sprintf('"`uname -n`"')
-           mycomputer = @machine_id
-
-
-
-File: gnuplot.info,  Node: Syntax,  Next: Time/Date_data,  Prev: Substitution_and_Command_line_macros,  Up: Gnuplot
-
-1.30 Syntax
-===========
-
-Options and any accompanying parameters are separated by spaces whereas
-lists and coordinates are separated by commas.  Ranges are separated by
-colons and enclosed in brackets [], text and file names are enclosed in
-quotes, and a few miscellaneous things are enclosed in parentheses.
-
-   Commas are used to separate coordinates on the 'set' commands
-'arrow', 'key', and 'label'; the list of variables being fitted (the
-list after the 'via' keyword on the *note fit:: command); lists of
-discrete contours or the loop parameters which specify them on the *note
-cntrparam:: command; the arguments of the 'set' commands *note
-dgrid3d::, *note dummy::, *note isosamples::, *note offsets::, *note
-origin::, *note samples::, *note size::, 'time', and *note view::; lists
-of tics or the loop parameters which specify them; the offsets for
-titles and axis labels; parametric functions to be used to calculate the
-x, y, and z coordinates on the 'plot', *note replot:: and 'splot'
-commands; and the complete sets of keywords specifying individual plots
-(data sets or functions) on the 'plot', *note replot:: and 'splot'
-commands.
-
-   Parentheses are used to delimit sets of explicit tics (as opposed to
-loop parameters) and to indicate computations in 'using' specifiers of
-the *note fit::, 'plot', *note replot:: and 'splot' commands.
-
-   (Parentheses and commas are also used as usual in function notation.)
-
-   Square brackets are used to delimit ranges given in 'set', 'plot' or
-'splot' commands.
-
-   Colons are used to separate extrema in 'range' specifications
-(whether they are given on 'set', 'plot' or 'splot' commands) and to
-separate entries in the 'using' specifier of the 'plot', *note replot::,
-'splot' and *note fit:: commands.
-
-   Semicolons are used to separate commands given on a single command
-line.
-
-   Curly braces are used in the syntax for enhanced text mode and to
-delimit blocks in if/then/else statements.  They are also used to denote
-complex numbers: {3,2} = 3 + 2i.
-
-* Menu:
-
-* quote_marks::
-
-
-File: gnuplot.info,  Node: quote_marks,  Prev: Syntax,  Up: Syntax
-
-1.30.1 quote marks
-------------------
-
-Gnuplot uses three forms of quote marks for delimiting text strings,
-double-quote (ascii 34), single-quote (ascii 39), and backquote (ascii
-96).
-
-   Filenames may be entered with either single- or double-quotes.  In
-this manual the command examples generally single-quote filenames and
-double-quote other string tokens for clarity.
-
-   String constants and text strings used for labels, titles, or other
-plot elements may be enclosed in either single quotes or double quotes.
-Further processing of the quoted text depends on the choice of quote
-marks.
-
-   Backslash processing of special characters like \n (newline) and \345
-(octal character code) is performed only for double-quoted strings.  In
-single-quoted strings, backslashes are just ordinary characters.  To get
-a single-quote (ascii 39) in a single-quoted string, it must be doubled.
-Thus the strings "d\" s' b\\" and 'd" s" b\' are completely equivalent.
-
-   Text justification is the same for each line of a multi-line string.
-Thus the center-justified string
-           "This is the first line of text.\nThis is the second line."
-
-   will produce
-                            This is the first line of text.
-                               This is the second line.
-
-   but
-           'This is the first line of text.\nThis is the second line.'
-
-   will produce
-               This is the first line of text.\nThis is the second line.
-
-
-   Enhanced text processing is performed for both double-quoted text and
-single-quoted text.  See 'enhanced text'.
-
-   Back-quotes are used to enclose system commands for substitution into
-the command line.  See 'substitution'.
-
-
-File: gnuplot.info,  Node: Time/Date_data,  Next: Watchpoints_,  Prev: Syntax,  Up: Gnuplot
-
-1.31 Time/Date data
-===================
-
-'gnuplot' supports the use of time and/or date information as input
-data.  This feature is activated by the commands 'set xdata time', 'set
-ydata time', etc.
-
-   Internally all times and dates are converted to the number of seconds
-from the year 1970.  The command *note timefmt:: defines the default
-format for all inputs: data files, ranges, tics, label positions -
-anything that accepts a time data value defaults to receiving it in this
-format.  Only one default format can be in effect at a given time.  Thus
-if both x and y data in a file are time/date, by default they are
-interpreted in the same format.  However this default can be replaced
-when reading any particular file or column of input using the
-'timecolumn' function in the corresponding 'using' specifier.
-
-   The conversion to and from seconds assumes Universal Time (which is
-the same as Greenwich Standard Time).  There is no provision for
-changing the time zone or for daylight savings.  If all your data refer
-to the same time zone (and are all either daylight or standard) you
-don't need to worry about these things.  But if the absolute time is
-crucial for your application, you'll need to convert to UT yourself.
-
-   Commands like *note xrange:: will re-interpret the integer according
-to *note timefmt::.  If you change *note timefmt::, and then 'show' the
-quantity again, it will be displayed in the new *note timefmt::.  For
-that matter, if you reset the data type flag for that axis (e.g.  *note
-xdata::), the quantity will be shown in its numerical form.
-
-   The commands 'set format' or 'set tics format' define the format that
-will be used for tic labels, whether or not input for the specified axis
-is time/date.
-
-   If time/date information is to be plotted from a file, the 'using'
-option _must_ be used on the 'plot' or 'splot' command.  These commands
-simply use white space to separate columns, but white space may be
-embedded within the time/date string.  If you use tabs as a separator,
-some trial-and-error may be necessary to discover how your system treats
-them.
-
-   The 'time' function can be used to get the current system time.  This
-value can be converted to a date string with the *note strftime::
-function, or it can be used in conjunction with 'timecolumn' to generate
-relative time/date plots.  The type of the argument determines what is
-returned.  If the argument is an integer, 'time' returns the current
-time as an integer, in seconds from 1 Jan 1970.  If the argument is real
-(or complex), the result is real as well.  The precision of the
-fractional (sub-second) part depends on your operating system.  If the
-argument is a string, it is assumed to be a format string, and it is
-passed to *note strftime:: to provide a formatted time/date string.
-
-   The following example demonstrates time/date plotting.
-
-   Suppose the file "data" contains records like
-
-           03/21/95 10:00  6.02e23
-
-
-   This file can be plotted by
-
-           set xdata time
-           set timefmt "%m/%d/%y"
-           set xrange ["03/21/95":"03/22/95"]
-           set format x "%m/%d"
-           set timefmt "%m/%d/%y %H:%M"
-           plot "data" using 1:3
-
-
-   which will produce xtic labels that look like "03/21".
-
-   Gnuplot tracks time to millisecond precision.  Time formats have been
-modified to match this.  Example: print the current time to msec
-precision
-          print strftime("%H:%M:%.3S %d-%b-%Y",time(0.0))
-          18:15:04.253 16-Apr-2011
-
-
-   See 'time_specifiers', 'set xtics time', 'set mxtics time'.
-
-
-File: gnuplot.info,  Node: Watchpoints_,  Prev: Time/Date_data,  Up: Gnuplot
-
-1.32 Watchpoints
-================
-
-Support for watchpoints is present only if your copy of gnuplot was
-built with configuration option -enable-watchpoints.  This feature is
-EXPERIMENTAL [details may change in a subsequent release version].
-
-   Syntax:
-           plot FOO watch {x|y|z|F(x,y)} = <value>
-           plot FOO watch mouse
-
-
-           set style watchpoints nolabels
-           set style watchpoints label <label-properties>
-
-
-           unset style watchpoints      # return to default style
-
-
-           show watchpoints    # summarizes all watches from previous plot command
-
-
-   A watchpoint is a target value for the x, y, or z coordinate or for a
-function f(x,y).  Each watchpoint is attached to a single plot within a
-'plot' command.  Watchpoints are tracked only for styles 'with lines'
-and *note linespoints::.  Every component line segment of that plot is
-checked against all watchpoints attached the plot to see whether one or
-more of the watchpoint targets is satisfied at a point along that line
-segment.  A list of points that satisfy the the target condition
-("hits") is accumulated as the plot is drawn.
-
-   For example, if there is a watchpoint with a target y=100, each line
-segment is checked to see if the y coordinates of the two endpoints
-bracket the target y value.  If so then some point [x,y] on the line
-segment satisfies the target condition y = 100 exactly.  This target
-point is then found by linear interpolation or by iterative bisection.
-
-   Watchpoints within a single plot command are numbered successively.
-More than one watchpoint per plot component may be specified.  Example:
-          plot DATA using 1:2 smooth cnormal watch y=0.25 watch y=0.5 watch y=0.75
-
-
-   Watchpoint hits for each target in the previous plot command are
-stored in named arrays WATCH_n.  You can also display a summary of all
-watchpoint hits from the previous plot command; see *note watchpoints::.
-
-          gnuplot> show watchpoints
-          Plot title:     "DATA using 1:2 smooth cnormal"
-            Watch 1 target y = 0.25         (1 hits)
-                    hit 1   x 49.7  y 0.25
-            Watch 2 target y = 0.5          (1 hits)
-                    hit 1   x 63.1  y 0.5
-            Watch 3 target y = 0.75         (1 hits)
-                    hit 1   x 67.8  y 0.75
-
-
-   Smoothing: Line segments are checked as they are drawn.  For
-unsmoothed data plots this means a hit found by interpolation will lie
-exactly on a line segment connecting two data points.  If a data plot is
-smoothed, hits will lie on a line segment from the smoothed curve.
-Depending on the quality of the smoothed fit, this may or may not be
-more accurate than the hit from the unsmoothed data.
-
-   Accuracy: If the line segment was generated from a function plot, the
-exact value of x such that f(x) = y is found by iterative bisection.
-Otherwise the coordinates [x,y] are approximated by linear interpolation
-along the line segment.
-
-* Menu:
-
-* watch_mouse::
-* watch_labels::
-
-
-File: gnuplot.info,  Node: watch_mouse,  Next: watch_labels,  Prev: Watchpoints_,  Up: Watchpoints_
-
-1.32.1 watch mouse
-------------------
-
-Using the current mouse x coordinate as a watch target generates a label
-that moves along the line of the plot tracking the horizontal position
-of the mouse.  This allows simultaneous readout of the y values of
-multiple plot lines in the same graph.  The appearance of the point
-indicating the current position and of the label can be modified by 'set
-style watchpoint' and 'set style textbox'
-
-   Example:
-
-          set style watchpoint labels point pt 6 ps 2 boxstyle 1
-          set style textbox 1 lw 0.5 opaque
-          plot for [i=1:N] "file.dat" using 1:(column(i)) watch mouse
-
-
-
-File: gnuplot.info,  Node: watch_labels,  Prev: watch_mouse,  Up: Watchpoints_
-
-1.32.2 watch labels
--------------------
-
-By default, labels are always generated for the target "watch mouse".
-You can turn labels on for other watch targets using the command *note
-labels::.  The label text is "x : y", where x and y are the coordinates
-of the point, formatted using the current settings for the corresponding
-axes.
-
-   Example:
-          set y2tics format "%.2f°"
-          set style watchpoint labels point pt 6
-          plot FOO axes x1y2 watch mouse
-
-   D watchpoints 2
-
-
-File: gnuplot.info,  Node: Plotting_styles,  Next: Commands,  Prev: Gnuplot,  Up: Top
-
-2 Plotting styles
-*****************
-
-Many plotting styles are available in gnuplot.  They are listed
-alphabetically below.  The commands 'set style data' and 'set style
-function' change the default plotting style for subsequent 'plot' and
-'splot' commands.
-
-   You can also specify the plot style explicitly as part of the 'plot'
-or 'splot' command.  If you want to mix plot styles within a single
-plot, you must specify the plot style for each component.
-
-   Example:
-
-          plot 'data' with boxes, sin(x) with lines
-
-
-   Each plot style has its own expected set of data entries in a data
-file.  For example, by default the 'lines' style expects either a single
-column of y values (with implicit x ordering) or a pair of columns with
-x in the first and y in the second.  For more information on how to
-fine-tune how columns in a file are interpreted as plot data, see
-'using'.
-
-* Menu:
-
-* arrows::
-* Bee_swarm_plots::
-* boxerrorbars::
-* boxes::
-* boxplot::
-* boxxyerror::
-* candlesticks::
-* circles::
-* contourfill::
-* dots::
-* ellipses::
-* filledcurves::
-* financebars::
-* fillsteps::
-* fsteps::
-* histeps::
-* heatmaps::
-* histograms::
-* hsteps::
-* image::
-* impulses::
-* labels::
-* lines::
-* linespoints::
-* masking::
-* parallelaxes::
-* Polar_plots::
-* points::
-* polygons::
-* rgbalpha::
-* rgbimage::
-* sectors::
-* spiderplot::
-* steps::
-* surface::
-* vectors::
-* xerrorbars::
-* xyerrorbars::
-* xerrorlines::
-* xyerrorlines::
-* yerrorbars::
-* yerrorlines::
-* 3D_plots::
-* Fence_plots::
-* isosurface::
-* Zerrorfill::
-* Animation::
-
-
-File: gnuplot.info,  Node: arrows,  Next: Bee_swarm_plots,  Prev: Plotting_styles,  Up: Plotting_styles
-
-2.1 arrows
-==========
-
-The 2D 'arrows' style draws an arrow with specified length and
-orientation angle at each point (x,y).  Additional input columns may be
-used to provide variable (per-datapoint) color information or arrow
-style.  It is identical to the 2D style *note vectors:: except that each
-arrow head is positioned using length + angle rather than delta_x +
-delta_y.  See *note vectors::.
-
-          4 columns:  x  y  length  angle
-
-
-   The keywords 'with arrows' may be followed by inline arrow style
-properties, a reference to a predefined arrow style, or 'arrowstyle
-variable' to load the index of the desired arrow style for each arrow
-from a separate column.
-
-   'length' > 0 is interpreted in x-axis coordinates.  -1 < 'length' < 0
-is interpreted in horizontal graph coordinates; i.e.  |length| is a
-fraction of the total graph width.  The program will adjust for
-differences in x and y scaling or plot aspect ratio so that the visual
-length is independent of the orientation angle.
-
-   'angle' is always specified in degrees.
-
-* Menu:
-
-* arrowstyle_variable::
-
-
-File: gnuplot.info,  Node: arrowstyle_variable,  Prev: arrows,  Up: arrows
-
-2.1.1 arrowstyle variable
--------------------------
-
-For plot styles 'with arrows' and *note vectors::, you can provide an
-extra column of input data that provides an integer arrow style
-corresponding to style previously defined using 'set style arrow'.
-
-   Example:
-          set style arrow 1 head nofilled linecolor "blue" linewidth 0.5
-          set style arrow 2 head filled linecolor "red" linewidth 1.0
-          # column 5 is expected to contain either 1 or 2,
-          # determining which of the two previous defined styles to use
-          plot DATA using 1:2:3:4:5 with arrows arrowstyle variable
-
-
-
-File: gnuplot.info,  Node: Bee_swarm_plots,  Next: boxerrorbars,  Prev: arrows,  Up: Plotting_styles
-
-2.2 Bee swarm plots
-===================
-
-"Bee swarm" plots result from applying jitter to separate overlapping
-points.  A typical use is to compare the distribution of y values
-exhibited by two or more categories of points, where the category
-determines the x coordinate.  See the *note jitter:: command for how to
-control the overlap criteria and the displacement pattern used for
-jittering.  The plots in the figure were created by the same plot
-command but different jitter settings.
-
-          set jitter
-          plot $data using 1:2:1 with points lc variable
-
-
-
-File: gnuplot.info,  Node: boxerrorbars,  Next: boxes,  Prev: Bee_swarm_plots,  Up: Plotting_styles
-
-2.3 boxerrorbars
-================
-
-The *note boxerrorbars:: style is only relevant to 2D data plotting.  It
-is a combination of the *note boxes:: and *note yerrorbars:: styles.  It
-requires 3, 4, or 5 columns of data.  An additional (4th, 5th or 6th)
-input column may be used to provide variable (per-datapoint) color
-information (see 'linecolor' and 'rgbcolor variable').
-
-          3 columns:  x  y  ydelta
-          4 columns:  x  y  ydelta xdelta         (xdelta <= 0 means use boxwidth)
-          5 columns:  x  y  ylow  yhigh  xdelta   (xdelta <= 0 means use boxwidth)
-
-
-   The boxwidth will come from the fourth column if the y errors are
-given as "ydelta" or from the fifth column if they are in the form of
-"ylow yhigh".  If xdelta is zero or negative, the width of the box is
-controlled by the value previously given for boxwidth.  See *note
-boxwidth::.
-
-   A vertical error bar is drawn to represent the y error in the same
-way as for the *note yerrorbars:: style, either from y-ydelta to
-y+ydelta or from ylow to yhigh, depending on how many data columns are
-provided.  The line style used for the error bar may be controlled using
-'set bars'.  Otherwise the error bar will match the border of the box.
-
-   DEPRECATED: Old versions of gnuplot treated 'boxwidth = -2.0' as a
-special case for four-column data with y errors in the form "ylow
-yhigh".  In this case boxwidth was adjusted to leave no gap between
-adjacent boxes.  This treatment is retained for backward-compatibility
-but may be removed in a future version.
-
-
-File: gnuplot.info,  Node: boxes,  Next: boxplot,  Prev: boxerrorbars,  Up: Plotting_styles
-
-2.4 boxes
-=========
-
-In 2D plots the *note boxes:: style draws a rectangle centered about the
-given x coordinate that extends from the x axis, i.e.  from y=0 not from
-the graph border, to the given y coordinate.  The width of the box can
-be provided in an additional input column or controlled by *note
-boxwidth::.  Otherwise each box extends to touch the adjacent boxes.
-
-   In 3D plots the *note boxes:: style draws a box centered at the given
-[x,y] coordinate that extends from the plane at z=0 to the given z
-coordinate.  The width of the box on x can be provided in a separate
-input column or via *note boxwidth::.  The depth of the box on y is
-controlled by *note boxdepth::.  Boxes do not automatically expand to
-touch each other.
-
-* Menu:
-
-* 2D_boxes::
-* 3D_boxes::
-
-
-File: gnuplot.info,  Node: 2D_boxes,  Next: 3D_boxes,  Prev: boxes,  Up: boxes
-
-2.4.1 2D boxes
---------------
-
-*note boxes:: uses 2 or 3 columns of basic data.  Additional input
-columns may be used to provide information such as variable line or fill
-color.  See 'rgbcolor variable'.
-
-          2 columns:  x  y
-          3 columns:  x  y  x_width
-
-
-   The width of the box is obtained in one of three ways.  If the input
-data has a third column, this will be used to set the box width.
-Otherwise if a width has been set using the *note boxwidth:: command,
-this will be used.  If neither of these is available, the width of each
-box will be calculated so that it touches the adjacent boxes.
-
-   The box interiors are drawn using the current fillstyle.
-Alternatively a fillstyle may be specified in the plot command.  See
-'set style fill'.  If no fillcolor is given in the plot command, the
-current line color is used.
-
-   Examples:
-
-   To plot a data file with solid filled boxes with a small vertical
-space separating them (bargraph):
-
-           set boxwidth 0.9 relative
-           set style fill solid 1.0
-           plot 'file.dat' with boxes
-
-
-   To plot a sine and a cosine curve in pattern-filled boxes style with
-explicit fill color:
-
-           set style fill pattern
-           plot sin(x) with boxes fc 'blue', cos(x) with boxes fc 'gold'
-
-
-   The sin plot will use pattern 0; the cos plot will use pattern 1.
-Any additional plots would cycle through the patterns supported by the
-terminal driver.
-
-
-File: gnuplot.info,  Node: 3D_boxes,  Prev: 2D_boxes,  Up: boxes
-
-2.4.2 3D boxes
---------------
-
-*note boxes:: requires at least 3 columns of input data.  Additional
-input columns may be used to provide information such as box width or
-fill color.
-
-          3 columns:  x  y  z
-          4 columns:  x  y  z  [x_width or color]
-          5 columns:  x  y  z  x_width  color
-
-
-   The last column is used as a color only if the splot command
-specifies a variable color mode.  Examples
-
-          splot 'blue_boxes.dat' using 1:2:3 fc "blue"
-          splot 'rgb_boxes.dat' using 1:2:3:4 fc rgb variable
-          splot 'category_boxes.dat' using 1:2:3:4:5 lc variable
-
-
-   In the first example all boxes are blue and have the width previously
-set by *note boxwidth::.  In the second example the box width is still
-taken from *note boxwidth:: because the 4th column is interpreted as a
-24-bit RGB color.  The third example command reads box width from column
-4 and interprets the value in column 5 as an integer linetype from which
-the color is derived.
-
-   By default boxes have no thickness; they consist of a single
-rectangle parallel to the xz plane at the specified y coordinate.  You
-can change this to a true box with four sides and a top by setting a
-non-zero extent on y.  See *note boxdepth::.
-
-   3D boxes are processed as pm3d quadrangles rather than as surfaces.
-Because of this the front/back order of drawing is not affected by *note
-hidden3d::.  See 'set pm3d'.  In gnuplot version 6 the edges of the box
-are colored by the border color of the plot's fill style; this is a
-change from version 5.  For best results use a combination of 'set pm3d
-depthorder base' and *note lighting::.
-
-
-File: gnuplot.info,  Node: boxplot,  Next: boxxyerror,  Prev: boxes,  Up: Plotting_styles
-
-2.5 boxplot
-===========
-
-Boxplots are a common way to represent a statistical distribution of
-values.  Gnuplot boxplots are always vertical, showing a distribution of
-values along y.  Quartile boundaries are determined such that 1/4 of the
-points have a y value equal or less than the first quartile boundary,
-1/2 of the points have y value equal or less than the second quartile
-(median) value, etc.  A box is drawn around the region between the first
-and third quartiles with a horizontal line at the median value.
-Whiskers extend from the box to user-specified limits.  Points that lie
-outside these limits (outliers) are drawn individually.  The width of
-the boxplot can be controlled either by *note boxwidth:: or by providing
-it in a third field of the 'using' specifier in the plot command.
-
-   Syntax
-
-          2 columns:   x-position        y-value
-          3 columns:   x-position        y-value  boxwidth
-          4 columns:   first-x-position  y-value  boxwidth  category
-
-
-   The horizontal position of a boxplot is usually given as a constant
-value in the first field (x-position) of the 'using' specifier in the
-plot command.  You can place an identifying label at this position under
-the boxplot by adding an 'xticlabel' specifier in the plot command (two
-or three column syntax) or by providing it as a string in a separate
-data column (four column syntax).  Both examples below should produce a
-plot with layout similar to the one in the boxplot example figure.
-
-   Examples
-
-          #
-          # Compare distribution of y-values from two different files.
-          set border 2                    # left-hand border only
-          set xtics nomirror scale 0      # no tickmarks; only labels
-          set ytics rangelimited nomirror
-          plot 'dataset_A' using (1.):2:xticlabel('A') with boxplot, \
-               'dataset_B' using (2.):2:xticlabel('B') with boxplot
-
-          #
-          # Compare y-values from two categories of data in the same file.
-          # Each line contains a category string ("A" or "B") in column 1 and
-          # a data value in column 2.  Labels auto-generated from category string.
-          start_x = 1.0
-          boxwidth = 0.5
-          plot 'mixeddata' using (start_x):2:(boxwidth):1 with boxplot
-
-
-   By default a single boxplot is produced from all y values found in
-the column specified by the second field of the using specification.  If
-a fourth field is given in the 'using' specification the content of that
-input column will be used as a string that identifies a discrete
-category.  A separate boxplot will be drawn for each category found in
-the input.  The horizontal separation between these boxplots is 1.0 by
-default;, it can be changed by 'set style boxplot separation'.  By
-default the category identifier is shown as a tic label below each
-boxplot.  Note that if category column contains numerical values they
-are nevertheless treated as strings and thus do not usually correspond
-to the x coordinate of the boxplot.
-
-   The order of data points in the input file is not important.  If
-there are multiple blocks of data in the input file separated by two
-blank lines, individual blocks may be selected with the *note index::
-keyword or by using the the data block number ('column(-2)') as a level
-value in the fourth column.  See 'pseudocolumns', *note index::.
-
-   By default the whiskers extend vertically from the ends of the box to
-the most distant point whose y value lies within 1.5 times the
-interquartile range.  By default outliers are drawn as circles (point
-type 7).  The width of bars at the end of the whiskers may be controlled
-using 'set bars' or *note errorbars::.  Multiple outliers with the same
-y value are displaced horizontally by one character width.  This spacing
-can be controlled by *note jitter::.
-
-   These default properties may be changed using the *note boxplot::
-command.  See *note boxplot::, 'bars', *note boxwidth::, 'fillstyle',
-*note candlesticks::.
-
-
-File: gnuplot.info,  Node: boxxyerror,  Next: candlesticks,  Prev: boxplot,  Up: Plotting_styles
-
-2.6 boxxyerror
-==============
-
-The *note boxxyerror:: plot style is only relevant to 2D data plotting.
-It is similar to the *note xyerrorbars:: style except that it draws
-rectangular areas rather than crosses.  It uses either 4 or 6 basic
-columns of input data.  An additional (5th or 7th) input column may be
-used to provide variable (per-datapoint) color information (see
-'linecolor' and 'rgbcolor variable').
-
-          4 columns:  x  y  xdelta  ydelta
-          6 columns:  x  y  xlow  xhigh  ylow  yhigh
-
-
-   The box width and height are determined from the x and y errors in
-the same way as they are for the *note xyerrorbars:: style--either from
-xlow to xhigh and from ylow to yhigh, or from x-xdelta to x+xdelta and
-from y-ydelta to y+ydelta, depending on how many data columns are
-provided.
-
-   The 6 column form of the command provides a convenient way to plot
-rectangles with arbitrary x and y bounds.
-
-   The interior of the boxes is drawn according to the current
-fillstyle.  See 'set style fill' and *note boxes:: for details.
-Alternatively a new fillstyle may be specified in the plot command.
-
-
-File: gnuplot.info,  Node: candlesticks,  Next: circles,  Prev: boxxyerror,  Up: Plotting_styles
-
-2.7 candlesticks
-================
-
-The *note candlesticks:: style can be used for 2D data plotting of
-financial data or for generating box-and-whisker plots of statistical
-data.  The symbol is a rectangular box, centered horizontally at the x
-coordinate and limited vertically by the opening and closing prices.  A
-vertical line segment at the x coordinate extends up from the top of the
-rectangle to the high price and another down to the low.  The vertical
-line will be unchanged if the low and high prices are interchanged.
-
-   Five columns of basic data are required:
-
-           financial data:   date  open  low  high  close
-           whisker plot:     x  box_min  whisker_min  whisker_high  box_high
-
-
-   The width of the rectangle can be controlled by the *note boxwidth::
-command.  For backwards compatibility with earlier gnuplot versions,
-when the boxwidth parameter has not been set then the width of the
-candlestick rectangle is taken from 'set errorbars <width>'.
-
-   Alternatively, an explicit width for each box-and-whiskers grouping
-may be specified in an optional 6th column of data.  The width must be
-given in the same units as the x coordinate.
-
-   An additional (6th, or 7th if the 6th column is used for width data)
-input column may be used to provide variable (per-datapoint) color
-information (see 'linecolor' and 'rgbcolor variable').
-
-   By default the vertical line segments have no crossbars at the top
-and bottom.  If you want crossbars, which are typically used for
-box-and-whisker plots, then add the keyword 'whiskerbars' to the plot
-command.  By default these whiskerbars extend the full horizontal width
-of the candlestick, but you can modify this by specifying a fraction of
-the full width.
-
-   The usual convention for financial data is that the rectangle is
-empty if (open < close) and solid fill if (close < open).  This is the
-behavior you will get if the current fillstyle is set to "empty".  See
-'fillstyle'.  If you set the fillstyle to solid or pattern, then this
-will be used for all boxes independent of open and close values.  See
-also *note errorbars:: and *note financebars::.  See also the
-candlestick (http://www.gnuplot.info/demo/candlesticks.html) and finance
-(http://www.gnuplot.info/demo/finance.html) demos.
-
-   Note: To place additional symbols or lines on a box-and-whisker plot
-requires additional plot components.  The first example below uses a
-second component that squashes the candlestick onto a single line placed
-at the median value.
-
-       # Data columns:X Min 1stQuartile Median 3rdQuartile Max
-       set errorbars 4.0
-       set style fill empty
-       plot 'stat.dat' using 1:3:2:6:5 with candlesticks title 'Quartiles', \
-            ''         using 1:4:4:4:4 with candlesticks lt -1 notitle
-
-
-       # Plot with crossbars on the whiskers, crossbars are 50% of full width
-       plot 'stat.dat' using 1:3:2:6:5 with candlesticks whiskerbars 0.5
-
-
-   See *note boxwidth::, *note errorbars::, 'set style fill', and *note
-boxplot::.
-
-
-File: gnuplot.info,  Node: circles,  Next: contourfill,  Prev: candlesticks,  Up: Plotting_styles
-
-2.8 circles
-===========
-
-The *note circles:: style plots a circle with an explicit radius at each
-data point.  The radius is always interpreted in the units of the plot's
-horizontal axis (x or x2).  The scale on y and the aspect ratio of the
-plot are both ignored.  If the radius is not given in a separate column
-for each point it is taken from 'set style circle'.  In this case the
-radius may use graph or screen coordinates.
-
-   Many combinations of per-point and previously set properties are
-possible.  For 2D plots these include
-
-         using x:y
-         using x:y:radius
-         using x:y:color
-         using x:y:radius:color
-         using x:y:radius:arc_begin:arc_end
-         using x:y:radius:arc_begin:arc_end:color
-
-
-   By default a full circle will be drawn.  The result is similar to
-using a 'points' plot with variable size points and pointtype 7, except
-that the circles scale with the x axis range.  It is possible to instead
-plot arc segments by specifying a start and end angle (in degrees) in
-columns 4 and 5.
-
-   A per-circle color may be provided in the last column of the using
-specifier.  In this case the plot command must include a corresponding
-variable color term such as 'lc variable' or 'fillcolor rgb variable'.
-
-   See 'set style circle', 'set object circle', and 'set style fill'.
-
-   For 3D plots the using specifier must contain
-
-         splot DATA using x:y:z:radius:color
-
-
-   where the variable color column is optional.
-
-   Examples:
-
-         # draws circles whose area is proportional to the value in column 3
-         set style fill transparent solid 0.2 noborder
-         plot 'data' using 1:2:(sqrt($3)) with circles, \
-              'data' using 1:2 with linespoints
-
-
-         # draws Pac-men instead of circles
-         plot 'data' using 1:2:(10):(40):(320) with circles
-
-
-         # draw a pie chart with inline data
-         set xrange [-15:15]
-         set style fill transparent solid 0.9 noborder
-         plot '-' using 1:2:3:4:5:6 with circles lc var
-         0    0    5    0    30    1
-         0    0    5   30    70    2
-         0    0    5   70   120    3
-         0    0    5  120   230    4
-         0    0    5  230   360    5
-         e
-
-
-
-File: gnuplot.info,  Node: contourfill,  Next: dots,  Prev: circles,  Up: Plotting_styles
-
-2.9 contourfill
-===============
-
-Syntax:
-          splot f(x,y) with contourfill {at base} {fillstyle <style>}
-
-
-   Contourfill is a 3D plotting style used to color a pm3d surface in
-slices along the z axis.  It can be used in 2D projection ('set view
-map') to create 2D contour plots with solid color between contour lines.
-The slice boundaries and the assigned colors are both controlled using
-*note contourfill::.  See also 'pm3d', 'zclip'.
-
-   This style can be combined with 'set contours' to superimpose contour
-lines that bound the slices.  Care must be taken that the slice
-boundaries from *note contourfill:: match the contour boundaries from
-*note cntrparam::.
-
-          # slice boundaries determined by ztics
-          # coloring set by palette mapping the slice midpoint z value
-          set pm3d border retrace
-          set contourfill ztics
-          set ztics -20, 5, 20
-          set contour
-          set cntrparam cubic levels increment -20, 5, 20
-          set cntrlabel onecolor
-          set view map
-          splot g(x,y) with contourfill, g(x,y) with lines nosurface
-
-
-
-File: gnuplot.info,  Node: dots,  Next: ellipses,  Prev: contourfill,  Up: Plotting_styles
-
-2.10 dots
-=========
-
-The *note dots:: style plots a tiny dot at each point; this is useful
-for scatter plots with many points.  Either 1 or 2 columns of input data
-are required in 2D. Three columns are required in 3D.
-
-   For some terminals (post, pdf) the size of the dot can be controlled
-by changing the linewidth.
-
-          1 column    y         # x is row number
-          2 columns:  x  y
-          3 columns:  x  y  z   # 3D only (splot)
-
-
-
-File: gnuplot.info,  Node: ellipses,  Next: filledcurves,  Prev: dots,  Up: Plotting_styles
-
-2.11 ellipses
-=============
-
-Syntax:
-          plot <data> with ellipses {units [xx|xy|yy]}
-
-
-   The *note ellipses:: style plots an ellipse at each data point.  This
-style is only relevant for 2D plotting.  Each ellipse is described in
-terms of its center, major and minor diameters, and the angle between
-its major diameter and the x axis.
-
-          2 columns: x y
-          3 columns: x y diam  (used for both major and minor axes)
-          4 columns: x y major_diam minor_diam
-          5 columns: x y major_diam minor_diam angle
-
-
-   If only two input columns are present, they are taken as the
-coordinates of the centers, and the ellipses will be drawn with the
-default extent (see 'set style ellipse').  The orientation of the
-ellipse, which is defined as the angle between the major diameter and
-the plot's x axis, is taken from the default ellipse style (see 'set
-style ellipse').
-
-   If three input columns are provided, the third column is used for
-both diameters.  The orientation angle defaults to zero.
-
-   If four columns are present, they are interpreted as x, y, major
-diameter, minor diameter.  Note that these are diameters, not radii.  If
-either diameter is negative, both diameters will be taken from the
-default set by 'set style ellipse'.
-
-   An optional 5th column may specify the orientation angle in degrees.
-The ellipses will also be drawn with their default extent if either of
-the supplied diameters in the 3-4-5 column form is negative.
-
-   In all of the above cases, optional variable color data may be given
-in an additional last (3th, 4th, 5th or 6th) column.  See *note
-colorspec::.
-
-   'units keyword:' If 'units xy' is included in the plot specification,
-the major diameter is interpreted in the units of the plot's horizontal
-axis (x or x2) while the minor diameter in that of the vertical axis (y
-or y2).  If the x and y axis scales are not equal, the major/minor
-diameter ratio will no longer be correct after rotation.  'units xx'
-interprets both diameters in units of the x axis.  'units yy' interprets
-both diameters in units of the y axis.  In the latter two cases the
-ellipses will have the correct aspect ratio even if the plot is resized.
-If 'units' is omitted from the plot command, the setting from 'set style
-ellipse' will be used.
-
-   Example (draws ellipses, cycling through the available line types):
-
-         plot 'data' using 1:2:3:4:(0):0 with ellipses
-
-
-   See also 'set object ellipse', 'set style ellipse' and 'fillstyle'.
-
-
-File: gnuplot.info,  Node: filledcurves,  Next: financebars,  Prev: ellipses,  Up: Plotting_styles
-
-2.12 filledcurves
-=================
-
-The *note filledcurves:: style is available in both 2D and (since
-version 6.1) 3D.
-
-   The 2D style has three variants.  The first two variants require
-either a single function or two columns (x,y) of input data.
-
-   Syntax for 2D:
-
-         plot f(x) with filledcurves [option]
-         plot DATA using 1:2    with filledcurves [option]
-         plot DATA using 1:2:3  with filledcurves [option]
-
-
-   where the option can be one of the following
-
-         closed
-         {above|below} x1 x2  y r=<a> xy=<x>,<y>
-         between
-
-
-   The first variant, 'closed', treats the curve itself as a closed
-polygon.  This is the default if there are two columns of input data.
-
-         filledcurves closed   ... just filled closed curve,
-
-
-   The second variant is to fill the area between the curve and a given
-axis, a horizontal or vertical line, or a point.  This can be further
-restricted to filling the area above or below the specified line.
-
-         filledcurves x1       ... x1 axis,
-         filledcurves x2       ... x2 axis, etc for y1 and y2 axes,
-         filledcurves y=42     ... line at y=42, i.e. parallel to x axis,
-         filledcurves xy=10,20 ... point 10,20 of x1,y1 axes (arc-like shape).
-         filledcurves above r=1.5  the area of a polar plot outside radius 1.5
-
-
-   The third variant fills the area between two curves sampled at the
-same set of x coordinates.  It requires three columns of input data (x,
-y1, y2).  This is the default if there are three or more columns of
-input data.  If you have a y value in column 2 and an associated error
-value in column 3 the three column variant can be used in combination
-with a solid line to show the area of uncertainty on either side of that
-line.  See also the similar 3D plot style 'zerrorfill'.
-
-         plot $DAT using 1:($2-$3):($2+$3) with filledcurves, \
-              $DAT using 1:2 smooth mcs with lines
-
-
-* Menu:
-
-* above/below::
-* 3D_waterfall_plots::
-* fill_properties::
-
-
-File: gnuplot.info,  Node: above/below,  Next: 3D_waterfall_plots,  Prev: filledcurves,  Up: filledcurves
-
-2.12.1 above/below
-------------------
-
-The 'above' and 'below' options apply both to commands of the form
-         plot f(x) with filledcurves {above|below} {y|r}=<val>
-
-   and to commands of the form
-         plot DATA with filledcurves using 1:2:3 with filledcurves {above|below}
-
-   In either case the option limits the filled area to one side of the
-bounding line or curve.
-
-   Zooming a filled curve drawn from a datafile may produce empty or
-incorrect areas because gnuplot is clipping points and lines, and not
-areas.
-
-   If the values <x>, <y>, or <a> are outside the drawing boundary they
-are moved to the graph boundary.  Then the actual fill area in the case
-of option xy=<x>,<y> will depend on xrange and yrange.
-
-
-File: gnuplot.info,  Node: 3D_waterfall_plots,  Next: fill_properties,  Prev: above/below,  Up: filledcurves
-
-2.12.2 3D waterfall plots
--------------------------
-
-          set style fill solid border lc "black"
-          splot for [scan=N:1:-1] DATA index scan \
-                using x:y:z with filledcurves fc background
-
-
-   In gnuplot 6.1 the 3D *note filledcurves:: plot style is designed to
-display a set of two-dimensional curves that are incrementally displaced
-along an orthogonal axis.  Normally x or y is a fixed value for each
-curve so that the lines either represent z=f(x) at sequential y values
-or z=f(y) at sequential x values.  This is convenient for drawing
-waterfall plots.
-
-   In order to ensure that foreground curves occlude more distant ones
-it is important to order the sequence of curves from back to front.
-
-   See also 'fenceplots'.  D waterfallplot 1
-
-
-File: gnuplot.info,  Node: fill_properties,  Prev: 3D_waterfall_plots,  Up: filledcurves
-
-2.12.3 fill properties
-----------------------
-
-Plotting *note filledcurves:: can be further customized by giving a
-fillstyle (solid/transparent/pattern) or a fillcolor.  If no fillstyle
-('fs') is given in the plot command then the current default fill style
-is used.  See 'set style fill'.  If no fillcolor ('fc') is given in the
-plot command, the current line color is used.
-
-   The {{no}border} property of the fillstyle is honored by filledcurves
-mode 'closed', the default.  It is ignored by all other filledcurves
-modes.  Example:
-          plot 'data' with filledcurves fc "cyan" fs solid 0.5 border lc "blue"
-
-
-
-File: gnuplot.info,  Node: financebars,  Next: fillsteps,  Prev: filledcurves,  Up: Plotting_styles
-
-2.13 financebars
-================
-
-The *note financebars:: style is only relevant for 2D data plotting of
-financial data.  It requires 1 x coordinate (usually a date) and 4 y
-values (prices).
-
-          5 columns:   date  open  low  high  close
-
-
-   An additional (6th) input column may be used to provide variable
-(per-record) color information (see 'linecolor' and 'rgbcolor
-variable').
-
-   The symbol is a vertical line segment, located horizontally at the x
-coordinate and limited vertically by the high and low prices.  A
-horizontal tic on the left marks the opening price and one on the right
-marks the closing price.  The length of these tics may be changed by
-*note errorbars::.  The symbol will be unchanged if the high and low
-prices are interchanged.  See *note errorbars:: and *note
-candlesticks::, and also the finance demo.
-(http://www.gnuplot.info/demo/finance.html)
-
-
-File: gnuplot.info,  Node: fillsteps,  Next: fsteps,  Prev: financebars,  Up: Plotting_styles
-
-2.14 fillsteps
-==============
-
-          plot <data> with fillsteps {above|below} {y=<baseline>}
-
-
-   The *note fillsteps:: style is only relevant to 2D plotting.  It is
-exactly like the style *note steps:: except that the area between the
-curve and the baseline (default y=0) is filled in the current fill
-style.  The options 'above' and 'below' fill only the portion to one
-side of the baseline.  Note that in moving from one data point to the
-next, both *note steps:: and *note fillsteps:: first trace the change in
-x coordinate and then the change in y coordinate.  See *note steps::.
-        1 column:   y     # implicit x from line number (column 0)
-        2 columns:  x y
-
-
-
-File: gnuplot.info,  Node: fsteps,  Next: histeps,  Prev: fillsteps,  Up: Plotting_styles
-
-2.15 fsteps
-===========
-
-The *note fsteps:: style is only relevant to 2D plotting.  It connects
-consecutive points with two line segments: the first from (x1,y1) to
-(x1,y2) and the second from (x1,y2) to (x2,y2).  The input column
-requires are the same as for plot styles 'lines' and 'points'.  The
-difference between *note fsteps:: and *note steps:: is that *note
-fsteps:: traces first the change in y and then the change in x.  *note
-steps:: traces first the change in x and then the change in y.
-
-   See also steps demo.  (http://www.gnuplot.info/demo/steps.html)
-        1 column:   y     # implicit x from line number (column 0)
-        2 columns:  x y
-
-
-
-File: gnuplot.info,  Node: histeps,  Next: heatmaps,  Prev: fsteps,  Up: Plotting_styles
-
-2.16 histeps
-============
-
-The *note histeps:: style is only relevant to 2D plotting.  It is
-intended for plotting histograms.  Y-values are assumed to be centered
-at the x-values; the point at x1 is represented as a horizontal line
-from ((x0+x1)/2,y1) to ((x1+x2)/2,y1).  The lines representing the end
-points are extended so that the step is centered on at x.  Adjacent
-points are connected by a vertical line at their average x, that is,
-from ((x1+x2)/2,y1) to ((x1+x2)/2,y2).  The input column requires are
-the same as for plot styles 'lines' and 'points'.
-
-   If *note autoscale:: is in effect, it selects the xrange from the
-data rather than the steps, so the end points will appear only half as
-wide as the others.  See also steps demo.
-(http://www.gnuplot.info/demo/steps.html)
-        1 column:   y     # implicit x from line number (column 0)
-        2 columns:  x y
-
-
-
-File: gnuplot.info,  Node: heatmaps,  Next: histograms,  Prev: histeps,  Up: Plotting_styles
-
-2.17 heatmaps
-=============
-
-Several of gnuplot's plot styles can be used to create heat maps.  The
-choice of which style to use is dictated by the type of data.
-
-   Pixel-based heat maps all have the property that each pixel in the
-map corresponds exactly to one original data value.  The pixel-based
-image styles require a regular rectangular grid of data values; see
-'with image'.  However it is possible to handle missing grid values (see
-'sparse') and it is also possible to mask out only a portion of the grid
-for display (see *note masking::).  Unless there are a large number of
-grid elements, it is usually good to render each rectangular element
-separately ('with image pixels') so that smoothing or lossy compression
-is not applied to the resulting "image".
-
-   A polar equivalent to image pixel-based heat maps can be generated
-using 2D plot style *note sectors::.  Each input point corresponds to
-exactly one annular sector of a polar grid, equivalent to a pixel.
-Unlike the polar grid surface option described below, any number of
-individual grid sectors may be provided.  This plot style can be used in
-either polar or cartesian coordinate plots to place polar sectors
-anywhere on the graph.  The figure here shows two halves of a polar heat
-map displaced across the origin by +/- Δx on a cartesian coordinate
-plot.  See *note sectors::.
-
-   If the data points do not constitute a regular rectangular grid, they
-can often be used to fit a gridded surface by interpolation or by
-splines.  Alternatively a point-density function can be mapped onto a
-gridded plane or smooth surface.  See *note dgrid3d::.  The gridded
-surface can then be plotted as a pm3d surface (see *note masking::
-example).  In this case the points on the heat map do not retain a
-one-to-one correspondence with the input data.  I.e.  the validity of
-the heat map represenation is only as good as the gridded approximation.
-The demo collection has examples of generating 2D heatmaps from a set of
-points heatmap_points.dem
-(http://www.gnuplot.info/demo/heatmap_points.html)
-
-   If your copy of gnuplot was built with the -enable-polar-grid option,
-polar coordinate data points can be used to generate a 2D polar heat map
-in which each "pixel" corresponded to a pre-determined range of theta
-and r.  See 'set polar grid' and 'with surface'.  This process is
-exactly analogous to the use of *note dgrid3d:: and 'with pm3d' except
-that it operates in 2D polar coordinate space.
-
-
-File: gnuplot.info,  Node: histograms,  Next: hsteps,  Prev: heatmaps,  Up: Plotting_styles
-
-2.18 histograms
-===============
-
-The *note histograms:: style is only relevant to 2D plotting.  It
-produces a bar chart from a sequence of parallel data columns.  Each
-element of the 'plot' command must specify a single input data source
-(e.g.  one column of the input file), possibly with associated tic
-values or key titles.  Four styles of histogram layout are currently
-supported.
-
-           set style histogram clustered {gap <gapsize>}
-           set style histogram errorbars {gap <gapsize>} {<linewidth>}
-           set style histogram rowstacked
-           set style histogram columnstacked
-           set style histogram {title font "name,size" tc <colorspec>}
-
-
-   The default style corresponds to 'set style histogram clustered gap
-2'.  In this style, each set of parallel data values is collected into a
-group of boxes clustered at the x-axis coordinate corresponding to their
-sequential position (row #) in the selected datafile columns.  Thus if
-<n> datacolumns are selected, the first cluster is centered about x=1,
-and contains <n> boxes whose heights are taken from the first entry in
-the corresponding <n> data columns.  This is followed by a gap and then
-a second cluster of boxes centered about x=2 corresponding to the second
-entry in the respective data columns, and so on.  The default gap width
-of 2 indicates that the empty space between clusters is equivalent to
-the width of 2 boxes.  All boxes derived from any one column are given
-the same fill color and/or pattern; however see the subsection
-'histograms colors'.
-
-   Each cluster of boxes is derived from a single row of the input data
-file.  It is common in such input files that the first element of each
-row is a label.  Labels from this column may be placed along the x-axis
-underneath the appropriate cluster of boxes with the 'xticlabels' option
-to 'using'.
-
-   The *note errorbars:: style is very similar to the 'clustered' style,
-except that it requires additional columns of input for each entry.  The
-first column holds the height (y value) of that box, exactly as for the
-'clustered' style.
-          2 columns:        y yerr          bar extends from y-yerr to y+err
-          3 columns:        y ymin ymax     bar extends from ymin to ymax
-
-   The appearance of the error bars is controlled by the current value
-of *note errorbars:: and by the optional <linewidth> specification.
-
-   Two styles of stacked histogram are supported, chosen by the command
-'set style histogram {rowstacked|columnstacked}'.  In these styles the
-data values from the selected columns are collected into stacks of
-boxes.  Positive values stack upwards from y=0; negative values stack
-downwards.  Mixed positive and negative values will produce both an
-upward stack and a downward stack.  The default stacking mode is
-'rowstacked'.
-
-   The 'rowstacked' style places a box resting on the x-axis for each
-data value in the first selected column; the first data value results in
-a box a x=1, the second at x=2, and so on.  Boxes corresponding to the
-second and subsequent data columns are layered on top of these,
-resulting in a stack of boxes at x=1 representing the first data value
-from each column, a stack of boxes at x=2 representing the second data
-value from each column, and so on.  All boxes derived from any one
-column are given the same fill color and/or pattern (see 'set style
-fill').
-
-   The 'columnstacked' style is similar, except that each stack of boxes
-is built up from a single data column.  Each data value from the first
-specified data column yields a box in the stack at x=1, each data value
-from the second specified data column yields a box in the stack at x=2,
-and so on.  In this style the color of each box is taken from the row
-number, rather than the column number, of the corresponding data field.
-
-   Box widths may be modified using the *note boxwidth:: command.  Box
-fill styles may be set using the 'set style fill' command.
-
-   Histograms always use the x1 axis, but may use either y1 or y2.  If a
-plot contains both histograms and other plot styles, the non-histogram
-plot elements may use either the x1 or the x2 axis.
-
-   One additional style option 'set style histogram nokeyseparators' is
-relevant only to plots that contain multiple histograms.  See *note
-newhistogram:: for additional discussion of this case.
-
-   Examples: Suppose that the input file contains data values in columns
-2, 4, 6, ...  and error estimates in columns 3, 5, 7, ...  This example
-plots the values in columns 2 and 4 as a histogram of clustered boxes
-(the default style).  Because we use iteration in the plot command, any
-number of data columns can be handled in a single command.  See 'plot
-for'.
-
-           set boxwidth 0.9 relative
-           set style data histograms
-           set style histogram cluster
-           set style fill solid 1.0 border lt -1
-           plot for [COL=2:4:2] 'file.dat' using COL
-
-
-   This will produce a plot with clusters of two boxes (vertical bars)
-centered at each integral value on the x axis.  If the first column of
-the input file contains labels, they may be placed along the x-axis
-using the variant command
-
-           plot for [COL=2:4:2] 'file.dat' using COL:xticlabels(1)
-
-
-   If the file contains both magnitude and range information for each
-value, then error bars can be added to the plot.  The following commands
-will add error bars extending from (y-<error>) to (y+<error>), capped by
-horizontal bar ends drawn the same width as the box itself.  The error
-bars and bar ends are drawn with linewidth 2, using the border linetype
-from the current fill style.
-
-           set errorbars fullwidth
-           set style fill solid 1 border lt -1
-           set style histogram errorbars gap 2 lw 2
-           plot for [COL=2:4:2] 'file.dat' using COL:COL+1
-
-
-   This shows how to plot the same data as a rowstacked histogram.  Just
-to be different, the plot command in this example lists the separate
-columns individually rather than using iteration.
-
-           set style histogram rowstacked
-           plot 'file.dat' using 2, '' using 4:xtic(1)
-
-
-   This will produce a plot in which each vertical bar corresponds to
-one row of data.  Each vertical bar contains a stack of two segments,
-corresponding in height to the values found in columns 2 and 4 of the
-datafile.  Finally, the commands
-
-           set style histogram columnstacked
-           plot 'file.dat' using 2, '' using 4
-
-
-   will produce two vertical stacks, one for each column of data.  The
-stack at x=1 will contain a box for each entry in column 2 of the
-datafile.  The stack at x=2 will contain a box for each parallel entry
-in column 4 of the datafile.
-
-   Because this interchanges gnuplot's usual interpretation of input
-rows and columns, the specification of key titles and x-axis tic labels
-must also be modified accordingly.  See the comments given below.
-
-           set style histogram columnstacked
-           plot '' u 5:key(1)            # uses first column to generate key titles
-           plot '' u 5 title columnhead  # uses first row to generate xtic labels
-
-
-   Note that the two examples just given present exactly the same data
-values, but in different formats.
-
-* Menu:
-
-* newhistogram::
-* automated_iteration_over_multiple_columns::
-* histogram_color_assignments::
-
-
-File: gnuplot.info,  Node: newhistogram,  Next: automated_iteration_over_multiple_columns,  Prev: histograms,  Up: histograms
-
-2.18.1 newhistogram
--------------------
-
-Syntax:
-
-          newhistogram {"<title>" {font "name,size"} {tc <colorspec>}}
-                       {lt <linetype>} {fs <fillstyle>} {at <x-coord>}
-
-
-   More than one set of histograms can appear in a single plot.  In this
-case you can force a gap between them, and a separate label for each
-set, by using the *note newhistogram:: command.  For example
-
-           set style histogram  cluster
-           plot newhistogram "Set A", 'a' using 1, '' using 2, '' using 3, \
-                newhistogram "Set B", 'b' using 1, '' using 2, '' using 3
-
-
-   The labels "Set A" and "Set B" will appear beneath the respective
-sets of histograms, under the overall x axis label.
-
-   The newhistogram command can also be used to force histogram coloring
-to begin with a specific color (linetype).  By default colors will
-continue to increment successively even across histogram boundaries.
-Here is an example using the same coloring for multiple histograms
-           plot newhistogram "Set A" lt 4, 'a' using 1, '' using 2, '' using 3, \
-                newhistogram "Set B" lt 4, 'b' using 1, '' using 2, '' using 3
-
-
-   Similarly you can force the next histogram to begin with a specified
-fillstyle.  If the fillstyle is set to 'pattern', then the pattern used
-for filling will be incremented automatically.
-
-   Starting a new histogram will normally add a blank entry to the key,
-so that titles from this set of histogram components will be separated
-from those of the previous histogram.  This blank line may be
-undesirable if the components have no individual titles.  It can be
-suppressed by modifying the style with 'set style histogram
-nokeyseparators'.
-
-   The 'at <x-coord>' option sets the x coordinate position of the
-following histogram to <x-coord>.  For example
-
-            set style histogram cluster
-            set style data histogram
-            set style fill solid 1.0 border -1
-            set xtic 1 offset character 0,0.3
-            plot newhistogram "Set A", \
-                 'file.dat' u 1 t 1, '' u 2 t 2, \
-                 newhistogram "Set B" at 8, \
-                 'file.dat' u 2 t 2, '' u 2 t 2
-
-
-   will position the second histogram to start at x=8.
-
-
-File: gnuplot.info,  Node: automated_iteration_over_multiple_columns,  Next: histogram_color_assignments,  Prev: newhistogram,  Up: histograms
-
-2.18.2 automated iteration over multiple columns
-------------------------------------------------
-
-If you want to create a histogram from many columns of data in a single
-file, it is very convenient to use the plot iteration feature.  See
-'plot for'.  For example, to create stacked histograms of the data in
-columns 3 through 8
-
-           set style histogram columnstacked
-           plot for [i=3:8] "datafile" using i title columnhead
-
-
-
-File: gnuplot.info,  Node: histogram_color_assignments,  Prev: automated_iteration_over_multiple_columns,  Up: histograms
-
-2.18.3 histogram color assignments
-----------------------------------
-
-The program assigns a color to each component box in a histogram
-automatically such that equivalent data values maintain a consistent
-color wherever they appear in the rows or columns of the histogram.  The
-colors are taken from successive linetypes, starting either with the
-next unused linetype or an initial linetype provided in a *note
-newhistogram:: element.
-
-   In some cases this mechanism fails due to data sources that are not
-truly parallel (i.e.  some files contain incomplete data).  In other
-cases there may be additional properties of the data that could be
-visualized by, say, varying the intensity or saturation of their base
-color.  As an alternative to the automatic color assignment, you can
-provide an explicit color value for each data value in a second 'using'
-column via the 'linecolor variable' or 'rgb variable' mechanism.  See
-*note colorspec::.  Depending on the layout of your data, the color
-category might correspond to a row header or a column header or a data
-column.  Note that you will probably have to customize the key sample
-colors to match (see 'keyentry').
-
-   Example: Suppose file_001.dat through file_008.dat contain one column
-with a category identifier A, B, C, ...  and a second column with a data
-value.  Not all of the files contain a line for every category, so they
-are not truly parallel.  The program would be wrong to assign the same
-color to the value from line N in each file.  Instead we assign a color
-based on the category in column 1.
-
-          file(i) = sprintf("file_%03d.dat",i)
-          array Category = ["A", "B", "C", "D", "E", "F"]
-          color(c) = index(Category, strcol(c))
-          set style data histogram
-          plot for [i=1:8] file(i) using 2:(color(1)) linecolor variable
-
-
-   A more complete example including generation of a custom key is in
-the demo collection histogram_colors.dem
-(http://www.gnuplot.info/demo/histogram_colors.html) D histogram_colors
-1
-
-
-File: gnuplot.info,  Node: hsteps,  Next: image,  Prev: histograms,  Up: Plotting_styles
-
-2.19 hsteps
-===========
-
-The 2D plotting style *note hsteps:: renders a horizontal line segment
-("step") for each data point.  The step may extend to the left, to the
-right, or to both sides of the point's x-coordinate.  Additional
-keywords control the lines connecting adjacent steps and option area
-fill between the step and a baseline y value.
-
-   Syntax:
-          plot <data> with hsteps
-                              {forward|backward}
-                              {baseline|pillars|link|nolink}
-                              {{above|below} y=<baseline>}
-                              {offset <y-offset>}
-
-
-          2 columns:  x  y
-          3 columns:  x  y  width
-
-
-   This plot style requires 2 or 3 columns of data.  Additional input
-columns can be used to provide variable line or fill colors (see
-'rgbcolor variable').  The x values of the input data are assumed to be
-monotonic.
-
-   If the width of each step is not explicitly given through a third
-input column, each segment’s width is calculated so that it abuts the
-adjacent horizontal segments.  A negative value in column 3 will be
-treated as a request for a full-width step.
-
-   The 'forward' and 'backward' keywords can be used to specify the
-direction in which the horizontal segment extends from the given x
-coordinate.  If neither is specified, the horizontal segment extends on
-both sides of the given x-value halfway to the x-value of the next
-adjacent point.  However, for the first and last points, where there are
-no corresponding outer adjacent points, the horizontal segments are
-extrapolated using distances to the adjacent inner points (see *note
-histeps::, *note boxes::).
-
-   The default ('baseline') and 'pillar' variants employ a baseline y
-value.  If not provided in the plot command, the baseline is taken to be
-y=0.  If the plot command uses a fill style, the baseline also serves to
-delimit one boundary of the fill area.  Four style variants are
-possible.
-
-   'baseline' (default): If there is no gap along x between adjacent
-steps, they are connected by a vertical line segment between them.  This
-produces a curve like the *note steps::, *note histeps::, or *note
-fsteps:: styles.  If there is a gap between steps, usually because the
-width is less than the point spacing, the connecting line drops to the
-baseline and continues along it before rising again.  This produces a
-sequence of rectangular pulses.
-
-          set xzeroaxis
-          plot $data using 1:2 with hsteps
-          plot $data using 1:2:(0.5) with hsteps
-
-
-   'pillar': At each end of each step a vertical line is drawn to the
-baseline.  Note that no horizontal line segments are drawn at the
-baseline.
-
-          plot $data using 1:2       with hsteps pillar
-          plot $data using 1:2:(0.5) with hsteps pillar
-          plot $data using 1:2:(0.5) \
-                     with hsteps pillar above fc "blue", \
-               $data using 1:2:(0.5) \
-                     with hsteps pillar below fc "red"
-
-
-   'nolink': No connecting line is drawn between adjacent steps.
-Baseline and fill properties are not relevant to this variant.
-
-         plot $data using 1:2 with hsteps nolink, \
-              $data using 1:2 with hsteps nolink forward, \
-              $data using 1:2 with hsteps nolink backward, \
-              $data using 1:2 with points pt "|"
-
-
-   *note link::: Adjacent steps steps are connected by a single straight
-line segment.  Depending on the step widths, this line may be diagonal
-rather than vertical.
-
-   Example: The *note link:: variant can be superimposed onto the
-'pillar' variant to produce a stacked histogram plot in which category
-boundaries are connected.
-
-          set style line 11 lw 2 lc "gray" dt "."
-          set style line 12 lw 2 lc variable
-          plot $data using 1:3:(0.5)   ls 11 with hsteps link, \
-               $data using 1:3:(0.5):1 ls 12 with hsteps pillar fs solid 0.7 border, \
-               $data using 1:4:(0.5)   ls 11 with hsteps link, \
-               $data using 1:4:(0.5):1 ls 12 with hsteps pillar fs transparent pattern 1 border
-
-
-* Menu:
-
-* offset::
-* missing_data::
-
-
-File: gnuplot.info,  Node: offset,  Next: missing_data,  Prev: hsteps,  Up: hsteps
-
-2.19.1 offset
--------------
-
-The offset value modifies any of the *note hsteps:: variants by adding
-an increment to the y value of both the data point itself (column 2) and
-the baseline of the plot it appears in.  An example of use is to draw a
-logic circuit timing chart in which pulse waveforms are aligned
-vertically.  In general the offset can be used to stack plots from
-multiple data sets that share a common range of y values.
-
-          # bit(k,char) is a function that returns 0 or 1
-          # for the state of bit k in an ASCII character
-          set style fill solid 0.2 border
-          plot for [k=1:8] STR using 1:(bit(k,STR[$1])):(0.5) \
-               with hsteps fillcolor "black" offset k
-
-
-
-File: gnuplot.info,  Node: missing_data,  Prev: offset,  Up: hsteps
-
-2.19.2 missing data
--------------------
-
-In the hsteps style, empty lines, NaN values, and missing data have
-distinct meanings.  If an empty line is present in the data, the data
-series is reset at that point.  This is analogous to a blank line
-causing a break to start a new curve in the case of 'with lines'.  If an
-x-value contains NaN, it is processed in the same manner as an empty
-line.  If the x-value is valid but the y-value contains NaN, no
-horizontal line is drawn for that particular data point but the x-value
-is still used if needed to estimate the step width.
-
-
-File: gnuplot.info,  Node: image,  Next: impulses,  Prev: hsteps,  Up: Plotting_styles
-
-2.20 image
-==========
-
-The 'image', *note rgbimage::, and *note rgbalpha:: plotting styles all
-project a uniformly sampled grid of data values onto a plane in either
-2D or 3D. The input data may be an actual bitmapped image, perhaps
-converted from a standard format such as PNG, or a simple array of
-numerical values.  These plot styles are often used to produce heatmaps.
-For 2D heatmaps in polar coordinates, see 'set polar grid'.
-
-   This figure illustrates generation of a heat map from an array of
-scalar values.  The current palette is used to map each value onto the
-color assigned to the corresponding pixel.  See also 'sparse'.
-           plot '-' matrix with image
-           5 4 3 1 0
-           2 2 0 0 1
-           0 0 0 1 0
-           0 1 2 4 3
-           e
-           e
-
-
-   Each pixel (data point) of the input 2D image will become a rectangle
-or parallelepiped in the plot.  The coordinates of each data point will
-determine the center of the parallelepiped.  That is, an M x N set of
-data will form an image with M x N pixels.  This is different from the
-pm3d plotting style, where an M x N set of data will form a surface of
-(M-1) x (N-1) elements.  The scan directions for a binary image data
-grid can be further controlled by additional keywords.  See 'binary
-keywords flipx', 'keywords center', and 'keywords rotate'.
-
-   Image data can be scaled to fill a particular rectangle within a 2D
-plot coordinate system by specifying the x and y extent of each pixel.
-See 'binary keywords dx' and 'dy'.  To generate the figure at the right,
-the same input image was placed multiple times, each with a specified
-dx, dy, and origin.  The input PNG image of a building is 50x128 pixels.
-The tall building was drawn by mapping this using 'dx=0.5 dy=1.5'.  The
-short building used a mapping 'dx=0.5 dy=0.35'.
-
-   The 'image' style handles input pixels containing a grayscale or
-color palette value.  Thus 2D plots ('plot' command) require 3 columns
-of data (x,y,value), while 3D plots ('splot' command) require 4 columns
-of data (x,y,z,value).
-
-   The *note rgbimage:: style handles input pixels that are described by
-three separate values for the red, green, and blue components.  Thus 5D
-data (x,y,r,g,b) is needed for 'plot' and 6D data (x,y,z,r,g,b) for
-'splot'.  The individual red, green, and blue components are assumed to
-lie in the range [0:255].  This matches the convention used in PNG and
-JPEG files (see *note filetype::).  However some data files use an
-alternative convention in which RGB components are floating point values
-in the range [0:1].  To use the *note rgbimage:: style with such data,
-first use the command 'set rgbmax 1.0'.
-
-   The *note rgbalpha:: style handles input pixels that contain alpha
-channel (transparency) information in addition to the red, green, and
-blue components.  Thus 6D data (x,y,r,g,b,a) is needed for 'plot' and 7D
-data (x,y,z,r,g,b,a) for 'splot'.  The r, g, b, and alpha components are
-assumed to lie in the range [0:255].  To plot data for which RGBA
-components are floating point values in the range [0:1], first use the
-command 'set rgbmax 1.0'.
-
-   If only a single data column is provided for the color components of
-either rgbimage or rgbalpha plots, it is interpreted as containing 32
-bit packed ARGB data using the convention that alpha=0 means opaque and
-alpha=255 means fully transparent.  Note that this is backwards from the
-alpha convention if alpha is supplied in a separate column, but matches
-the ARGB packing convention for individual commands to set color.  See
-*note colorspec::.
-
-* Menu:
-
-* transparency::
-* image_pixels::
-
-
-File: gnuplot.info,  Node: transparency,  Next: image_pixels,  Prev: image,  Up: image
-
-2.20.1 transparency
--------------------
-
-The *note rgbalpha:: plotting style assumes that each pixel of input
-data contains an alpha value in the range [0:255].  A pixel with alpha =
-0 is purely transparent and does not alter the underlying contents of
-the plot.  A pixel with alpha = 255 is purely opaque.  All terminal
-types can handle these two extreme cases.  A pixel with 0 < alpha < 255
-is partially transparent.  Terminal types that do not support partial
-transparency will round this value to 0 or 255.  D argb_hexdata 2
-
-
-File: gnuplot.info,  Node: image_pixels,  Prev: transparency,  Up: image
-
-2.20.2 image pixels
--------------------
-
-Some terminals use device- or library-specific optimizations to render
-image data within a rectangular 2D area.  This sometimes produces
-undesirable output, e.g.  inter-pixel smoothing, bad clipping or missing
-edges.  An example of this is the smoothing applied by web browsers when
-rendering svg images.  The 'pixels' keyword tells gnuplot to use generic
-code to render the image pixel-by-pixel.  This rendering mode is slower
-and may result in larger output files, but should produce a consistent
-rendered view on all terminals.  It may in particular be preferable for
-heatmaps with a small number of pixels.  Example:
-           plot 'data' with image pixels
-
-
-
-File: gnuplot.info,  Node: impulses,  Next: labels,  Prev: image,  Up: Plotting_styles
-
-2.21 impulses
-=============
-
-The *note impulses:: style displays a vertical line from y=0 to the y
-value of each point (2D) or from z=0 to the z value of each point (3D).
-Note that the y or z values may be negative.  Data from additional
-columns can be used to control the color of each impulse.  To use this
-style effectively in 3D plots, it is useful to choose thick lines
-(linewidth > 1).  This approximates a 3D bar chart.
-
-          1 column:   y
-          2 columns:  x  y     # line from [x,0] to [x,y]  (2D)
-          3 columns:  x  y  z  # line from [x,y,0] to [x,y,z] (3D)
-
-
-
-File: gnuplot.info,  Node: labels,  Next: lines,  Prev: impulses,  Up: Plotting_styles
-
-2.22 labels
-===========
-
-The *note labels:: style reads coordinates and text from a data file and
-places the text string at the corresponding 2D or 3D position.  3 or 4
-input columns of basic data are required.  Additional input columns may
-be used to provide properties that vary point by point such as text
-rotation angle (keywords 'rotate variable') or color (see 'textcolor
-variable').
-
-          3 columns:  x  y  string    # 2D version
-          4 columns:  x  y  z  string # 3D version
-
-
-   The font, color, rotation angle and other properties of the printed
-text may be specified as additional command options (see 'set label').
-The example below generates a 2D plot with text labels constructed from
-the city whose name is taken from column 1 of the input file, and whose
-geographic coordinates are in columns 4 and 5.  The font size is
-calculated from the value in column 3, in this case the population.
-
-       CityName(String,Size) = sprintf("{/=%d %s}", Scale(Size), String)
-       plot 'cities.dat' using 5:4:(CityName(stringcolumn(1),$3)) with labels
-
-
-   If we did not want to adjust the font size to a different size for
-each city name, the command would be much simpler:
-
-       plot 'cities.dat' using 5:4:1 with labels font "Times,8"
-
-
-   If the labels are marked as *note hypertext:: then the text only
-appears if the mouse is hovering over the corresponding anchor point.
-See *note hypertext::.  In this case you must enable the label's 'point'
-attribute so that there is a point to act as the hypertext anchor:
-
-       plot 'cities.dat' using 5:4:1 with labels hypertext point pt 7
-
-
-   The *note labels:: style can also be used in place of the 'points'
-style when the set of predefined point symbols is not suitable or not
-sufficiently flexible.  For example, here we define a set of chosen
-single-character symbols and assign one of them to each point in a plot
-based on the value in data column 3:
-
-       set encoding utf8
-       symbol(z) = "∙□+⊙♠♣♡♢"[int(z):int(z)]
-       splot 'file' using 1:2:(symbol($3)) with labels
-
-
-   This example shows use of labels with variable rotation angle in
-column 4 and textcolor ("tc") in column 5.  Note that variable color is
-always taken from the last column in the 'using' specifier.
-
-       plot $Data using 1:2:3:4:5 with labels tc variable rotate variable
-
-
-
-File: gnuplot.info,  Node: lines,  Next: linespoints,  Prev: labels,  Up: Plotting_styles
-
-2.23 lines
-==========
-
-The 'lines' style connects adjacent points with straight line segments.
-It may be used in either 2D or 3D plots.  The basic form requires 1, 2,
-or 3 columns of input data.  Additional input columns may be used to
-provide information such as variable line color (see 'rgbcolor
-variable').
-
-   2D form (no "using" spec)
-        1 column:   y     # implicit x from row number
-        2 columns:  x y
-
-   3D form (no "using" spec)
-        1 column:   z     # implicit x from row, y from index
-        3 columns:  x y z
-
-
-   See also 'linetypes', 'linewidth', and 'linestyle'.
-
-
-File: gnuplot.info,  Node: linespoints,  Next: masking,  Prev: lines,  Up: Plotting_styles
-
-2.24 linespoints
-================
-
-The *note linespoints:: style (short form 'lp') connects adjacent points
-with straight line segments and then goes back to draw a small symbol at
-each point.  Points are drawn with the default size determined by *note
-pointsize:: unless a specific point size is given in the plot command or
-a variable point size is provided in an additional column of input data.
-Additional input columns may also be used to provide information such as
-variable line color.  See 'lines' and 'points'.
-
-   Two keywords control whether or not every point in the plot is marked
-with a symbol, 'pointinterval' (short form 'pi') and 'pointnumber'
-(short form 'pn').
-
-   'pi N' or 'pi -N' tells gnuplot to only place a symbol on every Nth
-point.  A negative value for N will erase the portion of line segment
-that passes underneath the symbol.  The size of the erased portion is
-controlled by *note pointintervalbox::.
-
-   'pn N' or 'pn -N' tells gnuplot to label only N of the data points,
-evenly spaced over the data set.  As with 'pi', a negative value for N
-will erase the portion of line segment that passes underneath the
-symbol.
-
-
-File: gnuplot.info,  Node: masking,  Next: parallelaxes,  Prev: linespoints,  Up: Plotting_styles
-
-2.25 masking
-============
-
-The plotting style 'with mask' is used to define a masking region that
-can be applied to pm3d surfaces or to images specified later in the same
-'plot' or 'splot' command.  Input data is interpreted as a stream of
-[x,y] or [x,y,z] coordinates defining the vertices of one or more
-polygons.  As in plotting style *note polygons::, polygons are separated
-by a blank line.  If the mask is part of a 3D (splot) command then a
-column of z values is required on input but is currently not used for
-anything.
-
-   If a mask definition is present in the plot command, then any
-subsequent image or pm3d surface in the same command can be masked by
-adding the keyword 'mask'.  If no mask has been defined, this keyword is
-ignored.
-
-   This example illustrates using the convex hull circumscribing a set
-of points to mask the corresponding region of a pm3d surface.
-        set table $HULL
-        plot $POINTS using 1:2 convexhull
-        unset table
-
-
-        set view map
-        set multiplot layout 1,2
-        splot $POINTS using 1:2:3 with pm3d, \
-              $POINTS using 1:2:(0) nogrid with points
-        splot $HULL using 1:2:(0) with mask, \
-              $POINTS using 1:2:3 mask with pm3d
-        unset multiplot
-
-   The 'splot' command for the first panel renders the unmasked surface
-created by dgrid3d from the original points and then the points
-themselves, in that order.  The 'splot' command for the second panel
-renders the masked surface.  Note that definition of the mask must come
-first (plot 'with mask'), followed by the pm3d surface it applies to
-(plot style 'with pm3d' modified by the 'mask' keyword).  A more
-complete version of this example is in the demo collection mask_pm3d.dem
-(http://www.gnuplot.info/demo/mask_pm3d.html)
-
-   Although it is not shown here, a single mask can include multiple
-polygonal regions.
-
-   The masking commands are EXPERIMENTAL. Details may change in a future
-release.
-
-
-File: gnuplot.info,  Node: parallelaxes,  Next: Polar_plots,  Prev: masking,  Up: Plotting_styles
-
-2.26 parallelaxes
-=================
-
-Parallel axis plots can highlight correlation in a multidimensional data
-set.  Individual columns of input data are each associated with a
-separately scaled vertical axis.  If all columns are drawn from a single
-file then each line on the plot represents values from a single row of
-data in that file.  It is common to use some discrete categorization to
-assign line colors, allowing visual exploration of the correlation
-between this categorization and the axis dimensions.
-
-   Syntax:
-
-         set style data parallelaxes
-         plot $DATA using col1{:varcol1} {at <xpos>} {<line properties}, \
-              $DATA using col2, ...
-
-
-   The 'at' keyword allows explicit placement of the parallel vertical
-axes along the x axis as in the example below.  If no explicit x
-coordinate is provide axis N will be placed at x=N.
-
-          array xpos[5] = [1, 5, 6, 7, 11, 12]
-          plot for [col=1:5] $DATA using col with parallelaxes at xpos[col]
-
-
-   By default gnuplot will automatically determine the range and scale
-of the individual axes from the input data, but the usual 'set axis
-range' commands can be used to customize this.  See *note paxis::.
-
-
-File: gnuplot.info,  Node: Polar_plots,  Next: points,  Prev: parallelaxes,  Up: Plotting_styles
-
-2.27 Polar plots
-================
-
-Polar plots are generated by changing the current coordinate system to
-polar before issuing a plot command.  The option 'set polar' tells
-gnuplot to interpret input 2D coordinates as <angle>,<radius> rather
-than <x>,<y>.  Many, but not all, of the 2D plotting styles work in
-polar mode.  The figure shows a combination of plot styles 'lines' and
-*note filledcurves::.  See 'set polar', *note rrange::, 'set size
-square', *note theta::, *note ttics::.
-
-   Polar heatmaps can be generated using plot style 'with surface'
-together with 'set polar grid'.
-          set size square
-          set angle degrees
-          set rtics
-          set grid polar
-          set palette cubehelix negative gamma 0.8
-          set polar grid gauss kdensity scale 35
-          set polar grid theta [0:190]
-          plot DATA with surface, DATA with points pt 7
-
-
-
-File: gnuplot.info,  Node: points,  Next: polygons,  Prev: Polar_plots,  Up: Plotting_styles
-
-2.28 points
-===========
-
-The 'points' style displays a small symbol at each point.  The command
-*note pointsize:: may be used to change the default size of all points.
-The point type defaults to that of the linetype.  See 'linetypes'.  If
-no 'using' spec is found in the plot command, input data columns are
-interpreted implicitly in the order 'x y pointsize pointtype color' as
-described below.
-
-   The first 8 point types are shared by all terminals.  Individual
-terminals may provide a much larger number of distinct point types.  Use
-the 'test' command to show what is provided by the current terminal
-settings.
-
-   Alternatively any single printable character may be given instead of
-a numerical point type, as in the example below.  You may use any
-unicode character as the pointtype (assumes utf8 support).  See 'escape
-sequences'.  Longer strings may be plotted using plot style *note
-labels:: rather than 'points'.
-
-          plot f(x) with points pt "#"
-          plot d(x) with points pt "\U+2299"
-
-
-* Menu:
-
-* variable_point_properties::
-
-
-File: gnuplot.info,  Node: variable_point_properties,  Prev: points,  Up: points
-
-2.28.1 variable point properties
---------------------------------
-
-Plot styles that contain a point symbol optionally accept additional
-data columns in the 'using' specifier to control the appearance of that
-point.  This is indicated by modifying the keywords 'pointtype', *note
-pointsize::, or 'linecolor' in the plot command with the additional
-keyword 'variable' rather than providing a number.  Plot style *note
-labels:: also accepts a variable text rotation angle.  Example:
-          # Input data provides [x,y] in columns 1:2
-          # point size is given in column 5
-          # RGB color is given as hexadecimal value in column 4
-          # all points use pointtype 7
-            plot DATA using 1:2:5:4 with points lc rgb variable ps variable pt 7
-
-
-   If more than one variable property is specified, columns are
-interpreted in the order below regardless of the order of keywords in
-the plot command.
-
-         textrotation : pointsize : pointtype : color
-
-
-   Thus in the example above "lc rgb variable" appears first in the plot
-command but the color is taken from the final column (4) given by
-'using'.  Variable color is always taken from the last additional
-column.  There are several methods of specifying variable color.  See
-*note colorspec::.
-
-   Note: for information on user-defined program variables, see
-'variables'.
-
-
-File: gnuplot.info,  Node: polygons,  Next: rgbalpha,  Prev: points,  Up: Plotting_styles
-
-2.29 polygons
-=============
-
-2D plots:
-
-          plot DATA {using 1:2} with polygons
-
-
-   *note polygons:: is treated as 'plot with filledcurves closed' except
-that each polygon's border is rendered as a closed curve even if its
-first and last points are not the same.  The border line type is taken
-from the fill style.  The input data file may contain multiple polygons
-separated by single blank lines.  Each polygon can be assigned a
-separate fill color by providing a third using specifier and the
-keywords 'fc variable' (value is interpreted as a linetype) or 'fc rgb
-variable' (value is interpreted as a 24-bit RGB color).  Only the color
-value from the first vertex of the polygon is used.
-
-   3D plots:
-
-          splot DATA {using x:y:z} with polygons
-                {fillstyle <fillstyle spec>}
-                {fillcolor <colorspec>}
-
-
-   *note polygons:: uses pm3d to render individual triangles,
-quadrangles, and larger polygons in 3D. These may be facets of a 3D
-surface or isolated shapes.  The code assumes that the vertices lie in a
-plane.  Vertices defining individual polygons are read from successive
-records of the input file.  A blank line separates one polygon from the
-next.
-
-   The fill style and color may be specified in the splot command,
-otherwise the global fillstyle from 'set style fill' is used.  Due to
-limitations in the pm3d code, a single border line style from *note
-border:: is applied to all 3D polygons.  This restriction may be removed
-in a later gnuplot version, which will impose a distinction between the
-linecolor and fillcolor properties.
-
-   Each polygon may be assigned a separate fill color by providing a
-fourth using specifier and the keywords 'fc variable' (value is
-interpreted as a linetype) or 'fc rgb variable' (value is interpreted as
-a 24-bit RGB color).  Only the color value from the first vertex of the
-polygon is used.
-
-   pm3d sort order and lighting are applied to the faces.  It is
-probably always desirable to use 'set pm3d depthorder'.
-
-          set xyplane at 0
-          set view equal xyz
-          unset border
-          unset tics
-          set pm3d depth
-          set pm3d border lc "black" lw 1.5
-          splot 'icosahedron.dat' with polygons \
-                fs transparent solid 0.8 fc bgnd
-
-
-
-File: gnuplot.info,  Node: rgbalpha,  Next: rgbimage,  Prev: polygons,  Up: Plotting_styles
-
-2.30 rgbalpha
-=============
-
-See 'image'.
-
-
-File: gnuplot.info,  Node: rgbimage,  Next: sectors,  Prev: rgbalpha,  Up: Plotting_styles
-
-2.31 rgbimage
-=============
-
-See 'image'.
-
-
-File: gnuplot.info,  Node: sectors,  Next: spiderplot,  Prev: rgbimage,  Up: Plotting_styles
-
-2.32 sectors
-============
-
-The 2D plotting style *note sectors:: renders one annular segment
-("sector") for each line of input data.  The shape of each sector is
-described by four required data values.  An additional pair of data
-values can be included to specify the origin of the annulus this sector
-is taken from.  A per-sector color may be provided in an additional
-column.
-
-   The plot style itself can be used in either cartesian or polar mode
-('set polar').  The units and interpretation for the azimuth and the
-sector angle are controlled using *note angles:: and *note theta::.
-
-   Columns 1 and 2 specify the azimuth (theta) and radius (r) of one
-corner of the sector.  Columns 3 and 4 specify the angular and radial
-extents of the sector ("sector_angle" and "annular_width").  Columns 5
-and 6, if present, specify the coordinates of the center of the annulus
-(default [0,0]).  The interpretation is [x,y] in cartesian mode and
-[theta,r] in polar mode.
-
-   Syntax:
-         plot DATA {using specifier} {units xy | units xx | units yy}
-
-
-   using specifier
-         4 columns: azimuth radius sector_angle annular_width
-         5 columns: azimuth radius sector_angle annular_width color
-         6 columnd: azimuth radius sector_angle annular_width center_x center_y
-         7 columns: azimuth radius sector_angle annular_width center_x center_y color
-
-
-   Note that if the x and y axis scales are not equal, the envelope of
-the full annulus in x/y coordinates will appear as an ellipse rather
-than a circle.  The annulus envelope and thus the apparent sector
-annular width can be adjusted to correct for unequal axis scales using
-the same mechanism as for ellipses.  Adding 'units xx' to the command
-line causes the sector to be rendered as if the current x axis scale
-applied equally to both x and y.  Similarly 'units yy' causes the sector
-to be rendered as if the current y axis scale applied equally to both x
-and y.  See *note isotropic::, 'set style ellipse'.
-
-   Plotting with sectors can provide polar coordinate equivalents for
-the cartesian plot styles *note boxes:: (see wind rose figure), *note
-boxxyerror:: and 'image pixels' (see example in *note heatmaps::).
-Because sector plots are compatible with cartesian mode plot layout,
-multiple plots can be placed at different places on a single graph,
-which would not be possible for other polar mode plot styles.
-
-   An example of using sectors to create a wind rose in shown here.
-Other applications include polar heatmaps, dial charts, pie/donut
-charts, and annular error boxes for data points in polar coordinates.
-Worked examples for all of these are given in the sectors demo.
-(http://www.gnuplot.info/demo/sectors.html)
-
-
-File: gnuplot.info,  Node: spiderplot,  Next: steps,  Prev: sectors,  Up: Plotting_styles
-
-2.33 spiderplot
-===============
-
-Spider plots are essentially parallel axis plots in which the axes are
-arranged radially rather than vertically.  Such plots are sometimes
-called 'radar charts'.  In gnuplot this requires working within a
-coordinate system established by the command *note spiderplot::,
-analogous to 'set polar' except that the angular coordinate is
-determined implicitly by the parallel axis number.  The appearance,
-labelling, and tic placement of the axes is controlled by *note paxis::.
-Further style choices are controlled using *note spiderplot::, 'set
-grid', and the individual components of the plot command.
-
-   Because each spider plot corresponds to a row of data rather than a
-column, it would make no sense to generate key entry titles in the
-normal way.  Instead, if a plot component contains a title the text is
-used to label the corresponding axis.  This overrides any previous 'set
-paxis n label "Foo"'.  To place a title in the key, you can either use a
-separate 'keyentry' command or extract text from a column in the input
-file with the 'key(column)' using specifier.  See 'keyentry', 'using
-key'.
-
-   In this figure a spiderplot with 5 axes is used to compare multiple
-entities that are each characterized by five scores.  Each line (row) in
-$DATA generates a new polygon on the plot.
-
-          $DATA << EOD
-                   A      B      C      D      E      F
-          George  15     75     20     43     90     50
-          Harriet 40     40     40     60     30     50
-          EOD
-          set spiderplot
-          set style spiderplot fs transparent solid 0.2 border
-          set for [p=1:5] paxis p range [0:100]
-          set for [p=2:5] paxis p tics format ""
-          set             paxis 1 tics font ",9"
-          set for [p=1:5] paxis p label sprintf("Score %d",p)
-          set grid spiderplot
-          plot for [i=1:5] $DATA using i:key(1)
-
-
-* Menu:
-
-* newspiderplot::
-
-
-File: gnuplot.info,  Node: newspiderplot,  Prev: spiderplot,  Up: spiderplot
-
-2.33.1 newspiderplot
---------------------
-
-Normally the sequential elements of a plot command *note spiderplot::
-each correspond to one vertex of a single polygon.  In order to describe
-multiple polygons in the same plot command, they must be separated by
-*note newspiderplot::.  Example:
-          # One polygon with 10 vertices
-          plot for [i=1:5] 'A' using i, for [j=1:5] 'B' using j
-          # Two polygons with 5 vertices
-          plot for [i=1:5] 'A' using i, newspiderplot, for [j=1:5] 'B' using j
-
-
-
-File: gnuplot.info,  Node: steps,  Next: surface,  Prev: spiderplot,  Up: Plotting_styles
-
-2.34 steps
-==========
-
-The *note steps:: style is only relevant to 2D plotting.  It connects
-consecutive points with two line segments: the first from (x1,y1) to
-(x2,y1) and the second from (x2,y1) to (x2,y2).  The input column
-requires are the same as for plot styles 'lines' and 'points'.  The
-difference between *note fsteps:: and *note steps:: is that *note
-fsteps:: traces first the change in y and then the change in x.  *note
-steps:: traces first the change in x and then the change in y.  To fill
-the area between the curve and the baseline at y=0, use *note
-fillsteps::.  See also steps demo.
-(http://www.gnuplot.info/demo/steps.html)
-        1 column:   y     # implicit x from line number (column 0)
-        2 columns:  x y
-
-
-
-File: gnuplot.info,  Node: surface,  Next: vectors,  Prev: steps,  Up: Plotting_styles
-
-2.35 surface
-============
-
-The plot style 'with surface' has two uses.
-
-   In 3D plots, 'with surface' always produces a surface.  If a 3D data
-set is recognizable as a mesh (grid) then by default the program
-implicitly treats the plot style 'with lines' as requesting a gridded
-surface, making 'with lines' a synonym for 'with surface'.  However the
-command 'set surface explicit' suppresses this treatment, in which case
-'with surface' and 'with lines' become distinct styles that may be used
-in the same plot.
-
-   If you have points in 3D that are not recognized as a grid, you may
-be able to fit a suitable grid first.  See *note dgrid3d::.
-
-   In 2D polar mode plots, 'with surface' is used to produce a solid
-fill gridded represention of the data.  Generation of the surface is
-controlled using the command 'set polar grid'.
-
-
-File: gnuplot.info,  Node: vectors,  Next: xerrorbars,  Prev: surface,  Up: Plotting_styles
-
-2.36 vectors
-============
-
-The 2D *note vectors:: style draws a vector from (x,y) to
-(x+xdelta,y+ydelta).  The 3D *note vectors:: style is similar, but
-requires six columns of basic data.  In both cases, an additional input
-column (5th in 2D, 7th in 3D) may be used to provide variable
-(per-datapoint) color information.  (see 'linecolor' and 'rgbcolor
-variable').  A small arrowhead is drawn at the end of each vector.
-
-          4 columns:  x  y  xdelta  ydelta
-          6 columns:  x  y  z  xdelta  ydelta  zdelta
-
-
-   The keywords "with vectors" may be followed by inline arrow style
-properties, by reference to a predefined arrow style, or by a request to
-read the index of the desired arrow style for each vector from a
-separate input column.  See the first three examples below.
-
-   Examples:
-
-          plot ... using 1:2:3:4 with vectors filled heads
-          plot ... using 1:2:3:4 with vectors arrowstyle 3
-          plot ... using 1:2:3:4:5 with vectors arrowstyle variable
-          splot 'file.dat' using 1:2:3:(1):(1):(1) with vectors filled head lw 2
-
-
-   Notes: You cannot mix the 'arrowstyle' keyword with other line style
-qualifiers in the plot command.  An additional column of color values is
-required if the arrow style includes 'lc variable' or 'lc rgb variable'.
-
-   splot with vectors is supported only for 'set mapping cartesian'.
-'set clip one' and 'set clip two' affect vectors drawn in 2D. See 'set
-clip' and 'arrowstyle'.
-
-   See also the 2D plot style 'with arrows' that is identical to *note
-vectors:: except that each arrow is specified using x:y:length:angle.
-
-
-File: gnuplot.info,  Node: xerrorbars,  Next: xyerrorbars,  Prev: vectors,  Up: Plotting_styles
-
-2.37 xerrorbars
-===============
-
-The *note xerrorbars:: style is only relevant to 2D data plots.  *note
-xerrorbars:: is like 'points', except that a horizontal error bar is
-also drawn.  At each point (x,y), a line is drawn from (xlow,y) to
-(xhigh,y) or from (x-xdelta,y) to (x+xdelta,y), depending on how many
-data columns are provided.  The appearance of the tic mark at the ends
-of the bar is controlled by *note errorbars::.  The clearance between
-the point and the error bars is controlled by *note pointintervalbox::.
-To have the error bars pass directly through the point with no
-interruption, use *note pointintervalbox::.  The basic style requires
-either 3 or 4 columns:
-
-          3 columns:  x  y  xdelta
-          4 columns:  x  y  xlow  xhigh
-
-
-   An additional input column (4th or 5th) may be used to provide
-variable color.  This style does not permit variable point properties.
-
-
-File: gnuplot.info,  Node: xyerrorbars,  Next: xerrorlines,  Prev: xerrorbars,  Up: Plotting_styles
-
-2.38 xyerrorbars
-================
-
-The *note xyerrorbars:: style is only relevant to 2D data plots.  *note
-xyerrorbars:: is like 'points', except that horizontal and vertical
-error bars are also drawn.  At each point (x,y), lines are drawn from
-(x,y-ydelta) to (x,y+ydelta) and from (x-xdelta,y) to (x+xdelta,y) or
-from (x,ylow) to (x,yhigh) and from (xlow,y) to (xhigh,y), depending
-upon the number of data columns provided.  The appearance of the tic
-mark at the ends of the bar is controlled by *note errorbars::.  The
-clearance between the point and the error bars is controlled by *note
-pointintervalbox::.  To have the error bars pass directly through the
-point with no interruption, use *note pointintervalbox::.  Either 4 or 6
-input columns are required.
-
-          4 columns:  x  y  xdelta  ydelta
-          6 columns:  x  y  xlow  xhigh  ylow  yhigh
-
-
-   If data are provided in an unsupported mixed form, the 'using'
-specifier of the 'plot' command should be used to set up the appropriate
-form.  For example, if the data are of the form (x,y,xdelta,ylow,yhigh),
-then you can use
-
-           plot 'data' using 1:2:($1-$3):($1+$3):4:5 with xyerrorbars
-
-
-   An additional input column (5th or 7th) may be used to provide
-variable color.  This style does not permit variable point properties.
-
-
-File: gnuplot.info,  Node: xerrorlines,  Next: xyerrorlines,  Prev: xyerrorbars,  Up: Plotting_styles
-
-2.39 xerrorlines
-================
-
-The *note xerrorlines:: style is only relevant to 2D data plots.  *note
-xerrorlines:: is like *note linespoints::, except that a horizontal
-error line is also drawn.  At each point (x,y), a line is drawn from
-(xlow,y) to (xhigh,y) or from (x-xdelta,y) to (x+xdelta,y), depending on
-how many data columns are provided.  The appearance of the tic mark at
-the ends of the bar is controlled by *note errorbars::.  The basic style
-requires either 3 or 4 columns:
-
-          3 columns:  x  y  xdelta
-          4 columns:  x  y  xlow  xhigh
-
-
-   An additional input column (4th or 5th) may be used to provide
-variable color.  This style does not permit variable point properties.
-
-
-File: gnuplot.info,  Node: xyerrorlines,  Next: yerrorbars,  Prev: xerrorlines,  Up: Plotting_styles
-
-2.40 xyerrorlines
-=================
-
-The *note xyerrorlines:: style is only relevant to 2D data plots.  *note
-xyerrorlines:: is like *note linespoints::, except that horizontal and
-vertical error bars are also drawn.  At each point (x,y), lines are
-drawn from (x,y-ydelta) to (x,y+ydelta) and from (x-xdelta,y) to
-(x+xdelta,y) or from (x,ylow) to (x,yhigh) and from (xlow,y) to
-(xhigh,y), depending upon the number of data columns provided.  The
-appearance of the tic mark at the ends of the bar is controlled by *note
-errorbars::.  Either 4 or 6 input columns are required.
-
-          4 columns:  x  y  xdelta  ydelta
-          6 columns:  x  y  xlow  xhigh  ylow  yhigh
-
-
-   If data are provided in an unsupported mixed form, the 'using'
-specifier of the 'plot' command should be used to set up the appropriate
-form.  For example, if the data are of the form (x,y,xdelta,ylow,yhigh),
-then you can use
-
-           plot 'data' using 1:2:($1-$3):($1+$3):4:5 with xyerrorlines
-
-
-   An additional input column (5th or 7th) may be used to provide
-variable color.  This style does not permit variable point properties.
-
-
-File: gnuplot.info,  Node: yerrorbars,  Next: yerrorlines,  Prev: xyerrorlines,  Up: Plotting_styles
-
-2.41 yerrorbars
-===============
-
-The *note yerrorbars:: (or *note errorbars::) style is only relevant to
-2D data plots.  *note yerrorbars:: is like 'points', except that a
-vertical error bar is also drawn.  At each point (x,y), a line is drawn
-from (x,y-ydelta) to (x,y+ydelta) or from (x,ylow) to (x,yhigh),
-depending on how many data columns are provided.  The appearance of the
-tic mark at the ends of the bar is controlled by *note errorbars::.  The
-clearance between the point and the error bars is controlled by *note
-pointintervalbox::.  To have the error bars pass directly through the
-point with no interruption, use *note pointintervalbox::.
-
-          2 columns:  [implicit x] y ydelta
-          3 columns:  x  y  ydelta
-          4 columns:  x  y  ylow  yhigh
-
-
-   Additional input columns may be used to provide information such as
-variable point size, point type, or color.
-
-   See also errorbar demo.  (http://www.gnuplot.info/demo/mgr.html)
-
-
-File: gnuplot.info,  Node: yerrorlines,  Next: 3D_plots,  Prev: yerrorbars,  Up: Plotting_styles
-
-2.42 yerrorlines
-================
-
-The *note yerrorlines:: (or 'errorlines') style is only relevant to 2D
-data plots.  *note yerrorlines:: is like *note linespoints::, except
-that a vertical error line is also drawn.  At each point (x,y), a line
-is drawn from (x,y-ydelta) to (x,y+ydelta) or from (x,ylow) to
-(x,yhigh), depending on how many data columns are provided.  The
-appearance of the tic mark at the ends of the bar is controlled by *note
-errorbars::.  Either 3 or 4 input columns are required.
-
-          3 columns:  x  y  ydelta
-          4 columns:  x  y  ylow  yhigh
-
-
-   Additional input columns may be used to provide information such as
-variable point size, point type, or color.
-
-   See also errorbar demo.  (http://www.gnuplot.info/demo/mgr.html)
-
-
-File: gnuplot.info,  Node: 3D_plots,  Next: Fence_plots,  Prev: yerrorlines,  Up: Plotting_styles
-
-2.43 3D plots
-=============
-
-3D plots are generated using the command 'splot' rather than 'plot'.
-Many of the 2D plot styles (points, images, impulse, labels, vectors)
-can also be used in 3D by providing an extra column of data containing z
-coordinate.  Some plot types (pm3d coloring, surfaces, contours) must be
-generated using the 'splot' command even if only a 2D projection is
-wanted.
-
-* Menu:
-
-* surface_plots::
-* 2D_projection_(set_view_map)::
-* PM3D_plots::
-
-
-File: gnuplot.info,  Node: surface_plots,  Next: 2D_projection_(set_view_map),  Prev: 3D_plots,  Up: 3D_plots
-
-2.43.1 surface plots
---------------------
-
-The styles 'splot with lines' and 'splot with surface' both generate a
-surface made from a grid of lines.  Solid surfaces can be generated
-using the style 'splot with pm3d'.  Usually the surface is displayed at
-some convenient viewing angle, such that it clearly represents a 3D
-surface.  See *note view::.  In this case the X, Y, and Z axes are all
-visible in the plot.  The illusion of 3D is enhanced by choosing hidden
-line removal.  See *note hidden3d::.  The 'splot' command can also
-calculate and draw contour lines corresponding to constant Z values.
-These contour lines may be drawn onto the surface itself, or projected
-onto the XY plane.  See 'set contour'.
-
-
-File: gnuplot.info,  Node: 2D_projection_(set_view_map),  Next: PM3D_plots,  Prev: surface_plots,  Up: 3D_plots
-
-2.43.2 2D projection (set view map)
------------------------------------
-
-An important special case of the 'splot' command is to map the Z
-coordinate onto a 2D surface by projecting the plot along the Z axis
-onto the xy plane.  See 'set view map'.  This plot mode is useful for
-contour plots and heat maps.  This figure shows contours plotted once
-with plot style 'lines' and once with style *note labels::.
-
-
-File: gnuplot.info,  Node: PM3D_plots,  Prev: 2D_projection_(set_view_map),  Up: 3D_plots
-
-2.43.3 PM3D plots
------------------
-
-3D surfaces can also be drawn using solid pm3d quadrangles rather than
-lines.  In this case there is no hidden surface removal, but if the
-component facets are drawn back-to-front then a similar effect is
-achieved.  See 'set pm3d depthorder'.  While pm3d surfaces are by
-default colored using a smooth color palette (see *note palette::), it
-is also possible to specify a solid color surface or to specify distinct
-solid colors for the top and bottom surfaces as in the figure shown
-here.  See *note fillcolor::.  Unlike the line-trimming in hidden3d
-mode, pm3d surfaces can be smoothly clipped to the current zrange.  See
-*note clipping::.
-
-
-File: gnuplot.info,  Node: Fence_plots,  Next: isosurface,  Prev: 3D_plots,  Up: Plotting_styles
-
-2.44 Fence plots
-================
-
-Fence plots combine several 2D plots by aligning their Y coordinates and
-separating them from each other by a displacement along X. Filling the
-area between a base value and each plot's series of Z values enhances
-the visual impact of the alignment on Y and comparison on Z. There are
-several ways such plots can be created in gnuplot.  The simplest is to
-use the 5 column variant of the 'zerrorfill' style.  Suppose there are
-separate curves z = Fi(y) indexed by i.  A fence plot is generated by
-'splot with zerrorfill' using input columns
-          i y z_base z_base Fi(y)
-
-
-
-File: gnuplot.info,  Node: isosurface,  Next: Zerrorfill,  Prev: Fence_plots,  Up: Plotting_styles
-
-2.45 isosurface
-===============
-
-This 3D plot style requires a populated voxel grid (see *note vgrid::,
-*note vfill::).  Linear interpolation of voxel grid values is used to
-estimate fractional grid coordinates corresponding to the requested
-isolevel.  These points are then used to generate a tessellated surface.
-The facets making up the surface are rendered as pm3d polygons, so the
-surface coloring, transparency, and border properties are controlled by
-'set pm3d'.  In general the surface is easier to interpret visually if
-facets are given a thin border that is darker than the fill color.  By
-default the tessellation uses a mixture of quadrangles and triangles.
-To use triangle only, see *note isosurface::.  Example:
-          set style fill solid 0.3
-          set pm3d depthorder border lc "blue" lw 0.2
-          splot $helix with isosurface level 10 fc "cyan"
-
-
-
-File: gnuplot.info,  Node: Zerrorfill,  Next: Animation,  Prev: isosurface,  Up: Plotting_styles
-
-2.46 Zerrorfill
-===============
-
-Syntax:
-
-          splot DATA using 1:2:3:4[:5] with zerrorfill {fc|fillcolor <colorspec>}
-                     {lt|linetype <n>} {<line properties>}
-
-
-   The 'zerrorfill' plot style is similar to one variant of the 2D plot
-style *note filledcurves::.  It fills the area between two functions or
-data lines that are sampled at the same x and y points.  It requires 4
-or 5 input columns:
-
-          4 columns:  x  y  z  zdelta
-          5 columns:  x  y  z  zlow  zhigh
-
-
-   The area between zlow and zhigh is filled and then a line is drawn
-through the z values.  By default both the line and the fill area use
-the same color, but you can change this in the splot command.  The fill
-area properties are also affected by the global fill style; see 'set
-style fill'.
-
-   If there are multiple curves in the splot command each new curve may
-occlude all previous curves.  To get proper depth sorting so that curves
-can only be occluded by curves closer to the viewer, it is best to order
-the curves from back to front.  Alternatively you can use 'set pm3d
-depthorder base' to sort them automatically, but unfortunately this
-causes all the filled areas to be drawn after all of the corresponding
-lines of z values.  In order to see both the lines and the depth-sorted
-fill areas you probably will need to make the fill areas partially
-transparent.
-
-   The fill area in the first two examples below is the same.
-
-          splot 'data' using 1:2:3:4 with zerrorfill fillcolor "grey" lt black
-          splot 'data' using 1:2:3:($3-$4):($3+$4) with zerrorfill
-          splot '+' using 1:(const):(func1($1)):(func2($1)) with zerrorfill
-          splot for [k=1:5] datafile[k] with zerrorfill lt black fc lt (k+1)
-
-
-   This plot style can also be used to create fence plots.  See
-'fenceplots'.  See also 'waterfallplots'.
-
-
-File: gnuplot.info,  Node: Animation,  Prev: Zerrorfill,  Up: Plotting_styles
-
-2.47 Animation
-==============
-
-Any of gnuplot's interactive terminals (qt win wxt x11 aqua) can be used
-to display an animation by plotting successive frames from the command
-line or from a script.
-
-   Several non-mousing terminals also support some form of animation.
-See 'term sixelgd', 'term kittycairo'.
-
-   Two terminals can save an animation to a file for later playback
-locally or by embedding it a web page.  See 'term gif animate', 'term
-webp'.
-
-   Example:
-
-          unset border; unset tics; unset key; set view equal xyz
-          set pm3d border linecolor "black"
-
-
-          set term webp animate delay 50
-          set output 'spinning_d20.webp'
-          do for [ang=1:360:2] {
-              set view 60, ang
-              splot 'icosahedron.dat' with polygons fc "gold"
-          }
-          unset output
-
-
-
-File: gnuplot.info,  Node: Commands,  Next: Terminal_types,  Prev: Plotting_styles,  Up: Top
-
-3 Commands
-**********
-
-This section lists the commands acceptable to 'gnuplot' in alphabetical
-order.  Printed versions of this document contain all commands; the text
-available interactively may not be complete.  Indeed, on some systems
-there may be no commands at all listed under this heading.
-
-   Note that in most cases unambiguous abbreviations for command names
-and their options are permissible, i.e., "'p f(x) w li'" instead of
-"'plot f(x) with lines'".
-
-   In the syntax descriptions, braces ({}) denote optional arguments and
-a vertical bar (|) separates mutually exclusive choices.
-
-* Menu:
-
-* Break::
-* cd::
-* call::
-* clear::
-* Continue::
-* Do::
-* evaluate::
-* exit::
-* fit::
-* function_blocks::
-* help::
-* history::
-* if::
-* for::
-* import::
-* load::
-* local::
-* lower::
-* pause::
-* plot::
-* print::
-* printerr::
-* pwd::
-* quit::
-* raise::
-* refresh::
-* remultiplot::
-* replot::
-* reread::
-* reset::
-* return::
-* save::
-* set-show::
-* shell::
-* show::
-* splot::
-* stats_(Statistical_Summary)::
-* system_::
-* test::
-* toggle::
-* undefine::
-* unset::
-* update::
-* vclear::
-* vfill::
-* warn::
-* While::
-
-
-File: gnuplot.info,  Node: Break,  Next: cd,  Prev: Commands,  Up: Commands
-
-3.1 Break
-=========
-
-The 'break' command is only meaningful inside the bracketed iteration
-clause of a 'do' or 'while' statement.  It causes the remaining
-statements inside the bracketed clause to be skipped and iteration is
-terminated.  Execution resumes at the statement following the closing
-bracket.  See also 'continue'.
-
-
-File: gnuplot.info,  Node: cd,  Next: call,  Prev: Break,  Up: Commands
-
-3.2 cd
-======
-
-The 'cd' command changes the working directory.
-
-   Syntax:
-           cd '<directory-name>'
-
-
-   The directory name must be enclosed in quotes.
-
-   Examples:
-           cd 'subdir'
-           cd ".."
-
-
-   It is recommended that Windows users use single-quotes, because
-backslash [\] has special significance inside double-quotes and has to
-be escaped.  For example,
-           cd "c:\newdata"
-
-   fails, but
-           cd 'c:\newdata'
-           cd "c:\\newdata"
-
-   work as expected.
-
-
-File: gnuplot.info,  Node: call,  Next: clear,  Prev: cd,  Up: Commands
-
-3.3 call
-========
-
-The *note call:: command is identical to the 'load' command with one
-exception: the name of the file being loaded may be followed by up to
-nine parameters.
-
-          call "inputfile" <param-1> <param-2> <param-3> ... <param-9>
-
-
-   Gnuplot now provides a set of string variables ARG0, ARG1, ..., ARG9
-and an integer variable ARGC. When a *note call:: command is executed
-ARG0 is set to the name of the input file, ARGC is set to the number of
-parameters present, and ARG1 to ARG9 are loaded from the parameters that
-follow it on the command line.  Any existing contents of the ARG
-variables are saved and restored across a *note call:: command.
-
-   Because the parameters ARG1 ...  ARG9 are stored in ordinary string
-variables they may be dereferenced by macro expansion.  However in many
-cases it is more natural to use them as you would any other variable.
-
-   In parallel with the string representation of parameters ARG1 ...
-ARG9, the parameters themselves are stored in an array ARGV[9].  See
-'ARGV'.
-
-   DEPRECATED: Versions prior to 5.0 performed macro-like substitution
-of the special tokens $0, $1, ...  $9 with the literal contents of
-<param-1> ...  That older mechanism is no longer supported.
-
-   EXPERIMENTAL: Function blocks (new in this version) provide a more
-flexible alternative to *note call::.  See 'function blocks'.
-
-* Menu:
-
-* ARGV[_]::
-* Example::
-
-
-File: gnuplot.info,  Node: ARGV[_],  Next: Example,  Prev: call,  Up: call
-
-3.3.1 ARGV[ ]
--------------
-
-When a gnuplot script is entered via the *note call:: command any
-parameters passed by the caller are available via two mechanisms.  Each
-parameter is stored as a string in variables ARG1, ARG2, ...  ARG9.
-Each parameter is also stored as one element of the array ARGV[9].
-Numerical values are stored as complex variables.  All other values are
-stored as strings.  ARGC holds the number of parameters.  Thus after a
-call
-
-          call 'routine_1.gp'  1 pi "title"
-
-
-   The three arguments are available inside routine_1.gp as follows
-
-          ARGC = 3
-          ARG1 = "1"         ARGV[1] = 1.0
-          ARG2 = "3.14159"   ARGV[2] = 3.14159265358979...
-          ARG3 = "title"     ARGV[3] = "title"
-
-
-   In this example ARGV[1] and ARGV[2] have the full precision of a
-floating point variable.  ARG2 lost precision in being stored as a
-string using format "%g".
-
-   ARGC and a corresponding array ARGV[ARGC] are also available to code
-inside a function block call.  However invocation of a function block
-does not create string variables ARG1,...  .
-
-
-File: gnuplot.info,  Node: Example,  Prev: ARGV[_],  Up: call
-
-3.3.2 Example
--------------
-
-          Call site
-              MYFILE = "script1.gp"
-              FUNC = "sin(x)"
-              call MYFILE FUNC 1.23 "This is a plot title"
-          Upon entry to the called script
-              ARG0 holds "script1.gp"
-              ARG1 holds the string "sin(x)"
-              ARG2 holds the string "1.23"
-              ARG3 holds the string "This is a plot title"
-              ARGC is 3
-          The script itself can now execute
-              plot @ARG1 with lines title ARG3
-              print ARG2 * 4.56, @ARG2 * 4.56
-              print "This plot produced by script ", ARG0
-
-
-   Notice that because ARG1 is a string it must be dereferenced as a
-macro, but ARG2 may be dereferenced either as a macro (yielding a
-numerical constant) or a variable (yielding that same numerical value
-after auto-promotion of the string "1.23" to a real).
-
-   The same result could be obtained directly from a shell script by
-invoking gnuplot with the '-c' command line option:
-
-          gnuplot -persist -c "script1.gp" "sin(x)" 1.23 "This is a plot title"
-
-
-
-File: gnuplot.info,  Node: clear,  Next: Continue,  Prev: call,  Up: Commands
-
-3.4 clear
-=========
-
-The *note clear:: command erases the current screen or output device as
-specified by *note terminal:: and *note output::.  This usually
-generates a formfeed on hardcopy devices.
-
-   For some terminals *note clear:: erases only the portion of the
-plotting surface defined by *note size::, so for these it can be used in
-conjunction with *note multiplot:: to create an inset.
-
-   Example:
-           set multiplot
-           plot sin(x)
-           set origin 0.5,0.5
-           set size 0.4,0.4
-           clear
-           plot cos(x)
-           unset multiplot
-
-
-   Please see *note multiplot::, *note size::, and *note origin:: for
-details.
-
-
-File: gnuplot.info,  Node: Continue,  Next: Do,  Prev: clear,  Up: Commands
-
-3.5 Continue
-============
-
-The 'continue' command is only meaningful inside the bracketed iteration
-clause of a 'do' or 'while' statement.  It causes the remaining
-statements inside the bracketed clause to be skipped.  Execution resumes
-at the start of the next iteration (if any remain in the loop
-condition).  See also 'break'.
-
-
-File: gnuplot.info,  Node: Do,  Next: evaluate,  Prev: Continue,  Up: Commands
-
-3.6 Do
-======
-
-Syntax:
-           do for <iteration-spec> {
-                <commands>
-                <commands>
-           }
-
-   Execute a sequence of commands multiple times.  The commands must be
-enclosed in curly brackets, and the opening "{" must be on the same line
-as the 'do' keyword.  This command cannot be used with old-style
-(un-bracketed) if/else statements.  See *note if::.  For examples of
-iteration specifiers, see *note iteration::.  Example:
-           set multiplot layout 2,2
-           do for [name in "A B C D"] {
-               filename = name . ".dat"
-               set title sprintf("Condition %s",name)
-               plot filename title name
-           }
-           unset multiplot
-
-   See also 'while', 'continue', 'break'.
-
-
-File: gnuplot.info,  Node: evaluate,  Next: exit,  Prev: Do,  Up: Commands
-
-3.7 evaluate
-============
-
-The *note evaluate:: command executes gnuplot commands contained in a
-string or in a function block.  Newline characters are not allowed
-within the string.
-
-          evaluate "commands in a string constant"
-          evaluate string_valued_function( ... arguments ... )
-          evaluate $functionblock( ... arguments ... )
-
-
-   This is especially useful for a repetition of similar commands.
-
-   Example:
-           set_label(x, y, text) \
-             = sprintf("set label '%s' at %f, %f point pt 5", text, x, y)
-           eval set_label(1., 1., 'one/one')
-           eval set_label(2., 1., 'two/one')
-           eval set_label(1., 2., 'one/two')
-
-
-   Please see 'function blocks' and *note macros:: for other mechanisms
-that construct or execute strings containing gnuplot commands.
-
-
-File: gnuplot.info,  Node: exit,  Next: fit,  Prev: evaluate,  Up: Commands
-
-3.8 exit
-========
-
-          exit
-          exit message "error message text"
-          exit status <integer error code>
-
-
-   The commands *note exit:: and *note quit::, as well as the
-END-OF-FILE character (usually Ctrl-D) terminate input from the current
-input stream: terminal session, pipe, or file input (pipe).  If input
-streams are nested (inherited 'load' scripts), then reading will
-continue in the parent stream.  When the top level stream is closed, the
-program itself will exit.
-
-   The command 'exit gnuplot' will immediately and unconditionally cause
-gnuplot to exit even if the input stream is multiply nested.  In this
-case any open output files may not be completed cleanly.  Example of
-use:
-
-           bind "ctrl-x" "unset output; exit gnuplot"
-
-
-   The command 'exit error "error message"' simulates a program error.
-In interactive mode it prints the error message and returns to the
-command line, breaking out of all nested loops or calls.  In
-non-interactive mode the program will exit.
-
-   When gnuplot exits to the controlling shell, the return value is not
-usually informative.  This variant of the command allows you to return a
-specific value.
-
-          exit status <value>
-
-
-   See help for 'batch/interactive' for more details.
-
-
-File: gnuplot.info,  Node: fit,  Next: function_blocks,  Prev: exit,  Up: Commands
-
-3.9 fit
-=======
-
-The *note fit:: command fits a user-supplied real-valued expression to a
-set of data points, using the nonlinear least-squares
-Marquardt-Levenberg algorithm.  There can be up to 12 independent
-variables, there is always 1 dependent variable, and any number of
-parameters can be fitted.  Optionally, error estimates can be input for
-weighting the data points.
-
-   The basic use of *note fit:: is best explained by a simple example
-where a set of measured x and y values read from a file are used to be
-modeled by a function y = f(x).
-
-           f(x) = a + b*x + c*x**2
-           fit f(x) 'measured.dat' using 1:2 via a,b,c
-           plot 'measured.dat' u 1:2, f(x)
-
-
-   Syntax:
-           fit {<ranges>} <expression>
-               '<datafile>' {datafile-modifiers}
-               {{unitweights} | {y|xy|z}error | errors <var1>{,<var2>,...}}
-               via '<parameter file>' | <var1>{,<var2>,...}
-
-
-   Ranges may be specified to filter the data used in fitting.
-Out-of-range data points are ignored.  The syntax is
-           [{dummy_variable=}{<min>}{:<max>}],
-
-   analogous to 'plot'; see *note ranges::.
-
-   <expression> can be any valid 'gnuplot' expression, although the most
-common is a previously user-defined function of the form f(x) or f(x,y).
-It must be real-valued.  The names of the independent variables are set
-by the *note dummy:: command, or in the <ranges> part of the command
-(see below); by default, the first two are called x and y.  Furthermore,
-the expression should depend on one or more variables whose value is to
-be determined by the fitting procedure.
-
-   <datafile> is treated as in the 'plot' command.  All the *note
-datafile:: modifiers ('using', *note every::,...)  except *note smooth::
-are applicable to *note fit::.  See *note datafile::.
-
-   The datafile contents can be interpreted flexibly by providing a
-'using' qualifier as with plot commands.  For example to generate the
-independent variable x as the sum of columns 2 and 3, while taking z
-from column 6 and requesting equal weights:
-
-           fit ... using ($2+$3):6
-
-
-   In the absence of a 'using' specification, the fit implicitly assumes
-there is only a single independent variable.  If the file itself, or the
-using specification, contains only a single column of data, the line
-number is taken as the independent variable.  If a 'using' specification
-is given, there can be up to 12 independent variables (and more if
-specially configured at compile time).
-
-   The 'unitweights' option, which is the default, causes all data
-points to be weighted equally.  This can be changed by using the
-'errors' keyword to read error estimates of one or more of the variables
-from the data file.  These error estimates are interpreted as the
-standard deviation s of the corresponding variable value and used to
-compute a weight for the datum as 1/s**2.
-
-   In case of error estimates of the independent variables, these
-weights are further multiplied by fitting function derivatives according
-to the "effective variance method" (Jay Orear, Am.  J. Phys., Vol.  50,
-1982).
-
-   The 'errors' keyword is to be followed by a comma-separated list of
-one or more variable names for which errors are to be input; the
-dependent variable z must always be among them, while independent
-variables are optional.  For each variable in this list, an additional
-column will be read from the file, containing that variable's error
-estimate.  Again, flexible interpretation is possible by providing the
-'using' qualifier.  Note that the number of independent variables is
-thus implicitly given by the total number of columns in the 'using'
-qualifier, minus 1 (for the dependent variable), minus the number of
-variables in the 'errors' qualifier.
-
-   As an example, if one has 2 independent variables, and errors for the
-first independent variable and the dependent variable, one uses the
-'errors x,z' qualifier, and a 'using' qualifier with 5 columns, which
-are interpreted as x:y:z:sx:sz (where x and y are the independent
-variables, z the dependent variable, and sx and sz the standard
-deviations of x and z).
-
-   A few shorthands for the 'errors' qualifier are available: 'yerrors'
-(for fits with 1 column of independent variable), and 'zerrors' (for the
-general case) are all equivalent to 'errors z', indicating that there is
-a single extra column with errors of the dependent variable.
-
-   'xyerrors', for the case of 1 independent variable, indicates that
-there are two extra columns, with errors of both the independent and the
-dependent variable.  In this case the errors on x and y are treated by
-Orear's effective variance method.
-
-   Note that 'yerror' and 'xyerror' are similar in both form and
-interpretation to the *note yerrorlines:: and *note xyerrorlines:: 2D
-plot styles.
-
-   With the command 'set fit v4' the fit command syntax is compatible
-with 'gnuplot' version 4.  In this case there must be two more 'using'
-qualifiers (z and s) than there are independent variables, unless there
-is only one variable.  'gnuplot' then uses the following formats,
-depending on the number of columns given in the 'using' specification:
-
-           z                           # 1 independent variable (line number)
-           x:z                         # 1 independent variable (1st column)
-           x:z:s                       # 1 independent variable (3 columns total)
-           x:y:z:s                     # 2 independent variables (4 columns total)
-           x1:x2:x3:z:s                # 3 independent variables (5 columns total)
-           x1:x2:x3:...:xN:z:s         # N independent variables (N+2 columns total)
-
-
-   Please beware that this means that you have to supply z-errors s in a
-fit with two or more independent variables.  If you want unit weights
-you need to supply them explicitly by using e.g.  then format x:y:z:(1).
-
-   The dummy variable names may be changed when specifying a range as
-noted above.  The first range corresponds to the first 'using' spec, and
-so on.  A range may also be given for z (the dependent variable), in
-which case data points for which f(x,...)  is out of the z range will
-not contribute to the residual being minimized.
-
-   Multiple datasets may be simultaneously fit with functions of one
-independent variable by making y a 'pseudo-variable', e.g., the dataline
-number, and fitting as two independent variables.  See *note
-multi-branch::.
-
-   The 'via' qualifier specifies which parameters are to be optimized,
-either directly, or by referencing a parameter file.
-
-   Examples:
-           f(x) = a*x**2 + b*x + c
-           g(x,y) = a*x**2 + b*y**2 + c*x*y
-           set fit limit 1e-6
-           fit f(x) 'measured.dat' via 'start.par'
-           fit f(x) 'measured.dat' using 3:($7-5) via 'start.par'
-           fit f(x) './data/trash.dat' using 1:2:3 yerror via a, b, c
-           fit g(x,y) 'surface.dat' using 1:2:3 via a, b, c
-           fit a0 + a1*x/(1 + a2*x/(1 + a3*x)) 'measured.dat' via a0,a1,a2,a3
-           fit a*x + b*y 'surface.dat' using 1:2:3 via a,b
-           fit [*:*][yaks=*:*] a*x+b*yaks 'surface.dat' u 1:2:3 via a,b
-
-
-           fit [][][t=*:*] a*x + b*y + c*t 'foo.dat' using 1:2:3:4 via a,b,c
-
-
-           set dummy x1, x2, x3, x4, x5
-           h(x1,x2,x3,x4,s5) = a*x1 + b*x2 + c*x3 + d*x4 + e*x5
-           fit h(x1,x2,x3,x4,x5) 'foo.dat' using 1:2:3:4:5:6 via a,b,c,d,e
-
-
-   After each iteration step, detailed information about the current
-state of the fit is written to the display.  The same information about
-the initial and final states is written to a log file, "fit.log".  This
-file is always appended to, so as to not lose any previous fit history;
-it should be deleted or renamed as desired.  By using the command 'set
-fit logfile', the name of the log file can be changed.
-
-   If activated by using 'set fit errorvariables', the error for each
-fitted parameter will be stored in a variable named like the parameter,
-but with "_err" appended.  Thus the errors can be used as input for
-further computations.
-
-   If 'set fit prescale' is activated, fit parameters are prescaled by
-their initial values.  This helps the Marquardt-Levenberg routine
-converge more quickly and reliably in cases where parameters differ in
-size by several orders of magnitude.
-
-   The fit may be interrupted by pressing Ctrl-C (Ctrl-Break in
-wgnuplot).  After the current iteration completes, you have the option
-to (1) stop the fit and accept the current parameter values, (2)
-continue the fit, (3) execute a 'gnuplot' command as specified by 'set
-fit script' or the environment variable 'FIT_SCRIPT'. The default is
-*note replot::, so if you had previously plotted both the data and the
-fitting function in one graph, you can display the current state of the
-fit.
-
-   Once *note fit:: has finished, the *note fit:: command may be used to
-store final values in a file for subsequent use as a parameter file.
-See *note fit:: for details.
-
-* Menu:
-
-* adjustable_parameters::
-* short_introduction::
-* error_estimates::
-* control::
-* error_recovery::
-* multi-branch::
-* starting_values::
-* time_data::
-* tips::
-
-
-File: gnuplot.info,  Node: adjustable_parameters,  Next: short_introduction,  Prev: fit,  Up: fit
-
-3.9.1 adjustable parameters
----------------------------
-
-There are two ways that 'via' can specify the parameters to be adjusted,
-either directly on the command line or indirectly, by referencing a
-parameter file.  The two use different means to set initial values.
-
-   Adjustable parameters can be specified by a comma-separated list of
-variable names after the 'via' keyword.  Any variable that is not
-already defined is created with an initial value of 1.0.  However, the
-fit is more likely to converge rapidly if the variables have been
-previously declared with more appropriate starting values.
-
-   In a parameter file, each parameter to be varied and a corresponding
-initial value are specified, one per line, in the form
-           varname = value
-
-
-   Comments, marked by '#', and blank lines are permissible.  The
-special form
-           varname = value       # FIXED
-
-
-   means that the variable is treated as a 'fixed parameter',
-initialized by the parameter file, but not adjusted by *note fit::.  For
-clarity, it may be useful to designate variables as fixed parameters so
-that their values are reported by *note fit::.  The keyword '# FIXED'
-has to appear in exactly this form.
-
-
-File: gnuplot.info,  Node: short_introduction,  Next: error_estimates,  Prev: adjustable_parameters,  Up: fit
-
-3.9.2 short introduction
-------------------------
-
-*note fit:: is used to find a set of parameters that 'best' fits your
-data to your user-defined function.  The fit is judged on the basis of
-the sum of the squared differences or 'residuals' (SSR) between the
-input data points and the function values, evaluated at the same places.
-This quantity is often called 'chisquare' (i.e., the Greek letter chi,
-to the power of 2).  The algorithm attempts to minimize SSR, or more
-precisely the weighted sum of squared residuals (WSSR), for which the
-residuals are weighted by the input data errors before being squared;
-see 'fit error_estimates' for details.
-
-   That's why it is called 'least-squares fitting'.  Let's look at an
-example to see what is meant by 'non-linear', but first we had better go
-over some terms.  Here it is convenient to use z as the dependent
-variable for user-defined functions of either one independent variable,
-z=f(x), or two independent variables, z=f(x,y).  A parameter is a
-user-defined variable that *note fit:: will adjust, i.e., an unknown
-quantity in the function declaration.  Linearity/non-linearity refers to
-the relationship of the dependent variable, z, to the parameters which
-*note fit:: is adjusting, not of z to the independent variables, x
-and/or y.  (To be technical, the second {and higher} derivatives of the
-fitting function with respect to the parameters are zero for a linear
-least-squares problem).
-
-   For linear least-squares the user-defined function will be a sum of
-simple functions, not involving any parameters, each multiplied by one
-parameter.  Nonlinear least-squares handles more complicated functions
-in which parameters can be used in a large number of ways.  An example
-that illustrates the difference between linear and nonlinear
-least-squares is the Fourier series.  One member may be written as
-          z=a*sin(c*x) + b*cos(c*x).
-
-   If a and b are the unknown parameters and c is constant, then
-estimating values of the parameters is a linear least-squares problem.
-However, if c is an unknown parameter, the problem is nonlinear.
-
-   In the linear case, parameter values can be determined by
-comparatively simple linear algebra, in one direct step.  However the
-linear special case is also solved along with more general nonlinear
-problems by the iterative procedure that 'gnuplot' uses.  *note fit::
-attempts to find the minimum by doing a search.  Each step (iteration)
-calculates WSSR with a new set of parameter values.  The
-Marquardt-Levenberg algorithm selects the parameter values for the next
-iteration.  The process continues until a preset criterion is met,
-either (1) the fit has "converged" (the relative change in WSSR is less
-than a certain limit, see 'set fit limit'), or (2) it reaches a preset
-iteration count limit (see 'set fit maxiter').  The fit may also be
-interrupted and subsequently halted from the keyboard (see *note fit::).
-The user variable FIT_CONVERGED contains 1 if the previous fit command
-terminated due to convergence; it contains 0 if the previous fit
-terminated for any other reason.  FIT_NITER contains the number of
-iterations that were done during the last fit.
-
-   Often the function to be fitted will be based on a model (or theory)
-that attempts to describe or predict the behaviour of the data.  Then
-*note fit:: can be used to find values for the free parameters of the
-model, to determine how well the data fits the model, and to estimate an
-error range for each parameter.  See 'fit error_estimates'.
-
-   Alternatively, in curve-fitting, functions are selected independent
-of a model (on the basis of experience as to which are likely to
-describe the trend of the data with the desired resolution and a minimum
-number of parameters*functions.)  The *note fit:: solution then provides
-an analytic representation of the curve.
-
-   However, if all you really want is a smooth curve through your data
-points, the *note smooth:: option to 'plot' may be what you've been
-looking for rather than *note fit::.
-
-
-File: gnuplot.info,  Node: error_estimates,  Next: control,  Prev: short_introduction,  Up: fit
-
-3.9.3 error estimates
----------------------
-
-In *note fit::, the term "error" is used in two different contexts, data
-error estimates and parameter error estimates.
-
-   Data error estimates are used to calculate the relative weight of
-each data point when determining the weighted sum of squared residuals,
-WSSR or chisquare.  They can affect the parameter estimates, since they
-determine how much influence the deviation of each data point from the
-fitted function has on the final values.  Some of the *note fit:: output
-information, including the parameter error estimates, is more meaningful
-if accurate data error estimates have been provided.
-
-   The 'statistical overview' describes some of the *note fit:: output
-and gives some background for the 'practical guidelines'.
-
-* Menu:
-
-* statistical_overview::
-* practical_guidelines::
-
-
-File: gnuplot.info,  Node: statistical_overview,  Next: practical_guidelines,  Prev: error_estimates,  Up: error_estimates
-
-3.9.3.1 statistical overview
-............................
-
-The theory of non-linear least-squares is generally described in terms
-of a normal distribution of errors, that is, the input data is assumed
-to be a sample from a population having a given mean and a Gaussian
-(normal) distribution about the mean with a given standard deviation.
-For a sample of sufficiently large size, and knowing the population
-standard deviation, one can use the statistics of the chisquare
-distribution to describe a "goodness of fit" by looking at the variable
-often called "chisquare".  Here, it is sufficient to say that a reduced
-chisquare (chisquare/degrees of freedom, where degrees of freedom is the
-number of datapoints less the number of parameters being fitted) of 1.0
-is an indication that the weighted sum of squared deviations between the
-fitted function and the data points is the same as that expected for a
-random sample from a population characterized by the function with the
-current value of the parameters and the given standard deviations.
-
-   If the standard deviation for the population is not constant, as in
-counting statistics where variance = counts, then each point should be
-individually weighted when comparing the observed sum of deviations and
-the expected sum of deviations.
-
-   At the conclusion *note fit:: reports 'stdfit', the standard
-deviation of the fit, which is the rms of the residuals, and the
-variance of the residuals, also called 'reduced chisquare' when the data
-points are weighted.  The number of degrees of freedom (the number of
-data points minus the number of fitted parameters) is used in these
-estimates because the parameters used in calculating the residuals of
-the datapoints were obtained from the same data.  If the data points
-have weights, 'gnuplot' calculates the so-called p-value, i.e.  one
-minus the cumulative distribution function of the chisquare-distribution
-for the number of degrees of freedom and the resulting chisquare, see
-'fit practical_guidelines'.  These values are exported to the variables
-           FIT_NDF = Number of degrees of freedom
-           FIT_WSSR = Weighted sum-of-squares residual
-           FIT_STDFIT = sqrt(WSSR/NDF)
-           FIT_P = p-value
-
-
-   To estimate confidence levels for the parameters, one can use the
-minimum chisquare obtained from the fit and chisquare statistics to
-determine the value of chisquare corresponding to the desired confidence
-level, but considerably more calculation is required to determine the
-combinations of parameters which produce such values.
-
-   Rather than determine confidence intervals, *note fit:: reports
-parameter error estimates which are readily obtained from the
-variance-covariance matrix after the final iteration.  By convention,
-these estimates are called "standard errors" or "asymptotic standard
-errors", since they are calculated in the same way as the standard
-errors (standard deviation of each parameter) of a linear least-squares
-problem, even though the statistical conditions for designating the
-quantity calculated to be a standard deviation are not generally valid
-for a nonlinear least-squares problem.  The asymptotic standard errors
-are generally over-optimistic and should not be used for determining
-confidence levels, but are useful for qualitative purposes.
-
-   The final solution also produces a correlation matrix indicating
-correlation of parameters in the region of the solution; The main
-diagonal elements, autocorrelation, are always 1; if all parameters were
-independent, the off-diagonal elements would be nearly 0.  Two variables
-which completely compensate each other would have an off-diagonal
-element of unit magnitude, with a sign depending on whether the relation
-is proportional or inversely proportional.  The smaller the magnitudes
-of the off-diagonal elements, the closer the estimates of the standard
-deviation of each parameter would be to the asymptotic standard error.
-
-
-File: gnuplot.info,  Node: practical_guidelines,  Prev: statistical_overview,  Up: error_estimates
-
-3.9.3.2 practical guidelines
-............................
-
-If you have a basis for assigning weights to each data point, doing so
-lets you make use of additional knowledge about your measurements, e.g.,
-take into account that some points may be more reliable than others.
-That may affect the final values of the parameters.
-
-   Weighting the data provides a basis for interpreting the additional
-*note fit:: output after the last iteration.  Even if you weight each
-point equally, estimating an average standard deviation rather than
-using a weight of 1 makes WSSR a dimensionless variable, as chisquare is
-by definition.
-
-   Each fit iteration will display information which can be used to
-evaluate the progress of the fit.  (An '*' indicates that it did not
-find a smaller WSSR and is trying again.)  The 'sum of squares of
-residuals', also called 'chisquare', is the WSSR between the data and
-your fitted function; *note fit:: has minimized that.  At this stage,
-with weighted data, chisquare is expected to approach the number of
-degrees of freedom (data points minus parameters).  The WSSR can be used
-to calculate the reduced chisquare (WSSR/ndf) or stdfit, the standard
-deviation of the fit, sqrt(WSSR/ndf).  Both of these are reported for
-the final WSSR.
-
-   If the data are unweighted, stdfit is the rms value of the deviation
-of the data from the fitted function, in user units.
-
-   If you supplied valid data errors, the number of data points is large
-enough, and the model is correct, the reduced chisquare should be about
-unity.  (For details, look up the 'chi-squared distribution' in your
-favorite statistics reference.)  If so, there are additional tests,
-beyond the scope of this overview, for determining how well the model
-fits the data.
-
-   A reduced chisquare much larger than 1.0 may be due to incorrect data
-error estimates, data errors not normally distributed, systematic
-measurement errors, 'outliers', or an incorrect model function.  A plot
-of the residuals, e.g., 'plot 'datafile' using 1:($2-f($1))', may help
-to show any systematic trends.  Plotting both the data points and the
-function may help to suggest another model.
-
-   Similarly, a reduced chisquare less than 1.0 indicates WSSR is less
-than that expected for a random sample from the function with normally
-distributed errors.  The data error estimates may be too large, the
-statistical assumptions may not be justified, or the model function may
-be too general, fitting fluctuations in a particular sample in addition
-to the underlying trends.  In the latter case, a simpler function may be
-more appropriate.
-
-   The p-value of the fit is one minus the cumulative distribution
-function of the chisquare-distribution for the number of degrees of
-freedom and the resulting chisquare.  This can serve as a measure of the
-goodness-of-fit.  The range of the p-value is between zero and one.  A
-very small or large p-value indicates that the model does not describe
-the data and its errors well.  As described above, this might indicate a
-problem with the data, its errors or the model, or a combination
-thereof.  A small p-value might indicate that the errors have been
-underestimated and the errors of the final parameters should thus be
-scaled.  See also 'set fit errorscaling'.
-
-   You'll have to get used to both *note fit:: and the kind of problems
-you apply it to before you can relate the standard errors to some more
-practical estimates of parameter uncertainties or evaluate the
-significance of the correlation matrix.
-
-   Note that *note fit::, in common with most nonlinear least-squares
-implementations, minimizes the weighted sum of squared distances
-(y-f(x))**2.  It does not provide any means to account for "errors" in
-the values of x, only in y.  Also, any "outliers" (data points outside
-the normal distribution of the model) will have an exaggerated effect on
-the solution.
-
-
-File: gnuplot.info,  Node: control,  Next: error_recovery,  Prev: error_estimates,  Up: fit
-
-3.9.4 control
--------------
-
-There are two environment variables that can be defined to affect *note
-fit::.  The environment variables must be defined before 'gnuplot' is
-executed; how to do so depends on your operating system.
-
-           FIT_LOG
-
-   changes the name (and/or path) of the file to which the fit log will
-be written.  The default is to write "fit.log" in the current working
-directory.  This can be overwritten at run time using the command 'set
-fit logfile'.
-
-           FIT_SCRIPT
-
-   specifies a command that may be executed after an user interrupt.
-The default is *note replot::, but a 'plot' or 'load' command may be
-useful to display a plot customized to highlight the progress of the
-fit.  This can be changed at run time using 'set fit script'.
-
-   For many other run time adjustments to way fit works, see *note
-fit::.
-
-
-File: gnuplot.info,  Node: error_recovery,  Next: multi-branch,  Prev: control,  Up: fit
-
-3.9.5 error recovery
---------------------
-
-Starting with gnuplot version 6, the *note fit:: command always returns
-to the next command input line regardless of the success or failure of
-fitting.  This allows scripted recovery from fit errors.  The variable
-FIT_ERROR is set to 0 on success, non-zero on error.  This example plots
-however many of five data sets can be successfully fit.  Failure for
-data set 2 would not prevent fitting data sets 3 through 5.
-
-          do for [i=1:5] {
-              DATA = sprintf("Data_%05d.dat", i)
-              fit f(x) DATA via a,b,c
-              if (FIT_ERROR || !FIT_CONVERGED) {
-                  print "Fit failed for ", DATA
-                  continue
-              }
-              set output sprintf("dataset_%05.png", i)
-              plot DATA, f(x)
-              unset output
-          }
-
-
-
-File: gnuplot.info,  Node: multi-branch,  Next: starting_values,  Prev: error_recovery,  Up: fit
-
-3.9.6 multi-branch
-------------------
-
-In multi-branch fitting, multiple data sets can be simultaneously fit
-with functions of one independent variable having common parameters by
-minimizing the total WSSR. The function and parameters (branch) for each
-data set are selected by using a 'pseudo-variable', e.g., either the
-dataline number (a 'column' index of -1) or the datafile index (-2), as
-the second independent variable.
-
-   Example: Given two exponential decays of the form, z=f(x), each
-describing a different data set but having a common decay time, estimate
-the values of the parameters.  If the datafile has the format x:z:s,
-then
-          f(x,y) = (y==0) ? a*exp(-x/tau) : b*exp(-x/tau)
-          fit f(x,y) 'datafile' using  1:-2:2:3  via a, b, tau
-
-
-   For a more complicated example, see the file "hexa.fnc" used by the
-"fit.dem" demo.
-
-   Appropriate weighting may be required since unit weights may cause
-one branch to predominate if there is a difference in the scale of the
-dependent variable.  Fitting each branch separately, using the
-multi-branch solution as initial values, may give an indication as to
-the relative effect of each branch on the joint solution.
-
-
-File: gnuplot.info,  Node: starting_values,  Next: time_data,  Prev: multi-branch,  Up: fit
-
-3.9.7 starting values
----------------------
-
-Nonlinear fitting is not guaranteed to converge to the global optimum
-(the solution with the smallest sum of squared residuals, SSR), and can
-get stuck at a local minimum.  The routine has no way to determine that;
-it is up to you to judge whether this has happened.
-
-   *note fit:: may, and often will get "lost" if started far from a
-solution, where SSR is large and changing slowly as the parameters are
-varied, or it may reach a numerically unstable region (e.g., too large a
-number causing a floating point overflow) which results in an "undefined
-value" message or 'gnuplot' halting.
-
-   To improve the chances of finding the global optimum, you should set
-the starting values at least roughly in the vicinity of the solution,
-e.g., within an order of magnitude, if possible.  The closer your
-starting values are to the solution, the less chance of stopping at a
-false minimum.  One way to find starting values is to plot data and the
-fitting function on the same graph and change parameter values and *note
-replot:: until reasonable similarity is reached.  The same plot is also
-useful to check whether the fit found a false minimum.
-
-   Of course finding a nice-looking fit does not prove there is no
-"better" fit (in either a statistical sense, characterized by an
-improved goodness-of-fit criterion, or a physical sense, with a solution
-more consistent with the model.)  Depending on the problem, it may be
-desirable to *note fit:: with various sets of starting values, covering
-a reasonable range for each parameter.
-
-
-File: gnuplot.info,  Node: time_data,  Next: tips,  Prev: starting_values,  Up: fit
-
-3.9.8 time data
----------------
-
-In fitting time data it is important to remember that gnuplot represents
-time as seconds since 1 January 1970.  For example if you wanted to fit
-a quadratic model for the time dependence of something measured over the
-course of one day in 2023, you might expect that it could be done using
-          T(x) = a + b*x + c*x*x
-          set xdata time
-          fit T(x) 'hits.dat' using 1:3 via a,b,c
-
-
-   This will probably fail, because internally the x values
-corresponding to that one day will have a range something like
-[1.67746e+09 : 1.67754e+09].  The fractional change in x across the
-measured data will be only about 1.e-05 and to guarantee convergence you
-would probably need many decimal places of accuracy in the initial
-parameter estimates.
-
-   One solution is to recast the problem as change in time since the
-start of measurement.
-          set xdata time       # data format "27-02-2023 12:00:00 measurement"
-          timefmt  = "%d-%m-%Y %H:%M:%S"
-          set timefmt timefmt
-          t0 = strptime( timefmt, "27-02-2023 00:00:00" )
-          fit T(x) 'temperature.dat' using ($1-t0):3 via a,b,c
-
-
-   This shifts the range of the data to [0 : 86400], which is more
-tractable.  Another possibility in this case is to ignore the date in
-column 1 and use relative time formats (tH/tM/tS) applied to column 2.
-          set timefmt "%tH:%tM:%tS"
-          fit T(x) 'temperature.dat' using 2:3 via a,b,c
-
-
-
-File: gnuplot.info,  Node: tips,  Prev: time_data,  Up: fit
-
-3.9.9 tips
-----------
-
-Here are some tips to keep in mind to get the most out of *note fit::.
-They're not very organized, so you'll have to read them several times
-until their essence has sunk in.
-
-   The two forms of the 'via' argument to *note fit:: serve two largely
-distinct purposes.  The 'via "file"' form is best used for (possibly
-unattended) batch operation, where you supply the starting parameter
-values in a file.
-
-   The 'via var1, var2, ...'  form is best used interactively, where the
-command history mechanism may be used to edit the list of parameters to
-be fitted or to supply new startup values for the next try.  This is
-particularly useful for hard problems, where a direct fit to all
-parameters at once won't work without good starting values.  To find
-such, you can iterate several times, fitting only some of the
-parameters, until the values are close enough to the goal that the final
-fit to all parameters at once will work.
-
-   Make sure that there is no mutual dependency among parameters of the
-function you are fitting.  For example, don't try to fit a*exp(x+b),
-because a*exp(x+b)=a*exp(b)*exp(x).  Instead, fit either a*exp(x) or
-exp(x+b).
-
-   A technical issue: The larger the ratio of the largest and the
-smallest absolute parameter values, the slower the fit will converge.
-If the ratio is close to or above the inverse of the machine floating
-point precision, it may take next to forever to converge, or refuse to
-converge at all.  You will either have to adapt your function to avoid
-this, e.g., replace 'parameter' by '1e9*parameter' in the function
-definition, and divide the starting value by 1e9 or use 'set fit
-prescale' which does this internally according to the parameter starting
-values.
-
-   If you can write your function as a linear combination of simple
-functions weighted by the parameters to be fitted, by all means do so.
-That helps a lot, because the problem is no longer nonlinear and should
-converge with only a small number of iterations, perhaps just one.
-
-   Some prescriptions for analysing data, given in practical
-experimentation courses, may have you first fit some functions to your
-data, perhaps in a multi-step process of accounting for several aspects
-of the underlying theory one by one, and then extract the information
-you really wanted from the fitting parameters of those functions.  With
-*note fit::, this may often be done in one step by writing the model
-function directly in terms of the desired parameters.  Transforming data
-can also quite often be avoided, though sometimes at the cost of a more
-difficult fit problem.  If you think this contradicts the previous
-paragraph about simplifying the fit function, you are correct.
-
-   A "singular matrix" message indicates that this implementation of the
-Marquardt-Levenberg algorithm can't calculate parameter values for the
-next iteration.  Try different starting values, writing the function in
-another form, or a simpler function.
-
-   Finally, a nice quote from the manual of another fitting package
-(fudgit), that kind of summarizes all these issues: "Nonlinear fitting
-is an art!"
-
-
-File: gnuplot.info,  Node: function_blocks,  Next: help,  Prev: fit,  Up: Commands
-
-3.10 function blocks
-====================
-
-The 'function' command signals the definition of a here-document
-containing a named block of gnuplot code that can be called as a
-function.  As with data blocks, the name of a function block must begin
-with a '$'.  Up to nine named parameters may be specified as part of the
-definition.  These names may be used inside the function block as local
-variables.  See 'local' and 'scope'.
-
-   Once the function block is defined, you can invoke it by name
-anywhere that a normal function could be used.  If the return value is
-not relevant, the function block may be invoked by an "evaluate" command
-rather than as part of an assignment expression.
-
-   Example:
-          function $sinc(arg) << EOF
-              if (arg == 0) { return 1.0 }
-              return sin(arg) / arg
-          EOF
-
-
-          gnuplot> plot $sinc(x) with lines title "sinc(x) as a function block"
-
-
-   It is not necessary to specify a list of named arguments to a
-function block at the time it is declared.  The number and values of
-arguments to the function passed from the command line can be be
-accessed from inside the function block as an integer variable ARGC and
-a corresponding array ARGV[ARGC]. See 'ARGV'. This allows defining a
-function block that can operate on a variable number of arguments.
-Unlike loading a file via a *note call:: statement, arguments are not
-repackaged as string variables (e.g.  ARG1).
-
-   Example:
-          function $max << EOF
-              local max = real("-Inf")
-              if (ARGC == 0) { return NaN }
-              do for [i=1:ARGC] {
-                  if (max < ARGV[i]) {
-                      max = ARGV[i]
-                  }
-              }
-              return max
-          EOF
-          gnuplot> foo = $max( f(A), 2.0, C, Array[3] )
-          gnuplot> baz = $max( foo, 100. )
-
-
-   The primary motivation for function block support is to allow
-definition of complicated functions directly in gnuplot.  Execution is
-of course slower than if the same function were coded in C or Fortran,
-but this is acceptable for many purposes.  If execution speed matters
-then the function can be implemented later as a plugin instead (see
-'plugins').
-
-   A second use for function blocks is to allow execution of gnuplot
-commands in a context they otherwise could not appear.  Suppose for
-example you want to plot data from two csv files, but one file uses
-comma-separated fields while the other uses semicolon-separated fields.
-Normally this property would have been set by a previous *note
-datafile:: command and would have to match all files used by the plot
-command.  However we can define a function block to invoke as a
-definition immediately before each file is referenced in the plot.
-
-          function $set_csv(char) << EOF
-              set datafile separator char
-          EOF
-          plot tmp=$set_csv(",") FILE1, tmp=$set_csv(";") FILE2
-
-
-   Limitations:
-   * Data blocks and function blocks cannot be defined inside a function
-     block.
-   * Pseudofile '-' cannot be used to read data inside a function block.
-   * These commands cannot be executed inside a function block:
-            *note reset::, *note shell::, `!<shell command>`.
-
-   * A 'plot', *note replot::, 'splot', *note refresh::, 'stats', *note
-     vfill::, or *note fit:: command is accepted in a function block
-     only if none of those commands is already in progress.  E.g.  you
-     cannot use 'stats' in a function block called by a 'plot' command,
-     you cannot invoke 'plot' from inside a *note fit:: command, etc.
-
-   A non-trivial example of using function blocks to implement and plot
-a 15-term Lanczos approximation for the complex lngamma function is
-provided in the demo collection as function_block.dem
-(http://www.gnuplot.info/demo_6.0/function_block.html) The function
-block implementation is slower by a factor of roughly 25 compared to the
-built-in lnGamma function using the same algorithm coded directly in C.
-Nevertheless it is still fast enough for 3D interactive rotation.
-
-   Use of function blocks is EXPERIMENTAL. Details may change before
-inclusion in a release version.
-
-
-File: gnuplot.info,  Node: help,  Next: history,  Prev: function_blocks,  Up: Commands
-
-3.11 help
-=========
-
-The *note help:: command displays built-in help.  To specify information
-on a particular topic use the syntax:
-
-           help {<topic>}
-
-
-   If <topic> is not specified, a short message is printed about
-'gnuplot'.  After help for the requested topic is given, a menu of
-subtopics is given; help for a subtopic may be requested by typing its
-name, extending the help request.  After that subtopic has been printed,
-the request may be extended again or you may go back one level to the
-previous topic.  Eventually, the 'gnuplot' command line will return.
-
-   If a question mark (?)  is given as the topic, the list of topics
-currently available is printed on the screen.
-
-
-File: gnuplot.info,  Node: history,  Next: if,  Prev: help,  Up: Commands
-
-3.12 history
-============
-
-The *note history:: command prints or saves previous commands in the
-history list, or reexecutes a previous entry in the list.  To modify the
-behavior of this command or the location of the saved history file, see
-*note history::.
-
-   Input lines with *note history:: as their first command are not
-stored in the command history.
-
-   Examples:
-
-           history               # show the complete history
-           history 5             # show last 5 entries in the history
-           history quiet 5       # show last 5 entries without entry numbers
-           history "hist.gp"     # write the complete history to file hist.gp
-           history "hist.gp" append # append the complete history to file hist.gp
-           history 10 "hist.gp"  # write last 10 commands to file hist.gp
-           history 10 "|head -5 >>diary.gp" # write 5 history commands using pipe
-           history ?load         # show all history entries starting with "load"
-           history ?"set c"      # like above, several words enclosed in quotes
-           hist !"set xr"        # like above, several words enclosed in quotes
-           hist !55              # reexecute the command at history entry 55
-
-
-
-File: gnuplot.info,  Node: if,  Next: for,  Prev: history,  Up: Commands
-
-3.13 if
-=======
-
-Syntax:
-           if (<condition>) { <commands>;
-                  <commands>
-                  <commands>
-           } else if (<condition>) {
-                  <commands>
-           } else {
-                  <commands>
-           }
-
-
-   This version of gnuplot supports block-structured if/else statements.
-If the keyword *note if:: or 'else' is immediately followed by an
-opening "{", then conditional execution applies to all statements,
-possibly on multiple input lines, until a matching "}" terminates the
-block.  If commands may be nested.
-
-   Prior to gnuplot version 5 the scope of if/else commands was limited
-to a single input line.  Now a multi-line clause may be enclosed in
-curly brackets.  The old syntax is still honored but cannot be used
-inside a bracketed clause.
-
-   Old syntax:
-           if (<condition>) <command-line> [; else if (<condition>) ...; else ...]
-
-   If no opening "{" follows the *note if:: keyword, the command(s) in
-<command-line> will be executed if <condition> is true (non-zero) or
-skipped if <condition> is false (zero).  Either case will consume
-commands on the input line until the end of the line or an occurrence of
-'else'.  Note that use of ';' to allow multiple commands on the same
-line will _not_ end the conditionalized commands.
-
-
-File: gnuplot.info,  Node: for,  Next: import,  Prev: if,  Up: Commands
-
-3.14 for
-========
-
-The 'plot', 'splot', 'set' and *note unset:: commands may optionally
-contain an iteration clause.  This has the effect of executing the basic
-command multiple times, each time re-evaluating any expressions that
-make use of the iteration control variable.  Iteration of arbitrary
-command sequences can be requested using the 'do' command.  Two forms of
-iteration clause are currently supported:
-
-           for [intvar = start:end{:increment}]
-           for [stringvar in "A B C D"]
-
-
-   Examples:
-
-           plot for [filename in "A.dat B.dat C.dat"] filename using 1:2 with lines
-           plot for [basename in "A B C"] basename.".dat" using 1:2 with lines
-           set for [i = 1:10] style line i lc rgb "blue"
-           unset for [tag = 100:200] label tag
-
-
-   Nested iteration is supported:
-
-           set for [i=1:9] for [j=1:9] label i*10+j sprintf("%d",i*10+j) at i,j
-
-
-   See additional documentation for *note iteration::, 'do'.
-
-
-File: gnuplot.info,  Node: import,  Next: load,  Prev: for,  Up: Commands
-
-3.15 import
-===========
-
-The *note import:: command associates a user-defined function name with
-a function exported by an external shared object.  This constitutes a
-plugin mechanism that extends the set of functions available in gnuplot.
-
-   Syntax:
-           import func(x[,y,z,...]) from "sharedobj[:symbol]"
-
-
-   Examples:
-           # make the function myfun, exported by "mylib.so" or "mylib.dll"
-           # available for plotting or numerical calculation in gnuplot
-           import myfun(x) from "mylib"
-           import myfun(x) from "mylib:myfun"    # same as above
-
-
-           # make the function theirfun, defined in "theirlib.so" or "theirlib.dll"
-           # available under a different name
-           import myfun(x,y,z) from "theirlib:theirfun"
-
-
-   The program extends the name given for the shared object by either
-".so" or ".dll" depending on the operating system, and searches for it
-first as a full path name and then as a path relative to the current
-directory.  The operating system itself may also search any directories
-in LD_LIBRARY_PATH or DYLD_LIBRARY_PATH. See 'plugins'.
-
-
-File: gnuplot.info,  Node: load,  Next: local,  Prev: import,  Up: Commands
-
-3.16 load
-=========
-
-The 'load' command executes each line of the specified input file as if
-it had been typed in interactively.  Files created by the *note save::
-command can later be 'load'ed.  Any text file containing valid gnuplot
-commands can be executed by a 'load' command.  Files being loaded may
-themselves contain 'load' or *note call:: commands.  To pass arguments
-to a loaded file, see *note call::.
-
-   Syntax:
-           load "<input-file>"
-           load $datablock
-
-
-   The name of the input file must be enclosed in quotes.
-
-   The special filename "-" may be used to 'load' commands from standard
-input.  This allows a 'gnuplot' command file to accept some commands
-from standard input.  Please see help for 'batch/interactive' for more
-details.
-
-   On systems that support a popen function, the load file can be read
-from a pipe by starting the file name with a '<'.
-
-   Examples:
-           load 'work.gnu'
-           load "func.dat"
-           load "< loadfile_generator.sh"
-
-
-   The 'load' command is performed implicitly on any file names given as
-arguments to 'gnuplot'.  These are loaded in the order specified, and
-then 'gnuplot' exits.
-
-   EXPERIMENTAL: It is also possible to execute commands from lines of
-text stored internally.  See 'function blocks'.  A function block may be
-defined in-line or in an external file.  Once the function block has
-been defined the commands may be executed repeatedly using *note
-evaluate:: on the internal copy rather than reloading the file.
-
-
-File: gnuplot.info,  Node: local,  Next: lower,  Prev: load,  Up: Commands
-
-3.17 local
-==========
-
-Syntax:
-          local foo = <expression>
-          local array foo[size]
-
-
-   The 'local' keyword introduces declaration of a variable whose scope
-is limited to the execution of the code block in which it is declared.
-Declaration is optional, but without it all variables are global.  If
-the name of a local variable duplicates the name of a global variable,
-the global variable is shadowed until exit from the local scope.  See
-'scope'.
-
-   Local declarations may be used to prevent a global variable from
-being unintentionally overwritten by a *note call:: or 'load' statement.
-They are particularly useful inside a function block.  The 'local'
-command is also valid inside the code block in curly brackets following
-an *note if::, 'else', 'do for', or 'while' statement.
-
-   Example: Suppose you want to write a script "plot_all_data.gp"
-containing commands that plot a bunch of data sets.  You want to call
-this convenience script from the command line or from other scripts
-without worrying that it trashes any variables with names "file" or
-"files" or "dataset" or "outfile".  The variable "file" is inherently
-local because it is an iteration variable (see 'scope') but the other
-three names need keyword 'local' to protect them.
-
-   plot_all_data.gp:
-          local files = system("ls -1 *.dat")
-          do for [file in files] {
-             local dataset = file[1:strstrt(file,".dat")-1]
-             local outfile = dataset . ".png"
-             set output outfile
-             plot file with lines title dataset
-          }
-          unset output
-
-
-
-File: gnuplot.info,  Node: lower,  Next: pause,  Prev: local,  Up: Commands
-
-3.18 lower
-==========
-
-See *note raise::.
-
-
-File: gnuplot.info,  Node: pause,  Next: plot,  Prev: lower,  Up: Commands
-
-3.19 pause
-==========
-
-The 'pause' command displays any text associated with the command and
-then waits a specified amount of time or until the carriage return is
-pressed.  'pause' is especially useful in conjunction with 'load' files.
-
-   Syntax:
-           pause <time> {"<string>"}
-           pause mouse {<endcondition>}{, <endcondition>} {"<string>"}
-           pause mouse close
-
-
-   <time> may be any constant or floating-point expression.  'pause -1'
-will wait until a carriage return is hit, zero (0) won't pause at all,
-and a positive number will wait the specified number of seconds.
-
-   If the current terminal supports 'mousing', then 'pause mouse' will
-terminate on either a mouse click or on ctrl-C. For all other terminals,
-or if mousing is not active, 'pause mouse' is equivalent to 'pause -1'.
-
-   If one or more end conditions are given after 'pause mouse', then any
-one of the conditions will terminate the pause.  The possible end
-conditions are 'keypress', 'button1', 'button2', 'button3', 'close', and
-'any'.  If the pause terminates on a keypress, then the ascii value of
-the key pressed is returned in MOUSE_KEY. The character itself is
-returned as a one character string in MOUSE_CHAR. Hotkeys (bind command)
-are disabled if keypress is one of the end conditions.  Zooming is
-disabled if button3 is one of the end conditions.
-
-   In all cases the coordinates of the mouse are returned in variables
-MOUSE_X, MOUSE_Y, MOUSE_X2, MOUSE_Y2.  See 'mouse variables'.
-
-   Note: Since 'pause' communicates with the operating system rather
-than the graphics, it may behave differently with different device
-drivers (depending upon how text and graphics are mixed).
-
-   Examples:
-           pause -1    # Wait until a carriage return is hit
-           pause 3     # Wait three seconds
-           pause -1  "Hit return to continue"
-           pause 10  "Isn't this pretty?  It's a cubic spline."
-           pause mouse "Click any mouse button on selected data point"
-           pause mouse keypress "Type a letter from A-F in the active window"
-           pause mouse button1,keypress
-           pause mouse any "Any key or button will terminate"
-
-
-   The variant "pause mouse key" will resume after any keypress in the
-active plot window.  If you want to wait for a particular key to be
-pressed, you can use a loop such as:
-
-           print "I will resume after you hit the Tab key in the plot window"
-           plot <something>
-           pause mouse key
-           while (MOUSE_KEY != 9) {
-               pause mouse key
-           }
-
-
-* Menu:
-
-* pause_mouse_close::
-* pseudo-mousing_during_pause::
-
-
-File: gnuplot.info,  Node: pause_mouse_close,  Next: pseudo-mousing_during_pause,  Prev: pause,  Up: pause
-
-3.19.1 pause mouse close
-------------------------
-
-The command 'pause mouse close' is a specific example of pausing to wait
-for an external event.  In this case the program waits for a "close"
-event from the plot window.  Exactly how to generate such an event
-varies with your desktop environment and configuration, but usually you
-can close the plot window by clicking on some widget on the window
-border or by typing a hot-key sequence such as <alt><F4> or <ctrl>q.  If
-you are unsure whether a suitable widget or hot-key is available to the
-user, you may also want to define a hot-key sequence using gnuplot's own
-mechanism.  See 'bind'.
-
-   The command sequence below may be useful when running gnuplot from a
-script rather than from the command line.
-
-          plot <...whatever...>
-          bind all "alt-End" "exit gnuplot"
-          pause mouse close
-
-
-
-File: gnuplot.info,  Node: pseudo-mousing_during_pause,  Prev: pause_mouse_close,  Up: pause
-
-3.19.2 pseudo-mousing during pause
-----------------------------------
-
-Some terminals use the same window for text entry and graphical display,
-including terminal types 'dumb', 'sixel', 'kitty', and 'domterm'.  These
-terminals do not currently support mousing per se, but during a 'pause
-mouse' command they interpret keystrokes in the same way that a mousing
-terminal would.  E.g.  left/right/up/down arrow keys change the view
-angle of 3D plots and perform incremental pan/zoom for 2D plots, 'l'
-toggles log-scale axes, 'a' autoscales the current plot, 'h' displays a
-list of key bindings.  A carriage return terminates the 'pause' and
-restores normal command line processing.
-
-
-File: gnuplot.info,  Node: plot,  Next: print,  Prev: pause,  Up: Commands
-
-3.20 plot
-=========
-
-'plot' and 'splot' are the primary commands for drawing plots with
-'gnuplot'.  They offer many different graphical representations for
-functions and data.  'plot' is used to draw 2D functions and data.
-'splot' draws 2D projections of 3D surfaces and data.
-
-   Syntax:
-           plot {<ranges>} <plot-element> {, <plot-element>, <plot-element>}
-
-
-   Each plot element consists of a definition, a function, or a data
-source together with optional properties or modifiers:
-           plot-element:
-                {<iteration>}
-                <definition> | {sampling-range} <function> | <data source>
-                             | keyentry
-                {axes <axes>} {<title-spec>}
-                {with <style>}
-
-
-   The graphical representation of each plot element is determined by
-the keyword 'with', e.g.  'with lines' or *note boxplot::.  See
-'plotting styles'.
-
-   The data to be plotted is either generated by a function (two
-functions if in parametric mode), read from a data file, read from a
-named data block that was defined previously, or extracted from an
-array.  Multiple datafiles, data blocks, arrays, and/or functions may be
-plotted in a single plot command separated by commas.
-
-   Many additional keywords are specific to data plots.  See *note
-datafile::.  Also see 'data', 'inline data', *note functions::.
-
-   A plot-element that contains the definition of a function or variable
-does not create any visible output, see third example below.
-
-   Examples:
-           plot sin(x)
-           plot sin(x), cos(x)
-           plot f(x) = sin(x*a), a = .2, f(x), a = .4, f(x)
-           plot "datafile.1" with lines, "datafile.2" with points
-           plot [t=1:10] [-pi:pi*2] tan(t), \
-                "data.1" using (tan($2)):($3/$4) smooth csplines \
-                         axes x1y2 notitle with lines 5
-           plot for [datafile in "spinach.dat broccoli.dat"] datafile
-
-
-   See also 'show plot'.
-
-* Menu:
-
-* axes::
-* binary::
-* data::
-* functions::
-* parametric::
-* ranges::
-* sampling::
-* for_loops_in_plot_command::
-* title::
-* with::
-
-
-File: gnuplot.info,  Node: axes,  Next: binary,  Prev: plot,  Up: plot
-
-3.20.1 axes
------------
-
-There are four possible sets of axes available; the keyword <axes> is
-used to select the axes for which a particular line should be scaled.
-'x1y1' refers to the axes on the bottom and left; 'x2y2' to those on the
-top and right; 'x1y2' to those on the bottom and right; and 'x2y1' to
-those on the top and left.  Ranges specified on the 'plot' command apply
-only to the first set of axes (bottom left).
-
-
-File: gnuplot.info,  Node: binary,  Next: data,  Prev: axes,  Up: plot
-
-3.20.2 binary
--------------
-
-BINARY DATA FILES:
-
-   It is necessary to provide the keyword *note binary:: after the
-filename.  Adequate details of the file format must be given on the
-command line or extracted from the file itself for a supported binary
-*note filetype::.  In particular, there are two structures for binary
-files, binary matrix format and binary general format.
-
-   The *note matrix:: format contains a two dimensional array of 32 bit
-IEEE float values plus an additional column and row of coordinate
-values.  In the 'using' specifier of a plot command, column 1 refers to
-the matrix row coordinate, column 2 refers to the matrix column
-coordinate, and column 3 refers to the value stored in the array at
-those coordinates.
-
-   The *note general:: format contains an arbitrary number of columns
-for which information must be specified at the command line.  For
-example, 'array', *note record::, 'format' and 'using' can indicate the
-size, format and dimension of data.  There are a variety of useful
-commands for skipping file headers and changing endianess.  There are a
-set of commands for positioning and translating data since often
-coordinates are not part of the file when uniform sampling is inherent
-in the data.  Unlike reading from a text or matrix binary file, general
-binary does not treat the generated columns as 1, 2 or 3 in the 'using'
-list.  Instead column 1 refers to column 1 of the file, or as specified
-in the 'format' list.
-
-   There are global default settings for the various binary options
-which may be set using the same syntax as the options when used as part
-of the '(s)plot <filename> binary ...'  command.  This syntax is 'set
-datafile binary ...'.  The general rule is that common command-line
-specified parameters override file-extracted parameters which override
-default parameters.
-
-   *note matrix:: is the default binary format when no keywords specific
-to *note general:: are given, i.e., 'array', *note record::, 'format',
-*note filetype::.
-
-   General binary data can be entered at the command line via the
-special file name '-'.  However, this is intended for use through a pipe
-where programs can exchange binary data, not for keyboards.  There is no
-"end of record" character for binary data.  Gnuplot continues reading
-from a pipe until it has read the number of points declared in the
-'array' qualifier.  See *note matrix:: or *note general:: for more
-details.
-
-   The *note index:: keyword is not supported, since the file format
-allows only one surface per file.  The *note every:: and 'using'
-specifiers are supported.  'using' operates as if the data were read in
-the above triplet form.  Binary File Splot Demo.
-(http://www.gnuplot.info/demo/binary.html)
-
-* Menu:
-
-* general::
-* array::
-* record::
-* skip::
-* format::
-* blank::
-* endian::
-* filetype::
-* keywords::
-
-
-File: gnuplot.info,  Node: general,  Next: array,  Prev: binary,  Up: binary
-
-3.20.2.1 general
-................
-
-The *note binary:: keyword appearing alone indicates a binary data file
-that contains both coordinate information describing a non-uniform grid
-and the value of each grid point (see *note matrix::).  Binary data in
-any other format requires additional keywords to describe the layout of
-the data.  Unfortunately the syntax of these required additional
-keywords is convoluted.  Nevertheless the general binary mode is
-particularly useful for application programs sending large amounts of
-data to gnuplot.
-
-   Syntax:
-           plot '<file_name>' {binary <binary list>} ...
-           splot '<file_name>' {binary <binary list>} ...
-
-
-   General binary format is activated by keywords in <binary list>
-pertaining to information about file structure, i.e., 'array', *note
-record::, 'format' or *note filetype::.  Otherwise, non-uniform matrix
-binary format is assumed.  (See *note matrix:: for more details.)
-
-   Gnuplot knows how to read a few standard binary file types that are
-fully self-describing, e.g.  PNG images.  Type *note binary:: at the
-command line for a list.  Apart from these, you can think of binary data
-files as conceptually the same as text data.  Each point has columns of
-information which are selected via the 'using' specification.  If no
-'format' string is specified, gnuplot will read in a number of binary
-values equal to the largest column given in the '<using list>'.  For
-example, 'using 1:3' will result in three columns being read, of which
-the second will be ignored.  Certain plot types have an associated
-default using specification.  For example, 'with image' has a default of
-'using 1', while *note rgbimage:: has a default of 'using 1:2:3'.
-
-
-File: gnuplot.info,  Node: array,  Next: record,  Prev: general,  Up: binary
-
-3.20.2.2 array
-..............
-
-Describes the sampling array dimensions associated with the binary file.
-The coordinates will be generated by gnuplot.  A number must be
-specified for each dimension of the array.  For example, 'array=(10,20)'
-means the underlying sampling structure is two-dimensional with 10
-points along the first (x) dimension and 20 points along the second (y)
-dimension.  A negative number indicates that data should be read until
-the end of file.  If there is only one dimension, the parentheses may be
-omitted.  A colon can be used to separate the dimensions for multiple
-records.  For example, 'array=25:35' indicates there are two
-one-dimensional records in the file.
-
-
-File: gnuplot.info,  Node: record,  Next: skip,  Prev: array,  Up: binary
-
-3.20.2.3 record
-...............
-
-The *note record:: keyword provides array dimensions describing how data
-in a binary file are to be arranged into an array.  A number must be
-specified for each dimension of the array.  For example,
-'record=(10,20)' means the underlying structure is two-dimensional with
-10 points along the first (x) dimension and 20 points along the second
-(y) dimension.  A negative number indicates that data should be read
-until the end of file.
-
-   If there is only one dimension, the parentheses may be omitted.  A
-colon can be used to separate the dimensions for multiple records.  E.g.
-'record=25:35' describes a file containing two one-dimensional records.
-
-   This keyword serves the same function as 'array' and has the same
-syntax.  However, 'array' causes gnuplot to generate coordinate
-information while *note record:: does not.  Use *note record:: when the
-coordinates are to be read from columns of the binary data file records.
-
-
-File: gnuplot.info,  Node: skip,  Next: format,  Prev: record,  Up: binary
-
-3.20.2.4 skip
-.............
-
-This keyword allows you to skip sections of a binary file.  For
-instance, if the file contains a 1024 byte header before the start of
-the data region you would probably want to use
-           plot '<file_name>' binary skip=1024 ...
-
-   If there are multiple records in the file, you may specify a leading
-offset for each.  For example, to skip 512 bytes before the 1st record
-and 256 bytes before the second and third records
-           plot '<file_name> binary record=356:356:356 skip=512:256:256 ...
-
-
-
-File: gnuplot.info,  Node: format,  Next: blank,  Prev: skip,  Up: binary
-
-3.20.2.5 format
-...............
-
-The default binary format is a float.  For more flexibility, the format
-can include details about variable sizes.  For example,
-'format="%uchar%int%float"' associates an unsigned character with the
-first using column, an int with the second column and a float with the
-third column.  If the number of size specifications is less than the
-greatest column number, the size is implicitly taken to be similar to
-the last given variable size.
-
-   Furthermore, similar to the 'using' specification, the format can
-include discarded columns via the '*' character and have implicit
-repetition via a numerical repeat-field.  For example,
-'format="%*2int%3float"' causes gnuplot to discard two ints before
-reading three floats.  To list variable sizes, type 'show datafile
-binary datasizes'.  There are a group of names that are machine
-dependent along with their sizes in bytes for the particular
-compilation.  There is also a group of names which attempt to be machine
-independent.
-
-
-File: gnuplot.info,  Node: blank,  Next: endian,  Prev: format,  Up: binary
-
-3.20.2.6 blank
-..............
-
-Some plot styles expect a blank line to separate groups of data points
-read from a text input file.  For instance the vertices of one polygon
-in an input text data stream are separated from those of the next
-polygon by a blank line.  Since there are no actual blank lines in a
-binary file, this option allows a special record in a general binary
-file to be interpreted as if it were a blank line.  The only option
-currently supported is 'blank=NaN', which means that a value of NaN in
-the first field of a record causes the entire record to be treated as if
-it were a blank line.
-
-   Example:
-          plot DATA binary format="%2float" blank=NAN using 1:2 with polygons
-
-
-
-File: gnuplot.info,  Node: endian,  Next: filetype,  Prev: blank,  Up: binary
-
-3.20.2.7 endian
-...............
-
-Often the endianess of binary data in the file does not agree with the
-endianess used by the platform on which gnuplot is running.  Several
-words can direct gnuplot how to arrange bytes.  For example
-'endian=little' means treat the binary file as having byte significance
-from least to greatest.  The options are
-
-                   little:  least significant to greatest significance
-                      big:  greatest significance to least significance
-                  default:  assume file endianess is the same as compiler
-              swap (swab):  Interchange the significance.  (If things
-                            don't look right, try this.)
-
-
-   Gnuplot can support "middle" ("pdp") endian if it is compiled with
-that option.
-
-
-File: gnuplot.info,  Node: filetype,  Next: keywords,  Prev: endian,  Up: binary
-
-3.20.2.8 filetype
-.................
-
-For some standard binary file formats gnuplot can extract all the
-necessary information from the file in question.  As an example,
-"format=edf" will read ESRF Header File format files.  For a list of the
-currently supported file formats, type 'show datafile binary filetypes'.
-
-   There is a special file type called 'auto' for which gnuplot will
-check if the binary file's extension is a quasi-standard extension for a
-supported format.
-
-   Command line keywords may be used to override settings extracted from
-the file.  The settings from the file override any defaults.  See *note
-binary::.
-
--- AVS --
-
-   'avs' is one of the automatically recognized binary file types for
-images.  AVS is an extremely simple format, suitable mostly for
-streaming between applications.  It consists of 2 longs (xwidth, ywidth)
-followed by a stream of pixels, each with four bytes of information
-alpha/red/green/blue.
-
--- EDF --
-
-   'edf' is one of the automatically recognized binary file types for
-images.  EDF stands for ESRF Data Format, and it supports both edf and
-ehf formats (the latter means ESRF Header Format).  More information on
-specifications can be found at
-
-       http://www.edfplus.info/specs
-
-
--- PNG --
-
-   If gnuplot was configured to use the libgd library for png/gif/jpeg
-output, then it can also be used to read these same image types as
-binary files.  You can use an explicit command
-           plot 'file.png' binary filetype=png
-
-   Or the file type will be recognized automatically from the extension
-if you have previously requested
-           set datafile binary filetype=auto
-
-
-
-File: gnuplot.info,  Node: keywords,  Prev: filetype,  Up: binary
-
-3.20.2.9 keywords
-.................
-
-The following keywords apply only when generating coordinates from
-binary data files.  That is, the control mapping the individual elements
-of a binary array, matrix, or image to specific x/y/z positions.
-
--- SCAN --
-
-   A great deal of confusion can arise concerning the relationship
-between how gnuplot scans a binary file and the dimensions seen on the
-plot.  To lessen the confusion, conceptually think of gnuplot _always_
-scanning the binary file point/line/plane or fast/medium/slow.  Then
-this keyword is used to tell gnuplot how to map this scanning convention
-to the Cartesian convention shown in plots, i.e., x/y/z.  The qualifier
-for scan is a two or three letter code representing where point is
-assigned (first letter), line is assigned (second letter), and plane is
-assigned (third letter).  For example, 'scan=yx' means the fastest,
-point-by-point, increment should be mapped along the Cartesian y
-dimension and the middle, line-by-line, increment should be mapped along
-the x dimension.
-
-   When the plotting mode is 'plot', the qualifier code can include the
-two letters x and y.  For 'splot', it can include the three letters x, y
-and z.
-
-   There is nothing restricting the inherent mapping from
-point/line/plane to apply only to Cartesian coordinates.  For this
-reason there are cylindrical coordinate synonyms for the qualifier codes
-where t (theta), r and z are analogous to the x, y and z of Cartesian
-coordinates.
-
--- TRANSPOSE --
-
-   Shorthand notation for 'scan=yx' or 'scan=yxz'.  I.e.  it affects the
-assignment of pixels to scan lines during input.  To instead transpose
-an image when it is displayed try
-          plot 'imagefile' binary filetype=auto flipx rotate=90deg with rgbimage
-
-
--- DX, DY, DZ --
-
-   When gnuplot generates coordinates, it uses the spacing described by
-these keywords.  For example 'dx=10 dy=20' would mean space samples
-along the x dimension by 10 and space samples along the y dimension by
-20.  'dy' cannot appear if 'dx' does not appear.  Similarly, 'dz' cannot
-appear if 'dy' does not appear.  If the underlying dimensions are
-greater than the keywords specified, the spacing of the highest
-dimension given is extended to the other dimensions.  For example, if an
-image is being read from a file and only 'dx=3.5' is given gnuplot uses
-a delta x and delta y of 3.5.
-
-   The following keywords also apply only when generating coordinates.
-However they may also be used with matrix binary files.
-
--- FLIPX, FLIPY, FLIPZ --
-
-   Sometimes the scanning directions in a binary datafile are not
-consistent with that assumed by gnuplot.  These keywords can flip the
-scanning direction along dimensions x, y, z.
-
--- ORIGIN	--
-
-   When gnuplot generates coordinates based upon transposition and flip,
-it attempts to always position the lower left point in the array at the
-origin, i.e., the data lies in the first quadrant of a Cartesian system
-after transpose and flip.
-
-   To position the array somewhere else on the graph, the *note origin::
-keyword directs gnuplot to position the lower left point of the array at
-a point specified by a tuple.  The tuple should be a double for 'plot'
-and a triple for 'splot'.  For example, 'origin=(100,100):(100,200)' is
-for two records in the file and intended for plotting in two dimensions.
-A second example, 'origin=(0,0,3.5)', is for plotting in three
-dimensions.
-
--- CENTER --
-
-   Similar to *note origin::, this keyword will position the array such
-that its center lies at the point given by the tuple.  For example,
-'center=(0,0)'.  Center does not apply when the size of the array is
-'Inf'.
-
--- ROTATE --
-
-   The transpose and flip commands provide some flexibility in
-generating and orienting coordinates.  However, for full degrees of
-freedom, it is possible to apply a rotational vector described by a
-rotational angle in two dimensions.
-
-   The 'rotate' keyword applies to the two-dimensional plane, whether it
-be 'plot' or 'splot'.  The rotation is done with respect to the positive
-angle of the Cartesian plane.
-
-   The angle can be expressed in radians, radians as a multiple of pi,
-or degrees.  For example, 'rotate=1.5708', 'rotate=0.5pi' and
-'rotate=90deg' are equivalent.
-
-   If *note origin:: is specified, the rotation is done about the lower
-left sample point before translation.  Otherwise, the rotation is done
-about the array 'center'.
-
--- PERPENDICULAR --
-
-   For 'splot', the concept of a rotational vector is implemented by a
-triple representing the vector to be oriented normal to the
-two-dimensional x-y plane.  Naturally, the default is (0,0,1).  Thus
-specifying both rotate and perpendicular together can orient data myriad
-ways in three-space.
-
-   The two-dimensional rotation is done first, followed by the
-three-dimensional rotation.  That is, if R' is the rotational 2 x 2
-matrix described by an angle, and P is the 3 x 3 matrix projecting
-(0,0,1) to (xp,yp,zp), let R be constructed from R' at the upper left
-sub-matrix, 1 at element 3,3 and zeros elsewhere.  Then the matrix
-formula for translating data is v' = P R v, where v is the 3 x 1 vector
-of data extracted from the data file.  In cases where the data of the
-file is inherently not three-dimensional, logical rules are used to
-place the data in three-space.  (E.g., usually setting the z-dimension
-value to zero and placing 2D data in the x-y plane.)
-
-
-File: gnuplot.info,  Node: data,  Next: functions,  Prev: binary,  Up: plot
-
-3.20.3 data
------------
-
-Data provided in a file can be plotted by giving the name of the file
-(enclosed in single or double quotes) on the 'plot' command line.  Data
-may also come from an input stream that is not a file.  See *note
-special-filenames::, *note piped-data::, 'datablocks'.
-
-   Syntax:
-           plot '<file_name>' {binary <binary list>}
-                              {{nonuniform|sparse} matrix}
-                              {index <index list> | index "<name>"}
-                              {every <every list>}
-                              {skip <number-of-lines>}
-                              {using <using list>}
-                              {convexhull} {concavehull}
-                              {smooth <option>}
-                              {bins <options>}
-                              {mask}
-                              {volatile} {zsort} {noautoscale}
-
-
-   The modifiers *note binary::, *note index::, *note every::, *note
-skip::, 'using', *note smooth::, 'bins', 'mask', 'convexhull',
-'concavehull', and 'zsort' are discussed separately.  In brief
-   * 'skip N' tells the program to ignore N lines at the start of the
-     input file
-   * *note binary:: indicates that the file contains binary data rather
-     than text
-   * *note index:: selects which data sets in a multi-data-set file are
-     to be plotted
-   * *note every:: specifies which points within a single data set are
-     to be plotted
-   * 'using' specifies which columns in the file are to be used in which
-     order
-   * *note smooth:: performs simple filtering, interpolation, or
-     curve-fitting of the data prior to plotting
-   * 'convexhull' either alone or in combination with *note smooth::
-     replaces the points in the input data set with a new set of points
-     that constitute the vertices of a bounding polygon.
-   * 'bins' sorts individual input points into equal-sized intervals
-     along x and plots a single accumulated value per interval
-   * 'mask' filters the data through a previously defined mask to plot
-     only a selected subset of pixels in an image or a selected region
-     of a pm3d surface.
-   * *note volatile:: indicates that the content of the file may not be
-     available to reread later and therefore it should be retained
-     internally for re-use.
-
-   'splot' has a similar syntax but does not support 'bins' and supports
-only a few *note smooth:: options.
-
-   The 'noautoscale' keyword means that the points making up this plot
-will be ignored when automatically determining axis range limits.
-
-   TEXT DATA FILES:
-
-   Each non-empty line in a data file describes one data point, except
-that records beginning with '#' will be treated as comments and ignored.
-
-   Depending on the plot style and options selected, from one to eight
-values are read from each line and associated with a single data point.
-See 'using'.
-
-   The individual records on a single line of data must be separated by
-white space (one or more blanks or tabs) or a special field separator
-character which is specified by the *note datafile:: command.  A single
-field may itself contain white space characters if the entire field is
-enclosed in a pair of double quotes, or if a field separator other than
-white space is in effect.  Whitespace inside a pair of double quotes is
-ignored when counting columns, so the following datafile line has three
-columns:
-           1.0 "second column" 3.0
-
-
-   Data may be written in exponential format with the exponent preceded
-by the letter e or E. The fortran exponential specifiers d, D, q, and Q
-may also be used if the command 'set datafile fortran' is in effect.
-
-   Blank records in a data file are significant.  Single blank records
-designate discontinuities in a 'plot'; no line will join points
-separated by a blank records (if they are plotted with a line style).
-Two blank records in a row indicate a break between separate data sets.
-See *note index::.
-
-   If autoscaling has been enabled (*note autoscale::), the axes are
-automatically extended to include all datapoints, with a whole number of
-tic marks if tics are being drawn.  This has two consequences: i) For
-'splot', the corner of the surface may not coincide with the corner of
-the base.  In this case, no vertical line is drawn.  ii) When plotting
-data with the same x range on a dual-axis graph, the x coordinates may
-not coincide if the x2tics are not being drawn.  This is because the x
-axis has been autoextended to a whole number of tics, but the x2 axis
-has not.  The following example illustrates the problem:
-
-           reset; plot '-', '-' axes x2y1
-           1 1
-           19 19
-           e
-           1 1
-           19 19
-           e
-
-
-   To avoid this, you can use the *note noextend:: modifier of the *note
-autoscale:: or 'set [axis]range' commands.  This turns off extension of
-the axis range to include the next tic mark.
-
-   Label coordinates and text can also be read from a data file (see
-*note labels::).
-
-* Menu:
-
-* columnheaders::
-* csv_files::
-* every::
-* example_datafile::
-* filters::
-* index::
-* skip_::
-* smooth::
-* special-filenames::
-* piped-data::
-* using::
-* volatile::
-
-
-File: gnuplot.info,  Node: columnheaders,  Next: csv_files,  Prev: data,  Up: data
-
-3.20.3.1 columnheaders
-......................
-
-Extra lines at the start of a data file may be explicitly ignored using
-the *note skip:: keyword in the plot command.  A single additional line
-containing text column headers may be present.  It is skipped
-automatically if the plot command refers explicitly to column headers,
-e.g.  by using them for titles.  Otherwise you may need to skip it
-explicitly either by adding one to the skip count or by setting the
-attribute *note columnheaders::.  See *note skip::, 'columnhead',
-'autotitle columnheader', *note datafile::.
-
-
-File: gnuplot.info,  Node: csv_files,  Next: every,  Prev: columnheaders,  Up: data
-
-3.20.3.2 csv files
-..................
-
-Syntax:
-          set datafile separator {whitespace | tab | comma | "chars"}
-
-
-   "csv" is short for "comma-separated values".  The term "csv file" is
-loosely applied to files in which data fields are delimited by a
-specific character, not necessarily a comma.  To read data from a csv
-file you must tell gnuplot what the field-delimiting character is.  For
-instance to read from a file using semicolon as a field delimiter:
-
-          set datafile separator ";"
-
-
-   See 'set datafile separator'.  This applies only to files used for
-input.  To create a csv file on output, use the corresponding
-'separator' option to *note table::.
-
-
-File: gnuplot.info,  Node: every,  Next: example_datafile,  Prev: csv_files,  Up: data
-
-3.20.3.3 every
-..............
-
-The *note every:: keyword allows a periodic sampling of a data set to be
-plotted.
-
-   For ordinary files a "point" single record (line); a "block" of data
-is a set of consecutive records with blank lines before and after the
-block.
-
-   For matrix data a "block" and "point" correspond to "row" and
-"column".  See *note every::.
-
-   Syntax:
-           plot 'file' every {<point_incr>}
-                               {:{<block_incr>}
-                                 {:{<start_point>}
-                                   {:{<start_block>}
-                                     {:{<end_point>}
-                                       {:<end_block>}}}}}
-
-
-   The data points to be plotted are selected according to a loop from
-<'start_point'> to <'end_point'> with increment <'point_incr'> and the
-blocks according to a loop from <'start_block'> to <'end_block'> with
-increment <'block_incr'>.
-
-   The first datum in each block is numbered '0', as is the first block
-in the file.
-
-   Note that records containing unplottable information are counted.
-
-   Any of the numbers can be omitted; the increments default to unity,
-the start values to the first point or block, and the end values to the
-last point or block.  ':' at the end of the *note every:: option is not
-permitted.  If *note every:: is not specified, all points in all lines
-are plotted.
-
-   Examples:
-           every :::3::3    # selects just the fourth block ('0' is first)
-           every :::::9     # selects the first 10 blocks
-           every 2:2        # selects every other point in every other block
-           every ::5::15    # selects points 5 through 15 in each block
-
-
-   See simple plot demos (simple.dem)
-(http://www.gnuplot.info/demo/simple.html) , Non-parametric splot demos
-(http://www.gnuplot.info/demo/surface1.html) , and Parametric splot
-demos (http://www.gnuplot.info/demo/surface2.html) .
-
-
-File: gnuplot.info,  Node: example_datafile,  Next: filters,  Prev: every,  Up: data
-
-3.20.3.4 example datafile
-.........................
-
-This example plots the data in the file "population.dat" and a
-theoretical curve:
-
-           pop(x) = 103*exp((1965-x)/10)
-           set xrange [1960:1990]
-           plot 'population.dat', pop(x)
-
-
-   The file "population.dat" might contain:
-
-           # Gnu population in Antarctica since 1965
-              1965   103
-              1970   55
-              1975   34
-              1980   24
-              1985   10
-
-
-   Binary examples:
-
-           # Selects two float values (second one implicit) with a float value
-           # discarded between them for an indefinite length of 1D data.
-           plot '<file_name>' binary format="%float%*float" using 1:2 with lines
-
-
-           # The data file header contains all details necessary for creating
-           # coordinates from an EDF file.
-           plot '<file_name>' binary filetype=edf with image
-           plot '<file_name>.edf' binary filetype=auto with image
-
-
-           # Selects three unsigned characters for components of a raw RGB image
-           # and flips the y-dimension so that typical image orientation (start
-           # at top left corner) translates to the Cartesian plane.  Pixel
-           # spacing is given and there are two images in the file.  One of them
-           # is translated via origin.
-           plot '<file_name>' binary array=(512,1024):(1024,512) format='%uchar' \
-                dx=2:1 dy=1:2 origin=(0,0):(1024,1024) flipy u 1:2:3 w rgbimage
-
-
-           # Four separate records in which the coordinates are part of the
-           # data file.  The file was created with a endianess different from
-           # the system on which gnuplot is running.
-           splot '<file_name>' binary record=30:30:29:26 endian=swap u 1:2:3
-
-
-           # Same input file, but this time we skip the 1st and 3rd records
-           splot '<file_name>' binary record=30:26 skip=360:348 endian=swap u 1:2:3
-
-
-   See also *note matrix::.
-
-
-File: gnuplot.info,  Node: filters,  Next: index,  Prev: example_datafile,  Up: data
-
-3.20.3.5 filters
-................
-
-Filter operations are applied immediately after reading input data,
-before applying any smoothing or style-specific processing options.  In
-general the purpose of a filter is to replace the original full set of
-input points with a selected subset of points, possibly modified,
-regrouped, or reordered, The filters currently supported are 'bins',
-'convexhull', 'concavehull', 'mask', 'sharpen', and 'zsort'.
-
--- BINS --
-
-   Syntax:
-          plot 'DATA' using <XCOL> {:<YCOL>} bins{=<NBINS>}
-               {binrange [<LOW>:<HIGH>]} {binwidth=<width>}
-               {binvalue={sum|avg}}
-
-
-   The 'bins' option to a 'plot' command first assigns the original data
-to equal width bins on x and then plots a single value per bin.  The
-default number of bins is controlled by *note samples::, but this can be
-changed by giving an explicit number of bins in the command.
-
-   If no binrange is given, the range is taken from the extremes of the
-x values found in 'DATA'.
-
-   Given the range and the number of bins, bin width is calculated
-automatically and points are assigned to bins 0 to NBINS-1
-          BINWIDTH = (HIGH - LOW) / (NBINS-1)
-          xmin = LOW - BINWIDTH/2
-          xmax = HIGH + BINWIDTH/2
-          first bin holds points with (xmin <= x < xmin + BINWIDTH)
-          last bin holds points with (xmax-BINWIDTH <= x < xman)
-          each point is assigned to bin i = floor(NBINS * (x-xmin)/(xmax-xmin))
-
-
-   Alternatively you can provide a fixed bin width, in which case nbins
-is calculated as the smallest number of bins that will span the range.
-
-   On output bins are plotted or tabulated by midpoint.  E.g.  if the
-program calculates bin width as shown above, the x coordinate output for
-the first bin is x=LOW (not x=xmin).
-
-   If only a single column is given in the using clause then each data
-point contributes a count of 1 to the accumulation of total counts in
-the bin for that x coordinate value.  If a second column is given then
-the value in that column is added to the accumulation for the bin.  Thus
-the following two plot commands are equivalent:
-          plot 'DATA" using N bins=20
-          set samples 20
-          plot 'DATA' using (column(N)):(1)
-
-
-   By default the y value plotted for each bin is the sum of the y
-values over all points in that bin.  This corresponds to option
-'binvalue=sum'.  The alternative 'binvalue=avg' plots the mean y value
-for points in that bin.
-
-   For related processing options see 'smooth frequency' and 'smooth
-kdensity'.
-
--- CONVEXHULL --
-
-   Convexhull is not a plot style.  It can appear either alone as a
-filter keyword or in combination with 'smooth path' and/or 'expand
-<increment>'.
-
-          plot FOO using x:y convexhull
-          plot FOO using x:y convexhull smooth path
-          plot FOO using x:y convexhull expand <increment> {smooth path}
-
-
-   The points in FOO are replaced by a subset of the original points
-that constitute the unique bounding convex polygon, the convex hull.
-The vertices of this polygon are output in clockwise order to form a
-closed curve.  The first and last points of the generated curve are
-equal, making it suitable for plotting with styles 'lines', *note
-polygons::, or *note filledcurves::.  The convex hull may also be useful
-as a mask to selectively render the region of an image or a pm3d surface
-that contains all the original data points.  See *note masking::.
-
-   If the keyword *note smooth:: is present, the vertices are then used
-as guide points to generate a smooth closed curve (see 'smooth path').
-By default this smoothed curve runs through the bounding points.
-
-   The optional 'expand' keyword and increment shift the edge segments
-of the hull away from the interior by an incremental distance.  The
-displaced segments are then connected using miter joins; this means that
-each vertex of the original hull is replaced by two vertices, since
-there is now a gap between the to adjoining edges.
-
--- CONCAVEHULL --
-
-   Present only if your copy of gnuplot was configured
--enable-chi-shapes.
-
-   Concavehull is not a plot style.  It is a filter that finds a
-bounding polygon, a "hull", of the input data points and replaces the
-original points with an ordered subset of points that lie along the
-perimeter of this polygon.  Unlike the convex hull, which is uniquely
-defined for any set of points, more than one concave hull is possible.
-Various schemes for selecting a concave hull exist; gnuplot generates
-hulls that are χ-shapes as defined by Duckham et al.  (2008) Patttern
-Recognition 41:3224-3236.
-
-   For a given set of points, a χ-shape is generated by iterative
-removal of triangles from the Delaunay triangulation.  Each iteration
-removes a single triangle subject to the criteria: (1) A triangle is
-only eligible for removal if this would not reduce the connectivity of
-the bounded shape to contact at a single point; (2) one edge of the
-triangle is the longest segment of the current perimeter; (3) this edge
-is longer than a pre-selected characteristic length parameter that fully
-determines the χ-shape.  In gnuplot this characteristic length parameter
-is taken from user variable 'chi_length'.  Iteration stops when there
-are no remaining eligible triangles.  If 'chi_length' is large, no
-triangles are removed and the χ-shape is the original perimeter, i.e.
-the convex hull.  As 'chi_length' is reduced, more and more triangles
-are removed and the resulting shape becomes increasingly less convex.
-Too-small values of 'chi_length' are undesirable.
-
-   Appropriate choice of 'chi_length' depends strongly on the density
-and distribution of the input data points.  If no value for 'chi_length'
-has been set by the user, gnuplot will choose one automatically but
-there is no guarantee that this value is suitable for your data.  For
-the data used in the figures shown here gnuplot would choose
-chi_length=22.6 by default, which is 0.6 of the length of the longest
-edge in the convex hull.  You can change the fraction of the longest
-edge used as a default with the command 'set chi_shape fraction <value>'
-
-   The value of 'chi_length' used in the current plot, whether provided
-by the user or chosen by the program, is saved to variable
-GPVAL_CHI_LENGTH.
-
-   The optional 'expand' keyword and increment shift each edge segment
-of the hull away from the interior by a fixed distance.  This creates a
-new set of points describing a closed curve that lies outside all of the
-original points.  It can be combined with 'smooth path'.
-
--- MASK --
-
-          plot FOO using 1:2:3 mask with {pm3d|image}
-
-
-   Once a mask has been defined, you can use it as a filter to select a
-subset of points from an image or pm3d plot.  See *note masking::.
-
--- SHARPEN --
-
-   The 'sharpen' filter applies only to function plots.  It looks for
-extrema in the function being plotted, which may not lie exactly at any
-of the x values sampled to generate the component line segments making
-up the graph.  The true local extrema are found by bisection and added
-to the set of sampled points.  This reduces but does not entirely
-eliminate truncation of sharp peaks due to coarse sampling.
-
-   Example:
-          set samples 150
-          set xrange [-8:8]
-          plot abs(sqrt(sin(x))) sharpen
-
-
-   Without the "sharpen" keyword, the resulting graph shows a continuous
-curve with minima at intervals of pi that should reach zero but are
-artefactually truncated to apparent minimal y values between 0.02 and
-0.20.  Adding the "sharpen" keyword produces instead a correct
-representation of the function with periodic sharp minima that reach
-y=0.  D sharpen 1
-
--- ZSORT --
-
-          plot FOO using x:y:z:color zsort with points lc palette
-
-
-   Input data is sorted immediately after input, prior to applying any
-smoothing options.  Note that some smoothing options will re-sort the
-data, in which case 'zsort' has no effect on the plot.  If z is not
-auto-scaled, points with z value out of range are flagged but not
-deleted.
-
-   The intended use is to filter presentation of 2D scatter plots with a
-huge number of points so that the distribution of high-scoring points
-remains evident.  Sorting the points on z guarantees that points with a
-high z-value will not be obscured by points with lower z-values.
-
-
-File: gnuplot.info,  Node: index,  Next: skip_,  Prev: filters,  Up: data
-
-3.20.3.6 index
-..............
-
-The *note index:: keyword allows you to select specific data sets in a
-multi-data-set file for plotting.  For array indexing please see *note
-arrays::.
-
-   Syntax:
-           plot 'file' index { <m>{:<n>{:<p>}} | "<name>" }
-
-
-   Data sets are separated by pairs of blank records.  'index <m>'
-selects only set <m>; 'index <m>:<n>' selects sets in the range <m> to
-<n>; and 'index <m>:<n>:<p>' selects indices <m>, <m>+<p>, <m>+2<p>,
-etc., but stopping at <n>.  Following C indexing, the index 0 is
-assigned to the first data set in the file.  Specifying too large an
-index results in an error message.  If <p> is specified but <n> is left
-blank then every <p>-th dataset is read until the end of the file.  If
-*note index:: is not specified, the entire file is plotted as a single
-data set.
-
-   Example:
-           plot 'file' index 4:5
-
-
-   For each point in the file, the index value of the data set it
-appears in is available via the pseudo-column 'column(-2)'.  This leads
-to an alternative way of distinguishing individual data sets within a
-file as shown below.  This is more awkward than the *note index::
-command if all you are doing is selecting one data set for plotting, but
-is very useful if you want to assign different properties to each data
-set.  See 'pseudocolumns', 'lc variable'.
-
-   Example:
-           plot 'file' using 1:(column(-2)==4 ? $2 : NaN)        # very awkward
-           plot 'file' using 1:2:(column(-2)) linecolor variable # very useful!
-
-
-   'index '<name>'' selects the data set with name '<name>'.  Names are
-assigned to data sets in comment lines.  The comment character and
-leading white space are removed from the comment line.  If the resulting
-line starts with <name>, the following data set is now named <name> and
-can be selected.
-
-   Example:
-           plot 'file' index 'Population'
-
-
-   Please note that every comment that starts with <name> will name the
-following data set.  To avoid problems it may be useful to choose a
-naming scheme like '== Population ==' or '[Population]'.
-
-   splot with indices demo.
-(http://www.gnuplot.info/demo/multimsh.html)</p>
-
-
-File: gnuplot.info,  Node: skip_,  Next: smooth,  Prev: index,  Up: data
-
-3.20.3.7 skip
-.............
-
-The *note skip:: keyword tells the program to skip lines at the start of
-a text (i.e.  not binary) data file.  The lines that are skipped do not
-count toward the line count used in processing the *note every::
-keyword.  Note that 'skip N' skips lines only at the start of the file,
-whereas 'every ::N' skips lines at the start of every block of data in
-the file.  See also *note skip:: for a similar option that applies to
-binary data files.
-
-
-File: gnuplot.info,  Node: smooth,  Next: special-filenames,  Prev: skip_,  Up: data
-
-3.20.3.8 smooth
-...............
-
-'gnuplot' includes a few routines for interpolation and other operations
-applied to data as it is input; these are grouped under the *note
-smooth:: option.  More sophisticated data processing may be performed by
-preprocessing the data externally or by using *note fit:: with an
-appropriate model.  See also the discussion of *note filters::.
-
-   Syntax:
-           smooth {unique | frequency | fnormal | cumulative | cnormal
-                  | csplines | acsplines | mcsplines  bezier | sbezier
-                  | path
-                  | kdensity {bandwidth} {period}
-                  | unwrap}
-
-
-   The 'unique', 'frequency', 'fnormal', 'cumulative' and 'cnormal'
-options sort the data on x and then plot some aspect of the distribution
-of x values.
-
-   The spline and Bezier options determine coefficients describing a
-continuous curve between the endpoints of the data.  This curve is then
-plotted in the same manner as a function, that is, by finding its value
-at uniform intervals along the abscissa (see *note samples::) and
-connecting these points with straight line segments.  If the data set is
-interrupted by blank lines or undefined values a separate continuous
-curve is fit for each uninterrupted subset of the data.  Adjacent
-separately fit segments may be separated by a gap or discontinuity.
-
-   'unwrap' manipulates the data to avoid jumps of more than pi by
-adding or subtracting multiples of 2*pi.
-
-   If *note autoscale:: is in effect, axis ranges will be computed for
-the final curve rather than for the original data.
-
-   If *note autoscale:: is not in effect, and a spline curve is being
-generated, sampling of the spline fit is done across the intersection of
-the x range covered by the input data and the fixed abscissa range
-defined by *note xrange::.
-
-   If too few points are available to apply the requested smoothing
-operation an error message is produced.
-
-   The *note smooth:: options have no effect on function plots.  Only
-'smooth path' is possible in polar coordinate mode.
-
-   Smoothing in 3D plots (splot) is currently limited to generating a
-natural cubic spline to pass through a set of 3D points.  In the general
-case the splines are generated along a trajectory ('smooth path').  For
-a 2D projection of 3D data 'smooth csplines' acts as it does in 2D.
-Either keyword is accepted in an 'splot' command.
-
-          splot $DATA using 1:2:3 smooth path with lines
-
-
--- ACSPLINES --
-
-   The 'smooth acsplines' option approximates the data with a natural
-smoothing spline.  After the data are made monotonic in x (see 'smooth
-unique'), a curve is piecewise constructed from segments of cubic
-polynomials whose coefficients are found by fitting to the individual
-data points weighted by the value, if any, given in the third column of
-the using spec.  The default is equivalent to
-           plot 'data-file' using 1:2:(1.0) smooth acsplines
-
-
-   Qualitatively, the absolute magnitude of the weights determines the
-number of segments used to construct the curve.  If the weights are
-large, the effect of each datum is large and the curve approaches that
-produced by connecting consecutive points with natural cubic splines.
-If the weights are small, the curve is composed of fewer segments and
-thus is smoother; the limiting case is the single segment produced by a
-weighted linear least squares fit to all the data.  The smoothing weight
-can be expressed in terms of errors as a statistical weight for a point
-divided by a "smoothing factor" for the curve so that (standard) errors
-in the file can be used as smoothing weights.
-
-   Example:
-           sw(x,S)=1/(x*x*S)
-           plot 'data_file' using 1:2:(sw($3,100)) smooth acsplines
-           splot 'data_file' using 1:2:3:(sw($4,100)) smooth acsplines
-
-
-   'splot ...  smooth acsplines with lines' fits splines to the x, y,
-and z coordinates of successive data points.  Unlike the 2D case, the
-points are not sorted first so it is possible to fit splines to a
-trajectory containing loops.  Caution: In the general 3D case there are
-many more spline terms fitted, so the weight value must be larger to
-achieve a comparable effect.  Also note that fractional path length is
-used as the implicit control variable and therefore the intervals being
-weighted do not match the projections onto a single axis.
-
--- BEZIER --
-
-   The 'smooth bezier' option approximates the data with a Bezier curve
-of degree n (the number of data points) that connects the endpoints.
-
--- BINS --
-
-   'smooth bins' is the same as 'bins'.  See 'bins'.
-
--- CSPLINES --
-
-   The 'smooth csplines' option connects consecutive points by natural
-cubic splines after rendering the data monotonic on x (see 'smooth
-unique').  The smoothed curve always passes through the data points, so
-closely-spaced points may generate local bumps and excursions in the
-smoothed curve.
-
-   'splot ...  smooth csplines with lines' fits splines to the x, y, and
-z coordinates of successive data points.  Unlike 2D csplines, the points
-are not sorted first so it is possible to fit splines to a trajectory
-containing loops.  In the general case three separate sets of spline
-coefficients are generated, each treating one coordinate x, y, or z as a
-function of a shared implicit trajectory path parameter.  This is
-equivalent to the 2D 'plot ...  smooth path' option.
-
-   In the special case that the curve lies in the xz, yz, or xy plane
-then only a single set of spline coefficients is generated.  This allows
-you to generate a stack of smoothed curves in 3D where each one
-replicates the spline fit you would have obtained from a 2D plot of the
-coordinates in projection.
-
--- MCSPLINES --
-
-   The 'smooth mcsplines' option connects consecutive points by cubic
-splines constrained such that the smoothed function preserves the
-monotonicity and convexity of the original data points.  This reduces
-the effect of outliers.  FN Fritsch & RE Carlson (1980) "Monotone
-Piecewise Cubic Interpolation", SIAM Journal on Numerical Analysis 17:
-238–246.
-
--- PATH --
-
-   The 'smooth path' option generates cubic splines to fit points in the
-order they are presented in the input data; i.e.  they are not first
-sorted on x.  This generates a smooth spline through a closed curve or
-along a trajectory that contains loops.  This smoothing mode is
-supported for both 2D and 3D plot commands.  A separate curve is created
-for each set of points in the input file, where a blank line separates
-the sets.  Plotting 'smooth path with filledcurves closed' will
-guarantee that each set of points creates a closed curve.  Plotting
-'smooth path with lines' will generate a closed curve if the first and
-last points in the set overlap, otherwise it will create an open-ended
-smooth path.  See smooth_path.dem
-(http://www.gnuplot.info/demo_6.0/smooth_path.html)
-
--- SBEZIER --
-
-   The 'smooth sbezier' option first renders the data monotonic
-('unique') and then applies the 'bezier' algorithm.
-
--- UNIQUE --
-
-   The 'smooth unique' option makes the data monotonic in x; points with
-the same x-value are replaced by a single point having the average
-y-value.  The resulting points are then connected by straight line
-segments.
-
--- UNWRAP --
-
-   The 'smooth unwrap' option modifies the input data so that any two
-successive points will not differ by more than pi; a point whose y value
-is outside this range will be incremented or decremented by multiples of
-2pi until it falls within pi of the previous point.  This operation is
-useful for making wrapped phase measurements continuous over time.
-
--- FREQUENCY --
-
-   The 'smooth frequency' option makes the data monotonic in x; points
-with the same x-value are replaced by a single point having the summed
-y-values.  To plot a histogram of the number of data values in equal
-size bins, set the y-value to 1.0 so that the sum is a count of
-occurrences in that bin.  This is done implicitly if only a single
-column is provided.  Example:
-          binwidth = <something>  # set width of x values in each bin
-          bin(val) = binwidth * floor(val/binwidth)
-          plot "datafile" using (bin(column(1))):(1.0) smooth frequency
-          plot "datafile" using (bin(column(1))) smooth frequency  # same result
-
-   See also smooth.dem (http://www.gnuplot.info/demo/smooth.html)
-
--- FNORMAL --
-
-   The 'smooth fnormal' option work just like the 'frequency' option,
-but produces a normalized histogram.  It makes the data monotonic in x
-and normalises the y-values so they all sum to 1.  Points with the same
-x-value are replaced by a single point containing the sumed y-values.
-To plot a histogram of the number of data values in equal size bins, set
-the y-value to 1.0 so that the sum is a count of occurrences in that
-bin.  This is done implicitly if only a single column is provided.  See
-also smooth.dem (http://www.gnuplot.info/demo/smooth.html)
-
--- CUMULATIVE --
-
-   The 'smooth cumulative' option makes the data monotonic in x; points
-with the same x-value are replaced by a single point containing the
-cumulative sum of y-values of all data points with lower x-values (i.e.
-to the left of the current data point).  This can be used to obtain a
-cumulative distribution function from data.  See also smooth.dem
-(http://www.gnuplot.info/demo/smooth.html)
-
--- CNORMAL --
-
-   The 'smooth cnormal' option makes the data monotonic in x and
-normalises the y-values onto the range [0:1].  Points with the same
-x-value are replaced by a single point containing the cumulative sum of
-y-values of all data points with lower x-values (i.e.  to the left of
-the current data point) divided by the total sum of all y-values.  This
-can be used to obtain a normalised cumulative distribution function from
-data (useful when comparing sets of samples with differing numbers of
-members).  See also smooth.dem
-(http://www.gnuplot.info/demo/smooth.html)
-
--- KDENSITY --
-
-   The 'smooth kdensity' option generates and plots a kernel density
-estimate using Gaussian kernels for the distribution from which a set of
-values was drawn.  Values are taken from the first data column, optional
-weights are taken from the second column.  A Gaussian is placed at the
-location of each point and the sum of all these Gaussians is plotted as
-a function.  To obtain a normalized histogram, each weight should be
-1/number-of-points.
-
-   Bandwidth: By default gnuplot calculates and uses the bandwidth which
-would be optimal for normally distributed data values.
-          default_bandwidth = sigma * (4/3N) ** (0.2)
-
-   This will usually be a very conservative, i.e.  broad bandwidth.
-Alternatively, you can provide an explicit bandwidth.
-          plot $DATA smooth kdensity bandwidth <value> with boxes
-
-   The bandwidth used in the previous plot is stored in
-GPVAL_KDENSITY_BANDWIDTH.
-
-   Period: For periodic data individual Gaussian components should be
-treated as repeating at intervals of one period.  One example is data
-measured as a function of angle, where the period is 2pi.  Another
-example is data indexed by day-of-year and measured over multiple years,
-where the period is 365.  In such cases the period should be provided in
-the plot command:
-          plot $ANGULAR_DAT smooth kdensity period 2*pi with lines
-
-
-
-File: gnuplot.info,  Node: special-filenames,  Next: piped-data,  Prev: smooth,  Up: data
-
-3.20.3.9 special-filenames
-..........................
-
-There are a few filenames that have a special meaning: ", '-', '+' and
-'++'.
-
-   The empty filename " tells gnuplot to re-use the previous input file
-in the same plot command.  So to plot two columns from the same input
-file:
-
-           plot 'filename' using 1:2, '' using 1:3
-
-
-   The filename can also be reused over subsequent plot commands,
-however *note save:: then only records the name in a comment.
-
-   The special filenames '+' and '++' are a mechanism to allow the full
-range of 'using' specifiers and plot styles with inline functions.
-Normally a function plot can only have a single y (or z) value
-associated with each sampled point.  The pseudo-file '+' treats the
-sampled points as column 1, and allows additional column values to be
-specified via a 'using' specification, just as for a true input file.
-The number of samples is controlled via *note samples:: or by giving an
-explicit sampling interval in the range specifier.  Samples are
-generated over the range given by *note trange:: if it has been set,
-otherwise over the full range of *note xrange::.
-
-   Note: The use of trange is a change from some earlier gnuplot
-versions.  It allows the sampling range to differ from the x axis range.
-
-           plot '+' using ($1):(sin($1)):(sin($1)**2) with filledcurves
-
-
-   An independent sampling range can be provided immediately before the
-'+'.  As in normal function plots, a name can be assigned to the
-independent variable.  If given for the first plot element, the sampling
-range specifier has to be preceded by the 'sample' keyword (see also
-*note sampling::).
-
-           plot sample [beta=0:2*pi] '+' using (sin(beta)):(cos(beta)) with lines
-
-
-   Here is an example where the sampling interval (1.5) is given as part
-of the sampling range.  Samples will be generated at -3, -1.5, 0, 1.5,
-..., 24.
-
-           plot $MYDATA, [t=-3:25:1.5] '+' using (t):(f(t))
-
-
-   The pseudo-file '++' returns 2 columns of data forming a regular grid
-of [u,v] coordinates with the number of points along u controlled by
-*note samples:: and the number of points along v controlled by *note
-isosamples::.  You must set urange and vrange before plotting '++'.
-However the x and y ranges can be autoscaled or can be explicitly set to
-different values than urange and vrange.  Examples:
-
-           splot '++' using 1:2:(sin($1)*sin($2)) with pm3d
-           plot '++' using 1:2:(sin($1)*sin($2)) with image
-
-
-   The special filename ''-'' specifies that the data are inline; i.e.,
-they follow the command.  Only the data follow the command; 'plot'
-options like filters, titles, and line styles remain on the 'plot'
-command line.  This is similar to << in unix shell script.  The data are
-entered as though they were being read from a file, one data point per
-record.  The letter "e" at the start of the first column terminates data
-entry.
-
-   ''-'' is intended for situations where it is useful to have data and
-commands together, e.g.  when both are piped to 'gnuplot' from another
-application.  Some of the demos, for example, might use this feature.
-While 'plot' options such as *note index:: and *note every:: are
-recognized, their use forces you to enter data that won't be used.  For
-all but the simplest cases it is probably easier to first define a
-datablock and then read from it rather than from ''-''.  See
-'datablocks'.
-
-   If you use ''-'' with *note replot::, you may need to enter the data
-more than once.  See *note replot::, *note refresh::.  Here again it may
-be better to use a datablock.
-
-   A blank filename (") specifies that the previous filename should be
-reused.  This can be useful with things like
-
-           plot 'a/very/long/filename' using 1:2, '' using 1:3, '' using 1:4
-
-
-   If you use both ''-'' and '"' on the same 'plot' command, you'll need
-to provide two sets of inline data.  It will not reuse the first one.
-
-
-File: gnuplot.info,  Node: piped-data,  Next: using,  Prev: special-filenames,  Up: data
-
-3.20.3.10 piped-data
-....................
-
-On systems with a popen function, the datafile can be piped through a
-shell command by starting the file name with a '<'.  For example,
-
-           pop(x) = 103*exp(-x/10)
-           plot "< awk '{print $1-1965, $2}' population.dat", pop(x)
-
-
-   would plot the same information as the first population example but
-with years since 1965 as the x axis.  If you want to execute this
-example, you have to delete all comments from the data file above or
-substitute the following command for the first part of the command above
-(the part up to the comma):
-
-           plot "< awk '$0 !~ /^#/ {print $1-1965, $2}' population.dat"
-
-
-   While this approach is most flexible, it is possible to achieve
-simple filtering with the 'using' keyword.
-
-   On systems with an fdopen() function, data can be read from an
-arbitrary file descriptor attached to either a file or pipe.  To read
-from file descriptor 'n' use ''<&n''.  This allows you to easily pipe in
-several data files in a single call from a POSIX shell:
-
-           $ gnuplot -p -e "plot '<&3', '<&4'" 3<data-3 4<data-4
-           $ ./gnuplot 5< <(myprogram -with -options)
-           gnuplot> plot '<&5'
-
-
-
-File: gnuplot.info,  Node: using,  Next: volatile,  Prev: piped-data,  Up: data
-
-3.20.3.11 using
-...............
-
-The most common datafile modifier is 'using'.  It tells the program
-which columns of data in the input file are to be plotted.
-
-   Syntax:
-           plot 'file' using <entry> {:<entry> {:<entry> ...}} {'format'}
-
-
-   Each <entry> may be a simple column number that selects the value
-from one field of the input file, a string that matches a column label
-in the first line of a data set, an expression enclosed in parentheses,
-or a special function not enclosed in parentheses such as xticlabels(2).
-
-   If the entry is an expression in parentheses, then the function
-column(N) may be used to indicate the value in column N. That is,
-column(1) refers to the first item read, column(2) to the second, and so
-on.  The special symbols $1, $2, ...  are shorthand for column(1),
-column(2) ...
-
-   The special symbol $# evaluates to the total number of columns in the
-current line of input, so column($#) or stringcolumn($#) always returns
-the content of the final column even if the number of columns is unknown
-or different lines in the file contain different numbers of columns.
-
-   The function 'valid(N)' tests whether column N contains a valid
-number.  It returns 0 if the column value is missing, uninterpretable,
-or NaN.
-
-   If each column of data in the input file contains a label in the
-first row rather than a data value, this label can be used to identify
-the column on input and/or in the plot legend.  The column() function
-can be used to select an input column by label rather than by column
-number.  For example, if the data file contains
-           Height    Weight    Age
-           val1      val1      val1
-           ...       ...       ...
-
-   then the following plot commands are all equivalent
-           plot 'datafile' using 3:1, '' using 3:2
-           plot 'datafile' using (column("Age")):(column(1)), \
-                        '' using (column("Age")):(column(2))
-           plot 'datafile' using "Age":"Height", '' using "Age":"Weight"
-
-
-   The full string must match.  Comparison is case-sensitive.  To use
-column labels in the plot legend, use 'set key autotitle columnhead' or
-use function 'columnhead(N)' when specifying an individual title.
-
-   In addition to the actual columns 1...N in the input data file,
-gnuplot presents data from several "pseudo-columns" that hold
-bookkeeping information.  E.g.  $0 or column(0) returns the sequence
-number of this data record within a dataset.  Please see
-'pseudocolumns'.
-
-   An empty <entry> will default to its order in the list of entries.
-For example, 'using ::4' is interpreted as 'using 1:2:4'.
-
-   If the 'using' list has only a single entry, that <entry> will be
-used for y and the data point number (pseudo-column $0) is used for x;
-for example, "'plot 'file' using 1'" is identical to "'plot 'file' using
-0:1'".  If the 'using' list has two entries, these will be used for x
-and y.  See *note style:: and *note fit:: for details about plotting
-styles that make use of data from additional columns of input.
-
--- FORMAT --
-
-   If a format is specified, it is used to read in each datafile record
-using the C library 'scanf' function.  Otherwise the record is
-interpreted as consisting of columns (fields) of data separated by
-whitespace (spaces and/or tabs), but see 'datafile separator'.
-
-   'scanf' itself accepts several numerical specifications but 'gnuplot'
-requires all inputs to be double-precision floating-point variables, so
-"%lf" is essentially the only permissible specifier.  The format string
-must contain at least one such input specifier and no more than seven of
-them.  'scanf' expects to see white space - a blank, tab ("\t"), newline
-("\n"), or formfeed ("\f") - between numbers; anything else in the input
-stream must be explicitly skipped.
-
-   Note that the use of "\t", "\n", or "\f" requires use of
-double-quotes rather than single-quotes.
-
--- USING_EXAMPLES --
-
-   This creates a plot of the sum of the 2nd and 3rd data against the
-first: The format string specifies comma- rather than space-separated
-columns.  The same result could be achieved by specifying 'set datafile
-separator comma'.
-           plot 'file' using 1:($2+$3) '%lf,%lf,%lf'
-
-
-   In this example the data are read from the file "MyData" using a more
-complicated format:
-           plot 'MyData' using "%*lf%lf%*20[^\n]%lf"
-
-
-   The meaning of this format is:
-
-           %*lf        ignore a number
-           %lf         read a double-precision number (x by default)
-           %*20[^\n]   ignore 20 non-newline characters
-           %lf         read a double-precision number (y by default)
-
-
-   One trick is to use the ternary '?:' operator to filter data:
-
-           plot 'file' using 1:($3>10 ? $2 : 1/0)
-
-
-   which plots the datum in column two against that in column one
-provided the datum in column three exceeds ten.  '1/0' is undefined;
-'gnuplot' quietly ignores undefined points, so unsuitable points are
-suppressed.  Or you can use the pre-defined variable NaN to achieve the
-same result.
-
-   In fact, you can use a constant expression for the column number,
-provided it doesn't start with an opening parenthesis; constructs like
-'using 0+(complicated expression)' can be used.  The crucial point is
-that the expression is evaluated once if it doesn't start with a left
-parenthesis, or once for each data point read if it does.
-
-   If timeseries data are being used, the time can span multiple
-columns.  The starting column should be specified.  Note that the spaces
-within the time must be included when calculating starting columns for
-other data.  E.g., if the first element on a line is a time with an
-embedded space, the y value should be specified as column three.
-
-   It should be noted that (a) 'plot 'file'', (b) 'plot 'file' using
-1:2', and (c) 'plot 'file' using ($1):($2)' can be subtly different.
-See 'missing'.
-
-   It is often possible to plot a file with lots of lines of garbage at
-the top simply by specifying
-
-           plot 'file' using 1:2
-
-
-   However, if you want to leave text in your data files, it is safer to
-put the comment character (#) in the first column of the text lines.
-
--- PSEUDOCOLUMNS --
-
-   Expressions in the 'using' clause of a plot statement can refer to
-additional bookkeeping values in addition to the actual data values
-contained in the input file.  These are contained in "pseudocolumns".
-           column(0)   The sequential order of each point within a data set.
-                       The counter starts at 0, increments on each non-blank,
-                       non-comment line, and is reset by two sequential blank
-                       records. For data in non-uniform matrix format, column(0)
-                       is the linear order of each matrix element.
-                       The shorthand form $0 is available.
-           column(-1)  This counter starts at 0, increments on a single blank line,
-                       and is reset by two sequential blank lines.
-                       This corresponds to the data line in array or grid data.
-                       It can also be used to distinguish separate line segments
-                       or polygons within a data set.
-           column(-2)  Starts at 0 and increments on two sequential blank lines.
-                       This is the index number of the current data set within a
-                       file that contains multiple data sets.  See *note index::.
-           column($#)  The special symbol $# evaluates to the total number of
-                       columns available, so column($#) refers to the last
-                       (rightmost) field in the current input line.
-                       column($# - 1) would refer to the last-but-one column, etc.
-
-
--- ARRAYS --
-
-   When the data source being plotted is an array or array-valued
-function, the "columns" in a 'using' specification are interpreted as
-below.  See *note arrays:: for more detail.
-           column 1   the array index
-           column 2   the real component of a numerical array entry
-                      or the string value of a string array entry
-           column 3   the imaginary part of a numerical array entry
-
-
--- KEY --
-
-   The layout of certain plot styles (column-stacked histograms, spider
-plots) is such that it would make no sense to generate plot titles from
-a data column header.  Also it would make no sense to generate axis tic
-labels from the content of a data column (e.g.  'using
-2:3:xticlabels(1)').  These plots styles instead use the form 'using
-2:3:key(1)' to generate plot titles for the key from the text content of
-a data column, usually a first column of row headers.  See the example
-given for *note spiderplot::.
-
--- XTICLABELS --
-
-   Axis tick labels can be generated via a string function, usually
-taking a data column as an argument.  The simplest form uses the data
-column itself as a string.  That is, xticlabels(N) is shorthand for
-xticlabels(stringcolumn(N)). This example uses the contents of column 3
-as x-axis tick labels.
-
-           plot 'datafile' using <xcol>:<ycol>:xticlabels(3) with <plotstyle>
-
-
-   Axis tick labels may be generated for any of the plot axes: x x2 y y2
-z.  The 'ticlabels(<labelcol>)' specifiers must come after all of the
-data coordinate specifiers in the 'using' portion of the command.  For
-each data point which has a valid set of X,Y[,Z] coordinates, the string
-value given to xticlabels() is added to the list of xtic labels at the
-same X coordinate as the point it belongs to.  'xticlabels()' may be
-shortened to 'xtic()' and so on.
-
-   Example:
-
-           splot "data" using 2:4:6:xtic(1):ytic(3):ztic(6)
-
-
-   In this example the x and y axis tic labels are taken from different
-columns than the x and y coordinate values.  The z axis tics, however,
-are generated from the z coordinate of the corresponding point.
-
-   Example:
-
-           plot "data" using 1:2:xtic( $3 > 10. ? "A" : "B" )
-
-
-   This example shows the use of a string-valued function to generate
-x-axis tick labels.  Each point in the data file generates a tick mark
-on x labeled either "A" or "B" depending on the value in column 3.
-
--- X2TICLABELS --
-
-   See 'plot using xticlabels'.
-
--- YTICLABELS --
-
-   See 'plot using xticlabels'.
-
--- Y2TICLABELS --
-
-   See 'plot using xticlabels'.
-
--- ZTICLABELS --
-
-   See 'plot using xticlabels'.
-
-
-File: gnuplot.info,  Node: volatile,  Prev: using,  Up: data
-
-3.20.3.12 volatile
-..................
-
-The *note volatile:: keyword in a plot command indicates that the data
-previously read from the input stream or file may not be available for
-re-reading.  This tells the program to use *note refresh:: rather than
-*note replot:: commands whenever possible.  See *note refresh::.
-
-
-File: gnuplot.info,  Node: functions,  Next: parametric,  Prev: data,  Up: plot
-
-3.20.4 functions
-----------------
-
-Built-in or user-defined functions can be displayed by the 'plot' and
-'splot' commands in addition to, or instead of, data read from a file.
-The requested function is evaluated by sampling at regular intervals
-spanning the independent axis range[s].  See *note samples:: and *note
-isosamples::.  Example:
-           approx(ang) = ang - ang**3 / (3*2)
-           plot sin(x) title "sin(x)", approx(x) title "approximation"
-
-
-   To set a default plot style for functions, see 'set style function'.
-For information on built-in functions, see *note functions::.  For
-information on defining your own functions, see 'user-defined'.
-
-
-File: gnuplot.info,  Node: parametric,  Next: ranges,  Prev: functions,  Up: plot
-
-3.20.5 parametric
------------------
-
-When in parametric mode (*note parametric::) mathematical expressions
-must be given in pairs for 'plot' and in triplets for 'splot'.
-
-   Examples:
-           plot sin(t),t**2
-           splot cos(u)*cos(v),cos(u)*sin(v),sin(u)
-
-
-   Data files are plotted as before, except any preceding parametric
-function must be fully specified before a data file is given as a plot.
-In other words, the x parametric function ('sin(t)' above) and the y
-parametric function ('t**2' above) must not be interrupted with any
-modifiers or data functions; doing so will generate a syntax error
-stating that the parametric function is not fully specified.
-
-   Other modifiers, such as 'with' and *note title::, may be specified
-only after the parametric function has been completed:
-
-           plot sin(t),t**2 title 'Parametric example' with linespoints
-
-
-   See also Parametric Mode Demos.
-(http://www.gnuplot.info/demo/param.html)
-
-
-File: gnuplot.info,  Node: ranges,  Next: sampling,  Prev: parametric,  Up: plot
-
-3.20.6 ranges
--------------
-
-This section describes only the optional axis ranges that may appear as
-the very first items in a 'plot' or 'splot' command.  If present, these
-ranges override any range limits established by a previous 'set range'
-statement.  For optional ranges elsewhere in a 'plot' command that limit
-sampling of an individual plot component, see *note sampling::.
-
-   Syntax:
-           [{<dummy-var>=}{{<min>}:{<max>}}]
-           [{{<min>}:{<max>}}]
-
-
-   The first form applies to the independent variable (*note xrange:: or
-*note trange::, if in parametric mode).  The second form applies to
-dependent variables.  <dummy-var> optionally establishes a new name for
-the independent variable.  (The default name may be changed with *note
-dummy::.)
-
-   In non-parametric mode, ranges must be given in the order
-           plot [<xrange>][<yrange>][<x2range>][<y2range>] ...
-
-
-   In parametric mode, ranges must be given in the order
-           plot [<trange>][<xrange>][<yrange>][<x2range>][<y2range>] ...
-
-   The following 'plot' command shows setting *note trange:: to
-[-pi:pi], *note xrange:: to [-1.3:1.3] and *note yrange:: to [-1:1] for
-the duration of the graph:
-
-           plot [-pi:pi] [-1.3:1.3] [-1:1] sin(t),t**2
-
-
-   '*' can be used to allow autoscaling of either of min and max.  Use
-an empty range '[]' as a placeholder if necessary.
-
-   Ranges specified on the 'plot' or 'splot' command line affect only
-that one graph; use the *note xrange::, *note yrange::, etc., commands
-to change the default ranges for future graphs.
-
-   The use of on-the-fly range specifiers in a plot command may not
-yield the expected result for linked axes (see *note link::).
-
-   For time data you must provide the range in quotes, using the same
-format used to read time from the datafile.  See *note timefmt::.
-
-   Examples:
-
-   This uses the current ranges:
-           plot cos(x)
-
-
-   This sets the x range only:
-           plot [-10:30] sin(pi*x)/(pi*x)
-
-
-   This is the same, but uses t as the dummy-variable:
-           plot [t = -10 :30]  sin(pi*t)/(pi*t)
-
-
-   This sets both the x and y ranges:
-           plot [-pi:pi] [-3:3]  tan(x), 1/x
-
-
-   This sets only the y range:
-           plot [ ] [-2:sin(5)*-8] sin(x)**besj0(x)
-
-
-   This sets xmax and ymin only:
-           plot [:200] [-pi:]  $mydata using 1:2
-
-
-   This sets the x range for a timeseries:
-           set timefmt "%d/%m/%y %H:%M"
-           plot ["1/6/93 12:00":"5/6/93 12:00"] 'timedata.dat'
-
-
-
-File: gnuplot.info,  Node: sampling,  Next: for_loops_in_plot_command,  Prev: ranges,  Up: plot
-
-3.20.7 sampling
----------------
-
-* Menu:
-
-* 1D_sampling_(x_or_t_axis)::
-* 2D_sampling_(u_and_v_axes)::
-
-
-File: gnuplot.info,  Node: 1D_sampling_(x_or_t_axis),  Next: 2D_sampling_(u_and_v_axes),  Prev: sampling,  Up: sampling
-
-3.20.7.1 1D sampling (x or t axis)
-..................................
-
-By default, computed functions are sampled over the entire range of the
-plot as set by a prior *note xrange:: command, by an x-axis range
-specifier at the very start of the plot command, or by autoscaling the
-xrange to span data seen in all the elements of this plot.  Points
-generated by the pseudo-file "+" are sampled over the current range of
-the t axis, which may or may not be the same as the range of the x axis.
-
-   Individual plot components can be assigned a more restricted sampling
-range.
-
-   Examples:
-
-   This establishes a total range on x running from 0 to 1000 and then
-plots data from a file and two functions each spanning a portion of the
-total range:
-           set xrange [0:1000]
-           plot 'datafile', [0:200] func1(x), [200:500] func2(x)
-
-
-   This is similar except that the total range is established by the
-contents of the data file.  In this case the sampled functions may or
-may not be entirely contained in the plot:
-           set autoscale x
-           plot 'datafile', [0:200] func1(x), [200:500] func2(x)
-
-
-   The plot command below is ambiguous.  The initial range [0:10] will
-be interpreted as applying to the entire plot, overriding the previous
-xrange command, rather than applying solely to the sampling of the first
-function as was probably the intent:
-           set xrange [0:50]
-           plot [0:10] f(x), [10:20] g(x), [20:30] h(x)
-
-
-   To remove the ambiguity in the previous example, insert the keyword
-'sample' to indicate that [0:10] is a sampling range applied to a single
-plot component rather than a global x-axis range that would apply to the
-entire plot.
-           plot sample [0:10] f(x), [10:20] g(x), [20:30] h(x)
-
-
-   This example shows one way of tracing out a helix in a 3D plot
-           set xrange [-2:2]; set yrange [-2:2]
-           splot sample [h=1:10] '+' using (cos(h)):(sin(h)):(h)
-
-
-
-File: gnuplot.info,  Node: 2D_sampling_(u_and_v_axes),  Prev: 1D_sampling_(x_or_t_axis),  Up: sampling
-
-3.20.7.2 2D sampling (u and v axes)
-...................................
-
-Computed functions or data generated for the pseudo-file '++' use
-samples generated along the u and v axes.  See 'special-filenames ++'.
-2D sampling can be used in either 'plot' or 'splot' commands.
-
-   Example of 2D sampling in a 2D 'plot' command.  These commands
-generated the plot shown for plotstyle *note vectors::.  See *note
-vectors::.
-          set urange [ -2.0 : 2.0 ]
-          set vrange [ -2.0 : 2.0 ]
-          plot '++' using ($1):($2):($2*0.4):(-$1*0.4) with vectors
-
-
-   Example of 2D sampling in a 3D 'splot' command.  These commands are
-similar to the ones used in 'sampling.dem'.  Note that the two surfaces
-are sampled over u and v ranges smaller than the full x and y ranges of
-the resulting plot.
-          set title "3D sampling range distinct from plot x/y range"
-          set xrange [1:100]
-          set yrange [1:100]
-          splot sample [u=30:70][v=0:50] '++' using 1:2:(u*v) lt 3, \
-                [u=40:80][v=30:60] '++' using (u):(v):(u*sqrt(v)) lt 4
-
-
-   The range specifiers for sampling on u and v can include an explicit
-sampling interval to control the number and spacing of samples:
-          splot sample [u=30:70:1][v=0:50:5] '++' using 1:2:(func($1,$2))
-
-
-
-File: gnuplot.info,  Node: for_loops_in_plot_command,  Next: title,  Prev: sampling,  Up: plot
-
-3.20.8 for loops in plot command
---------------------------------
-
-If many similar files or functions are to be plotted together, it may be
-convenient to do so by iterating over a shared plot command.
-
-   Syntax:
-           plot for [<variable> = <start> : <end> {:<increment>}]
-           plot for [<variable> in "string of words"]
-
-
-   The scope of an iteration ends at the next comma or the end of the
-command, whichever comes first.  An exception to this is that
-definitions are grouped with the following plot item even if there is an
-intervening comma.  Note that iteration does not work for plots in
-parametric mode.
-
-   Example:
-           plot for [j=1:3] sin(j*x)
-
-
-   Example:
-           plot for [dataset in "apples bananas"] dataset."dat" title dataset
-
-
-   In this example iteration is used both to generate a file name and a
-corresponding title.
-
-   Example:
-           file(n) = sprintf("dataset_%d.dat",n)
-           splot for [i=1:10] file(i) title sprintf("dataset %d",i)
-
-
-   This example defines a string-valued function that generates file
-names, and plots ten such files together.  The iteration variable ('i'
-in this example) is treated as an integer, and may be used more than
-once.
-
-   Example:
-           set key left
-           plot for [n=1:4] x**n sprintf("%d",n)
-
-
-   This example plots a family of functions.
-
-   Example:
-           list = "apple banana cabbage daikon eggplant"
-           item(n) = word(list,n)
-           plot for [i=1:words(list)] item[i].".dat" title item(i)
-           list = "new stuff"
-           replot
-
-
-   This example steps through a list and plots once per item.  Because
-the items are retrieved dynamically, you can change the list and then
-replot.
-
-   Example:
-           list = "apple banana cabbage daikon eggplant"
-           plot for [i in list] i.".dat" title i
-           list = "new stuff"
-           replot
-
-
-   This example does exactly the same thing as the previous example, but
-uses the string iterator form of the command rather than an integer
-iterator.
-
-   If an iteration is to continue until all available data is consumed,
-use the symbol * instead of an integer <end>.  This can be used to
-process all columns in a line, all datasets (separated by 2 blank lines)
-in a file, or all files matching a template.
-
-   Examples:
-           plot for [file in "A.dat B.dat"] for [column=2:*] file using 1:column
-           splot for [i=0:*] 'datafile' index i using 1:2:3 with lines
-           plot for [i=1:*] file=sprintf("File_%03d.dat",i) file using 2 title file
-
-
-   Caveat: You can nest iterations where one is open-ended, as in the
-first example above.  However nesting an open-ended iteration inside
-another open-ended iteration is probably not useful, since both will
-terminate at the same time when no data is found.  The program will
-issue a warning if this happens.
-
-
-File: gnuplot.info,  Node: title,  Next: with,  Prev: for_loops_in_plot_command,  Up: plot
-
-3.20.9 title
-------------
-
-By default each plot is listed in the key by the corresponding function
-or file name.  You can give an explicit plot title instead using the
-*note title:: option.
-
-   Syntax:
-           title <text> | notitle [<ignored text>]
-           title columnheader | title columnheader(N)
-                 {at {beginning|end}} {{no}enhanced}
-
-
-   where <text> is a quoted string or an expression that evaluates to a
-string.  The quotes will not be shown in the key.
-
-   There is also an option that will interpret the first entry in a
-column of input data (i.e.  the column header) as a text field, and use
-it as the key title.  See 'datastrings'.  This can be made the default
-by specifying 'set key autotitle columnhead'.
-
-   The line title and sample can be omitted from the key by using the
-keyword 'notitle'.  A null title ('title "') is equivalent to 'notitle'.
-If only the sample is wanted, use one or more blanks ('title ' '').  If
-'notitle' is followed by a string this string is ignored.
-
-   If 'key autotitles' is set (which is the default) and neither *note
-title:: nor 'notitle' are specified the line title is the function name
-or the file name as it appears on the 'plot' command.  If it is a file
-name, any datafile modifiers specified will be included in the default
-title.
-
-   The layout of the key itself (position, title justification, etc.)
-can be controlled using 'set key'.
-
-   The 'at' keyword allows you to place the plot title somewhere outside
-the auto-generated key box.  The title can be placed immediately before
-or after the line in the graph itself by using 'at {beginning|end}'.
-This option may be useful when plotting 'with lines' but makes little
-sense for most other styles.
-
-   To place the plot title at an arbitrary location on the page, use the
-form 'at <x-position>,<y-position>'.  By default the position is
-interpreted in screen coordinates; e.g.  'at 0.5, 0.5' is always the
-middle of the screen regardless of plot axis scales or borders.  The
-format of titles placed in this way is still affected by key options.
-See 'set key'.
-
-   Examples:
-
-   This plots y=x with the title 'x':
-           plot x
-
-
-   This plots x squared with title "x^2" and file "data.1" with title
-"measured data":
-           plot x**2 title "x^2", 'data.1' t "measured data"
-
-
-   Plot multiple columns of data, each of which contains its own title
-on the first line of the file.  Place the titles after the corresponding
-lines rather than in a separate key:
-           unset key
-           set offset 0, graph 0.1
-           plot for [i=1:4] 'data' using i with lines title columnhead at end
-
-
-   Create a single key area for two separate plots:
-           set key Left reverse
-           set multiplot layout 2,2
-           plot sin(x) with points pt 6 title "Left plot is sin(x)" at 0.5, 0.30
-           plot cos(x) with points pt 7 title "Right plot is cos(x)" at 0.5, 0.27
-           unset multiplot
-
-
-
-File: gnuplot.info,  Node: with,  Prev: title,  Up: plot
-
-3.20.10 with
-------------
-
-Functions and data may be displayed in one of a large number of styles.
-The 'with' keyword provides the means of selection.
-
-   Syntax:
-           with <style> { {linestyle | ls <line_style>}
-                          | {{linetype  | lt <line_type>}
-                             {linewidth | lw <line_width>}
-                             {linecolor | lc <colorspec>}
-                             {pointtype | pt <point_type>}
-                             {pointsize | ps <point_size>}
-                             {arrowstyle | as <arrowstyle_index>}
-                             {fill | fs <fillstyle>} {fillcolor | fc <colorspec>}
-                             {nohidden3d} {nocontours} {nosurface}
-                             {palette}}
-                        }
-
-
-   where <style> is one of
-          lines        dots       steps     vectors      yerrorlines
-          points       impulses   fsteps    xerrorbar    xyerrorbars
-          linespoints  labels     histeps   xerrorlines  xyerrorlines
-          financebars  surface    arrows    yerrorbar    parallelaxes
-
-   or
-          boxes         boxplot        ellipses       histograms  rgbalpha
-          boxerrorbars  candlesticks   filledcurves   image       rgbimage
-          boxxyerror    circles        fillsteps      pm3d        polygons
-          isosurface    zerrorfill
-
-   or
-          table         mask
-
-
-   The first group of styles have associated line, point, and text
-properties.  The second group of styles also have fill properties.  See
-'fillstyle'.  Some styles have further sub-styles.  See 'plotting
-styles' for details of each.  Two special styles produce no immediate
-plot.  See *note table:: and 'with mask'.  The *note table:: style
-produces tabular output to a text file or data block.  A plot component
-whose style is 'with mask' defines a set of polygonal regions that can
-be used to mask subsequent plot elements.
-
-   A default style may be chosen by 'set style function' and 'set style
-data'.
-
-   By default, each function and data file will use a different line
-type and point type, up to the maximum number of available types.  All
-terminal drivers support at least six different point types, and re-use
-them, in order, if more are required.  To see the complete set of line
-and point types available for the current terminal, type 'test'.
-
-   If you wish to choose the line or point type for a single plot,
-<line_type> and <point_type> may be specified.  These are positive
-integer constants (or expressions) that specify the line type and point
-type to be used for the plot.  Use 'test' to display the types available
-for your terminal.
-
-   You may also scale the line width and point size for a plot by using
-<line_width> and <point_size>, which are specified relative to the
-default values for each terminal.  The pointsize may also be altered
-globally--see *note pointsize:: for details.  But note that both
-<point_size> as set here and as set by *note pointsize:: multiply the
-default point size; their effects are not cumulative.  That is, 'set
-pointsize 2; plot x with points ps 3' will use points three times the
-default size, not six.
-
-   It is also possible to specify 'pointsize variable' either as part of
-a line style or for an individual plot.  In this case one extra column
-of input is required, i.e.  3 columns for a 2D plot and 4 columns for a
-3D splot.  The size of each individual point is determined by
-multiplying the global pointsize by the value read from the data file.
-
-   If you have defined specific line type/width and point type/size
-combinations with 'set style line', one of these may be selected by
-setting <line_style> to the index of the desired style.
-
-   Both 2D and 3D plots ('plot' and 'splot' commands) can use colors
-from a smooth palette set previously with the command *note palette::.
-The color value corresponds to the z-value of the point itself or to a
-separate color coordinate provided in an optional additional 'using'
-column.  Color values may be treated either as a fraction of the palette
-range ('palette frac') or as a coordinate value mapped onto the colorbox
-range (*note palette:: or 'palette z').  See *note colorspec::, *note
-palette::, 'linetypes'.
-
-   The keyword 'nohidden3d' applies only to plots made with the 'splot'
-command.  Normally the global option *note hidden3d:: applies to all
-plots in the graph.  You can attach the 'nohidden3d' option to any
-individual plots that you want to exclude from the hidden3d processing.
-The individual elements other than surfaces (i.e.  lines, dots, labels,
-...)  of a plot marked 'nohidden3d' will all be drawn, even if they
-would normally be obscured by other plot elements.
-
-   Similarly, the keyword 'nocontours' will turn off contouring for an
-individual plot even if the global property 'set contour' is active.
-
-   Similarly, the keyword 'nosurface' will turn off the 3D surface for
-an individual plot even if the global property 'set surface' is active.
-
-   The keywords may be abbreviated as indicated.
-
-   Note that the 'linewidth', *note pointsize:: and *note palette::
-options are not supported by all terminals.
-
-   Examples:
-
-   This plots sin(x) with impulses:
-           plot sin(x) with impulses
-
-
-   This plots x with points, x**2 with the default:
-           plot x w points, x**2
-
-
-   This plots tan(x) with the default function style, file "data.1" with
-lines:
-           plot tan(x), 'data.1' with l
-
-
-   This plots "leastsq.dat" with impulses:
-           plot 'leastsq.dat' w i
-
-
-   This plots the data file "population" with boxes:
-           plot 'population' with boxes
-
-
-   This plots "exper.dat" with errorbars and lines connecting the points
-(errorbars require three or four columns):
-           plot 'exper.dat' w lines, 'exper.dat' notitle w errorbars
-
-
-   Another way to plot "exper.dat" with errorlines (errorbars require
-three or four columns):
-           plot 'exper.dat' w errorlines
-
-
-   This plots sin(x) and cos(x) with linespoints, using the same line
-type but different point types:
-           plot sin(x) with linesp lt 1 pt 3, cos(x) with linesp lt 1 pt 4
-
-
-   This plots file "data" with points of type 3 and twice usual size:
-           plot 'data' with points pointtype 3 pointsize 2
-
-
-   This plots file "data" with variable pointsize read from column 4
-           plot 'data' using 1:2:4 with points pt 5 pointsize variable
-
-
-   This plots two data sets with lines differing only by weight:
-           plot 'd1' t "good" w l lt 2 lw 3, 'd2' t "bad" w l lt 2 lw 1
-
-
-   This plots filled curve of x*x and a color stripe:
-           plot x*x with filledcurve closed, 40 with filledcurve y=10
-
-
-   This plots x*x and a color box:
-           plot x*x, (x>=-5 && x<=5 ? 40 : 1/0) with filledcurve y=10 lt 8
-
-
-   This plots a surface with color lines:
-           splot x*x-y*y with line palette
-
-
-   This plots two color surfaces at different altitudes:
-           splot x*x-y*y with pm3d, x*x+y*y with pm3d at t
-
-
-
-File: gnuplot.info,  Node: print,  Next: printerr,  Prev: plot,  Up: Commands
-
-3.21 print
-==========
-
-Syntax:
-           print <expression> {, <expression>, ...}
-
-
-   The 'print' command prints the value of one or more expressions.
-Output is to the screen unless it has been redirected using the 'set
-print' command.  See 'expressions'.  See also *note printerr::.
-
-   An <expression> may be any valid gnuplot expression, including
-numeric or string constants, a function returning a number or string, an
-array, or the name of a variable.  It is also possible to print a
-datablock.  The sprintf and gprintf functions can be used in conjunction
-with 'print' for additional flexibility in formatting the output.
-
-   You can use iteration within a print command to include multiple
-values on a single line of output.
-
-   Examples:
-          print 123 + 456
-          print sinh(pi/2)
-          print "rms of residuals (FIT_STDFIT) is ", FIT_STDFIT
-          print sprintf("rms of residuals is %.3f after fit", FIT_STDFIT)
-          print "Array A: ", A
-          print "Individual elements of array A: ", for [i=1:|A|] A[i]
-          print $DATA
-
-
-
-File: gnuplot.info,  Node: printerr,  Next: pwd,  Prev: print,  Up: Commands
-
-3.22 printerr
-=============
-
-*note printerr:: is the same as 'print' except that output is always
-sent to stderr even while redirection from a prior 'set print' command
-remains in effect.  Use the 'warn' command instead if you want the
-output to include the current filename (or function block name) and line
-number.
-
-
-File: gnuplot.info,  Node: pwd,  Next: quit,  Prev: printerr,  Up: Commands
-
-3.23 pwd
-========
-
-The *note pwd:: command prints the name of the working directory to the
-screen.
-
-   Note that if you wish to store the current directory into a string
-variable or use it in string expressions, then you can use variable
-GPVAL_PWD, see 'show variables all'.
-
-
-File: gnuplot.info,  Node: quit,  Next: raise,  Prev: pwd,  Up: Commands
-
-3.24 quit
-=========
-
-*note quit:: is a synonym for the *note exit:: command.  See *note
-exit::.
-
-
-File: gnuplot.info,  Node: raise,  Next: refresh,  Prev: quit,  Up: Commands
-
-3.25 raise
-==========
-
-Syntax:
-           raise {plot_window_id}
-           lower {plot_window_id}
-
-
-   The *note raise:: and *note lower:: commands function for only a few
-terminal types and may depend also on your window manager and display
-preference settings.
-           set term wxt 123     # create first plot window
-           plot $FOO
-           lower                # lower the only plot window that exists so far
-           set term wxt 456     # create 2nd plot window may occlude the first one
-           plot $BAZ
-           raise 123            # raise first plot window
-
-   These commands are known to be unreliable.
-
-
-File: gnuplot.info,  Node: refresh,  Next: remultiplot,  Prev: raise,  Up: Commands
-
-3.26 refresh
-============
-
-The *note refresh:: command is similar to *note replot::, with two major
-differences.  *note refresh:: reformats and redraws the current plot
-using the data already read in.  This means that you can use *note
-refresh:: for plots with inline data (pseudo-device '-') and for plots
-from datafiles whose contents are volatile.  You cannot use the *note
-refresh:: command to add new data to an existing plot.
-
-   Mousing operations, in particular zoom and unzoom, will use *note
-refresh:: rather than *note replot:: if appropriate.  Example:
-
-           plot 'datafile' volatile with lines, '-' with labels
-           100 200 "Special point"
-           e
-           # Various mousing operations go here
-           set title "Zoomed in view"
-           set term post
-           set output 'zoom.ps'
-           refresh
-
-
-
-File: gnuplot.info,  Node: remultiplot,  Next: replot,  Prev: refresh,  Up: Commands
-
-3.27 remultiplot
-================
-
-*note remultiplot:: replays a sequence of commands that were previously
-stored into the datablock named $GPVAL_LAST_MULTIPLOT during generation
-of the previous multiplot.  See 'new multiplots'.
-
-   EXPERIMENTAL: *note remultiplot:: is invoked implicitly from *note
-replot:: if the immediately preceding plot command was part of a
-completed multiplot.  *note remultiplot:: is also invoked by hot keys
-and mouse operations pan/zoom etc.  while a multiplot is displayed.
-
-
-File: gnuplot.info,  Node: replot,  Next: reread,  Prev: remultiplot,  Up: Commands
-
-3.28 replot
-===========
-
-The *note replot:: command without arguments repeats the last 'plot' or
-'splot' command.  This can be useful for viewing a plot with different
-'set' options, or when generating the same plot for several devices.
-
-   Arguments specified after a *note replot:: command will be added onto
-the last 'plot' or 'splot' command (with an implied ',' separator)
-before it is repeated.  *note replot:: accepts the same arguments as the
-'plot' and 'splot' commands except that ranges cannot be specified.
-Thus you can use *note replot:: to plot a function against the second
-axes if the previous command was 'plot' but not if it was 'splot'.
-
-   Note:
-
-           plot '-' ; ... ; replot
-
-
-   is not recommended, because it will require that you type in the data
-all over again.  In most cases you can use the *note refresh:: command
-instead, which will redraw the plot using the data previously read in.
-
-   See also 'command-line-editing' for ways to edit the last 'plot'
-('splot') command.
-
-   See also 'show plot' to show the whole current plotting command, and
-the possibility to copy it into the *note history::.
-
-   In previous gnuplot versions, a complete multiplot could not be
-redrawn.  The *note replot:: command reproduced only the final component
-plot of the full set.  In gnuplot version 6 the commands used to
-generate a multiplot are stored into a datablock $GPVAL_LAST_MULTIPLOT.
-They can be replayed to regenerate the entire multiplot using the new
-command *note remultiplot::.
-
-   EXPERIMENTAL (details may change in a subsequent gnuplot version): If
-the previously drawn plot was part of a multiplot, the *note replot::
-command is now automatically treated as *note remultiplot::.  Several
-caveats apply.  See 'new multiplots', *note remultiplot::.
-
-
-File: gnuplot.info,  Node: reread,  Next: reset,  Prev: replot,  Up: Commands
-
-3.29 reread
-===========
-
-[DEPRECATED in version 5.4]
-
-   This command is deprecated in favor of explicit iteration.  See
-'iterate'.  The *note reread:: command causes execution from the current
-'gnuplot' input file, as specified by a 'load' command, to immediately
-restart from the beginning of the file.  This essentially implements an
-endless loop of commands from the beginning of the file to the *note
-reread:: command.  *note reread:: has no effect when reading commands
-from stdin.
-
-
-File: gnuplot.info,  Node: reset,  Next: return,  Prev: reread,  Up: Commands
-
-3.30 reset
-==========
-
-          reset {bind | errors | session}
-
-
-   The *note reset:: command causes all graph-related options that can
-be set with the 'set' command to return to their default values.  This
-command can be used to restore the default settings after executing a
-loaded command file, or to return to a defined state after lots of
-settings have been changed.
-
-   The following are _not_ affected by *note reset:::
-          `set term` *note output:: *note loadpath:: `set linetype` *note fit::
-          *note encoding:: *note decimalsign:: *note locale:: *note psdir::
-          *note overflow:: *note multiplot::
-
-
-   Note that *note reset:: does not necessarily return settings to the
-state they were in at program entry, because the default values may have
-been altered by commands in the initialization files gnuplotrc,
-$HOME/.gnuplot, or $XDG_CONFIG_HOME/gnuplot/gnuplotrc.  However, these
-commands can be re-executed by using the variant command 'reset
-session'.
-
-   'reset session' deletes any user-defined variables and functions,
-restores default settings, and then re-executes the system-wide
-gnuplotrc initialization file and any private $HOME/.gnuplot or
-$XDG_CONFIG_HOME/gnuplot/gnuplotrc preferences file.  See
-'initialization'.
-
-   'reset errors' clears only the error state variables GPVAL_ERRNO and
-GPVAL_ERRMSG.
-
-   'reset bind' restores all hotkey bindings to their default state.
-
-
-File: gnuplot.info,  Node: return,  Next: save,  Prev: reset,  Up: Commands
-
-3.31 return
-===========
-
-Syntax:
-          return <expression>
-
-
-   The *note return:: command acts the same way as the *note exit:: and
-*note quit:: commands in that it terminates execution of the current
-code block or input stream.  The return value is meaningful only in the
-context of executing code in a function block.  See 'function blocks'.
-
-   Example:
-          function $myfun << EOF
-          local result = 0
-          if (error-condition) { return -1 }
-          ... body of function ...
-          return result
-          EOF
-
-
-
-File: gnuplot.info,  Node: save,  Next: set-show,  Prev: return,  Up: Commands
-
-3.32 save
-=========
-
-Syntax:
-           save  {functions | variables | terminal | set | fit | datablocks}
-                 '<filename>' {append}
-
-
-   If no option is specified, 'gnuplot' saves functions, user variables,
-'set' options and the most recent 'plot' or 'splot' command.  The
-current status of 'set term' and *note output:: is written as a comment.
-
-   Saved files are written in text format and may be read by the 'load'
-command.
-
-   *note terminal:: will write out just the *note terminal:: status,
-without the comment marker in front of it.  This is mainly useful for
-switching the *note terminal:: setting for a short while, and getting
-back to the previously set terminal, afterwards, by loading the saved
-*note terminal:: status.  Note that for a single gnuplot session you may
-rather use the other method of saving and restoring current terminal by
-the commands 'set term push' and 'set term pop', see 'set term'.
-
-   'save variables' writes all user variables but not datablocks and not
-internal variables GPVAL_* GPFUN_* MOUSE_* ARG*.
-
-   *note fit:: saves only the variables used in the most recent *note
-fit:: command.  The saved file may be used as a parameter file to
-initialize future fit commands using the 'via' keyword.
-
-   The filename must be enclosed in quotes.
-
-   The special filename "-" may be used to *note save:: commands to
-standard output.  On systems which support a popen function (Unix), the
-output of save can be piped through an external program by starting the
-file name with a '|'.  This provides a consistent interface to
-'gnuplot''s internal settings to programs which communicate with
-'gnuplot' through a pipe.  Please see help for 'batch/interactive' for
-more details.
-
-   Examples:
-           save 'work.gnu'
-           save functions 'func.dat'
-           save var 'state.dat'; save datablocks 'state.dat' append
-           save set 'options.dat'
-           save term 'myterm.gnu'
-           save '-'
-           save '|grep title >t.gp'
-
-
-
-File: gnuplot.info,  Node: set-show,  Next: shell,  Prev: save,  Up: Commands
-
-3.33 set-show
-=============
-
-The 'set' command can be used to set _lots_ of options.  No new graph is
-drawn, however, until a 'plot', 'splot', or *note replot:: command is
-given.
-
-   For most options the corresponding 'show' command reports the current
-setting.  A few 'show' commands like *note palette:: and *note
-colornames:: are documented separately.
-
-   Options changed using 'set' can be returned to the default state by
-giving the corresponding *note unset:: command.  See also the *note
-reset:: command, which returns all settable parameters to default
-values.
-
-   The 'set' and *note unset:: commands may optionally contain an
-iteration clause.  See 'plot for'.
-
-* Menu:
-
-* angles::
-* arrow::
-* autoscale::
-* bind_::
-* bmargin::
-* border::
-* boxwidth::
-* boxdepth::
-* chi_shapes::
-* color::
-* colormap::
-* colorsequence::
-* clabel::
-* clip::
-* cntrlabel::
-* cntrparam::
-* color_box::
-* colornames::
-* contour::
-* cornerpoles::
-* contourfill_::
-* dashtype_::
-* datafile::
-* decimalsign::
-* dgrid3d::
-* dummy::
-* encoding::
-* errorbars::
-* fit_::
-* fontpath::
-* format__::
-* grid::
-* hidden3d::
-* history_::
-* isosamples::
-* isosurface_::
-* isotropic::
-* jitter::
-* key_::
-* label::
-* linetype::
-* link::
-* lmargin::
-* loadpath::
-* locale::
-* logscale::
-* macros::
-* mapping::
-* margin::
-* micro::
-* minussign::
-* monochrome::
-* mouse::
-* mttics::
-* multiplot::
-* mx2tics::
-* mxtics::
-* my2tics::
-* mytics::
-* mztics::
-* nonlinear::
-* object::
-* offsets::
-* origin::
-* output::
-* overflow::
-* palette__::
-* parametric_::
-* paxis::
-* pixmap::
-* pm3d::
-* pointintervalbox::
-* pointsize::
-* polar::
-* print_::
-* psdir::
-* raxis::
-* rgbmax::
-* rlabel::
-* rmargin::
-* rrange::
-* rtics::
-* samples::
-* size::
-* spiderplot_::
-* style::
-* surface_::
-* table::
-* terminal::
-* termoption::
-* theta::
-* tics::
-* ticslevel::
-* ticscale::
-* timestamp::
-* timefmt::
-* title_::
-* tmargin::
-* trange::
-* ttics::
-* urange::
-* version::
-* vgrid::
-* view::
-* vrange::
-* vxrange::
-* vyrange::
-* vzrange::
-* walls::
-* watchpoints::
-* x2data::
-* x2dtics::
-* x2label::
-* x2mtics::
-* x2range::
-* x2tics::
-* x2zeroaxis::
-* xdata::
-* xdtics::
-* xlabel::
-* xmtics::
-* xrange::
-* xtics::
-* xyplane::
-* xzeroaxis::
-* y2data::
-* y2dtics::
-* y2label::
-* y2mtics::
-* y2range::
-* y2tics::
-* y2zeroaxis::
-* ydata::
-* ydtics::
-* ylabel::
-* ymtics::
-* yrange::
-* ytics::
-* yzeroaxis::
-* zdata::
-* zdtics::
-* zzeroaxis::
-* cbdata::
-* cbdtics::
-* zero::
-* zeroaxis::
-* zlabel::
-* zmtics::
-* zrange::
-* ztics::
-* cblabel::
-* cbmtics::
-* cbrange::
-* cbtics::
-
-
-File: gnuplot.info,  Node: angles,  Next: arrow,  Prev: set-show,  Up: set-show
-
-3.33.1 angles
--------------
-
-By default, 'gnuplot' assumes the independent variable in polar graphs
-is in units of radians.  If 'set angles degrees' is specified before
-'set polar', then the default range is [0:360] and the independent
-variable has units of degrees.  This is particularly useful for plots of
-data files.  The angle setting also applies to 3D mapping as set via the
-*note mapping:: command.
-
-   Syntax:
-           set angles {degrees | radians}
-           show angles
-
-
-   The angle specified in 'set grid polar' is also read and displayed in
-the units specified by *note angles::.
-
-   *note angles:: also affects the arguments of the machine-defined
-functions sin(x), cos(x) and tan(x), and the outputs of asin(x),
-acos(x), atan(x), atan2(x), and arg(x).  It has no effect on the
-arguments of hyperbolic functions or Bessel functions.  However, the
-output arguments of inverse hyperbolic functions of complex arguments
-are affected; if these functions are used, 'set angles radians' must be
-in effect to maintain consistency between input and output arguments.
-
-           x={1.0,0.1}
-           set angles radians
-           y=sinh(x)
-           print y         #prints {1.16933, 0.154051}
-           print asinh(y)  #prints {1.0, 0.1}
-
-   but
-           set angles degrees
-           y=sinh(x)
-           print y         #prints {1.16933, 0.154051}
-           print asinh(y)  #prints {57.29578, 5.729578}
-
-   See also poldat.dem: polar plot using angles demo.
-(http://www.gnuplot.info/demo/poldat.html)
-
-
-File: gnuplot.info,  Node: arrow,  Next: autoscale,  Prev: angles,  Up: set-show
-
-3.33.2 arrow
-------------
-
-Arbitrary arrows can be placed on a plot using the 'set arrow' command.
-
-   Syntax:
-           set arrow {<tag>} from <position> to <position>
-           set arrow {<tag>} from <position> rto <position>
-           set arrow {<tag>} from <position> length <coord> angle <ang>
-           set arrow <tag> arrowstyle | as <arrow_style>
-           set arrow <tag> {nohead | head | backhead | heads}
-                           {size <headlength>,<headangle>{,<backangle>}} {fixed}
-                           {filled | empty | nofilled | noborder}
-                           {front | back}
-                           {linestyle | ls <line_style>}
-                           {linetype | lt <line_type>}
-                           {linewidth | lw <line_width>}
-                           {linecolor | lc <colorspec>}
-                           {dashtype | dt <dashtype>}
-
-
-           unset arrow {<tag>}
-           show arrow {<tag>}
-
-
-   <tag> is an integer that identifies the arrow.  If no tag is given,
-the lowest unused tag value is assigned automatically.  The tag can be
-used to delete or change a specific arrow.  To change any attribute of
-an existing arrow, use 'set arrow' with the appropriate tag and specify
-the attributes to be changed.
-
-   The position of the first end point of the arrow is always specified
-by "from".  The other end point can be specified using any of three
-different mechanisms.  The <position>s are specified by either x,y or
-x,y,z, and may be preceded by 'first', 'second', 'graph', 'screen', or
-'character' to select the coordinate system.  Unspecified coordinates
-default to 0.  See 'coordinates' for details.  A coordinate system
-specifier does not carry over from the first endpoint description the
-second.
-
-   1) "to <position>" specifies the absolute coordinates of the other
-end.
-
-   2) "rto <position>" specifies an offset to the "from" position.  For
-linear axes, 'graph' and 'screen' coordinates, the distance between the
-start and the end point corresponds to the given relative coordinate.
-For logarithmic axes, the relative given coordinate corresponds to the
-factor of the coordinate between start and end point.  Thus, a negative
-relative value or zero are not allowed for logarithmic axes.
-
-   3) "length <coordinate> angle <angle>" specifies the orientation of
-the arrow in the plane of the graph.  Again any of the coordinate
-systems can be used to specify the length.  The angle is always in
-degrees.
-
-   Other characteristics of the arrow can either be specified as a
-pre-defined arrow style or by providing them in 'set arrow' command.
-For a detailed explanation of arrow characteristics, see 'arrowstyle'.
-
-   Examples:
-
-   To set an arrow pointing from the origin to (1,2) with user-defined
-linestyle 5, use:
-           set arrow to 1,2 ls 5
-
-
-   To set an arrow from bottom left of plotting area to (-5,5,3), and
-tag the arrow number 3, use:
-           set arrow 3 from graph 0,0 to -5,5,3
-
-
-   To change the preceding arrow to end at 1,1,1, without an arrow head
-and double its width, use:
-           set arrow 3 to 1,1,1 nohead lw 2
-
-
-   To draw a vertical line from the bottom to the top of the graph at
-x=3, use:
-           set arrow from 3, graph 0 to 3, graph 1 nohead
-
-
-   To draw a vertical arrow with T-shape ends, use:
-           set arrow 3 from 0,-5 to 0,5 heads size screen 0.1,90
-
-
-   To draw an arrow relatively to the start point, where the relative
-distances are given in graph coordinates, use:
-           set arrow from 0,-5 rto graph 0.1,0.1
-
-
-   To draw an arrow with relative end point in logarithmic x axis, use:
-           set logscale x
-           set arrow from 100,-5 rto 10,10
-
-   This draws an arrow from 100,-5 to 1000,5.  For the logarithmic x
-axis, the relative coordinate 10 means "factor 10" while for the linear
-y axis, the relative coordinate 10 means "difference 10".
-
-   To delete arrow number 2, use:
-           unset arrow 2
-
-
-   To delete all arrows, use:
-           unset arrow
-
-
-   To show all arrows (in tag order), use:
-           show arrow
-
-
-   arrows demos.  (http://www.gnuplot.info/demo/arrowstyle.html)
-
-
-File: gnuplot.info,  Node: autoscale,  Next: bind_,  Prev: arrow,  Up: set-show
-
-3.33.3 autoscale
-----------------
-
-Autoscaling may be set individually on the x, y or z axis or globally on
-all axes.  The default is to autoscale all axes.  If you want to
-autoscale based on a subset of the plots in the figure, you can mark the
-ones to be omitted with the flag 'noautoscale' in the plot command.  See
-*note datafile::.
-
-   Syntax:
-           set autoscale {<axis>{|min|max|fixmin|fixmax|fix} | fix | keepfix}
-           set autoscale noextend
-           unset autoscale {<axis>}
-           show autoscale
-
-
-   where <axis> is 'x', 'y', 'z', 'cb', 'x2', 'y2', 'xy', or 'paxis
-<p>'.  Appending 'min' or 'max' to the axis name tells 'gnuplot' to
-autoscale only the minimum or maximum of that axis.
-
-   If no axis name is given, all axes are autoscaled.
-
-   Autoscaling the independent axes (x for 'plot' and x,y for 'splot')
-adjusts the axis range to match the data being plotted.  If the plot
-contains only functions (no input data), autoscaling these axes has no
-effect.
-
-   Autoscaling the dependent axis (y for a 'plot' and z for 'splot')
-adjusts the axis range to match the data or function being plotted.
-
-   Adjustment of the axis range includes extending it to the next tic
-mark; i.e.  unless the extreme data coordinate exactly matches a tic
-mark, there will be some blank space between the data and the plot
-border.  Addition of this extra space can be suppressed by *note
-noextend::.  It can be further increased by the command 'set offset'.
-Please see *note xrange:: and *note offsets:: for additional
-information.
-
-   The behavior of autoscaling remains consistent in parametric mode,
-(see *note parametric::).  However, there are more dependent variables
-and hence more control over x, y, and z axis scales.  In parametric
-mode, the independent or dummy variable is t for 'plot's and u,v for
-'splot's.  *note autoscale:: in parametric mode, then, controls all
-ranges (t, u, v, x, y, and z) and allows x, y, and z to be fully
-autoscaled.
-
-   When tics are displayed on second axes but no plot has been specified
-for those axes, x2range and y2range are inherited from xrange and
-yrange.  This is done _before_ applying offsets or autoextending the
-ranges to a whole number of tics, which can cause unexpected results.
-To prevent this you can explicitly link the secondary axis range to the
-primary axis range.  See *note link::.
-
-* Menu:
-
-* noextend::
-* examples::
-* polar_mode::
-
-
-File: gnuplot.info,  Node: noextend,  Next: examples,  Prev: autoscale,  Up: autoscale
-
-3.33.3.1 noextend
-.................
-
-          set autoscale noextend
-
-
-   By default autoscaling sets the axis range limits to the nearest tic
-label position that includes all the plot data.  Keywords 'fixmin',
-'fixmax', 'fix' or *note noextend:: tell gnuplot to disable extension of
-the axis range to the next tic mark position.  In this case the axis
-range limit exactly matches the coordinate of the most extreme data
-point.  *note noextend:: is a synonym for 'set autoscale fix'.  Range
-extension for a single axis can be disabled by appending the *note
-noextend:: keyword to the corresponding range command, e.g.
-          set yrange [0:*] noextend
-
-
-   'set autoscale keepfix' autoscales all axes while leaving the fix
-settings unchanged.
-
-
-File: gnuplot.info,  Node: examples,  Next: polar_mode,  Prev: noextend,  Up: autoscale
-
-3.33.3.2 examples
-.................
-
-Examples:
-
-   This sets autoscaling of the y axis (other axes are not affected):
-           set autoscale y
-
-
-   This sets autoscaling only for the minimum of the y axis (the maximum
-of the y axis and the other axes are not affected):
-           set autoscale ymin
-
-
-   This disables extension of the x2 axis tics to the next tic mark,
-thus keeping the exact range as found in the plotted data and functions:
-           set autoscale x2fixmin
-           set autoscale x2fixmax
-
-
-   This sets autoscaling of the x and y axes:
-           set autoscale xy
-
-
-   This sets autoscaling of the x, y, z, x2 and y2 axes:
-           set autoscale
-
-
-   This disables autoscaling of the x, y, z, x2 and y2 axes:
-           unset autoscale
-
-
-   This disables autoscaling of the z axis only:
-           unset autoscale z
-
-
-
-File: gnuplot.info,  Node: polar_mode,  Prev: examples,  Up: autoscale
-
-3.33.3.3 polar mode
-...................
-
-When in polar mode ('set polar'), the xrange and the yrange may be left
-in autoscale mode.  If *note rrange:: is used to limit the extent of the
-polar axis, then xrange and yrange will adjust to match this
-automatically.  However, explicit xrange and yrange commands can later
-be used to make further adjustments.  See *note rrange::.
-
-   See also polar demos.  (http://www.gnuplot.info/demo/poldat.html)
-
-
-File: gnuplot.info,  Node: bind_,  Next: bmargin,  Prev: autoscale,  Up: set-show
-
-3.33.4 bind
------------
-
-'show bind' shows the current state of all hotkey bindings.  See 'bind'.
-
-
-File: gnuplot.info,  Node: bmargin,  Next: border,  Prev: bind_,  Up: set-show
-
-3.33.5 bmargin
---------------
-
-The command *note bmargin:: sets the size of the bottom margin.  Please
-see *note margin:: for details.
-
-
-File: gnuplot.info,  Node: border,  Next: boxwidth,  Prev: bmargin,  Up: set-show
-
-3.33.6 border
--------------
-
-The *note border:: and *note border:: commands control the display of
-the graph borders for the 'plot' and 'splot' commands.  Note that the
-borders do not necessarily coincide with the axes; with 'plot' they
-often do, but with 'splot' they usually do not.
-
-   Syntax:
-           set border {<integer>}
-                      {front | back | behind}
-                      {linestyle | ls <line_style>}
-                      {linetype | lt <line_type>} {linewidth | lw <line_width>}
-                      {linecolor | lc <colorspec>} {dashtype | dt <dashtype>}
-                      {polar}
-           unset border
-           show border
-
-
-   With a 'splot' displayed in an arbitrary orientation, like 'set view
-56,103', the four corners of the x-y plane can be referred to as
-"front", "back", "left" and "right".  A similar set of four corners
-exist for the top surface, of course.  Thus the border connecting, say,
-the back and right corners of the x-y plane is the "bottom right back"
-border, and the border connecting the top and bottom front corners is
-the "front vertical".  (This nomenclature is defined solely to allow the
-reader to figure out the table that follows.)
-
-   The borders are encoded in a 12-bit integer: the four low bits
-control the border for 'plot' and the sides of the base for 'splot'; the
-next four bits control the verticals in 'splot'; the four high bits
-control the edges on top of an 'splot'.  The border settings is thus the
-sum of the appropriate entries from the following table:
-
-                 Bit     plot        splot
-                   1   bottom      bottom left front
-                   2   left        bottom left back
-                   4   top         bottom right front
-                   8   right       bottom right back
-                  16   no effect   left vertical
-                  32   no effect   back vertical
-                  64   no effect   right vertical
-                 128   no effect   front vertical
-                 256   no effect   top left back
-                 512   no effect   top right back
-                1024   no effect   top left front
-                2048   no effect   top right front
-                4096   polar       no effect
-
-
-   The default setting is 31, which is all four sides for 'plot', and
-base and z axis for 'splot'.
-
-   Separate from the four vertical lines in a 3D border, the 'splot'
-command by default draws a vertical line each corner of a surface to the
-base plane of the plot.  These verticals are not controlled by *note
-border::.  Instead use *note cornerpoles::.
-
-   In 2D plots the border is normally drawn on top of all plots elements
-('front').  If you want the border to be drawn behind the plot elements,
-use 'set border back'.
-
-   In hidden3d plots the lines making up the border are normally subject
-to the same hidden3d processing as the plot elements.  'set border
-behind' will override this default.
-
-   Using the optional <linestyle>, <linetype>, <linewidth>, <linecolor>,
-and <dashtype> specifiers, the way the border lines are drawn can be
-influenced (limited by what the current terminal driver supports).
-Besides the border itself, this line style is used for the tics,
-independent of whether they are plotted on the border or on the axes
-(see 'set xtics').
-
-   For 'plot', tics may be drawn on edges other than bottom and left by
-enabling the second axes - see 'set xtics' for details.
-
-   If a 'splot' draws only on the base, as is the case with "'unset
-surface; set contour base'", then the verticals and the top are not
-drawn even if they are specified.
-
-   The 'set grid' options 'back', 'front' and 'layerdefault' also
-control the order in which the border lines are drawn with respect to
-the output of the plotted data.
-
-   The 'polar' keyword enables a circular border for polar plots.
-
-   Examples:
-
-   Draw default borders:
-           set border
-
-
-   Draw only the left and bottom ('plot') or both front and back bottom
-left ('splot') borders:
-           set border 3
-
-
-   Draw a complete box around a 'splot':
-           set border 4095
-
-
-   Draw a topless box around a 'splot', omitting the front vertical:
-           set border 127+256+512 # or set border 1023-128
-
-
-   Draw only the top and right borders for a 'plot' and label them as
-axes:
-           unset xtics; unset ytics; set x2tics; set y2tics; set border 12
-
-
-
-File: gnuplot.info,  Node: boxwidth,  Next: boxdepth,  Prev: border,  Up: set-show
-
-3.33.7 boxwidth
----------------
-
-The *note boxwidth:: command is used to set the default width of boxes
-in the *note boxes::, *note boxerrorbars::, *note boxplot::, *note
-candlesticks:: and *note histograms:: styles.
-
-   Syntax:
-           set boxwidth {<width>} {absolute|relative}
-           show boxwidth
-
-
-   By default, adjacent boxes are extended in width until they touch
-each other.  A different default width may be specified using the *note
-boxwidth:: command.  'Relative' widths are interpreted as being a
-fraction of this default width.
-
-   An explicit value for the boxwidth is interpreted as being a number
-of units along the current x axis ('absolute') unless the modifier
-'relative' is given.  If the x axis is a log-scale (see 'set log') then
-the value of boxwidth is truly "absolute" only at x=1; this physical
-width is maintained everywhere along the axis (i.e.  the boxes do not
-become narrower the value of x increases).  If the range spanned by a
-log scale x axis is far from x=1, some experimentation may be required
-to find a useful value of boxwidth.
-
-   The default is superseded by explicit width information taken from an
-extra data column in styles *note boxes:: or *note boxerrorbars::.  See
-*note boxes:: and *note boxerrorbars:: for more details.
-
-   To set the box width to automatic use the command
-           set boxwidth
-
-
-   To set the box width to half of the automatic size use
-           set boxwidth 0.5 relative
-
-
-   To set the box width to an absolute value of 2 use
-           set boxwidth 2 absolute
-
-
-
-File: gnuplot.info,  Node: boxdepth,  Next: chi_shapes,  Prev: boxwidth,  Up: set-show
-
-3.33.8 boxdepth
----------------
-
-          set boxdepth {<y extent>} | square
-
-   The *note boxdepth:: command affects only 3D plots created by *note
-boxes::.  It sets the extent of each box along the y axis, i.e.  its
-thickness.  'set boxdepth square' will try to choose a y extent that
-gives the appearance of a square cross section independent of the axis
-scales on x and y.
-
-
-File: gnuplot.info,  Node: chi_shapes,  Next: color,  Prev: boxdepth,  Up: set-show
-
-3.33.9 chi_shapes
------------------
-
-          set chi_shapes fraction <value>
-          unset chi_shapes
-
-
-   The concave hull filter creates χ-shapes defined by a characteristic
-length chi_length.  If no chi_length variable has been set, it chooses a
-value equal to a fraction of the longest edge in the bounding polygon
-(the convex hull).  The fraction defaults to 0.6 but can be changed
-using this command.  Choosing a value of 1.0 will reduce the resulting
-hull to the convex hull.  Smaller values will produce increasingly
-concave hulls.  See 'concavehull'.  The *note chi_shapes:: command
-restores the fraction to 0.6 and undefines the chi_length variable.
-
-
-File: gnuplot.info,  Node: color,  Next: colormap,  Prev: chi_shapes,  Up: set-show
-
-3.33.10 color
--------------
-
-Gnuplot assigns each element of a 'plot' or 'splot' command a new set of
-line properties taken from a predefined sequence.  The default is to
-distinguish successive lines by a change in color.  The alternative
-selected by *note monochrome:: uses a sequence of black lines
-distinguished by linewidth or dot/dash pattern.  The 'set color' command
-exits this alternative monochrome mode and restores the previous set of
-default color lines.  See *note monochrome::, 'set linetype', and *note
-colorsequence::.
-
-
-File: gnuplot.info,  Node: colormap,  Next: colorsequence,  Prev: color,  Up: set-show
-
-3.33.11 colormap
-----------------
-
-Syntax:
-
-          set colormap new <colormap-name>
-          set colormap <colormap-name> range [<min>:<max>]
-          show colormaps
-
-
-   'set colormap new <name>' creates a colormap array <name> and loads
-it from the current palette settings.  This saved colormap can be
-further manipulated as an array of 32-bit ARGB color values and used by
-name in subsequent plots.
-
-   Here is an example that creates a palette running from dark red to
-white, saves it to a colormap array named 'Reds', and makes all entries
-in the colormap partially transparent.  This named colormap is then used
-later to color a pm3d surface.  Note that the alpha channel value in a
-named colormap follows the convention for ARGB line properties; i.e 0 is
-opaque, 0xff is fully transparent.
-
-          set palette defined (0 "dark-red", 1 "white")
-          set colormap new Reds
-          do for [i=1:|Reds|] { Reds[i] = Reds[i] | 0x3F000000 }
-          splot func(x,y) with pm3d fillcolor palette Reds
-
-
-   The mapping of z values onto the colormap can be tuned by setting
-minimum and maximum z values that correspond to the end points.  For
-example
-
-          set colormap Reds range [0:10]
-
-
-   If no range is set, or if min and max are the same, then the mapping
-uses the current limits of cbrange.  See *note cbrange::.
-
-   A colormap can be used to gradient-fill a rectangular area.  See
-*note colormap::.
-
-
-File: gnuplot.info,  Node: colorsequence,  Next: clabel,  Prev: colormap,  Up: set-show
-
-3.33.12 colorsequence
----------------------
-
-Syntax:
-          set colorsequence {default|classic|podo}
-
-
-   'set colorsequence default' selects a terminal-independent repeating
-sequence of eight colors.  See 'set linetype', 'colors'.
-
-   'set colorsequence classic' lets each separate terminal type provide
-its own sequence of line colors.  The number provided varies from 4 to
-more than 100, but most start with red/green/blue/magenta/cyan/yellow.
-This was the default behaviour prior to version 5.
-
-   'set colorsequence podo' selects eight colors drawn from a set
-recommended by Wong (2011) [Nature Methods 8:441] as being easily
-distinguished by color-blind viewers with either protanopia or
-deuteranopia.
-
-   In each case you can further customize the length of the sequence and
-the colors used.  See 'set linetype', 'colors'.
-
-
-File: gnuplot.info,  Node: clabel,  Next: clip,  Prev: colorsequence,  Up: set-show
-
-3.33.13 clabel
---------------
-
-This command has been deprecated.  Use *note cntrlabel:: instead.  'set
-clabel "format"' is replaced by 'set cntrlabel format "format"'.  *note
-clabel:: is replaced by 'set cntrlabel onecolor'.
-
-
-File: gnuplot.info,  Node: clip,  Next: cntrlabel,  Prev: clabel,  Up: set-show
-
-3.33.14 clip
-------------
-
-Syntax:
-           set clip {points|one|two|radial}
-           unset clip {points|one|two|radial}
-           show clip
-
-
-   Default state:
-           unset clip points
-           set clip one
-           unset clip two
-           unset clip radial
-
-
-   Data points whose center lies inside the plot boundaries are normally
-drawn even if the finite size of the point symbol causes it to extend
-past a boundary line.  'set clip points' causes such points to be
-clipped (i.e.  not drawn) even though the point center is inside the
-boundaries of a 2D plot.  Data points whose center lies outside the plot
-boundaries are never drawn.
-
-   'unset clip' causes a line segment in a plot not to be drawn if
-either end of that segment lies outside the plot boundaries (i.e.
-xrange and yrange).
-
-   'set clip one' causes 'gnuplot' to draw the in-range portion of line
-segments with one endpoint in range and one endpoint out of range.  'set
-clip two' causes 'gnuplot' to draw the in-range portion of line segments
-with both endpoints out of range.  Line segments that lie entirely
-outside the plot boundaries are never drawn.
-
-   'set clip radial' affects plotting only in polar mode.  It clips
-lines against the radial bound established by 'set rrange [0:MAX]'. This
-criteria is applied in conjunction with 'set clip {one|two}'.  I.e.  the
-portion of a line between two points with R > RMAX that passes through
-the circle R = RMAX is drawn only if both 'clip two' and 'clip radial'
-are set.
-
-   Notes:
-
-   * 'set clip' affects only points and lines produced by plot styles
-'lines', *note linespoints::, 'points', 'arrows', and *note vectors::.
-
-   * Clipping of colored quadrangles drawn for pm3d surfaces and other
-solid objects is controlled *note clipping::.  The default is smooth
-clipping against the current zrange.
-
-   * Object clipping is controlled by the 'clip' or 'noclip' property of
-the individual object.
-
-   * In the current version of gnuplot, "plot with vectors" in polar
-mode does not test or clip against the maximum radius.
-
-
-File: gnuplot.info,  Node: cntrlabel,  Next: cntrparam,  Prev: clip,  Up: set-show
-
-3.33.15 cntrlabel
------------------
-
-Syntax:
-           set cntrlabel {format "format"} {font "font"}
-           set cntrlabel {start <int>} {interval <int>}
-           set cntrlabel onecolor
-
-
-   *note cntrlabel:: controls the labeling of contours, either in the
-key (default) or on the plot itself in the case of *note labels::.  In
-the latter case labels are placed along each contour line according to
-the 'pointinterval' or 'pointnumber' property of the label descriptor.
-By default a label is placed on the 5th line segment making up the
-contour line and repeated every 20th segment.  These defaults are
-equivalent to
-           set cntrlabel start 5 interval 20
-
-   They can be changed either via the *note cntrlabel:: command or by
-specifying the interval in the 'splot' command itself
-           set contours; splot $FOO with labels point pointinterval -1
-
-   Setting the interval to a negative value means that the label appear
-only once per contour line.  However if *note samples:: or *note
-isosamples:: is large then many contour lines may be created, each with
-a single label.
-
-   A contour label is placed in the plot key for each linetype used.  By
-default each contour level is given its own linetype, so a separate
-label appears for each.  The command 'set cntrlabel onecolor' causes all
-contours to be drawn using the same linetype, so only one label appears
-in the plot key.  This command replaces an older command *note clabel::.
-
-
-File: gnuplot.info,  Node: cntrparam,  Next: color_box,  Prev: cntrlabel,  Up: set-show
-
-3.33.16 cntrparam
------------------
-
-*note cntrparam:: controls the generation of contours and their
-smoothness for a contour plot.  'show contour' displays current settings
-of *note cntrparam:: as well as 'contour'.
-
-   Syntax:
-           set cntrparam { { linear
-                           | cubicspline
-                           | bspline
-                           | points <n>
-                           | order <n>
-                           | levels { <n>
-                                      | auto {<n>}
-                                      | discrete <z1> {,<z2>{,<z3>...}}
-                                      | incremental <start>, <incr> {,<end>}
-                                    }
-                             {{un}sorted}
-                             {firstlinetype N}
-                           }
-                         }
-           show contour
-
-
-   This command has two functions.  First, it sets the values of z for
-which contours are to be determined.  The number of contour levels <n>
-should be an integral constant expression.  <z1>, <z2> ...  are
-real-valued expressions.  Second, it controls the appearance of the
-individual contour lines.
-
-   Keywords controlling the smoothness of contour lines:
-
-   'linear', 'cubicspline', 'bspline'-- Controls type of approximation
-or interpolation.  If 'linear', then straight line segments connect
-points of equal z magnitude.  If 'cubicspline', then piecewise-linear
-contours are interpolated between the same equal z points to form
-somewhat smoother contours, but which may undulate.  If 'bspline', a
-guaranteed-smoother curve is drawn, which only approximates the position
-of the points of equal-z.
-
-   'points'-- Eventually all drawings are done with piecewise-linear
-strokes.  This number controls the number of line segments used to
-approximate the 'bspline' or 'cubicspline' curve.  Number of cubicspline
-or bspline segments (strokes) = 'points' * number of linear segments.
-
-   'order'-- Order of the bspline approximation to be used.  The bigger
-this order is, the smoother the resulting contour.  (Of course, higher
-order bspline curves will move further away from the original piecewise
-linear data.)  This option is relevant for 'bspline' mode only.  Allowed
-values are integers in the range from 2 (linear) to 10.
-
-   Keywords controlling the selection of contour levels:
-
-   'levels auto'-- This is the default.  <n> specifies a nominal number
-of levels; the actual number will be adjusted to give simple labels.  If
-the surface is bounded by zmin and zmax, contours will be generated at
-integer multiples of dz between zmin and zmax, where dz is 1, 2, or 5
-times some power of ten (like the step between two tic marks).
-
-   'levels discrete'-- Contours will be generated at z = <z1>, <z2> ...
-as specified; the number of discrete levels sets the number of contour
-levels.  In 'discrete' mode, any 'set cntrparam levels <n>' are ignored.
-
-   'levels incremental'-- Contours are generated at values of z
-beginning at <start> and increasing by <increment>, until the number of
-contours is reached.  <end> is used to determine the number of contour
-levels, which will be changed by any subsequent 'set cntrparam levels
-<n>'.  If the z axis is logarithmic, <increment> will be interpreted as
-a multiplicative factor, as it is for *note ztics::, and <end> should
-not be used.
-
-   Keywords controlling the assignment of linetype to contours:
-
-   By default the contours are generated in the reverse order specified
-('unsorted').  Thus 'set cntrparam levels increment 0, 10, 100' will
-create 11 contours levels starting with 100 and ending with 0.  Adding
-the keyword 'sorted' re-orders the contours by increasing numerical
-value, which in this case would mean the first contour is drawn at 0.
-
-   By default contours are drawn using successive linetypes starting
-with the next linetype after that used for the corresponding surface.
-Thus 'splot x*y lt 5' would use lt 6 for the first contour generated.
-If *note hidden3d:: mode is active then each surface uses two linetypes.
-In this case using default settings would cause the first contour to use
-the same linetype as the hidden surface, which is undesirable.  This can
-be avoided in either of two ways.  (1) Use 'set hidden3d offset N' to
-change the linetype used for the hidden surface.  A good choice would be
-'offset -1' since that will avoid all the contour linetypes.  (2) Use
-the 'set cntrparam firstlinetype N' option to specify a block of
-linetypes used for contour lines independent of whatever was used for
-the surface.  This is particularly useful if you want to customize the
-set of contour linetypes.  N <= 0 restores the default.
-
-   If the command *note cntrparam:: is given without any arguments
-specified all options are reset to the default:
-           set cntrparam order 4 points 5
-           set cntrparam levels auto 5 unsorted
-           set cntrparam firstlinetype 0
-
-
-* Menu:
-
-* Examples_::
-
-
-File: gnuplot.info,  Node: Examples_,  Prev: cntrparam,  Up: cntrparam
-
-3.33.16.1 Examples
-..................
-
-Examples:
-           set cntrparam bspline
-           set cntrparam points 7
-           set cntrparam order 10
-
-
-   To select levels automatically, 5 if the level increment criteria are
-met:
-           set cntrparam levels auto 5
-
-
-   To specify discrete levels at .1, .37, and .9:
-           set cntrparam levels discrete .1,1/exp(1),.9
-
-
-   To specify levels from 0 to 4 with increment 1:
-           set cntrparam levels incremental  0,1,4
-
-
-   To set the number of levels to 10 (changing an incremental end or
-possibly the number of auto levels):
-           set cntrparam levels 10
-
-
-   To set the start and increment while retaining the number of levels:
-           set cntrparam levels incremental 100,50
-
-
-   To define and use a customized block of contour linetypes
-           set linetype 100 lc "red" dt '....'
-           do for [L=101:199] {
-               if (L%10 == 0) {
-                   set linetype L lc "black" dt solid lw 2
-               } else {
-                   set linetype L lc "gray" dt solid lw 1
-               }
-           }
-           set cntrparam firstlinetype 100
-           set cntrparam sorted levels incremental 0, 1, 100
-
-
-   See also 'set contour' for control of where the contours are drawn,
-and *note cntrlabel:: for control of the format of the contour labels
-and linetypes.
-
-   See also contours demo (contours.dem)
-(http://www.gnuplot.info/demo/contours.html) and contours with user
-defined levels demo (discrete.dem).
-(http://www.gnuplot.info/demo/discrete.html) D contours 5 D discrete 3
-
-
-File: gnuplot.info,  Node: color_box,  Next: colornames,  Prev: cntrparam,  Up: set-show
-
-3.33.17 color box
------------------
-
-For plots that use palette coloring, in particular pm3d plots, the
-palette gradient is drawn in a color box next to the plot unless it is
-switched off by 'unset colorbox'.
-
-           set colorbox
-           set colorbox {
-                      { vertical | horizontal } {{no}invert}
-                      { default | bottom | user }
-                      { origin x, y }
-                      { size x, y }
-                      { front | back }
-                      { noborder | bdefault | border [line style] }
-                    }
-           show colorbox
-           unset colorbox
-
-
-   The orientation of the color gradient is set by 'vertical' or
-'horizontal'.
-
-   The color box position can be 'default' or 'bottom' or 'user'.  The
-'bottom' keyword is a convenience short cut equivalent to
-
-          set colorbox horizontal user origin screen 0.1, 0.07 size 0.8, 0.03.
-
-
-   If the colorbox is placed underneath the plot, as it is with
-'bottom', it may be useful to reserve additional space for it: 'set
-bmargin screen 0.2'.
-
-   'origin x, y' and 'size x, y' are used to tailor the exact placement
-in 'user' or 'bottom' positioning.  The x and y values are interpreted
-as screen coordinates by default, and this is the only legal option for
-3D plots.  2D plots, including splot with 'set view map', allow any
-coordinate system.
-
-   'back'/'front' control whether the color box is draw before or after
-the plot.
-
-   *note border:: turns the border on (this is the default).  'noborder'
-turns the border off.  If an positive integer argument is given after
-*note border::, it is used as a line style tag which is used for drawing
-the border, e.g.:
-         set style line 2604 linetype -1 linewidth .4
-         set colorbox border 2604
-
-   will use line style '2604', a thin line with the default border color
-(-1) for drawing the border.  'bdefault' (which is the default) will use
-the default border line style for drawing the border of the color box.
-
-   The axis of the color box is called 'cb' and it is controlled by
-means of the usual axes commands, i.e.  'set/unset/show' with *note
-cbrange::, '[m]cbtics', 'format cb', 'grid [m]cb', *note cblabel::, and
-perhaps even *note cbdata::, '[no]cbdtics', '[no]cbmtics'.
-
-   'set colorbox' without any parameter switches the position to
-default.  'unset colorbox' resets the default parameters for the
-colorbox and switches the colorbox off.
-
-   See also help for 'set pm3d', *note palette::, and 'set style line'.
-
-
-File: gnuplot.info,  Node: colornames,  Next: contour,  Prev: color_box,  Up: set-show
-
-3.33.18 colornames
-------------------
-
-Gnuplot knows a limited number of color names.  You can use these to
-define the color range spanned by a pm3d palette, to assign a named
-color to a particular linetype or linestyle, or to define a gradient for
-the current color palette.  Use the command *note colornames:: to list
-the known color names together with their RGB component definitions.
-Examples:
-           set style line 1 linecolor "sea-green"
-           set palette defined (0 "dark-red", 1 "white")
-           print sprintf("0x%06x", rgbcolor("dark-green"))
-                 0x006400
-
-
-
-File: gnuplot.info,  Node: contour,  Next: cornerpoles,  Prev: colornames,  Up: set-show
-
-3.33.19 contour
----------------
-
-'set contour' enables placement of contour lines on 3D surfaces.  This
-option is available only for 'splot'.  It requires grid data, e.g.  a
-file in which all the points for a single y-isoline are listed, then all
-the points for the next y-isoline, and so on.  A single blank line
-(containing no characters other than blank spaces) separates one
-y-isoline from the next.  see 'grid_data' for more details.
-
-   If the data is not already gridded, *note dgrid3d:: can be used to
-first create and populate an appropriate grid.
-
-   Syntax:
-           set contour {base | surface | both}
-           unset contour
-           show contour
-
-
-   The three options specify where to draw the contours: 'base' draws
-the contours on the grid base where the x/ytics are placed, 'surface'
-draws the contours on the surfaces themselves, and 'both' draws the
-contours on both the base and the surface.  If no option is provided,
-the default is 'base'.
-
-   See also *note cntrparam:: for the parameters that affect the drawing
-of contours, and *note cntrlabel:: for control of labeling of the
-contours.
-
-   Note that this option places lines or labels without otherwise
-changing the appearance of the surface itself.  If you want to recolor
-the surface so that the areas bounded by contour lines are assigned
-distinct colors, use instead the contourfill plot style.  See *note
-contourfill::.
-
-   While 'set contour' is in effect, 'splot with <style>' will place the
-style elements (points, lines, impulses, labels, etc) along the contour
-lines.  'with pm3d' will produce a pm3d surface and also contour lines.
-If you want to mix other plot elements, say labels read from a file,
-with the contours generated while 'set contour' is active you must
-append the keyword 'nocontours' after that clause in the splot command.
-
-   The surface can be switched off (see 'unset surface') to give a
-contour-only graph.  A 2D projection of the contour lines and optional
-labels can be generated by
-
-          set view map
-          splot DATA with lines nosurface, DATA with labels
-
-
-   Older gnuplot versions used an alternative multi-step method to save
-the 3D contour lines into a file or datablock and then plot them using a
-2D plot command as shown below.
-
-           set contour
-           set table $datablock
-           splot DATA with lines nosurface
-           unset table
-           # contour lines are now in $datablock, one contour per index
-           plot for [level=0:*] $datablock index level with lines
-
-
-   See also *note datafile:: and demos for contours (contours.dem)
-(http://www.gnuplot.info/demo/contours.html) and user defined contour
-levels (discrete.dem).  (http://www.gnuplot.info/demo/discrete.html)
-
-
-File: gnuplot.info,  Node: cornerpoles,  Next: contourfill_,  Prev: contour,  Up: set-show
-
-3.33.20 cornerpoles
--------------------
-
-By default splot draws a vertical line from each corner of a 3D surface
-to the base plane.  These vertical lines can be suppressed using *note
-cornerpoles::.
-
-
-File: gnuplot.info,  Node: contourfill_,  Next: dashtype_,  Prev: cornerpoles,  Up: set-show
-
-3.33.21 contourfill
--------------------
-
-The 3D plot style *note contourfill:: slices a pm3d surface into
-sections delimited by a set of planes perpendicular to the z axis.  The
-command *note contourfill:: controls placement of these limiting planes
-and the colors assigned to the individual sections.
-
-   Syntax:
-          set contourfill auto N          # split zrange evenly into N slices
-          set contourfill ztics           # slice at each z axis major tick
-          set contourfill cbtics          # slice at each cb axis major tick
-          set contourfill {palette | firstlinetype N}
-
-
-   The default is *note palette::, which splits the current z range into
-five equal slices (6 bounding planes) and assigns each slice the palette
-mapped color of its midpoint z value.
-
-   The options *note ztics:: or *note cbtics:: place split zrange by
-slicing at major ticks along that axis.  For example to slice
-specifically at z=2.5, z=7 and z=10 you could use the commands below.
-          set ztics add ("floor" 2.5, "boundary X" 7, "ceiling" 10)
-          set contourfill ztics
-
-
-   If you do not want to use palette coloring for the sections, you can
-choose any arbitrary range of successive linetypes and assign them the
-desired color sequence.
-          set for [i=101:110] linetype i lc mycolor[i]
-          set contourfill firstlinetype 101
-
-   *note palette:: restores palette coloring.  D contourfill 3
-
-
-File: gnuplot.info,  Node: dashtype_,  Next: datafile,  Prev: contourfill_,  Up: set-show
-
-3.33.22 dashtype
-----------------
-
-The *note dashtype:: command allows you to define a dash pattern that
-can then be referred to by its index.  This is purely a convenience, as
-anywhere that would accept the dashtype by its numerical index would
-also accept an explicit dash pattern.  Example:
-          set dashtype 5 (2,4,2,6)   # define or redefine dashtype number 5
-          plot f1(x) dt 5            # plot using the new dashtype
-          plot f1(x) dt (2,4,2,6)    # exactly the same plot as above
-          set linetype 5 dt 5        # always use this dash pattern with linetype 5
-          set dashtype 66 "..-"      # define a new dashtype using a string
-
-   See also *note dashtype::.  D dashtypes 2
-
-
-File: gnuplot.info,  Node: datafile,  Next: decimalsign,  Prev: dashtype_,  Up: set-show
-
-3.33.23 datafile
-----------------
-
-The *note datafile:: command options control interpretation of fields
-read from input data files by the 'plot', 'splot', and *note fit::
-commands.  Several options are currently implemented.  The settings
-apply uniformly to all data files read by subsequent commands; however
-see 'functionblocks' for a way to work around this if it is necessary to
-simultaneously handles files with conflicting formats.
-
-* Menu:
-
-* set_datafile_columnheaders::
-* set_datafile_fortran::
-* set_datafile_nofpe_trap::
-* set_datafile_missing::
-* set_datafile_separator::
-* set_datafile_commentschars::
-* set_datafile_binary::
-
-
-File: gnuplot.info,  Node: set_datafile_columnheaders,  Next: set_datafile_fortran,  Prev: datafile,  Up: datafile
-
-3.33.23.1 set datafile columnheaders
-....................................
-
-The *note columnheaders:: command guarantees that the first row of input
-will be interpreted as column headers rather than as data values.  It
-affects all input data sources to plot, splot, fit, and stats commands.
-If this setting is disabled by *note columnheaders::, the same effect is
-triggered on a per-file basis if there is an explicit columnheader()
-function in a using specifier or plot title associated with that file.
-See also 'set key autotitle' and 'columnheader'.
-
-
-File: gnuplot.info,  Node: set_datafile_fortran,  Next: set_datafile_nofpe_trap,  Prev: set_datafile_columnheaders,  Up: datafile
-
-3.33.23.2 set datafile fortran
-..............................
-
-The 'set datafile fortran' command enables a special check for values in
-the input file expressed as Fortran D or Q constants.  This extra check
-slows down the input process, and should only be selected if you do in
-fact have datafiles containing Fortran D or Q constants.  The option can
-be disabled again using 'unset datafile fortran'.
-
-
-File: gnuplot.info,  Node: set_datafile_nofpe_trap,  Next: set_datafile_missing,  Prev: set_datafile_fortran,  Up: datafile
-
-3.33.23.3 set datafile nofpe_trap
-.................................
-
-The 'set datafile nofpe_trap' command tells gnuplot not to re-initialize
-a floating point exception handler before every expression evaluation
-used while reading data from an input file.  This can significantly
-speed data input from very large files at the risk of program
-termination if a floating-point exception is generated.
-
-
-File: gnuplot.info,  Node: set_datafile_missing,  Next: set_datafile_separator,  Prev: set_datafile_nofpe_trap,  Up: datafile
-
-3.33.23.4 set datafile missing
-..............................
-
-Syntax:
-           set datafile missing "<string>"
-           set datafile missing NaN
-           show datafile missing
-           unset datafile
-
-
-   The 'set datafile missing' command tells 'gnuplot' there is a special
-string used in input data files to denote a missing data entry.  There
-is no default character for 'missing'.  Gnuplot makes a distinction
-between missing data and invalid data (e.g.  "NaN", 1/0.).  For example
-invalid data causes a gap in a line drawn through sequential data
-points; missing data does not.
-
-   Non-numeric characters found in a numeric field will usually be
-interpreted as invalid rather than as a missing data point unless they
-happen to match the 'missing' string.
-
-   Conversely *note NaN:: causes all data or expressions evaluating to
-not-a-number (NaN) to be treated as missing data.  See the imageNaN
-demo.  (http://www.gnuplot.info/demo/imageNaN.html)
-
-   The program notices a missing value flag in column N when the using
-specifier in a plot command directly refers to the column as 'using N',
-'using ($N)', or 'using (function($N))'. In these cases the expression,
-e.g.  func($N), is not evaluated at all.
-
-   The current gnuplot version also notices direct references of the
-form (column(N)), and it notices during evaluation if the expression
-depends even indirectly on a column value flagged "missing".
-
-   In all these cases the program treats the entire input data line as
-if it were not present at all.  However if an expression depends on a
-data value that is truly missing (e.g.  an empty field in a csv file) it
-may not be caught by these checks.  If it evaluates to NaN it will be
-treated as invalid data rather than as a missing data point.  If you
-want to treat such invalid data the same as missing data, use the
-command *note NaN::.
-
-
-File: gnuplot.info,  Node: set_datafile_separator,  Next: set_datafile_commentschars,  Prev: set_datafile_missing,  Up: datafile
-
-3.33.23.5 set datafile separator
-................................
-
-The command 'set datafile separator' tells 'gnuplot' that data fields in
-subsequent input files are separated by a specific character rather than
-by whitespace.  The most common use is to read in csv (comma-separated
-value) files written by spreadsheet or database programs.  By default
-data fields are separated by whitespace.
-
-   Syntax:
-           set datafile separator {whitespace | tab | comma | "<chars>"}
-
-
-   Examples:
-           # Input file contains tab-separated fields
-           set datafile separator "\t"
-
-
-           # Input file contains comma-separated values fields
-           set datafile separator comma
-
-
-           # Input file contains fields separated by either * or |
-           set datafile separator "*|"
-
-
-
-File: gnuplot.info,  Node: set_datafile_commentschars,  Next: set_datafile_binary,  Prev: set_datafile_separator,  Up: datafile
-
-3.33.23.6 set datafile commentschars
-....................................
-
-The command 'set datafile commentschars' specifies what characters can
-be used in a data file to begin comment lines.  If the first non-blank
-character on a line is one of these characters then the rest of the data
-line is ignored.  Default value of the string is "#!"  on VMS and "#"
-otherwise.
-
-   Syntax:
-           set datafile commentschars {"<string>"}
-           show datafile commentschars
-           unset commentschars
-
-
-   Then, the following line in a data file is completely ignored
-         # 1 2 3 4
-
-   but the following
-         1 # 3 4
-
-   will be interpreted as garbage in the 2nd column followed by valid
-data in the 3rd and 4th columns.
-
-   Example:
-           set datafile commentschars "#!%"
-
-
-
-File: gnuplot.info,  Node: set_datafile_binary,  Prev: set_datafile_commentschars,  Up: datafile
-
-3.33.23.7 set datafile binary
-.............................
-
-The *note binary:: command is used to set the defaults when reading
-binary data files.  The syntax matches precisely that used for commands
-'plot' and 'splot'.  See *note matrix:: and *note general:: for details
-about the keywords that can be present in <binary list>.
-
-   Syntax:
-           set datafile binary <binary list>
-           show datafile binary
-           show datafile
-           unset datafile
-
-
-   Examples:
-           set datafile binary filetype=auto
-           set datafile binary array=(512,512) format="%uchar"
-
-
-           show datafile binary   # list current settings
-
-
-
-File: gnuplot.info,  Node: decimalsign,  Next: dgrid3d,  Prev: datafile,  Up: set-show
-
-3.33.24 decimalsign
--------------------
-
-The *note decimalsign:: command selects a decimal sign for numbers
-printed into tic labels or 'set label' strings.
-
-   Syntax:
-           set decimalsign {<value> | locale {"<locale>"}}
-           unset decimalsign
-           show decimalsign
-
-
-   The argument <value> is a string to be used in place of the usual
-decimal point.  Typical choices include the period, '.', and the comma,
-',', but others may be useful, too.  If you omit the <value> argument,
-the decimal separator is not modified from the usual default, which is a
-period.  Unsetting decimalsign has the same effect as omitting <value>.
-
-   Example:
-
-   Correct typesetting in most European countries requires:
-           set decimalsign ','
-
-
-   Please note: If you set an explicit string, this affects only numbers
-that are printed using gnuplot's gprintf() formatting routine, including
-axis tics.  It does not affect the format expected for input data, and
-it does not affect numbers printed with the sprintf() formatting
-routine.  To change the behavior of both input and output formatting,
-instead use the form
-
-           set decimalsign locale
-
-
-   This instructs the program to use both input and output formats in
-accordance with the current setting of the LC_ALL, LC_NUMERIC, or LANG
-environmental variables.
-
-           set decimalsign locale "foo"
-
-
-   This instructs the program to format all input and output in
-accordance with locale "foo", which must be installed.  If locale "foo"
-is not found then an error message is printed and the decimal sign
-setting is unchanged.  On linux systems you can get a list of the
-locales installed on your machine by typing "locale -a".  A typical
-linux locale string is of the form "sl_SI.UTF-8".  A typical Windows
-locale string is of the form "Slovenian_Slovenia.1250" or "slovenian".
-Please note that interpretation of the locale settings is done by the C
-library at runtime.  Older C libraries may offer only partial support
-for locale settings such as the thousands grouping separator character.
-
-           set decimalsign locale; set decimalsign "."
-
-
-   This sets all input and output to use whatever decimal sign is
-correct for the current locale, but over-rides this with an explicit '.'
-in numbers formatted using gnuplot's internal gprintf() function.
-
-
-File: gnuplot.info,  Node: dgrid3d,  Next: dummy,  Prev: decimalsign,  Up: set-show
-
-3.33.25 dgrid3d
----------------
-
-The *note dgrid3d:: command enables and sets parameters for mapping
-non-grid data onto a grid.  See 'splot grid_data' for details about the
-grid data structure.  Aside from its use in fitting 3D surfaces, this
-process can also be used to generate 2D heatmaps, where the 'z' value of
-each point contributes to a local weighted value.
-
-   Syntax:
-           set dgrid3d {<rows>} {,{<cols>}} splines
-           set dgrid3d {<rows>} {,{<cols>}} qnorm {<norm>}
-           set dgrid3d {<rows>} {,{<cols>}} {gauss | cauchy | exp | box | hann}
-                           {kdensity} {<dx>} {,<dy>}
-           unset dgrid3d
-           show dgrid3d
-
-
-   By default *note dgrid3d:: is disabled.  When enabled, 3D data points
-read from a file are treated as a scattered data set used to fit a
-gridded surface.  The grid dimensions are derived from the bounding box
-of the scattered data subdivided by the row/col_size parameters from the
-*note dgrid3d:: statement.  The grid is equally spaced in x (rows) and
-in y (columns); the z values are computed as weighted averages or spline
-interpolations of the scattered points' z values.  In other words, a
-regularly spaced grid is created and then a smooth approximation to the
-raw data is evaluated for each grid point.  This surface is then plotted
-in place of the raw data.
-
-   While dgrid3d mode is enabled, if you want to plot individual points
-or lines without using them to create a gridded surface you must append
-the keyword 'nogrid' to the corresponding splot command.
-
-   The number of columns defaults to the number of rows, which defaults
-to 10.
-
-   Several algorithms are available to calculate the approximation from
-the raw data.  Some of these algorithms can take additional parameters.
-These interpolations are such that the closer the data point is to a
-grid point, the more effect it has on that grid point.
-
-   The 'splines' algorithm calculates an interpolation based on thin
-plate splines.  It does not take additional parameters.
-
-   The 'qnorm' algorithm calculates a weighted average of the input data
-at each grid point.  Each data point is weighted by the inverse of its
-distance from the grid point raised to some power.  The power is
-specified as an optional integer parameter that defaults to 1.  This
-algorithm is the default.
-
-   Finally, several smoothing kernels are available to calculate
-weighted averages: z = Sum_i w(d_i) * z_i / Sum_i w(d_i), where z_i is
-the value of the i-th data point and d_i is the distance between the
-current grid point and the location of the i-th data point.  All kernels
-assign higher weights to data points that are close to the current grid
-point and lower weights to data points further away.
-
-   The following kernels are available:
-           gauss :     w(d) = exp(-d*d)
-           cauchy :    w(d) = 1/(1 + d*d)
-           exp :       w(d) = exp(-d)
-           box :       w(d) = 1                     if d<1
-                            = 0                     otherwise
-           hann :      w(d) = 0.5*(1+cos(pi*d))     if d<1
-                       w(d) = 0                     otherwise
-
-
-   When using one of these five smoothing kernels, up to two additional
-numerical parameters can be specified: dx and dy.  These are used to
-rescale the coordinate differences when calculating the distance: d_i =
-sqrt( ((x-x_i)/dx)**2 + ((y-y_i)/dy)**2 ), where x,y are the coordinates
-of the current grid point and x_i,y_i are the coordinates of the i-th
-data point.  The value of dy defaults to the value of dx, which defaults
-to 1.  The parameters dx and dy make it possible to control the radius
-over which data points contribute to a grid point IN THE UNITS OF THE
-DATA ITSELF.
-
-   The optional keyword 'kdensity', which must come after the name of
-the kernel, but before the optional scale parameters, modifies the
-algorithm so that the values calculated for the grid points are not
-divided by the sum of the weights ( z = Sum_i w(d_i) * z_i ).  If all
-z_i are constant, this effectively plots a bivariate kernel density
-estimate: a kernel function (one of the five defined above) is placed at
-each data point, the sum of these kernels is evaluated at every grid
-point, and this smooth surface is plotted instead of the original data.
-This is similar in principle to what the 'smooth kdensity' option does
-to 1D datasets.  See kdensity2d.dem and heatmap_points.dem for usage
-example.
-
-   The *note dgrid3d:: option is a simple scheme which replaces
-scattered data with weighted averages on a regular grid.  More
-sophisticated approaches to this problem exist and should be used to
-preprocess the data outside 'gnuplot' if this simple solution is found
-inadequate.
-
-   See also the online demos for dgrid3d
-(http://www.gnuplot.info/demo/dgrid3d.html) scatter
-(http://www.gnuplot.info/demo/scatter.html) and heatmap_points
-(http://www.gnuplot.info/demo/heatmap_points.html) D heatmap_points 1 D
-heatmap_points 2 D heatmap_points 3
-
-
-File: gnuplot.info,  Node: dummy,  Next: encoding,  Prev: dgrid3d,  Up: set-show
-
-3.33.26 dummy
--------------
-
-The *note dummy:: command changes the default dummy variable names.
-
-   Syntax:
-           set dummy {<dummy-var>} {,<dummy-var>}
-           show dummy
-
-
-   By default, 'gnuplot' assumes that the independent, or "dummy",
-variable for the 'plot' command is "t" if in parametric or polar mode,
-or "x" otherwise.  Similarly the independent variables for the 'splot'
-command are "u" and "v" in parametric mode ('splot' cannot be used in
-polar mode), or "x" and "y" otherwise.
-
-   It may be more convenient to call a dummy variable by a more
-physically meaningful or conventional name.  For example, when plotting
-time functions:
-
-           set dummy t
-           plot sin(t), cos(t)
-
-
-   Examples:
-           set dummy u,v
-           set dummy ,s
-
-
-   The second example sets the second variable to s.  To reset the dummy
-variable names to their default values, use
-
-           unset dummy
-
-
-
-File: gnuplot.info,  Node: encoding,  Next: errorbars,  Prev: dummy,  Up: set-show
-
-3.33.27 encoding
-----------------
-
-The *note encoding:: command selects a character encoding.
-
-   Syntax:
-           set encoding {<value>}
-           set encoding locale
-           show encoding
-
-
-   Valid values are
-        default     - tells a terminal to use its default encoding
-        iso_8859_1  - the most common Western European encoding prior to UTF-8.
-                      Known in the PostScript world as 'ISO-Latin1'.
-        iso_8859_15 - a variant of iso_8859_1 that includes the Euro symbol
-        iso_8859_2  - used in Central and Eastern Europe
-        iso_8859_9  - used in Turkey (also known as Latin5)
-        koi8r       - popular Unix cyrillic encoding
-        koi8u       - Ukrainian Unix cyrillic encoding
-        cp437       - codepage for MS-DOS
-        cp850       - codepage for OS/2, Western Europe
-        cp852       - codepage for OS/2, Central and Eastern Europe
-        cp950       - MS version of Big5 (emf terminal only)
-        cp1250      - codepage for MS Windows, Central and Eastern Europe
-        cp1251      - codepage for 8-bit Russian, Serbian, Bulgarian, Macedonian
-        cp1252      - codepage for MS Windows, Western Europe
-        cp1254      - codepage for MS Windows, Turkish (superset of Latin5)
-        sjis        - shift-JIS Japanese encoding
-        utf8        - variable-length (multibyte) representation of Unicode
-                      entry point for each character
-
-
-   The command *note locale:: is different from the other options.  It
-attempts to determine the current locale from the runtime environment.
-On most systems this is controlled by the environmental variables
-LC_ALL, LC_CTYPE, or LANG. This mechanism is necessary, for example, to
-pass multibyte character encodings such as UTF-8 or EUC_JP to the wxt
-and pdf terminals.  This command does not affect the locale-specific
-representation of dates or numbers.  See also *note locale:: and *note
-decimalsign::.
-
-   Generally you should set the encoding before setting the terminal
-type, as it may affect the selection of fonts.
-
-
-File: gnuplot.info,  Node: errorbars,  Next: fit_,  Prev: encoding,  Up: set-show
-
-3.33.28 errorbars
------------------
-
-The *note errorbars:: command controls the tics at the ends of error
-bars, and also at the end of the whiskers belonging to a boxplot.
-
-   Syntax:
-           set errorbars {small | large | fullwidth | <size>} {front | back}
-                         {line-properties}
-           unset errorbars
-           show errorbars
-
-
-   'small' is a synonym for 0.0 (no crossbar), and 'large' for 1.0.  The
-default is 1.0 if no size is given.
-
-   The keyword 'fullwidth' is relevant only to boxplots and to
-histograms with errorbars.  It sets the width of the errorbar ends to be
-the same as the width of the associated box.  It does not change the
-width of the box itself.
-
-   The 'front' and 'back' keywords are relevant only to errorbars
-attached to filled rectangles (boxes, candlesticks, histograms).
-
-   Error bars are by default drawn using the same line properties as the
-border of the associated box.  You can change this by providing a
-separate set of line properties for the error bars.
-
-          set errorbars linecolor black linewidth 0.5 dashtype '.'
-
-
-
-File: gnuplot.info,  Node: fit_,  Next: fontpath,  Prev: errorbars,  Up: set-show
-
-3.33.29 fit
------------
-
-The *note fit:: command controls the options for the *note fit::
-command.
-
-   Syntax:
-           set fit {nolog | logfile {"<filename>"|default}}
-                   {{no}quiet|results|brief|verbose}
-                   {{no}errorvariables}
-                   {{no}covariancevariables}
-                   {{no}errorscaling}
-                   {{no}prescale}
-                   {maxiter <value>|default}
-                   {limit <epsilon>|default}
-                   {limit_abs <epsilon_abs>}
-                   {start-lambda <value>|default}
-                   {lambda-factor <value>|default}
-                   {script {"<command>"|default}}
-                   {v4 | v5}
-           unset fit
-           show fit
-
-
-   The 'logfile' option defines where the *note fit:: command writes its
-output.  The <filename> argument must be enclosed in single or double
-quotes.  If no filename is given or *note fit:: is used the log file is
-reset to its default value "fit.log" or the value of the environmental
-variable 'FIT_LOG'. If the given logfile name ends with a / or \, it is
-interpreted to be a directory name, and the actual filename will be
-"fit.log" in that directory.
-
-   By default the information written to the log file is also echoed to
-the terminal session.  'set fit quiet' turns off the echo, whereas
-'results' prints only final results.  'brief' gives one line summaries
-for every iteration of the fit in addition.  'verbose' yields detailed
-iteration reports as in version 4.
-
-   If the 'errorvariables' option is turned on, the error of each fitted
-parameter computed by *note fit:: will be copied to a user-defined
-variable whose name is formed by appending "_err" to the name of the
-parameter itself.  This is useful mainly to put the parameter and its
-error onto a plot of the data and the fitted function, for reference, as
-in:
-
-            set fit errorvariables
-            fit f(x) 'datafile' using 1:2 via a, b
-            print "error of a is:", a_err
-            set label 1 sprintf("a=%6.2f +/- %6.2f", a, a_err)
-            plot 'datafile' using 1:2, f(x)
-
-
-   If the 'errorscaling' option is specified, which is the default, the
-calculated parameter errors are scaled with the reduced chi square.
-This is equivalent to providing data errors equal to the calculated
-standard deviation of the fit (FIT_STDFIT) resulting in a reduced chi
-square of one.  With the 'noerrorscaling' option the estimated errors
-are the unscaled standard deviations of the fit parameters.  If no
-weights are specified for the data, parameter errors are always scaled.
-
-   If the 'prescale' option is turned on, parameters are prescaled by
-their initial values before being passed to the Marquardt-Levenberg
-routine.  This helps tremendously if there are parameters that differ in
-size by many orders of magnitude.  Fit parameters with an initial value
-of exactly zero are never prescaled.
-
-   The maximum number of iterations may be limited with the 'maxiter'
-option.  A value of 0 or 'default' means that there is no limit.
-
-   The 'limit' option can be used to change the default epsilon limit
-(1e-5) to detect convergence.  When the sum of squared residuals changes
-by a factor less than this number (epsilon), the fit is considered to
-have 'converged'.  The 'limit_abs' option imposes an additional absolute
-limit in the change of the sum of squared residuals and defaults to
-zero.
-
-   If you need even more control about the algorithm, and know the
-Marquardt-Levenberg algorithm well, the following options can be used to
-influence it.  The startup value of 'lambda' is normally calculated
-automatically from the ML-matrix, but if you want to, you may provide
-your own using the 'start_lambda' option.  Setting it to 'default' will
-re-enable the automatic selection.  The option 'lambda_factor' sets the
-factor by which 'lambda' is increased or decreased whenever the
-chi-squared target function increased or decreased significantly.
-Setting it to 'default' re-enables the default factor of 10.0.
-
-   The 'script' option may be used to specify a 'gnuplot' command to be
-executed when a fit is interrupted--see *note fit::.  This setting takes
-precedence over the default of *note replot:: and the environment
-variable 'FIT_SCRIPT'.
-
-   If the 'covariancevariables' option is turned on, the covariances
-between final parameters will be saved to user-defined variables.  The
-variable name for a certain parameter combination is formed by
-prepending "FIT_COV_" to the name of the first parameter and combining
-the two parameter names by "_".  For example given the parameters "a"
-and "b" the covariance variable is named "FIT_COV_a_b".
-
-   In version 5 the syntax of the fit command changed and it now
-defaults to unitweights if no 'error' keyword is given.  The 'v4' option
-restores the default behavior of gnuplot version 4, see also *note
-fit::.
-
-
-File: gnuplot.info,  Node: fontpath,  Next: format__,  Prev: fit_,  Up: set-show
-
-3.33.30 fontpath
-----------------
-
-Syntax:
-           set fontpath "/directory/where/my/fonts/live"
-           set term postscript fontfile <filename>
-
-
-   [DEPRECATED in version 5.4]
-
-   The *note fontpath:: directory is relevant only for embedding fonts
-in postscript output produced by the postscript terminal.  It has no
-effect on other gnuplot terminals.  If you are not embedding fonts you
-do not need this command, and even if you are embedding fonts you only
-need it for fonts that cannot be found via the other paths below.
-
-   Earlier versions of gnuplot tried to emulate a font manager by
-tracking multiple directory trees containing fonts.  This is now
-replaced by a search in the following places: (1) an absolute path given
-in the 'set term postscript fontfile' command (2) the current directory
-(3) any of the directories specified by *note loadpath:: (4) the
-directory specified by *note fontpath:: (5) the directory provided in
-environmental variable GNUPLOT_FONTPATH
-
-   Note: The search path for fonts specified by filename for the libgd
-terminals (png gif jpeg sixel) is controlled by environmental variable
-GDFONTPATH.
-
-
-File: gnuplot.info,  Node: format__,  Next: grid,  Prev: fontpath,  Up: set-show
-
-3.33.31 format
---------------
-
-The format of the tic-mark labels can be set with the 'set format'
-command or with the 'set tics format' or individual 'set {axis}tics
-format' commands.  For information on using an explicit format for input
-data see 'using format'.
-
-   Syntax:
-           set format {<axes>} {"<format-string>"} {numeric|timedate|geographic}
-           show format
-
-
-   where <axes> is either 'x', 'y', 'xy', 'x2', 'y2', 'z', 'cb' or
-nothing (which applies the format to all axes).  The following two
-commands are equivalent:
-           set format y "%.2f"
-           set ytics format "%.2f"
-
-
-   The length of the string is restricted to 100 characters.  The
-default format is "% h", "$%h$" for LaTeX terminals.  Other formats such
-as "%.2f" or "%3.0em" are often desirable.  "set format" with no
-following string will restore the default.
-
-   If the empty string "" is given, tics will have no labels, although
-the tic mark will still be plotted.  To eliminate the tic marks, use
-'unset xtics' or 'set tics scale 0'.
-
-   Newline (\n) and enhanced text markup is accepted in the format
-string.  Use double-quotes rather than single-quotes in this case.  See
-also 'syntax'.  Characters not preceded by "%" are printed verbatim.
-Thus you can include spaces and labels in your format string, such as
-"%g m", which will put " m" after each number.  If you want "%" itself,
-double it: "%g %%".
-
-   See also 'set xtics' for more information about tic labels, and *note
-decimalsign:: for how to use non-default decimal separators in numbers
-printed this way.  See also electron demo (electron.dem).
-(http://www.gnuplot.info/demo/electron.html)
-
-* Menu:
-
-* gprintf_::
-* format_specifiers::
-* time/date_specifiers::
-
-
-File: gnuplot.info,  Node: gprintf_,  Next: format_specifiers,  Prev: format__,  Up: format__
-
-3.33.31.1 gprintf
-.................
-
-The string function gprintf("format",x) uses gnuplot's own format
-specifiers, as do the gnuplot commands 'set format', *note timestamp::,
-and others.  These format specifiers are not the same as those used by
-the standard C-language routine sprintf().  gprintf() accepts only a
-single variable to be formatted.  Gnuplot also provides an
-sprintf("format",x1,x2,...)  routine if you prefer.  For a list of
-gnuplot's format options, see 'format specifiers'.
-
-
-File: gnuplot.info,  Node: format_specifiers,  Next: time/date_specifiers,  Prev: gprintf_,  Up: format__
-
-3.33.31.2 format specifiers
-...........................
-
-The acceptable formats (if not in time/date mode) are:
-
-           Format       Explanation
-           %f           floating point notation
-           %e or %E     exponential notation; an "e" or "E" before the power
-           %g or %G     the shorter of %e (or %E) and %f
-           %h or %H     like %g with "x10^{%S}" or "*10^{%S}" instead of "e%S"
-           %x or %X     hex
-           %o or %O     octal
-           %t           mantissa to base 10
-           %l           mantissa to base of current logscale
-           %s           mantissa to base of current logscale; scientific power
-           %T           power to base 10
-           %L           power to base of current logscale
-           %S           scientific power
-           %c           character replacement for scientific power
-           %b           mantissa of ISO/IEC 80000 notation (ki, Mi, Gi, Ti, Pi, Ei, Zi, Yi)
-           %B           prefix of ISO/IEC 80000 notation (ki, Mi, Gi, Ti, Pi, Ei, Zi, Yi)
-           %P           multiple of pi
-
-
-   A 'scientific' power is one such that the exponent is a multiple of
-three.  Character replacement of scientific powers ('"%c"') has been
-implemented for powers in the range -18 to +18.  For numbers outside of
-this range the format reverts to exponential.
-
-   Other acceptable modifiers (which come after the "%" but before the
-format specifier) are "-", which left-justifies the number; "+", which
-forces all numbers to be explicitly signed; " " (a space), which makes
-positive numbers have a space in front of them where negative numbers
-have "-"; "#", which places a decimal point after floats that have only
-zeroes following the decimal point; a positive integer, which defines
-the field width; "0" (the digit, not the letter) immediately preceding
-the field width, which indicates that leading zeroes are to be used
-instead of leading blanks; and a decimal point followed by a
-non-negative integer, which defines the precision (the minimum number of
-digits of an integer, or the number of digits following the decimal
-point of a float).
-
-   Some systems may not support all of these modifiers but may also
-support others; in case of doubt, check the appropriate documentation
-and then experiment.
-
-   Examples:
-           set format y "%t"; set ytics (5,10)          # "5.0" and "1.0"
-           set format y "%s"; set ytics (500,1000)      # "500" and "1.0"
-           set format y "%+-12.3f"; set ytics(12345)    # "+12345.000  "
-           set format y "%.2t*10^%+03T"; set ytic(12345)# "1.23*10^+04"
-           set format y "%s*10^{%S}"; set ytic(12345)   # "12.345*10^{3}"
-           set format y "%s %cg"; set ytic(12345)       # "12.345 kg"
-           set format y "%.0P pi"; set ytic(6.283185)   # "2 pi"
-           set format y "%.0f%%"; set ytic(50)          # "50%"
-
-
-           set log y 2; set format y '%l'; set ytics (1,2,3)
-           #displays "1.0", "1.0" and "1.5" (since 3 is 1.5 * 2^1)
-
-
-   There are some problem cases that arise when numbers like 9.999 are
-printed with a format that requires both rounding and a power.
-
-   If the data type for the axis is time/date, the format string must
-contain valid codes for the 'strftime' function (outside of 'gnuplot',
-type "man strftime").  See *note timefmt:: for a list of the allowed
-input format codes.
-
-
-File: gnuplot.info,  Node: time/date_specifiers,  Prev: format_specifiers,  Up: format__
-
-3.33.31.3 time/date specifiers
-..............................
-
-There are two groups of time format specifiers: time/date and relative
-time.  These may be used to generate axis tic labels or to encode time
-in a string.  See 'set xtics time', *note strftime::, *note strptime::.
-
-   The time/date formats are
-
-           Format       Explanation
-           %a           short name of day of the week (ignored on input)
-           %A           full name of day of the week (ignored on input)
-           %b or %h     abbreviated name of the month
-           %B           full name of the month
-           %d           day of the month, 01--31
-           %D           shorthand for "%m/%d/%y" (only output)
-           %F           shorthand for "%Y-%m-%d" (only output)
-           %k           hour, 0--23 (one or two digits)
-           %H           hour, 00--23 (always two digits)
-           %l           hour, 1--12 (one or two digits)
-           %I           hour, 01--12 (always two digits)
-           %j           day of the year, 001--366
-           %m           month, 01--12
-           %M           minute, 00--60
-           %p           "am" or "pm"
-           %r           shorthand for "%I:%M:%S %p" (only output)
-           %R           shorthand for "%H:%M" (only output)
-           %s           number of seconds since the start of year 1970
-           %S           second, integer 00--60 on output, (double) on input
-           %T           shorthand for "%H:%M:%S" (only output)
-           %U           week of the year (CDC/MMWR "epi week") (ignored on input)
-           %w           day of the week, 0--6 (Sunday = 0) (ignored on input)
-           %W           week of the year (ISO 8601 week date) (ignored on input)
-           %y           year, 0-68 for 2000-2068, 69-99 for 1969-1999
-           %Y           year, 4-digit
-           %z           timezone, [+-]hh:mm
-           %Z           timezone name, ignored string
-
-
-   For more information on the %W format (ISO week of year) see
-'tm_week'.  The %U format (CDC/MMWR epidemiological week) is similar to
-%W except that it uses weeks that start on Sunday rather than Monday.
-Caveat: Both the %W and the %U formats were unreliable in gnuplot
-versions prior to 5.4.2.  See unit test "week_date.dem".
-
-   The relative time formats express the length of a time interval on
-either side of a zero time point.  The relative time formats are
-
-           Format       Explanation
-           %tD          +/- days relative to time=0
-           %tH          +/- hours relative to time=0 (does not wrap at 24)
-           %tM          +/- minutes relative to time=0
-           %tS          +/- seconds associated with previous tH or tM field
-
-
-   Numerical formats may be preceded by a "0" ("zero") to pad the field
-with leading zeroes, and preceded by a positive digit to define the
-minimum field width.  The %S, and %t formats also accept a precision
-specifier so that fractional hours/minutes/seconds can be written.
-
--- EXAMPLES --
-
-   Examples of date format:
-
-   Suppose the x value in seconds corresponds a time slightly before
-midnight on 25 Dec 1976.  The text printed for a tic label at this
-position would be
-
-           set format x                 # defaults to "12/25/76 \n 23:11"
-           set format x "%A, %d %b %Y"  # "Saturday, 25 Dec 1976"
-           set format x "%r %D"         # "11:11:11 pm 12/25/76"
-           set xtics time format "%B"   # "December"
-
-
-   Examples of time format:
-
-   The date format specifiers encode a time in seconds as a clock time
-on a particular day.  So hours run only from 0-23, minutes from 0-59,
-and negative values correspond to dates prior to the epoch (1-Jan-1970).
-In order to report a time value in seconds as some number of
-hours/minutes/seconds relative to a time 0, use time formats %tH %tM
-%tS. To report a value of -3672.50 seconds
-
-           set format x                 # default date format "12/31/69 \n 22:58"
-           set format x "%tH:%tM:%tS"   # "-01:01:12"
-           set format x "%.2tH hours"   # "-1.02 hours"
-           set format x "%tM:%.2tS"     # "-61:12.50"
-
-
-
-File: gnuplot.info,  Node: grid,  Next: hidden3d,  Prev: format__,  Up: set-show
-
-3.33.32 grid
-------------
-
-The 'set grid' command allows grid lines to be drawn on the plot.
-
-   Syntax:
-           set grid {{no}{m}xtics} {{no}{m}ytics} {{no}{m}ztics}
-                    {{no}{m}x2tics} {{no}{m}y2tics} {{no}{m}rtics}
-                    {{no}{m}cbtics}
-                    {polar {<angle>}}
-                    {layerdefault | front | back}
-                    {{no}vertical}
-                    {<line-properties-major> {, <line-properties-minor>}}
-           unset grid
-           show grid
-
-
-   The grid can be enabled and disabled for the major and/or minor tic
-marks on any axis, and the linetype and linewidth can be specified for
-major and minor grid lines, also via a predefined linestyle, as far as
-the active terminal driver supports this (see 'set style line').
-
-   A polar grid can be drawn for 2D plots.  This is the default action
-of 'set grid' if the program is already in polar mode, but can be
-enabled explicitly by *note rtics:: whether or not the program is in
-polar mode.  Circles are drawn to intersect major and/or minor tics
-along the r axis, and radial lines are drawn with a spacing of <angle>.
-Tic marks around the perimeter are controlled by *note ttics::, but
-these do not produce radial grid lines.
-
-   The pertinent tics must be enabled before 'set grid' can draw them;
-'gnuplot' will quietly ignore instructions to draw grid lines at
-non-existent tics, but they will appear if the tics are subsequently
-enabled.
-
-   If no linetype is specified for the minor gridlines, the same
-linetype as the major gridlines is used.  The default polar angle is 30
-degrees.
-
-   If 'front' is given, the grid is drawn on top of the graphed data.
-If 'back' is given, the grid is drawn underneath the graphed data.
-Using 'front' will prevent the grid from being obscured by dense data.
-The default setup, 'layerdefault', is equivalent to 'back' for 2D plots.
-In 3D plots the default is to split up the grid and the graph box into
-two layers: one behind, the other in front of the plotted data and
-functions.  Since *note hidden3d:: mode does its own sorting, it ignores
-all grid drawing order options and passes the grid lines through the
-hidden line removal machinery instead.  These options actually affect
-not only the grid, but also the lines output by *note border:: and the
-various ticmarks (see 'set xtics').
-
-   In 3D plots grid lines at x- and y- axis tic positions are by default
-drawn only on the base plane parallel to z=0.  The 'vertical' keyword
-activates drawing grid lines in the xz and yz planes also, running from
-zmin to zmax.
-
-   Z grid lines are drawn on the bottom of the plot.  This looks better
-if a partial box is drawn around the plot--see *note border::.
-
-
-File: gnuplot.info,  Node: hidden3d,  Next: history_,  Prev: grid,  Up: set-show
-
-3.33.33 hidden3d
-----------------
-
-The *note hidden3d:: command enables hidden line removal for surface
-plotting (see 'splot').  Some optional features of the underlying
-algorithm can also be controlled using this command.
-
-   Syntax:
-           set hidden3d {defaults} |
-                        { {front|back}
-                          {{offset <offset>} | {nooffset}}
-                          {trianglepattern <bitpattern>}
-                          {{undefined <level>} | {noundefined}}
-                          {{no}altdiagonal}
-                          {{no}bentover} }
-           unset hidden3d
-           show hidden3d
-
-
-   In contrast to the usual display in gnuplot, hidden line removal
-actually treats the given function or data grids as real surfaces that
-can't be seen through, so plot elements behind the surface will be
-hidden by it.  For this to work, the surface needs to have 'grid
-structure' (see *note datafile:: about this), and it has to be drawn
-'with lines' or *note linespoints::.
-
-   When *note hidden3d:: is set, both the hidden portion of the surface
-and possibly its contours drawn on the base (see 'set contour') as well
-as the grid will be hidden.  Each surface has its hidden parts removed
-with respect to itself and to other surfaces, if more than one surface
-is plotted.  Contours drawn on the surface ('set contour surface') don't
-work.
-
-   *note hidden3d:: also affects 3D plotting styles 'points', *note
-labels::, *note vectors::, and *note impulses:: even if no surface is
-present in the graph.  Unobscured portions of each vector are drawn as
-line segments (no arrowheads).  Individual plots within the graph may be
-explicitly excluded from this processing by appending the extra option
-'nohidden3d' to the 'with' specifier.
-
-   Hidden3d does not affect solid surfaces drawn using the pm3d mode.
-To achieve a similar effect purely for pm3d surfaces, use instead 'set
-pm3d depthorder'.  To mix pm3d surfaces with normal *note hidden3d::
-processing, use the option 'set hidden3d front' to force all elements
-included in hidden3d processing to be drawn after any remaining plot
-elements, including the pm3d surface.
-
-   Functions are evaluated at isoline intersections.  The algorithm
-interpolates linearly between function points or data points when
-determining the visible line segments.  This means that the appearance
-of a function may be different when plotted with *note hidden3d:: than
-when plotted with 'nohidden3d' because in the latter case functions are
-evaluated at each sample.  Please see *note samples:: and *note
-isosamples:: for discussion of the difference.
-
-   The algorithm used to remove the hidden parts of the surfaces has
-some additional features controllable by this command.  Specifying
-'defaults' will set them all to their default settings, as detailed
-below.  If 'defaults' is not given, only explicitly specified options
-will be influenced: all others will keep their previous values, so you
-can turn on/off hidden line removal via 'set {no}hidden3d', without
-modifying the set of options you chose.
-
-   The first option, 'offset', influences the linetype used for lines on
-the 'back' side.  Normally, they are drawn in a linetype one index
-number higher than the one used for the front, to make the two sides of
-the surface distinguishable.  You can specify a different linetype
-offset to add instead of the default 1, by 'offset <offset>'.  Option
-'nooffset' stands for 'offset 0', making the two sides of the surface
-use the same linetype.
-
-   Next comes the option 'trianglepattern <bitpattern>'.  <bitpattern>
-must be a number between 0 and 7, interpreted as a bit pattern.  Each
-bit determines the visibility of one edge of the triangles each surface
-is split up into.  Bit 0 is for the 'horizontal' edges of the grid, Bit
-1 for the 'vertical' ones, and Bit 2 for the diagonals that split each
-cell of the original grid into two triangles.  The default pattern is 3,
-making all horizontal and vertical lines visible, but not the diagonals.
-You may want to choose 7 to see those diagonals as well.
-
-   The 'undefined <level>' option lets you decide what the algorithm is
-to do with data points that are undefined (missing data, or undefined
-function values), or exceed the given x-, y- or z-ranges.  Such points
-can either be plotted nevertheless, or taken out of the input data set.
-All surface elements touching a point that is taken out will be taken
-out as well, thus creating a hole in the surface.  If <level> = 3,
-equivalent to option 'noundefined', no points will be thrown away at
-all.  This may produce all kinds of problems elsewhere, so you should
-avoid this.  <level> = 2 will throw away undefined points, but keep the
-out-of-range ones.  <level> = 1, the default, will get rid of
-out-of-range points as well.
-
-   By specifying 'noaltdiagonal', you can override the default handling
-of a special case can occur if *note undefined:: is active (i.e.
-<level> is not 3).  Each cell of the grid-structured input surface will
-be divided in two triangles along one of its diagonals.  Normally, all
-these diagonals have the same orientation relative to the grid.  If
-exactly one of the four cell corners is excluded by the *note
-undefined:: handler, and this is on the usual diagonal, both triangles
-will be excluded.  However if the default setting of 'altdiagonal' is
-active, the other diagonal will be chosen for this cell instead,
-minimizing the size of the hole in the surface.
-
-   The 'bentover' option controls what happens to another special case,
-this time in conjunction with the 'trianglepattern'.  For rather crumply
-surfaces, it can happen that the two triangles a surface cell is divided
-into are seen from opposite sides (i.e.  the original quadrangle is
-'bent over'), as illustrated in the following ASCII art:
-
-                                                                   C----B
-         original quadrangle:  A--B      displayed quadrangle:     |\   |
-           ("set view 0,0")    | /|    ("set view 75,75" perhaps)  | \  |
-                               |/ |                                |  \ |
-                               C--D                                |   \|
-                                                                   A    D
-
-
-   If the diagonal edges of the surface cells aren't generally made
-visible by bit 2 of the <bitpattern> there, the edge CB above wouldn't
-be drawn at all, normally, making the resulting display hard to
-understand.  Therefore, the default option of 'bentover' will turn it
-visible in this case.  If you don't want that, you may choose
-'nobentover' instead.  D hidden 6 See also hidden line removal demo
-(hidden.dem) (http://www.gnuplot.info/demo/hidden.html) and complex
-hidden line demo (singulr.dem).
-(http://www.gnuplot.info/demo/singulr.html)
-
-
-File: gnuplot.info,  Node: history_,  Next: isosamples,  Prev: hidden3d,  Up: set-show
-
-3.33.34 history
----------------
-
-Syntax:
-        set history {size <N>} {quiet|numbers} {full|trim} {default}
-
-
-   A log of recent gnuplot commands is kept by default in
-$HOME/.gnuplot_history.  If this file is not found and xdg desktop
-support is enabled, the program will instead use
-$XDG_STATE_HOME/gnuplot_history.
-
-   When leaving gnuplot the value of history size limits the number of
-lines saved to the history file.  'set history size -1' allows an
-unlimited number of lines to be written to the history file.
-
-   By default the *note history:: command prints a line number in front
-of each command.  'history quiet' suppresses the number for this command
-only.  'set history quiet' suppresses numbers for all future *note
-history:: commands.
-
-   The *note trim:: option reduces the number of duplicate lines in the
-history list by removing earlier instances of the current command.
-
-   Default settings: *note trim::.
-
-
-File: gnuplot.info,  Node: isosamples,  Next: isosurface_,  Prev: history_,  Up: set-show
-
-3.33.35 isosamples
-------------------
-
-The isoline density (grid) for plotting functions as surfaces may be
-changed by the *note isosamples:: command.
-
-   Syntax:
-           set isosamples <iso_1> {,<iso_2>}
-           show isosamples
-
-
-   Each function surface plot will have <iso_1> iso-u lines and <iso_2>
-iso-v lines.  If you only specify <iso_1>, <iso_2> will be set to the
-same value as <iso_1>.  By default, sampling is set to 10 isolines per u
-or v axis.  A higher sampling rate will produce more accurate plots, but
-will take longer.  These parameters have no effect on data file
-plotting.
-
-   An isoline is a curve parameterized by one of the surface parameters
-while the other surface parameter is fixed.  Isolines provide a simple
-means to display a surface.  By fixing the u parameter of surface
-s(u,v), the iso-u lines of the form c(v) = s(u0,v) are produced, and by
-fixing the v parameter, the iso-v lines of the form c(u) = s(u,v0) are
-produced.
-
-   When a function surface plot is being done without the removal of
-hidden lines, *note samples:: controls the number of points sampled
-along each isoline; see *note samples:: and *note hidden3d::.  The
-contour algorithm assumes that a function sample occurs at each isoline
-intersection, so change in *note samples:: as well as *note isosamples::
-may be desired when changing the resolution of a function
-surface/contour.
-
-
-File: gnuplot.info,  Node: isosurface_,  Next: isotropic,  Prev: isosamples,  Up: set-show
-
-3.33.36 isosurface
-------------------
-
-Syntax:
-          set isosurface {mixed|triangles}
-          set isosurface {no}insidecolor <n>
-
-   Surfaces plotted by the command *note isosurface:: are by default
-constructed from a mixture of quadrangles and triangles.  The use of
-quadrangles creates a less complicated visual impression.  This command
-provides an option to tessellate with only triangles.
-
-   By default the inside of an isosurface is drawn in a separate color.
-The method of choosing that color is the same as for hidden3d surfaces,
-where an offset <n> is added to the base linetype.  To draw both the
-inside and outside surfaces in the same color, use 'set isosurface
-noinsidecolor'.
-
-
-File: gnuplot.info,  Node: isotropic,  Next: jitter,  Prev: isosurface_,  Up: set-show
-
-3.33.37 isotropic
------------------
-
-Syntax:
-          set isotropic
-          unset isotropic
-
-   *note isotropic:: adjusts the aspect ratio and size of the plot so
-that the unit length along the x, y, and z axes is the same.  It is
-equivalent to 'set size ratio -1; set view equal xyz' and supersedes
-both of those commands.  This affects both 2D and 3D plots.
-
-   *note isotropic:: relaxes both the 2D and 3D constraints.  It is
-equivalent to the older commands 'set size noratio; set view
-noequal_axes' but hopefully easier to remember.
-
-
-File: gnuplot.info,  Node: jitter,  Next: key_,  Prev: isotropic,  Up: set-show
-
-3.33.38 jitter
---------------
-
-Syntax:
-           set jitter {overlap <yposition>} {spread <factor>} {wrap <limit>}
-                      {swarm|square|vertical}
-
-   Examples:
-           set jitter                    # jitter points within 1 character width
-           set jitter overlap 1.5        # jitter points within 1.5 character width
-           set jitter over 1.5 spread 0.5  # same but half the displacement on x
-
-
-   When one or both coordinates of a data set are restricted to discrete
-values then many points may lie exactly on top of each other.  Jittering
-introduces an offset to the coordinates of these superimposed points
-that spreads them into a cluster.  The threshold value for treating the
-points as being overlapped may be specified in character widths or any
-of the usual coordinate options.  See 'coordinates'.  Jitter affects 2D
-plot styles 'with points', *note impulses:: and *note boxplot::.  It
-also affects 3D plotting of voxel grids.
-
-   The default jittering operation displaces points only along x.  This
-produces a distinctive pattern sometimes called a "bee swarm plot".  The
-optional keyword 'square' adjusts the y coordinate of displaced points
-in addition to their x coordinate so that the points lie in distinct
-layers separated by at least the 'overlap' distance.
-
-   To jitter along y (only) rather than along x, use keyword 'vertical'.
-
-   The maximum displacement (in character units) can be limited using
-the 'wrap' keyword.
-
-   Note that both the overlap criterion and the magnitude of jitter
-default to one character unit.  Thus the plot appearance will change
-with the terminal font size, canvas size, or zoom factor.  To avoid this
-you can specify the overlap criterion in the y axis coordinate system
-(the 'first' keyword) and adjust the point size and spread multiplier as
-appropriate.  See 'coordinates', *note pointsize::.
-
-   Caveat: jitter is incompatible with "pointsize variable".
-
-   *note jitter:: is also useful in 3D plots of voxel data.  Because
-voxel grids are regular lattices of evenly spaced points, many view
-angles cause points to overlap and/or generate Moiré patterns.  These
-artifacts can be removed by displacing the symbol drawn at each grid
-point by a random amount.
-
-
-File: gnuplot.info,  Node: key_,  Next: label,  Prev: jitter,  Up: set-show
-
-3.33.39 key
------------
-
-The 'set key' command enables a key (or legend) containing a title and a
-sample (line, point, box) for each plot in the graph.  The key may be
-turned off by requesting 'set key off' or 'unset key'.  Individual key
-entries may be turned off by using the 'notitle' keyword in the
-corresponding plot command.  The text of the titles is controlled by the
-'set key autotitle' option or by the *note title:: keyword of individual
-'plot' and 'splot' commands.
-
-   See 'key placement' for syntax of options that affect where the key
-is placed.  See 'key layout' for syntax of options that affect the
-content of the key.
-
-   Syntax (global options):
-           set key {on|off} {default}
-                 {font "<face>,<size>"} {{no}enhanced}
-                 {{no}title "<text>" {<font or other text options>}}
-                 {{no}autotitle {columnheader}}
-                 {{no}box {<line properties>}} {{no}opaque {fc <colorspec>}}
-                 {width <width_increment>} {height <height_increment>}
-           unset key
-
-
-   By default the key is placed in the upper right inside corner of the
-graph.  The optional 'font' becomes the default for all elements of the
-key.  You can provide an option title for the key as a whole that spans
-the full width of the key at the top.  This title can use different
-font, color, justification, and enhancement from individual plot titles.
-
-   Each component in a plot command is represented in the key by a
-single line containing corresponding title text and a line or symbol or
-shape representing the plot style.  The title text may be auto-generated
-or given explicitly in the plot command as 'title "text"'.  Using the
-keyword 'notitle' in the plot command will suppress generation of the
-entire line.  If you want to suppress the text only, use 'title ""' in
-the plot command.
-
-   Contour plots generated additional entries in the key (see *note
-cntrlabel::).  You can add extra lines to the key by inserting a dummy
-plot command that uses the keyword 'keyentry' rather than a filename or
-a function.  See 'keyentry'.
-
-   A box can be drawn around the key ('box {...}') with user-specified
-line properties.  The 'height' and 'width' increments (specified in
-character units) are added to or subtracted from the size of the key
-box.  This is useful mainly when you want larger borders around the key
-entries.
-
-   By default the key is built up one plot at a time.  That is, the key
-symbol and title are drawn at the same time as the corresponding plot.
-That means newer plots may sometimes place elements on top of the key.
-'set key opaque' causes the key to be generated after all the plots.  In
-this case the key area is filled with background color or the requested
-fill color and then the key symbols and titles are written.  The default
-can be restored by 'set key noopaque'.
-
-   The text in the key uses 'enhanced' mode by default.  This can be
-suppressed by the 'noenhanced' keyword applied to the entire key, to the
-key title only, or to individual plot titles.
-
-   'set key default' restores the default key configuration.
-          set key notitle
-          set key nobox noopaque
-          set key fixed right top vertical Right noreverse enhanced autotitle
-          set key noinvert samplen 4 spacing 1 width 0 height 0
-          set key maxcolumns 0 maxrows 0
-
-
-* Menu:
-
-* 3D_key::
-* key_examples::
-* extra_key_entries::
-* key_autotitle::
-* key_layout::
-* key_placement::
-* key_offset::
-* key_samples::
-* multiple_keys::
-
-
-File: gnuplot.info,  Node: 3D_key,  Next: key_examples,  Prev: key_,  Up: key_
-
-3.33.39.1 3D key
-................
-
-Placement of the key for 3D plots ('splot') by default uses the 'fixed'
-option.  This is very similar to 'inside' placement with one important
-difference.  The plot boundaries of a 3D plot change as the view point
-is rotated or scaled.  If the key is positioned 'inside' these
-boundaries then the key also moves when the view is changed.  'fixed'
-positioning ignores changes to the view angles or scaling; i.e.  the key
-remains fixed in one location on the canvas as the plot is rotated.
-
-   For 2D plots the 'fixed' option is exactly equivalent to 'inside'.
-
-   If 'splot' is being used to draw contours, by default a separate key
-entry is generated for each contour level with a distinct line type.  To
-modify this see *note cntrlabel::.
-
-
-File: gnuplot.info,  Node: key_examples,  Next: extra_key_entries,  Prev: 3D_key,  Up: key_
-
-3.33.39.2 key examples
-......................
-
-This places the key at the default location:
-           set key default
-
-
-   This places a key at a specific place (upper right) on the screen:
-           set key at screen 0.85, 0.85
-
-
-   This places the key below the graph and minimizes the vertical space
-taken:
-           set key below horizontal
-
-
-   This places the key in the bottom left corner of the plot,
-left-justifies the text, gives the key box a title at the top, and draws
-a box around it with a thick border:
-           set key left bottom Left title 'Legend' box lw 3
-
-
-
-File: gnuplot.info,  Node: extra_key_entries,  Next: key_autotitle,  Prev: key_examples,  Up: key_
-
-3.33.39.3 extra key entries
-...........................
-
-Normally each plot autogenerates a single line entry in the key.  If you
-need more control over what appears in the key you can use the
-'keyentry' keyword in the 'plot' or 'splot' command to insert extra
-lines.  Instead of providing a filename or function to plot, use
-'keyentry' as a placeholder followed by plot style information (used to
-generate a key symbol) and a title.  All the usual options for title
-font, text color, 'at' coordinates, and enhanced text markup apply.
-Example:
-          set key outside right center
-          plot $HEATMAP matrix with image notitle, \
-               keyentry "Outcomes" left, \
-               keyentry with boxes fc palette cb 0 title "no effect", \
-               keyentry with boxes fc palette cb 1 title "threshold", \
-               keyentry with boxes fc palette cb 3 title "typical range", \
-               keyentry                            title "as reported in [12]", \
-               keyentry with boxes fc palette cb 5 title "strong effect"
-
-
-   The line generated by 'keyentry "Outcomes" left' places
-left-justified text in the space that would normally hold the sample.
-This allows an embedded title that may span the full width of the key.
-If a title is given also in the same keyentry then both strings appear
-on the same line, allowing generation of two-column key entries.  You
-can use keywords 'left/right/center' for justification, 'boxed', etc.
-Example:
-          plot ..., keyentry "West Linn" boxed title "locations"
-
-
-
-File: gnuplot.info,  Node: key_autotitle,  Next: key_layout,  Prev: extra_key_entries,  Up: key_
-
-3.33.39.4 key autotitle
-.......................
-
-'set key autotitle' causes each plot to be identified in the key by the
-name of the data file or function used in the plot command.  This is the
-default.  'set key noautotitle' disables the automatic generation of
-plot titles.
-
-   The command 'set key autotitle columnheader' causes the first entry
-in each column of input data to be interpreted as a text string and used
-as a title for the corresponding plot.  If the quantity being plotted is
-a function of data from several columns, gnuplot may be confused as to
-which column to draw the title from.  In this case it is necessary to
-specify the column explicitly in the plot command, e.g.
-
-           plot "datafile" using (($2+$3)/$4) title columnhead(3) with lines
-
-
-   Note: The effect of 'set key autotitle columnheader', treatment of
-the first line in a data file as column headers rather than data applies
-even if the key is disabled by 'unset key'.  It also applies to 'stats'
-and *note fit:: commands even though they generate no key.  If you want
-the first line of data to be treated as column headers but _not_ to use
-them for plot titles, use *note columnheaders::.
-
-   In all cases an explicit *note title:: or 'notitle' keyword in the
-plot command itself will override the default from 'set key autotitle'.
-
-
-File: gnuplot.info,  Node: key_layout,  Next: key_placement,  Prev: key_autotitle,  Up: key_
-
-3.33.39.5 key layout
-....................
-
-Key layout options:
-          set key {vertical | horizontal}
-                 {maxcols {<max no. of columns> | auto}}
-                 {maxrows {<max no. of rows> | auto}}
-                 {columns <exact no. of columns>}
-                 {keywidth [screen|graph] <fraction>}
-                 {Left | Right}
-                 {{no}reverse} {{no}invert}
-                 {samplen <sample_length>} {spacing <line_spacing>}
-                 {width <width_increment>} {height <height_increment>}
-                 {title {"<text>"} {{no}enhanced} {center | left | right}}
-                 {font "<face>,<size>"} {textcolor <colorspec>}
-
-
-   Automatic arrangement of elements within the key into rows and
-columns is affected by the keywords shown above.  The default is
-'vertical', for which the key uses the fewest columns possible.
-Elements are aligned in a column until there is no more vertical space,
-at which point a new column is started.  The vertical space may be
-limited using 'maxrows'.  In the case of 'horizontal', the key instead
-uses the fewest rows possible.  The horizontal space may be limited
-using 'maxcols'.
-
-   The auto-selected number of rows and columns may be unsatisfactory.
-You can specify a definite number of columns using 'set key columns
-<N>'.  In this case you may need to adjust the sample widths ('samplen')
-and the total key width ('keywidth').
-
-   By default the first plot label is at the top of the key and
-successive labels are entered below it.  The 'invert' option causes the
-first label to be placed at the bottom of the key, with successive
-labels entered above it.  This option is useful to force the vertical
-ordering of labels in the key to match the order of box types in a
-stacked histogram.
-
-   'set key title "text"' places an overall title at the top of the key.
-Font, text justification, and other text properties specific to the
-title can be specified by placing the required keywords immediately
-after the '"text"' in this command.  Font or text properties specified
-elsewhere apply to all text in the key.
-
-   The default layout places a style sample (color, line, point, shape,
-etc) at the left of the key entry line, and the title text at the right.
-The text and sample positions can be swapped using the 'reverse'
-keyword.  Text justification of the individual plot titles within the
-key is controlled by 'Left' or 'Right' (default).  The horizontal extend
-of the style sample can be set to an approximate number of character
-width ('samplen').
-
-   When using the TeX/LaTeX group of terminals or terminals in which
-formatting information is embedded in the string, 'gnuplot' is bad at
-estimating the amount of space required, so the automatic key layout may
-be poor.  If the key is to be positioned at the left, it may help to use
-the combination 'set key left Left reverse' and force the appropriate
-number of columns or total key width.
-
-
-File: gnuplot.info,  Node: key_placement,  Next: key_offset,  Prev: key_layout,  Up: key_
-
-3.33.39.6 key placement
-.......................
-
-Key placement options:
-           set key {inside | outside | fixed}
-                   {lmargin | rmargin | tmargin | bmargin}
-                   {at <position>}}
-                   {left | right | center} {top | bottom | center}
-                   {offset <dx>,<dy>}
-
-
-   This section describes placement of the primary, auto-generated key.
-To construct a secondary key or place plot titles elsewhere, see
-'multiple keys'.
-
-   To understand positioning, the best concept is to think of a region,
-i.e., inside/outside, or one of the margins.  Along with the region,
-keywords 'left/center/right' (l/c/r) and 'top/center/bottom' (t/c/b)
-control where within the particular region the key should be placed.  In
-'inside' mode, the keywords 'left' (l), 'right' (r), 'top' (t), 'bottom'
-(b), and 'center' (c) push the key out toward the plot boundary as
-illustrated here:
-
-          t/l   t/c   t/r
-
-
-          c/l    c    c/r
-
-
-          b/l   b/c   b/r
-
-
-   In 'outside' mode, automatic placement is similar to the above
-illustration, but with respect to the view, rather than the graph
-boundary.  That is, a border is moved inward to make room for the key
-outside of the plotting area, although this may interfere with other
-labels and may cause an error on some devices.  The particular plot
-border that is moved depends upon the position described above and the
-stacking direction.  For options centered in one of the dimensions,
-there is no ambiguity about which border to move.  For the corners, when
-the stack direction is 'vertical', the left or right border is moved
-inward appropriately.  When the stack direction is 'horizontal', the top
-or bottom border is moved inward appropriately.
-
-   The margin syntax allows automatic placement of key regardless of
-stack direction.  When one of the margins *note lmargin:: (lm), *note
-rmargin:: (rm), *note tmargin:: (tm), and *note bmargin:: (bm) is
-combined with a single, non-conflicting direction keyword, the key is
-positioned along the outside of the page as shown here.  Keywords
-'above' and 'over' are synonymous with *note tmargin::.  Keywords
-'below' and 'under' are synonymous with *note bmargin::.
-
-               l/tm  c/tm  r/tm
-
-
-          t/lm                  t/rm
-
-
-          c/lm                  c/rm
-
-
-          b/lm                  b/rm
-
-
-               l/bm  c/bm  r/bm
-
-
-   For version compatibility, 'above', 'over', 'below', or 'under'
-without any additional l/c/r or stack direction keyword uses 'center'
-and 'horizontal'.  The keyword 'outside' without any additional t/b/c or
-stack direction keyword uses 'top', 'right' and 'vertical' (i.e., the
-same as t/rm above).
-
-   The <position> can be a simple x,y,z as in previous versions, but
-these can be preceded by one of five keywords ('first', 'second',
-'graph', 'screen', 'character') which selects the coordinate system in
-which the position of the first sample line is specified.  See
-'coordinates' for more details.  The effect of 'left', 'right', 'top',
-'bottom', and 'center' when <position> is given is to align the key as
-though it were text positioned using the label command, i.e., 'left'
-means left align with key to the right of <position>, etc.
-
-
-File: gnuplot.info,  Node: key_offset,  Next: key_samples,  Prev: key_placement,  Up: key_
-
-3.33.39.7 key offset
-....................
-
-Regardless of the key placement options chosen, the final position of
-the key can be adjusted manually by specifying an offset.  As usual, the
-x and y components of the offset may be given in character, graph, or
-screen coordinates.
-
-
-File: gnuplot.info,  Node: key_samples,  Next: multiple_keys,  Prev: key_offset,  Up: key_
-
-3.33.39.8 key samples
-.....................
-
-By default, each plot on the graph generates a corresponding entry in
-the key.  This entry contains a plot title and a sample line/point/box
-of the same color and fill properties as used in the plot itself.  The
-font and textcolor properties control the appearance of the individual
-plot titles that appear in the key.  Setting the textcolor to "variable"
-causes the text for each key entry to be the same color as the line or
-fill color for that plot.  This was the default in some earlier versions
-of gnuplot.
-
-   The length of the sample line can be controlled by 'samplen'.  The
-sample length is computed as the sum of the tic length and
-<sample_length> times the character width.  It also affects the
-positions of point samples in the key since these are drawn at the
-midpoint of the sample line, even if the line itself is not drawn.
-
-   Key entry lines are single-spaced based on the current font size.
-This can be adjusted by 'set key spacing <line-spacing>'.
-
-   The <width_increment> is a number of character widths to be added to
-or subtracted from the length of the string.  This is useful only when
-you are putting a box around the key and you are using control
-characters in the text.  'gnuplot' simply counts the number of
-characters in the string when computing the box width; this allows you
-to correct it.
-
-
-File: gnuplot.info,  Node: multiple_keys,  Prev: key_samples,  Up: key_
-
-3.33.39.9 multiple keys
-.......................
-
-It is possible to construct a legend/key manually rather than having the
-plot titles all appear in the auto-generated key.  This allows, for
-example, creating a single legend for the component panels in a
-multiplot.
-            set multiplot layout 3,2 columnsfirst
-            set style data boxes
-            plot $D using 0:6  lt 1 title at 0.75, 0.20
-            plot $D using 0:12 lt 2 title at 0.75, 0.17
-            plot $D using 0:13 lt 3 title at 0.75, 0.14
-            plot $D using 0:14 lt 4 title at 0.75, 0.11
-            set label 1 at screen 0.75, screen 0.22 "Custom combined key area"
-            plot $D using 0:($6+$12+$13+$14) with linespoints title "total"
-            unset multiplot
-
-
-
-File: gnuplot.info,  Node: label,  Next: linetype,  Prev: key_,  Up: set-show
-
-3.33.40 label
--------------
-
-Arbitrary labels can be placed on the plot using the 'set label'
-command.
-
-   Syntax:
-           set label {<tag>} {"<label text>"} {at <position>}
-                     {left | center | right}
-                     {norotate | rotate {by <degrees>}}
-                     {font "<name>{,<size>}"}
-                     {noenhanced}
-                     {front | back}
-                     {textcolor <colorspec>}
-                     {point <pointstyle> | nopoint}
-                     {offset <offset>}
-                     {nobox} {boxed {bs <boxstyle>}}
-                     {hypertext}
-           unset label {<tag>}
-           show label
-
-
-   The <position> is specified by either x,y or x,y,z, and may be
-preceded by 'first', 'second', 'polar', 'graph', 'screen', or
-'character' to indicate the coordinate system.  See 'coordinates' for
-details.
-
-   The tag is an integer that is used to identify the label.  If no
-<tag> is given, the lowest unused tag value is assigned automatically.
-The tag can be used to delete or modify a specific label.  To change any
-attribute of an existing label, use the 'set label' command with the
-appropriate tag, and specify the parts of the label to be changed.
-
-   The <label text> can be a string constant, a string variable, or a
-string- valued expression.  See 'strings', *note sprintf::, and *note
-gprintf::.
-
-   By default, the text is placed flush left against the point x,y,z.
-To adjust the way the label is positioned with respect to the point
-x,y,z, add the justification parameter, which may be 'left', 'right' or
-'center', indicating that the point is to be at the left, right or
-center of the text.  Labels outside the plotted boundaries are permitted
-but may interfere with axis labels or other text.
-
-   Some terminals support enclosing the label in a box.  See 'set style
-textbox'.  Not all terminals can handle boxes for rotated text.
-
-   If 'rotate' is given, the label is written vertically.  If 'rotate by
-<degrees>' is given, the baseline of the text will be set to the
-specified angle.  Some terminals do not support text rotation.
-
-   Font and its size can be chosen explicitly by 'font
-"<name>{,<size>}"' if the terminal supports font settings.  Otherwise
-the default font of the terminal will be used.
-
-   Normally the enhanced text mode string interpretation, if enabled for
-the current terminal, is applied to all text strings including label
-text.  The 'noenhanced' property can be used to exempt a specific label
-from the enhanced text mode processing.  The can be useful if the label
-contains underscores, for example.  See 'enhanced text'.
-
-   If 'front' is given, the label is written on top of the graphed data.
-If 'back' is given (the default), the label is written underneath the
-graphed data.  Using 'front' will prevent a label from being obscured by
-dense data.
-
-   'textcolor <colorspec>' changes the color of the label text.
-<colorspec> can be a linetype, an rgb color, or a palette mapping.  See
-help for *note colorspec:: and *note palette::.  'textcolor' may be
-abbreviated 'tc'.
-        `tc default` resets the text color to its default state.
-        `tc lt <n>` sets the text color to that of line type <n>.
-        `tc ls <n>` sets the text color to that of line style <n>.
-        `tc palette z` selects a palette color corresponding to the label z position.
-        `tc palette cb <val>` selects a color corresponding to <val> on the colorbox.
-        `tc palette fraction <val>`, with 0<=val<=1, selects a color corresponding to
-            the mapping [0:1] to grays/colors of the *note palette::.
-        `tc rgb "#RRGGBB"` or `tc rgb "0xRRGGBB"` sets an arbitrary 24-bit RGB color.
-        `tc rgb 0xRRGGBB`  As above; a hexadecimal constant does not require quotes.
-
-
-   If a <pointstyle> is given, using keywords 'lt', 'pt' and 'ps', see
-*note style::, a point with the given style and color of the given line
-type is plotted at the label position and the text of the label is
-displaced slightly.  This option is used by default for placing labels
-in 'mouse' enhanced terminals.  Use 'nopoint' to turn off the drawing of
-a point near the label (this is the default).
-
-   The displacement defaults to 1,1 in *note pointsize:: units if a
-<pointstyle> is given, 0,0 if no <pointstyle> is given.  The
-displacement can be controlled by the optional 'offset <offset>' where
-<offset> is specified by either x,y or x,y,z, and may be preceded by
-'first', 'second', 'graph', 'screen', or 'character' to select the
-coordinate system.  See 'coordinates' for details.
-
-   If one (or more) axis is timeseries, the appropriate coordinate
-should be given as a quoted time string according to the *note timefmt::
-format string.  See *note xdata:: and *note timefmt::.
-
-   The options available for 'set label' are also available for the
-*note labels:: plot style.  See *note labels::.  In this case the
-properties 'textcolor', 'rotate', and *note pointsize:: may be followed
-by keyword 'variable' rather than by a fixed value.  In this case the
-corresponding property of individual labels is determined by additional
-columns in the 'using' specifier.
-
-* Menu:
-
-* examples_::
-* hypertext::
-
-
-File: gnuplot.info,  Node: examples_,  Next: hypertext,  Prev: label,  Up: label
-
-3.33.40.1 examples
-..................
-
-Examples:
-
-   To set a label at (1,2) to "y=x", use:
-           set label "y=x" at 1,2
-
-
-   To set a Sigma of size 24, from the Symbol font set, at the center of
-the graph, use:
-           set label "S" at graph 0.5,0.5 center font "Symbol,24"
-
-
-   To set a label "y=x^2" with the right of the text at (2,3,4), and tag
-the label as number 3, use:
-           set label 3 "y=x^2" at 2,3,4 right
-
-
-   To change the preceding label to center justification, use:
-           set label 3 center
-
-
-   To delete label number 2, use:
-           unset label 2
-
-
-   To delete all labels, use:
-           unset label
-
-
-   To show all labels (in tag order), use:
-           show label
-
-
-   To set a label on a graph with a timeseries on the x axis, use, for
-example:
-           set timefmt "%d/%m/%y,%H:%M"
-           set label "Harvest" at "25/8/93",1
-
-
-   To display a freshly fitted parameter on the plot with the data and
-the fitted function, do this after the *note fit::, but before the
-'plot':
-           set label sprintf("a = %3.5g",par_a) at 30,15
-           bfit = gprintf("b = %s*10^%S",par_b)
-           set label bfit at 30,20
-
-
-   To display a function definition along with its fitted parameters,
-use:
-           f(x)=a+b*x
-           fit f(x) 'datafile' via a,b
-           set label GPFUN_f at graph .05,.95
-           set label sprintf("a = %g", a) at graph .05,.90
-           set label sprintf("b = %g", b) at graph .05,.85
-
-
-   To set a label displaced a little bit from a small point:
-           set label 'origin' at 0,0 point lt 1 pt 2 ps 3 offset 1,-1
-
-
-   To set a label whose color matches the z value (in this case 5.5) of
-some point on a 3D splot colored using pm3d:
-           set label 'text' at 0,0,5.5 tc palette z
-
-
-
-File: gnuplot.info,  Node: hypertext,  Prev: examples_,  Up: label
-
-3.33.40.2 hypertext
-...................
-
-Some terminals (wxt, qt, svg, canvas, win) allow you to attach hypertext
-to specific points on the graph or elsewhere on the canvas.  When the
-mouse hovers over the anchor point, a pop-up box containing the text is
-displayed.  Terminals that do not support hypertext will display
-nothing.  You must enable the 'point' attribute of the label in order
-for the hypertext to be anchored.  Enhanced text markup is not applied
-to hypertext labels.  Examples:
-           set label at 0,0 "Plot origin" hypertext point pt 1
-           plot 'data' using 1:2:0 with labels hypertext point pt 7 \
-                title 'mouse over point to see its order in data set'
-
-
-           # mousing over any point of this pm3d surface will display
-           # its Z coordinate as hypertext
-           splot '++' using 1:2:(F($1,$2)) with pm3d, \
-                 '++' using 1:2:(F($1,$2)):(sprintf("%.3f", F($1,$2))) with labels \
-                      hypertext point lc rgb "0xff000000" notitle
-
-
-   For the wxt and qt terminals, left-click on a hypertext anchor after
-the text has appeared will copy the hypertext to the clipboard.
-
-   EXPERIMENTAL (implementation details may change) - Text of the form
-"image{<xsize>,<ysize>}:<filename>{\n<caption text>}" will trigger
-display of the image file in a pop-up box.  The optional size overrides
-a default box size 300x200.  The types of image file recognized may vary
-by terminal type, but *.png should always work.  Any additional text
-lines following the image filename are displayed as usual for hypertext.
-Example:
-           set label 7 "image:../figures/Fig7_inset.png\nFigure 7 caption..."
-           set label 7 at 10,100 hypertext point pt 7
-
-
-
-File: gnuplot.info,  Node: linetype,  Next: link,  Prev: label,  Up: set-show
-
-3.33.41 linetype
-----------------
-
-The 'set linetype' command allows you to redefine the basic linetypes
-used for plots.  The command options are identical to those for "set
-style line".  Unlike line styles, redefinitions by 'set linetype' are
-persistent.  They are not affected by *note reset::.  However the
-initial linetype properties are restored by 'reset session'.
-
-   For example, whatever linetypes one and two look like to begin with,
-if you redefine them like this:
-
-           set linetype 1 lw 2 lc rgb "blue" pointtype 6
-           set linetype 2 lw 2 lc rgb "forest-green" pointtype 8
-
-
-   everywhere that uses lt 1 will now get a thick blue line.  This
-includes uses such as the definition of a temporary linestyle derived
-from the base linetype 1.  Similarly lt 2 will now produce a thick green
-line.
-
-   This mechanism can be used to define a set of personal preferences
-for the sequence of lines used in gnuplot.  The recommended way to do
-this is to add to the run-time initialization file ~/.gnuplot a sequence
-of commands like
-
-           set linetype 1 lc rgb "dark-violet" lw 2 pt 1
-           set linetype 2 lc rgb "sea-green"   lw 2 pt 7
-           set linetype 3 lc rgb "cyan"        lw 2 pt 6 pi -1
-           set linetype 4 lc rgb "dark-red"    lw 2 pt 5 pi -1
-           set linetype 5 lc rgb "blue"        lw 2 pt 8
-           set linetype 6 lc rgb "dark-orange" lw 2 pt 3
-           set linetype 7 lc rgb "black"       lw 2 pt 11
-           set linetype 8 lc rgb "goldenrod"   lw 2
-           set linetype cycle 8
-
-
-   Every time you run gnuplot the line types will be initialized to
-these values.  You may initialize as many linetypes as you like.  If you
-do not redefine, say, linetype 3 then it will continue to have the
-default properties (in this case blue, pt 3, lw 1, etc).
-
-   Similar script files can be used to define theme-based color choices,
-or sets of colors optimized for a particular plot type or output device.
-
-   The command 'set linetype cycle 8' tells gnuplot to re-use these
-definitions for the color and linewidth of higher-numbered linetypes.
-That is, linetypes 9-16, 17-24, and so on will use this same sequence of
-colors and widths.  The point properties (pointtype, pointsize,
-pointinterval) are not affected by this command.  'unset linetype cycle'
-disables this feature.  If the line properties of a higher numbered
-linetype are explicitly defined, this takes precedence over the recycled
-low-number linetype properties.
-
-
-File: gnuplot.info,  Node: link,  Next: lmargin,  Prev: linetype,  Up: set-show
-
-3.33.42 link
-------------
-
-Syntax:
-           set link {x2 | y2} {via <expression1> inverse <expression2>}
-           unset link
-
-
-   The *note link:: command establishes a mapping between the x and x2
-axes, or the y and y2 axes.  <expression1> maps primary axis coordinates
-onto the secondary axis.  <expression2> maps secondary axis coordinates
-onto the primary axis.
-
-   Examples:
-
-           set link x2
-
-
-   This is the simplest form of the command.  It forces the x2 axis to
-have identically the same range, scale, and direction as the x axis.
-Commands *note xrange::, *note x2range::, 'set auto x', etc will affect
-both the x and x2 axes.
-
-           set link x2 via x**2 inverse sqrt(x)
-           plot "sqrt_data" using 1:2 axes x2y1, "linear_data" using 1:2 axes x1y1
-
-
-   This command establishes forward and reverse mapping between the x
-and x2 axes.  The forward mapping is used to generate x2 tic labels and
-x2 mouse coordinate The reverse mapping is used to plot coordinates
-given in the x2 coordinate system.  Note that the mapping as given is
-valid only for x non-negative.  When mapping to the y2 axis, both
-<expression1> and <expression2> must use y as dummy variable.
-
-
-File: gnuplot.info,  Node: lmargin,  Next: loadpath,  Prev: link,  Up: set-show
-
-3.33.43 lmargin
----------------
-
-The command *note lmargin:: sets the size of the left margin.  Please
-see *note margin:: for details.
-
-
-File: gnuplot.info,  Node: loadpath,  Next: locale,  Prev: lmargin,  Up: set-show
-
-3.33.44 loadpath
-----------------
-
-The *note loadpath:: setting defines additional locations for data and
-command files searched by the *note call::, 'load', 'plot' and 'splot'
-commands.  If a file cannot be found in the current directory, the
-directories in *note loadpath:: are tried.
-
-   Syntax:
-           set loadpath {"pathlist1" {"pathlist2"...}}
-           show loadpath
-
-
-   Path names may be entered as single directory names, or as a list of
-path names separated by a platform-specific path separator, eg.  colon
-(':') on Unix, semicolon (';') on DOS/Windows/OS/2 platforms.  The *note
-loadpath::, *note save:: and 'save set' commands replace the
-platform-specific separator with a space character (' ').
-
-   If the environment variable GNUPLOT_LIB is set, its contents are
-appended to *note loadpath::.  However, *note loadpath:: prints the
-contents of *note loadpath:: and GNUPLOT_LIB separately.  Also, the
-*note save:: and 'save set' commands ignore the contents of GNUPLOT_LIB.
-
-
-File: gnuplot.info,  Node: locale,  Next: logscale,  Prev: loadpath,  Up: set-show
-
-3.33.45 locale
---------------
-
-The *note locale:: setting determines the language with which
-'{x,y,z}{d,m}tics' will write the days and months.
-
-   Syntax:
-           set locale {"<locale>"}
-
-
-   <locale> may be any language designation acceptable to your
-installation.  See your system documentation for the available options.
-The command 'set locale ""' will try to determine the locale from the
-LC_TIME, LC_ALL, or LANG environment variables.
-
-   To change the decimal point locale, see *note decimalsign::.  To
-change the character encoding to the current locale, see *note
-encoding::.
-
-
-File: gnuplot.info,  Node: logscale,  Next: macros,  Prev: locale,  Up: set-show
-
-3.33.46 logscale
-----------------
-
-Syntax:
-           set logscale <axes> {<base>}
-           unset logscale <axes>
-           show logscale
-
-
-   where <axes> may be any combinations of 'x', 'x2', 'y', 'y2', 'z',
-'cb', and 'r' in any order.  <base> is the base of the log scaling
-(default is base 10).  If no axes are specified, the command affects all
-axes except 'r'.  The command *note logscale:: turns off log scaling for
-all axes.  Note that the ticmarks generated for logscaled axes are not
-uniformly spaced.  See 'set xtics'.
-
-   Examples:
-
-   To enable log scaling in both x and z axes:
-           set logscale xz
-
-
-   To enable scaling log base 2 of the y axis:
-           set logscale y 2
-
-
-   To enable z and color log axes for a pm3d plot:
-           set logscale zcb
-
-
-   To disable z axis log scaling:
-           unset logscale z
-
-
-
-File: gnuplot.info,  Node: macros,  Next: mapping,  Prev: logscale,  Up: set-show
-
-3.33.47 macros
---------------
-
-In this version of gnuplot macro substitution is always enabled.  Tokens
-in the command line of the form @<stringvariablename> will be replaced
-by the text string contained in <stringvariablename>.  See
-'substitution'.
-
-
-File: gnuplot.info,  Node: mapping,  Next: margin,  Prev: macros,  Up: set-show
-
-3.33.48 mapping
----------------
-
-If data are provided to 'splot' in spherical or cylindrical coordinates,
-the *note mapping:: command should be used to instruct 'gnuplot' how to
-interpret them.
-
-   Syntax:
-           set mapping {cartesian | spherical | cylindrical}
-
-
-   A cartesian coordinate system is used by default.
-
-   For a spherical coordinate system, the data occupy two or three
-columns (or 'using' entries).  The first two are interpreted as the
-azimuthal and polar angles theta and phi (or "longitude" and
-"latitude"), in the units specified by *note angles::.  The radius r is
-taken from the third column if there is one, or is set to unity if there
-is no third column.  The mapping is:
-
-           x = r * cos(theta) * cos(phi)
-           y = r * sin(theta) * cos(phi)
-           z = r * sin(phi)
-
-
-   Note that this is a "geographic" spherical system, rather than a
-"polar" one (that is, phi is measured from the equator, rather than the
-pole).
-
-   For a cylindrical coordinate system, the data again occupy two or
-three columns.  The first two are interpreted as theta (in the units
-specified by *note angles::) and z.  The radius is either taken from the
-third column or set to unity, as in the spherical case.  The mapping is:
-
-           x = r * cos(theta)
-           y = r * sin(theta)
-           z = z
-
-
-   The effects of *note mapping:: can be duplicated with the 'using'
-specifier of the 'splot' command, but *note mapping:: may be more
-convenient if many data files are to be processed.  However even if
-*note mapping:: is used, 'using' may still be necessary if the data in
-the file are not in the required order.
-
-   *note mapping:: has no effect on 'plot'.  world.dem: mapping demos.
-(http://www.gnuplot.info/demo/world.html)
-
-
-File: gnuplot.info,  Node: margin,  Next: micro,  Prev: mapping,  Up: set-show
-
-3.33.49 margin
---------------
-
-The *note margin:: is the distance between the plot border and the outer
-edge of the canvas.  The size of the margin is chosen automatically, but
-can be overridden by the *note margin:: commands.  *note margin:: shows
-the current settings.  To alter the distance between the inside of the
-plot border and the data in the plot itself, see *note offsets::.
-
-   Syntax:
-           set lmargin {{at screen} <margin>}
-           set rmargin {{at screen} <margin>}
-           set tmargin {{at screen} <margin>}
-           set bmargin {{at screen} <margin>}
-           set margins <left>, <right>, <bottom>, <top>
-           show margin
-
-
-   The default units of <margin> are character heights or widths, as
-appropriate.  A positive value defines the absolute size of the margin.
-A negative value (or none) causes 'gnuplot' to revert to the computed
-value.  For 3D plots, only the left margin can be set using character
-units.
-
-   The keywords 'at screen' indicates that the margin is specified as a
-fraction of the full drawing area.  This can be used to precisely line
-up the corners of individual 2D and 3D graphs in a multiplot.  This
-placement ignores the current values of *note origin:: and *note size::,
-and is intended as an alternative method for positioning graphs within a
-multiplot.
-
-   Normally the margins of a plot are automatically calculated based on
-tics, tic labels, axis labels, the plot title, the timestamp and the
-size of the key if it is outside the borders.  If, however, tics are
-attached to the axes ('set xtics axis', for example), neither the tics
-themselves nor their labels will be included in either the margin
-calculation or the calculation of the positions of other text to be
-written in the margin.  This can lead to tic labels overwriting other
-text if the axis is very close to the border.
-
-
-File: gnuplot.info,  Node: micro,  Next: minussign,  Prev: margin,  Up: set-show
-
-3.33.50 micro
--------------
-
-By default the "%c" format specifier for scientific notation used to
-generate axis tick labels uses a lower case u as a prefix to indicate
-"micro" (10^-6).  The *note micro:: command tells gnuplot to use a
-different typographic character (unicode U+00B5).  The byte sequence
-used to represent this character depends on the current encoding.  See
-'format specifiers', *note encoding::.
-
-   If the current encoding default is not satisfactory, you can provide
-a character string that generates the desired representation.  This is
-mostly useful for latex terminals, for example
-          set micro "{\textmu}"
-
-
-
-File: gnuplot.info,  Node: minussign,  Next: monochrome,  Prev: micro,  Up: set-show
-
-3.33.51 minussign
------------------
-
-Gnuplot uses the C language library routine sprintf() for most formatted
-input.  However it also has its own formatting routine 'gprintf()' that
-is used to generate axis tic labels.  The C library routine always use a
-hyphen character (ascii \055) to indicate a negative number, as in -7.
-Many people prefer a different typographic minus sign character (unicode
-U+2212) for this purpose, as in −7.  The command
-
-          set minussign
-
-
-   causes gprintf() to use this minus sign character rather than a
-hyphen in numeric output.  In a utf-8 locale this is the multibyte
-sequence corresponding to unicode U+2212.  In a Window codepage 1252
-locale this is the 8-bit character ALT+150 ("en dash").  The *note
-minussign:: command will affect axis tic labels and any labels that are
-created by explicitly invoking gprintf.  It has no effect on other
-strings that contain a hyphen.  See *note gprintf::.
-
-   Note that this command is ignored when you are using any of the LaTeX
-terminals, as LaTeX has its own mechanism for handling minus signs.  It
-also is not necessary when using the postscript terminal because the
-postscript prologue output by gnuplot remaps the ascii hyphen code \055
-to a different glyph named 'minus'.
-
-   Example (assumes utf8 locale):
-
-          set minus
-          A = -5
-          print "A = ",A                 # printed string will contain a hyphen
-          print gprintf("A = %g",A)      # printed string will contain character U+2212
-          set label "V = -5"             # label will contain a hyphen
-          set label sprintf("V = %g",-5) # label will contain a hyphen
-          set label gprintf("V = %g",-5) # label will contain character U+2212
-
-
-
-File: gnuplot.info,  Node: monochrome,  Next: mouse,  Prev: minussign,  Up: set-show
-
-3.33.52 monochrome
-------------------
-
-Syntax:
-          set monochrome {linetype N <linetype properties>}
-
-
-   The *note monochrome:: command selects an alternative set of
-linetypes that differ by dot/dash pattern or line width rather than by
-color.  This command replaces the monochrome option offered by certain
-terminal types in earlier versions of gnuplot.  For backward
-compatibility these terminal types now implicitly invoke "set
-monochrome" if their own "mono" option is present.  For example,
-          set terminal pdf mono
-
-   is equivalent to
-          set terminal pdf
-          set mono
-
-
-   Selecting monochrome mode does not prevent you from explicitly
-drawing lines using RGB or palette colors, but see also *note gray::.
-Six monochrome linetypes are defined by default.  You can change their
-properties or add additional monochrome linetypes by using the full form
-of the command.  Changes made to the monochrome linetypes do not affect
-the color linetypes and vice versa.  To restore the usual set of color
-linetypes, use either *note monochrome:: or 'set color'.
-
-
-File: gnuplot.info,  Node: mouse,  Next: mttics,  Prev: monochrome,  Up: set-show
-
-3.33.53 mouse
--------------
-
-The command 'set mouse' enables mouse actions for the current
-interactive terminal.  It is enabled by default.
-
-   There are two mouse modes.  The 2D mode works for 'plot' commands and
-for 'splot' maps (i.e.  *note view:: with z-rotation 0, 90, 180, 270 or
-360 degrees, including 'set view map').  In this mode the mouse position
-is tracked and you can pan or zoom using the mouse buttons or arrow
-keys.  Some terminals support toggling individual plots on/off by
-clicking on the corresponding key title or on a separate widget.
-
-   For 3D graphs 'splot', the view and scaling of the graph can be
-changed with mouse buttons 1 and 2, respectively.  A vertical motion of
-Button 2 with the shift key held down changes the *note xyplane::.  If
-additionally to these buttons the modifier <ctrl> is held down, the
-coordinate axes are displayed but the data are suppressed.  This is
-useful for large data sets.  Mouse button 3 controls the azimuth of the
-z axis (see *note azimuth::).
-
-   Mousing coordinate readout in multiplot mode is displayed only with
-for the most recent plot within the multiplot.  See 'new multiplots'.
-
-   Syntax:
-           set mouse {doubleclick <ms>} {nodoubleclick}
-                     {{no}zoomcoordinates}
-                     {zoomfactors <xmultiplier>, <ymultiplier>}
-                     {noruler | ruler {at x,y}}
-                     {polardistance{deg|tan} | nopolardistance}
-                     {format <string>}
-                     {mouseformat <int> | <string> | function <f(x,y)>}
-                     {{no}labels {"labeloptions"}}
-                     {{no}zoomjump} {{no}verbose}
-           unset mouse
-
-
-   The options 'noruler' and 'ruler' switch the ruler off and on, the
-latter optionally setting the origin at the given coordinates.  While
-the ruler is on, the distance in user units from the ruler origin to the
-mouse is displayed continuously.  By default, toggling the ruler has the
-key binding 'r'.
-
-   The option 'polardistance' determines if the distance between the
-mouse cursor and the ruler is also shown in polar coordinates (distance
-and angle in degrees or tangent (slope)).  This corresponds to the
-default key binding '5'.
-
-   Choose the option *note labels:: to define persistent gnuplot labels
-using Button 2.  The default is 'nolabels', which makes Button 2 draw
-only a temporary label at the mouse position.  Labels are drawn with the
-current setting of *note mouseformat::.  The 'labeloptions' string is
-passed to the 'set label' command.  The default is "point pointtype 1"
-which will plot a small plus at the label position.  Temporary labels
-will disappear at the next *note replot:: or mouse zoom operation.
-Persistent labels can be removed by holding the Ctrl-Key down while
-clicking Button 2 on the label's point.  The threshold for how close you
-must be to the label is also determined by the *note pointsize::.
-
-   If the option 'verbose' is turned on the communication commands are
-shown during execution.  This option can also be toggled by hitting '6'
-in the driver's window.  'verbose' is off by default.
-
-   Press 'h' in the driver's window for a summary of the mouse and key
-bindings.  This will also display user defined bindings or 'hotkeys'
-defined by the 'bind' command.  Note that user defined binding may
-override default bindings.  See also help for 'bind'.
-
-* Menu:
-
-* doubleclick::
-* format___::
-* mouseformat::
-* scrolling::
-* zoom::
-
-
-File: gnuplot.info,  Node: doubleclick,  Next: format___,  Prev: mouse,  Up: mouse
-
-3.33.53.1 doubleclick
-.....................
-
-The doubleclick resolution is given in milliseconds and used for Button
-1, which copies the current mouse position to the 'clipboard' on some
-terminals.  The default value is 300 ms.  Setting the value to 0 ms
-triggers the copy on a single click.
-
-
-File: gnuplot.info,  Node: format___,  Next: mouseformat,  Prev: doubleclick,  Up: mouse
-
-3.33.53.2 format
-................
-
-The 'set mouse format' command specifies a format string for sprintf()
-which determines how the mouse cursor [x,y] coordinates are printed to
-the plot window and to the clipboard.  The default is "% #g".
-
-   This setting is superseded by "set mouse mouseformat".
-
-
-File: gnuplot.info,  Node: mouseformat,  Next: scrolling,  Prev: format___,  Up: mouse
-
-3.33.53.3 mouseformat
-.....................
-
-Syntax:
-          set mouse mouseformat i
-          set mouse mouseformat "custom format"
-          set mouse mouseformat function string_valued_function(x, y)
-
-   This command controls the format used to report the current mouse
-position.  An integer argument selects one of the format options in the
-table below.  A string argument is used as a format for sprintf() in
-option 7 and should contain two float specifiers, one for x and one for
-y.
-
-   Use of a custom function returning a string is EXPERIMENTAL. It
-allows readout of coordinate systems in which inverse mapping from
-screen coordinates to plot coordinates requires joint consideration of
-both x and y.  See for example the map_projection demo.
-
-   Example:
-          set mouse mouseformat "mouse x,y = %5.2g, %10.3f"
-
-   Use 'set mouse mouseformat ""' to turn this string off again.
-
-   The following formats are available:
-
-      0   default (same as 1)
-      1   axis coordinates                    1.23, 2.45
-      2   graph coordinates (from 0 to 1)    /0.00, 1.00/
-      3   x = timefmt     y = axis           [(as set by *note timefmt::), 2.45]
-      4   x = date        y = axis           [31. 12. 1999, 2.45]
-      5   x = time        y = axis           [23:59, 2.45]
-      6   x = date time   y = axis           [31. 12. 1999 23:59, 2.45]
-      7   format from `set mouse mouseformat <format-string>`
-      8   format from `set mouse mouseformat function <func>`
-
-
-
-File: gnuplot.info,  Node: scrolling,  Next: zoom,  Prev: mouseformat,  Up: mouse
-
-3.33.53.4 scrolling
-...................
-
-The mouse wheel adjusts x and y axis ranges in both 2D and 3D plots.
-Each adjustment increment is 10% of the current range by default.  This
-may be changed by 'set mouse zoomfactor <x-multiplier>, <y-multiplier>'.
-   * <wheel-up> scrolls y and y2 axis ranges up by a fraction of the
-     current range
-   * <wheel-down> scrolls y and y2 ranges down by a fraction of the
-     current range
-   * <shift+wheel-up> scrolls left (decreases x and x2 ranges)
-   * <shift+wheel-down> scrolls right (increases x and x2 ranges)
-   * <control+wheel-up> zooms in around the current mouse position
-   * <control+wheel-down> zooms out around the current mouse position
-   * <shift+control+wheel-up> zooms in only along x and x2 (pinch)
-   * <shift+control+wheel-down> zooms out only along x and x2 (expand)
-
-
-File: gnuplot.info,  Node: zoom,  Prev: scrolling,  Up: mouse
-
-3.33.53.5 zoom
-..............
-
-Proportional zoom in/out around the current mouse position is controlled
-by the mouse wheel (see *note scrolling::).
-
-   Enlarging a selected region in a 2D plot is accomplished by holding
-down the left mouse button and dragging the mouse to delineate a zoom
-region.  The original plot can be restored by typing the 'u' hotkey in
-the plot window.  Hotkeys 'p' and 'n' step back and forth through a
-history of zoom operations.
-
-   The option 'zoomcoordinates' determines if the coordinates of the
-zoom box are drawn at the edges while zooming.  This is on by default.
-
-   If the option 'zoomjump' is on, the mouse pointer will automatically
-offset a small distance after starting a zoom region with button 3.
-This can be useful to avoid a tiny (or even empty) zoom region.
-'zoomjump' is off by default.
-
-
-File: gnuplot.info,  Node: mttics,  Next: multiplot,  Prev: mouse,  Up: set-show
-
-3.33.54 mttics
---------------
-
-Minor tic marks around the perimeter of a polar plot are controlled by
-by *note mttics::.  Please see 'set mxtics'.
-
-
-File: gnuplot.info,  Node: multiplot,  Next: mx2tics,  Prev: mttics,  Up: set-show
-
-3.33.55 multiplot
------------------
-
-The command *note multiplot:: places 'gnuplot' in multiplot mode, in
-which several plots are placed next to each other on the same page or
-screen window.
-
-   Syntax:
-           set multiplot
-               { title <page title> {font <fontspec>} {enhanced|noenhanced} }
-               { layout <rows>,<cols>
-                 {rowsfirst|columnsfirst} {downwards|upwards}
-                 {scale <xscale>{,<yscale>}} {offset <xoff>{,<yoff>}}
-                 {margins <left>,<right>,<bottom>,<top>}
-                 {spacing <xspacing>{,<yspacing>}}
-               }
-           set multiplot {next|previous}
-           unset multiplot
-
-
-   For some terminals, no plot is displayed until the command *note
-multiplot:: is given, which causes the entire page to be drawn and then
-returns gnuplot to its normal single-plot mode.  For other terminals,
-each separate 'plot' command produces an updated display.
-
-   The *note clear:: command is used to erase the rectangular area of
-the page that will be used for the next plot.  This is typically needed
-to inset a small plot inside a larger plot.
-
-   Any labels or arrows that have been defined will be drawn for each
-plot according to the current size and origin (unless their coordinates
-are defined in the 'screen' system).  Just about everything else that
-can be 'set' is applied to each plot, too.  If you want something to
-appear only once on the page, for instance a single time stamp, you'll
-need to put a 'set time'/'unset time' pair around one of the 'plot',
-'splot' or *note replot:: commands within the *note multiplot::/*note
-multiplot:: block.
-
-   The multiplot title is separate from the individual plot titles, if
-any.  Space is reserved for it at the top of the page, spanning the full
-width of the canvas.
-
-   The commands *note origin:: and *note size:: must be used to
-correctly position each plot if no layout is specified or if fine tuning
-is desired.  See *note origin:: and *note size:: for details of their
-usage.
-
-   Example:
-           set multiplot
-           set size 0.4,0.4
-           set origin 0.1,0.1
-           plot sin(x)
-           set size 0.2,0.2
-           set origin 0.5,0.5
-           plot cos(x)
-           unset multiplot
-
-
-   This displays a plot of cos(x) stacked above a plot of sin(x).
-
-   *note size:: and *note origin:: refer to the entire plotting area
-used for each plot.  Please also see *note size::.  If you want to have
-the axes themselves line up, you can guarantee that the margins are the
-same size with the *note margin:: commands.  See *note margin:: for
-their use.  Note that the margin settings are absolute, in character
-units, so the appearance of the graph in the remaining space will depend
-on the screen size of the display device, e.g., perhaps quite different
-on a video display and a printer.
-
-   With the 'layout' option you can generate simple multiplots without
-having to give the *note size:: and *note origin:: commands before each
-plot: Those are generated automatically, but can be overridden at any
-time.  With 'layout' the display will be divided by a grid with <rows>
-rows and <cols> columns.  This grid is filled rows first or columns
-first depending on whether the corresponding option is given in the
-multiplot command.  The stack of plots can grow 'downwards' or
-'upwards'.  Default is 'rowsfirst' and 'downwards'.  The commands 'set
-multiplot next' and 'set multiplot previous' are relevant only in the
-context of using the layout option.  'next' skips the next position in
-the grid, leaving a blank space.  'prev' returns to the grid position
-immediately preceding the most recently plotted position.
-
-   Each plot can be scaled by 'scale' and shifted with 'offset'; if the
-y-values for scale or offset are omitted, the x-value will be used.
-*note multiplot:: will turn off the automatic layout and restore the
-values of *note size:: and *note origin:: as they were before 'set
-multiplot layout'.
-
-   Example:
-           set size 1,1
-           set origin 0,0
-           set multiplot layout 3,2 columnsfirst scale 1.1,0.9
-           [ up to 6 plot commands here ]
-           unset multiplot
-
-
-   The above example will produce 6 plots in 2 columns filled top to
-bottom, left to right.  Each plot will have a horizontal size of 1.1/2
-and a vertical size of 0.9/3.
-
-   Another possibility is to set uniform margins for all plots in the
-layout with options 'layout margins' and 'spacing', which must be used
-together.  With 'margins' you set the outer margins of the whole
-multiplot grid.
-
-   'spacing' gives the gap size between two adjacent subplots, and can
-also be given in 'character' or 'screen' units.  If a single value is
-given, it is used for both x and y direction, otherwise two different
-values can be selected.
-
-   If one value has no unit, the one of the preceding margin setting is
-used.
-
-   Example:
-           set multiplot layout 2,2 margins 0.1, 0.9, 0.1, 0.9 spacing 0.0
-
-
-   In this case the two left-most subplots will have left boundaries at
-screen coordinate 0.1, the two right-most subplots will have right
-boundaries at screen coordinate 0.9, and so on.  Because the spacing
-between subplots is given as 0, their inner boundaries will superimpose.
-
-   Example:
-           set multiplot layout 2,2 margins char 5,1,1,2 spacing screen 0, char 2
-
-
-   This produces a layout in which the boundary of both left subplots is
-5 character widths from the left edge of the canvas, the right boundary
-of the right subplots is 1 character width from the canvas edge.  The
-overall bottom margin is one character height and the overall top margin
-is 2 character heights.  There is no horizontal gap between the two
-columns of subplots.  The vertical gap between subplots is equal to 2
-character heights.
-
-   Example:
-           set multiplot layout 2,2 columnsfirst margins 0.1,0.9,0.1,0.9 spacing 0.1
-           set ylabel 'ylabel'
-           plot sin(x)
-           set xlabel 'xlabel'
-           plot cos(x)
-           unset ylabel
-           unset xlabel
-           plot sin(2*x)
-           set xlabel 'xlabel'
-           plot cos(2*x)
-           unset multiplot
-
-
-   See also *note remultiplot::, 'new multiplots', multiplot demo
-(multiplt.dem) (http://www.gnuplot.info/demo/multiplt.html)
-
-
-File: gnuplot.info,  Node: mx2tics,  Next: mxtics,  Prev: multiplot,  Up: set-show
-
-3.33.56 mx2tics
----------------
-
-Minor tic marks along the x2 (top) axis are controlled by *note
-mx2tics::.  Please see 'set mxtics'.
-
-
-File: gnuplot.info,  Node: mxtics,  Next: my2tics,  Prev: mx2tics,  Up: set-show
-
-3.33.57 mxtics
---------------
-
-Minor tic marks along the x axis are controlled by 'set mxtics'.  They
-can be turned off with 'unset mxtics'.  Similar commands control minor
-tics along the other axes.
-
-   Syntax:
-           set mxtics <freq>
-           set mxtics default
-           set mxtics time <N> <units>
-           unset mxtics
-           show mxtics
-
-
-   The same syntax applies to *note mytics::, *note mztics::, *note
-mx2tics::, *note my2tics::, 'mrtics', *note mttics:: and 'mcbtics'.
-
-   <freq> is the number of sub-intervals (NOT the number of minor tic
-marks) between major tics.  The default for a linear axis is either 2
-(one mark) or 5 (four marks) depending on the spacing of the major tics.
-
-   'default' will return the number of minor ticks to its default value.
-
-   'set mxtics time <N> <units>' applies only when the major tics are
-set to time mode.  See 'set mxtics time'.
-
-   If the axis is logarithmic, the number of sub-intervals will be set
-to a reasonable number by default (based upon the length of a decade).
-This will be overridden if <freq> is given.  However the usual minor
-tics (2, 3, ..., 8, 9 between 1 and 10, for example) are obtained by
-setting <freq> to 10, even though there are but nine sub-intervals.
-
-   To set minor tics at arbitrary positions, use the ("<label>" <pos>
-<level>, ...)  form of 'set {x|x2|y|y2|z}tics' with <label> empty and
-<level> set to 1.
-
-   The 'set m{x|x2|y|y2|z}tics' commands work only when there are
-uniformly spaced major tics.  If all major tics were placed explicitly
-by 'set {x|x2|y|y2|z}tics', then minor tic commands are ignored.
-Implicit major tics and explicit minor tics can be combined using 'set
-{x|x2|y|y2|z}tics' and 'set {x|x2|y|y2|z}tics add'.
-
-   Examples:
-           set xtics 0, 5, 10
-           set xtics add (7.5)
-           set mxtics 5
-
-   Major tics at 0,5,7.5,10, minor tics at 1,2,3,4,6,7,8,9
-           set logscale y
-           set ytics format ""
-           set ytics 1e-6, 10, 1
-           set ytics add ("1" 1, ".1" 0.1, ".01" 0.01, "10^-3" 0.001, \
-                          "10^-4" 0.0001)
-           set mytics 10
-
-   Major tics with special formatting, minor tics at log positions
-
-   By default, minor tics are off for linear axes and on for logarithmic
-axes.  They inherit the settings for 'axis|border' and '{no}mirror'
-specified for the major tics.  Please see 'set xtics' for information
-about these.
-
-* Menu:
-
-* mxtics_time::
-
-
-File: gnuplot.info,  Node: mxtics_time,  Prev: mxtics,  Up: mxtics
-
-3.33.57.1 mxtics time
-.....................
-
-Syntax:
-          set mxtics time <N> {seconds|minutes|hours|days|weeks|months|years}
-
-
-   This is a new command option introduced in gnuplot version 6.  It
-places minor tic marks exactly at some integral number of time units
-rather than at some fraction of the major tic interval.
-
-   The new default is that minor tics are not generated if the major
-tics are in time mode ('set xdata time' or 'set xtics time').
-
-   'set mxtics' or 'set mxtics <freq>' can restore the pre-version 6
-behavior but this was always problematic.  For example, automatic
-subdivision of a 72-year span placed major tics at 12-year intervals and
-minor tics at 5-year intervals.
-
-   Using 'set mxtics time 2 years', however, will place a minor tic mark
-exactly at the start of alternate years.  'set mxtics time 1 month' will
-place tic marks exactly at 1 Jan, 1 Feb, 1 Mar, 1 Apr, ...  even though
-those intervals contain an unequal number of days.
-
-
-File: gnuplot.info,  Node: my2tics,  Next: mytics,  Prev: mxtics,  Up: set-show
-
-3.33.58 my2tics
----------------
-
-Minor tic marks along the y2 (right-hand) axis are controlled by *note
-my2tics::.  Please see 'set mxtics'.
-
-
-File: gnuplot.info,  Node: mytics,  Next: mztics,  Prev: my2tics,  Up: set-show
-
-3.33.59 mytics
---------------
-
-Minor tic marks along the y axis are controlled by *note mytics::.
-Please see 'set mxtics'.
-
-
-File: gnuplot.info,  Node: mztics,  Next: nonlinear,  Prev: mytics,  Up: set-show
-
-3.33.60 mztics
---------------
-
-Minor tic marks along the z axis are controlled by *note mztics::.
-Please see 'set mxtics'.
-
-
-File: gnuplot.info,  Node: nonlinear,  Next: object,  Prev: mztics,  Up: set-show
-
-3.33.61 nonlinear
------------------
-
-Syntax:
-           set nonlinear <axis> via f(axis) inverse g(axis)
-           unset nonlinear <axis>
-
-
-   This command is similar to the *note link:: command except that only
-one of the two linked axes is visible.  The hidden axis remains linear.
-Coordinates along the visible axis are mapped by applying g(x) to hidden
-axis coordinates.  f(x) maps the visible axis coordinates back onto the
-hidden linear axis.  You must provide both the forward and inverse
-expressions.
-
-   To illustrate how this works, consider the case of a log-scale x2
-axis.
-
-           set x2ange [1:1000]
-           set nonlinear x2 via log10(x) inverse 10**x
-
-
-   This achieves the same effect as 'set log x2'.  The hidden axis in
-this case has range [0:3], obtained by calculating
-[log10(xmin):log10(xmax)].
-
-   The transformation functions f() and g() must be defined using a
-dummy variable appropriate to the nonlinear axis:
-         axis: x x2   dummy variable x
-         axis: y y2   dummy variable y
-         axis: z cb   dummy variable z
-         axis: r      dummy variable r
-
-
-   Example:
-
-           set xrange [-3:3]
-           set nonlinear x via norm(x) inverse invnorm(x)
-
-
-   This example establishes a probability-scaled ("probit") x axis, such
-that plotting the cumulative normal function Phi(x) produces a straight
-line plot against a linear y axis.
-
-   Example:
-
-           logit(p) = log(p/(1-p))
-           logistic(a) = 1. / (1. + exp(-a))
-           set xrange [.001 : .999]
-           set nonlinear y via logit(y) inverse logistic(y)
-           plot logit(x)
-
-
-   This example establishes a logit-scaled y axis such that plotting
-logit(x) on a linear x axis produces a straight line plot.
-
-   Example:
-
-           f(x) = (x <= 100) ? x : (x < 500) ? NaN : x-390
-           g(x) = (x <= 100) ? x : x+390
-           set xrange [0:1000] noextend
-           set nonlinear x via f(x) inverse g(x)
-           set xtics add (100,500)
-           plot sample [x=1:100] x, [x=500:1000] x
-
-
-   This example creates a "broken axis".  X coordinates 0-100 are at the
-left, X coordinates 500-1000 are at the right, there is a small gap (10
-units) between them.  So long as no data points with (100 < x < 500) are
-plotted, this works as expected.
-
-
-File: gnuplot.info,  Node: object,  Next: offsets,  Prev: nonlinear,  Up: set-show
-
-3.33.62 object
---------------
-
-The *note object:: command defines a single object which will appear in
-subsequent plots.  You may define as many objects as you like.
-Currently the supported object types are *note rectangle::, 'circle',
-'ellipse', and 'polygon'.  Rectangles inherit a default set of style
-properties (fill, color, border) from those set by the command *note
-rectangle::.  Every object can be given individual style properties when
-it is defined or in a later command.
-
-   Objects to be drawn in 2D plots may be defined in any combination of
-axis, graph, polar, or screen coordinates.  Object specifications in 3D
-plots cannot use graph coordinates.  Rectangles and ellipses in 3D plots
-are limited to screen coordinates.
-
-   Syntax:
-         set object <index>
-             <object-type> <object-properties>
-             {front|back|behind|depthorder}
-             {clip|noclip}
-             {fc|fillcolor <colorspec>} {fs <fillstyle>}
-             {default} {lw|linewidth <width>} {dt|dashtype <dashtype>}
-         unset object <index>
-
-
-   <object-type> is either *note rectangle::, 'ellipse', 'circle', or
-'polygon'.  Each object type has its own set of characteristic
-properties.
-
-   The options 'front', 'back', 'behind' control whether the object is
-drawn before or after the plot itself.  See *note layers::.  Setting
-'front' will draw the object in front of all plot elements, but behind
-any labels that are also marked 'front'.  Setting 'back' will place the
-object behind all plot curves and labels.  Setting 'behind' will place
-the object behind everything including the axes and 'back' rectangles,
-thus
-         set object rectangle from screen 0,0 to screen 1,1 behind
-
-   can be used to provide a colored background for the entire graph or
-page.
-
-   By default, objects are clipped to the graph boundary unless one or
-more vertices are given in screen coordinates.  Setting 'noclip' will
-disable clipping to the graph boundary, but will still clip against the
-screen size.
-
-   The fill color of the object is taken from the <colorspec>.  *note
-fillcolor:: may be abbreviated 'fc'.  The fill style is taken from
-<fillstyle>.  See *note colorspec:: and 'fillstyle'.  If the keyword
-'default' is given, these properties are inherited from the default
-settings at the time a plot is drawn.  See *note rectangle::.
-
-* Menu:
-
-* rectangle::
-* ellipse::
-* circle::
-* polygon::
-
-
-File: gnuplot.info,  Node: rectangle,  Next: ellipse,  Prev: object,  Up: object
-
-3.33.62.1 rectangle
-...................
-
-Syntax:
-         set object <index> rectangle
-             {from <position> {to|rto} <position> |
-              center <position> size <w>,<h> |
-              at <position> size <w>,<h>}
-
-
-   The position of the rectangle may be specified by giving the position
-of two diagonal corners (bottom left and top right) or by giving the
-position of the center followed by the width and the height.  In either
-case the positions may be given in axis, graph, or screen coordinates.
-See 'coordinates'.  The options 'at' and 'center' are synonyms.
-
-   Examples:
-         # Force the entire area enclosed by the axes to have background color cyan
-         set object 1 rect from graph 0, graph 0 to graph 1, graph 1 back
-         set object 1 rect fc rgb "cyan" fillstyle solid 1.0
-
-
-         # Position a red square with lower left at 0,0 and upper right at 2,3
-         set object 2 rect from 0,0 to 2,3 fc lt 1
-
-
-         # Position an empty rectangle (no fill) with a blue border
-         set object 3 rect from 0,0 to 2,3 fs empty border rgb "blue"
-
-
-         # Return fill and color to the default style but leave vertices unchanged
-         set object 2 rect default
-
-
-   Rectangle corners specified in screen coordinates may extend beyond
-the edge of the current graph.  Otherwise the rectangle is clipped to
-fit in the graph.
-
-
-File: gnuplot.info,  Node: ellipse,  Next: circle,  Prev: rectangle,  Up: object
-
-3.33.62.2 ellipse
-.................
-
-Syntax:
-         set object <index> ellipse {at|center} <position> size <w>,<h>
-             {angle <orientation>} {units xy|xx|yy}
-             {<other-object-properties>}
-
-
-   The position of the ellipse is specified by giving the center
-followed by the width and the height (actually the major and minor
-axes).  The keywords 'at' and 'center' are synonyms.  The center
-position may be given in axis, graph, or screen coordinates.  See
-'coordinates'.  The major and minor axis lengths must be given in axis
-coordinates.  The orientation of the ellipse is specified by the angle
-between the horizontal axis and the major diameter of the ellipse.  If
-no angle is given, the default ellipse orientation will be used instead
-(see 'set style ellipse').  The 'units' keyword controls the scaling of
-the axes of the ellipse.  'units xy' means that the major axis is
-interpreted in terms of units along the x axis, while the minor axis in
-that of the y axis.  'units xx' means that both axes of the ellipses are
-scaled in the units of the x axis, while 'units yy' means that both axes
-are in units of the y axis.  The default is 'xy' or whatever 'set style
-ellipse units' was set to.
-
-   NB: If the x and y axis scales are not equal, (e.g.  'units xy' is in
-effect) then the major/minor axis ratio will no longer be correct after
-rotation.
-
-   Note that 'set object ellipse size <2r>,<2r>' does not in general
-produce the same result as 'set object circle <r>'.  The circle radius
-is always interpreted in terms of units along the x axis, and will
-always produce a circle even if the x and y axis scales are different
-and even if the aspect ratio of your plot is not 1.  If 'units' is set
-to 'xy', then 'set object ellipse' interprets the first <2r> in terms of
-x axis units and the second <2r> in terms of y axis units.  This will
-only produce a circle if the x and y axis scales are identical and the
-plot aspect ratio is 1.  On the other hand, if 'units' is set to 'xx' or
-'yy', then the diameters specified in the 'set object' command will be
-interpreted in the same units, so the ellipse will have the correct
-aspect ratio, and it will maintain its aspect ratio even if the plot is
-resized.
-
-
-File: gnuplot.info,  Node: circle,  Next: polygon,  Prev: ellipse,  Up: object
-
-3.33.62.3 circle
-................
-
-Syntax:
-         set object <index> circle {at|center} <position> size <radius>
-             {arc [<begin>:<end>]} {no{wedge}}
-             {<other-object-properties>}
-
-
-   The position of the circle is specified by giving the position of the
-center center followed by the radius.  The keywords 'at' and 'center'
-are synonyms.  In 2D plots the position and radius may be given in any
-coordinate system.  See 'coordinates'.  Circles in 3D plots cannot use
-graph coordinates.  In all cases the radius is calculated relative to
-the horizontal scale of the axis, graph, or canvas.  Any disparity
-between the horizontal and vertical scaling will be corrected for so
-that the result is always a circle.  If you want to draw a circle in
-plot coordinates (such that it will appear as an ellipse if the
-horizontal and vertical scales are different), use 'set object ellipse'
-instead.
-
-   By default a full circle is drawn.  The optional qualifier 'arc'
-specifies a starting angle and ending angle, in degrees, for one arc of
-the circle.  The arc is always drawn counterclockwise.
-
-   See also 'set style circle', 'set object ellipse'.
-
-
-File: gnuplot.info,  Node: polygon,  Prev: circle,  Up: object
-
-3.33.62.4 polygon
-.................
-
-Syntax:
-         set object <index> polygon
-             from <position> to <position> ... {to <position>}
-
-   or
-             from <position> rto <position> ... {rto <position>}
-
-
-   The position of the polygon may be specified by giving the position
-of a sequence of vertices.  These may be given in any coordinate system.
-If relative coordinates are used (rto) then the coordinate type must
-match that of the previous vertex.  See 'coordinates'.
-
-   Example:
-         set object 1 polygon from 0,0 to 1,1 to 2,0
-         set object 1 fc rgb "cyan" fillstyle solid 1.0 border lt -1
-
-
--- DEPTHORDER --
-
-   The option 'set object N depthorder' applies to 3D polygon objects
-only.  Rather than assigning the object to layer front/back/behind it is
-included in the list of pm3d quadrangles sorted and rendered in order of
-depth by 'set pm3d depthorder'.  As with pm3d surfaces, two-sided
-coloring can be generated by specifying the object fillcolor as a
-linestyle.  In this case the ordering of the first three vertices in the
-polygon determines the "side".
-
-   If you set this property for an object that is not a 3D polygon it
-probably will not be drawn at all.
-
-
-File: gnuplot.info,  Node: offsets,  Next: origin,  Prev: object,  Up: set-show
-
-3.33.63 offsets
----------------
-
-Autoscaling sets the x and y axis ranges to match the coordinates of the
-data that is plotted.  Offsets provide a mechanism to expand these
-ranges to leave empty space between the data and the plot borders.
-Autoscaling then further extends each range to reach the next axis tic
-unless this has been suppressed by *note noextend:: or *note noextend::.
-See *note noextend::.  Offsets affect only scaling for the x1 and y1
-axes.
-
-   Syntax:
-           set offsets <left>, <right>, <top>, <bottom>
-           unset offsets
-           show offsets
-
-
-   Each offset may be a constant or an expression.  Each defaults to 0.
-By default, the left and right offsets are given in units of the first x
-axis, the top and bottom offsets in units of the first y axis.
-Alternatively, you may specify the offsets as a fraction of the total
-graph dimension by using the keyword "graph".  Only "graph" offsets are
-possible for nonlinear axes.
-
-   A positive offset expands the axis range in the specified direction,
-e.g.  a positive bottom offset makes ymin more negative.  Negative
-offsets interact badly with autoscaling and clipping.
-
-   Example:
-           set autoscale noextend
-           set offsets graph 0.05, 0, 2, 2
-           plot sin(x)
-
-
-   This graph of sin(x) will have y range [-3:3] because the function
-will be autoscaled to [-1:1] and the vertical offsets add 2 at each end
-of the range.  The x range will be [-11:10] because the default is
-[-10:10] and it has been expanded to the left by 0.05 of that total
-range.
-
-
-File: gnuplot.info,  Node: origin,  Next: output,  Prev: offsets,  Up: set-show
-
-3.33.64 origin
---------------
-
-The *note origin:: command is used to specify the origin of a plotting
-surface (i.e., the graph and its margins) on the screen.  The
-coordinates are given in the 'screen' coordinate system (see
-'coordinates' for information about this system).
-
-   Syntax:
-           set origin <x-origin>,<y-origin>
-
-
-
-File: gnuplot.info,  Node: output,  Next: overflow,  Prev: origin,  Up: set-show
-
-3.33.65 output
---------------
-
-Syntax:
-           set output {"<filename>"}
-           unset output
-           show output
-
-
-   Graphs produced by non-interactive terminals are by default sent to
-'stdout'.  The *note output:: command redirects output to the specified
-file or device.  The file opened by this command remains open until a
-subsequent set/unset output command, a change in terminal type, or exit
-from gnuplot.
-
-   Interactive terminals ignore *note output::.
-
-   The filename must be enclosed in quotes.  If the filename is omitted,
-the command is equivalent to *note output::; any output file opened by a
-previous *note output:: will be closed and new output will be sent to
-'stdout'.
-
-   When both *note terminal:: and *note output:: are used together, it
-is safest to give *note terminal:: first, because some terminals set a
-flag which is needed in some operating systems.  This would be the case,
-for example, if the operating system needs a separate open command for
-binary files.
-
-   On platforms that support pipes, it may be useful to pipe terminal
-output.  For instance,
-
-           set output "|lpr -Plaser filename"
-           set term png; set output "|display png:-"
-
-
-   On MSDOS machines, 'set output "PRN"' directs output to the default
-printer.
-
-
-File: gnuplot.info,  Node: overflow,  Next: palette__,  Prev: output,  Up: set-show
-
-3.33.66 overflow
-----------------
-
-Syntax:
-          set overflow {float | NaN | undefined}
-          unset overflow
-
-
-   This version of gnuplot supports 64-bit integer arithmetic.  This
-means that for values from 2^53 to 2^63 (roughly 10^16 to 10^19) integer
-evaluation preserves more precision than evaluation using IEEE 754
-floating point arithmetic.  However unlike the IEEE floating point
-representation, which sacrifices precision to span a total range of
-roughly [-10^307 : 10^307], integer operations that result in values
-outside the range [-2^63 : 2^63] overflow.  The *note overflow:: command
-lets you control what happens in case of overflow.  See options below.
-
-   *note overflow:: is the same as *note float::.  It causes the result
-to be returned as a real number rather than as an integer.  This is the
-default.
-
-   The command *note overflow:: causes integer arithmetic overflow to be
-ignored.  No error is shown.  This may be desirable if your platform
-allows only 32-bit integer arithmetic and you want to approximate the
-behaviour of gnuplot versions prior to 5.4.
-
-   The *note reset:: command does not affect the state of overflow
-handling.
-
-   Earlier gnuplot versions were limited to 32-bit arithmetic and
-ignored integer overflow.  Note, however, that some built-in operators
-did not use integer arithmetic at all, even when given integer
-arguments.  This included the exponentiation operator N**M and the
-summation operator (see *note summation::).  These operations now return
-an integer value when given integer arguments, making them potentially
-susceptible to overflow and thus affected by the state of *note
-overflow::.
-
-* Menu:
-
-* float::
-* NaN::
-* undefined::
-* affected_operations::
-
-
-File: gnuplot.info,  Node: float,  Next: NaN,  Prev: overflow,  Up: overflow
-
-3.33.66.1 float
-...............
-
-If an integer arithmetic expression overflows the limiting range, [-2^63
-: 2^63] for 64-bit integers, the result is returned as a floating point
-value instead.  This is not treated as an error.  Example:
-          gnuplot> set overflow float
-          gnuplot> A = 2**62 - 1;  print A, A+A, A+A+A
-          4611686018427387903 9223372036854775806 1.38350580552822e+19
-
-
-
-File: gnuplot.info,  Node: NaN,  Next: undefined,  Prev: float,  Up: overflow
-
-3.33.66.2 NaN
-.............
-
-If an integer arithmetic expression overflows the limiting range, [-2^63
-: 2^63] for 64-bit integers, the result is returned as NaN (Not a
-Number).  This is not treated as an error.  Example:
-          gnuplot> set overflow NaN
-          gnuplot> print 10**18, 10**19
-          1000000000000000000 NaN
-
-
-
-File: gnuplot.info,  Node: undefined,  Next: affected_operations,  Prev: NaN,  Up: overflow
-
-3.33.66.3 undefined
-...................
-
-If an integer arithmetic expression overflows the limiting range, [-2^63
-: 2^63] for 64-bit integers, the result is undefined.  This is treated
-as an error.  Example:
-          gnuplot> set overflow undefined
-          gnuplot> A = 10**19
-                       ^
-                   undefined value
-
-
-
-File: gnuplot.info,  Node: affected_operations,  Prev: undefined,  Up: overflow
-
-3.33.66.4 affected operations
-.............................
-
-The *note overflow:: state affects the arithmetic operators
-          + - * / **
-
-   and the built-in summation operation 'sum'.
-
-   All of these operations will return an integer result if all of the
-arguments are integers, so long as no overflow occurs during evaluation.
-
-   The *note overflow:: state does not affect logical or bit operations
-          << >>  | ^ &
-
-
-   If overflow occurs at any point during the course of evaluating of a
-summation *note float:: will cause the result to be returned as a real
-number even if the final sum is within the range of integer
-representation.
-
-
-File: gnuplot.info,  Node: palette__,  Next: parametric_,  Prev: overflow,  Up: set-show
-
-3.33.67 palette
----------------
-
-The palette is a set of colors, usually ordered as one or more stepped
-gradients, used to color pm3d surfaces, heat maps, and other plot
-elements.  Colors in the current palette are automatically mapped from
-plot coordinate z values or from an extra data column of gray values.
-The current palette is shown by default in a separate 'colorbox' drawn
-next to plots that use plot style 'pm3d'.  The colorbox can be
-customized or disabled.  See 'set colorbox'.  See also *note palette::
-and *note palette::.
-
-   Syntax:
-           set palette
-           set palette {
-                      { gray | color }
-                      { gamma <gamma> }
-                      {   rgbformulae <r>,<g>,<b>
-                        | defined { ( <gray1> <color1> {, <grayN> <colorN>}... ) }
-                        | file '<filename>' {datafile-modifiers}
-                        | colormap <colormap-name>
-                        | functions <R>,<G>,<B>
-                      }
-                      { cubehelix {start <val>} {cycles <val>} {saturation <val>} }
-                      { viridis }
-                      { model { RGB | CMY | HSV {start <radians>} } }
-                      { positive | negative }
-                      { nops_allcF | ps_allcF }
-                      { maxcolors <maxcolors> }
-                    }
-
-
-   A palette can be defined in several ways.  - Provide formulae for the
-red, green, and blue components as a function of the gray value between
-0 and 1.  *note rgbformulae:: allows you to choose from 36 predefined
-formulae.  *note functions:: allows you to define your own functions.  -
-Use *note defined:: to specify one or more smooth gradients, each
-spanning one segment of the total z range.  - Load a previously save
-palette into the current palette.  'Set palette file' reads a saved
-palette from a file.  *note colormap:: extracts the RGB components from
-a saved colormap.  - Specify a named palette, perhaps with additional
-parameters to customize.  The named palettes currently provided are
-*note cubehelix:: (a customizable family of palettes) and *note
-viridis::.
-
-   *note palette:: (without options) restores the default values.
-
-   'set palette negative' inverts the direction of the palette, e.g.
-'set palette viridis negative' creates a gradient from yellow to blue
-rather than from blue to yellow.
-
-   *note gray:: switches to a grayscale palette.  'set palette color'
-restores the most recent color palette.
-
-   In 'pm3d' color surfaces the gray value of each small quadrangle is
-obtained by mapping the averaged z-coordinate of its 4 corners from the
-range [min_z,max_z] into the range of grays, which is always [0:1].  The
-palette maps that gray value into an RGB color.
-
-   Palette colors can be mentioned explicitly in a color specification
-(see *note colorspec::).  This is useful to assign a palette color to an
-object or label.
-
-   The palette can be defined in any of three color spaces: RGB CMY HSV.
-See 'set palette model'.  All color component values in all color spaces
-are limited to [0,1].
-
-* Menu:
-
-* rgbformulae::
-* defined::
-* functions_::
-* gray::
-* cubehelix::
-* viridis::
-* colormap_::
-* file::
-* gamma_correction::
-* maxcolors::
-* Color_model::
-* postscript::
-
-
-File: gnuplot.info,  Node: rgbformulae,  Next: defined,  Prev: palette__,  Up: palette__
-
-3.33.67.1 rgbformulae
-.....................
-
-          set palette rgbformulae <function 1>, <function 2>, <function 3>
-
-   Despite its name, this option applies to all color spaces.  You must
-specify one of 36 preset mapping functions by number for each color
-component.  The available functions are listed by *note rgbformulae::.
-The default is 'set palette rgbformulae 7,5,15'.  In RGB space this uses
-function 7 to map the red component, function 5 to map the green
-component, and function 15 to map the blue component.  A negative
-function number inverts the sense of that component by mapping f(1-gray)
-rather than f(gray).
-
-   Some nice schemes in RGB color space
-        7,5,15   ... default (black-blue-red-yellow)
-        3,11,6   ... green-red-violet
-        23,28,3  ... ocean (green-blue-white)
-        21,22,23 ... hot (black-red-yellow-white)
-        30,31,32 ... black-blue-violet-yellow-white
-        33,13,10 ... rainbow (blue-green-yellow-red)
-        34,35,36 ... AFM hot (black-red-yellow-white)
-
-
-   A full color palette in HSV color space
-        3,2,2    ... red-yellow-green-cyan-blue-magenta-red
-
-
-
-File: gnuplot.info,  Node: defined,  Next: functions_,  Prev: rgbformulae,  Up: palette__
-
-3.33.67.2 defined
-.................
-
-Gray-to-rgb mapping can be manually set by use of *note defined::: A
-color gradient is defined and used to give the rgb values.  Such a
-gradient is a piecewise linear mapping from gray values in [0,1] to the
-RGB space [0,1]x[0,1]x[0,1].  You must specify the gray values and the
-corresponding RGB values between which linear interpolation will be
-done.
-
-   Syntax:
-           set palette  defined { ( <gray1> <color1> {, <grayN> <colorN>}... ) }
-
-
-   where N ≥ 2 and <grayN> are gray values which are mapped to [0,1].
-The corresponding rgb color <colorN> can be specified in three different
-ways:
-
-          <color> :=  { <r> <g> <b> | '<color-name>' | '#rrggbb' }
-
-
-   Either by three numbers (each in [0,1]) for red, green and blue,
-separated by whitespace, or the name of the color in quotes or X style
-color specifiers also in quotes.  You may freely mix the three types in
-a gradient definition, but the named color "red" will be something
-strange if RGB is not selected as color space.  Use *note colornames::
-for a list of known color names.
-
-   The <gray> values must form an ascending sequence of real numbers;
-the sequence will be automatically rescaled to [0,1].
-
-   *note defined:: (without a gradient definition in braces) switches to
-RGB color space and uses a preset full-spectrum color gradient.  Use
-'show palette gradient' to display the gradient.
-
-   Examples:
-
-   To produce a gray palette (useless but instructive) use:
-           set palette model RGB
-           set palette defined ( 0 "black", 1 "white" )
-
-
-   To produce a blue-to-yellow-to-red palette use (all equivalent):
-           set palette defined ( 0 "blue", 1 "yellow", 2 "red" )
-           set palette defined ( 0 0 0 1, 1 1 1 0, 2 1 0 0 )
-           set palette defined ( 0 "#0000ff", 1 "#ffff00", 2 "#ff0000" )
-
-
-   Full color spectrum within HSV color space:
-           set palette model HSV
-           set palette defined ( 0 0 1 1, 1 1 1 1 )
-           set palette defined ( 0 0 1 0, 1 0 1 1, 6 0.8333 1 1, 7 0.8333 0 1)
-
-
-   Full color HSV spectrum wrapping at some hue other than red
-           set palette model HSV start 0.15
-           set palette defined ( 0 0 1 1, 1 1 1 1 )
-
-
-   To produce a palette with only a few, equally-spaced colors:
-           set palette model RGB maxcolors 4
-           set palette defined ( 0 "yellow", 1 "red" )
-
-
-   'Traffic light' palette (non-smooth color jumps at gray = 1/3 and
-2/3).
-           set palette model RGB
-           set palette defined (0 "dark-green", 1 "green", \
-                                1 "yellow",     2 "dark-yellow", \
-                                2 "red",        3 "dark-red" )
-
-
-
-File: gnuplot.info,  Node: functions_,  Next: gray,  Prev: defined,  Up: palette__
-
-3.33.67.3 functions
-...................
-
-          set palette functions <f1(gray)>, <f2(gray)>, <f3(gray)>
-
-   This option is like *note rgbformulae:: except that you must provide
-an actual function for each color component rather than the index of a
-preset function.  The dummy parameter of each function, if any, must be
-"gray".  The function must map gray values in [0,1] to output values
-also in [0,1].
-
-   Examples:
-
-   To produce a full color palette use:
-           set palette model HSV functions gray, 1, 1
-
-
-   A nice black to gold palette:
-           set palette model RGB functions 1.1*gray**0.25, gray**0.75, 0
-
-
-   A gamma-corrected black and white palette
-           gamma = 2.2
-           map(gray) = gray**(1./gamma)
-           set palette model RGB functions map(gray), map(gray), map(gray)
-
-
-
-File: gnuplot.info,  Node: gray,  Next: cubehelix,  Prev: functions_,  Up: palette__
-
-3.33.67.4 gray
-..............
-
-*note gray:: switches to a grayscale palette shading from 0.0 = black to
-1.0 = white.  'set palette color' is an easy way to switch back from the
-gray palette to the last color mapping.
-
-
-File: gnuplot.info,  Node: cubehelix,  Next: viridis,  Prev: gray,  Up: palette__
-
-3.33.67.5 cubehelix
-...................
-
-The "cubehelix" option defines a family of palettes in which color (hue)
-varies around the standard color wheel while the net perceived intensity
-increases monotonically as the gray value goes from 0 to 1.
-           D A Green (2011) http://arxiv.org/abs/1108.5083
-
-   'start' defines the starting point along the color wheel in radians.
-'cycles' defines how many color wheel cycles span the palette range.
-Larger values of 'saturation' produce more saturated color; saturation >
-1 may lead to clipping of the individual RGB components and to intensity
-becoming non-monotonic.  The palette is also affected by 'set palette
-gamma'.  The default values are
-           set palette cubehelix start 0.5 cycles -1.5 saturation 1
-           set palette gamma 1.5
-
-
-
-File: gnuplot.info,  Node: viridis,  Next: colormap_,  Prev: cubehelix,  Up: palette__
-
-3.33.67.6 viridis
-.................
-
-           set palette viridis
-
-   The "viridis" palette is a (blue->yellow) gradient designed to
-accommodate users with impaired color vision.  Viridis was developed by
-Stéfan van der Walt and Nathaniel Smith.  It features an approximately
-linear gradient of perceived brightness (luminance).  The colormap
-version used in gnuplot is based on
-           "Viridis - Colorblind-Friendly Color Maps for R", Garnier et al (2021)
-           https://CRAN.R-project.org/package=viridis
-
-   D viridis 1
-
-
-File: gnuplot.info,  Node: colormap_,  Next: file,  Prev: viridis,  Up: palette__
-
-3.33.67.7 colormap
-..................
-
-'set palette colormap <name>' loads a defined gradient that was
-previously saved to a colormap.  Alpha channel information in the
-colormap, if any, will be lost when the color values are copied into the
-palette definition.  See *note colormap::.
-
-
-File: gnuplot.info,  Node: file,  Next: gamma_correction,  Prev: colormap_,  Up: palette__
-
-3.33.67.8 file
-..............
-
-'set palette file' is basically a 'set palette defined (<gradient>)'
-where <gradient> is read from a datafile or datablock.  The color values
-may be provided either as a single 24-bit packed RGB integer (1 or 2
-'using' columns) or as three separate fractional R, G, B components (3
-or 4 'using' columns).  If no explicit gray value is provided in the
-first input column, the line number is used; this generates equal
-spacing along the color axis.
-
-   The file is read as a normal data file, so all datafile modifiers can
-be used.  Please note that 'R' might actually be 'H' if HSV color space
-is selected.
-
-   Use 'show palette gradient' to display the gradient.
-
-   Examples:
-
-   Read in a palette of RGB triples each in range [0,255]:
-           set palette file 'some-palette' using ($1/255):($2/255):($3/255)
-
-
-   Equidistant rainbow (blue-green-yellow-red) palette:
-           set palette model RGB file "-" using 1:2:3
-           0 0 1
-           0 1 0
-           1 1 0
-           1 0 0
-           e
-
-
-   Same thing using explicit gray intervals and packed RGB values:
-           set palette model RGB file "-" using 1:2
-           1  0x0000ff
-           2  0x00ff00
-           3  0xffff00
-           4  0xff0000
-           e
-
-
-   Binary palette files are supported as well, see *note general::.
-Example: put 64 triplets of R,G,B doubles into file palette.bin and load
-it by
-           set palette file "palette.bin" binary record=64 using 1:2:3
-
-
-
-File: gnuplot.info,  Node: gamma_correction,  Next: maxcolors,  Prev: file,  Up: palette__
-
-3.33.67.9 gamma correction
-..........................
-
-Automatic gamma correction via 'set palette gamma <gamma>' can be done
-for gray maps (*note gray::) and for the *note cubehelix:: color palette
-schemes.  Gamma = 1 produces a linear ramp of intensity.  See *note
-palette::.
-
-   For gray mappings, <gamma> defaults to 1.5 which is usually suitable.
-
-   The gamma correction is applied to the cubehelix color palette
-family, but not to other palette coloring schemes.  However, you may
-easily implement gamma correction for explicit color functions.
-
-   Example:
-           set palette model RGB
-           set palette functions gray**0.64, gray**0.67, gray**0.70
-
-
-   To use gamma correction with interpolated gradients specify
-intermediate gray values with appropriate colors.  Instead of
-
-           set palette defined ( 0 0 0 0, 1 1 1 1 )
-
-
-   use e.g.
-
-           set palette defined ( 0 0 0 0, 0.5 .73 .73 .73, 1 1 1 1 )
-
-
-   or even more intermediate points until the linear interpolation fits
-the "gamma corrected" interpolation well enough.
-
-
-File: gnuplot.info,  Node: maxcolors,  Next: Color_model,  Prev: gamma_correction,  Up: palette__
-
-3.33.67.10 maxcolors
-....................
-
-'set palette maxcolors <N>' limits the palette to N discrete colors
-selected from a continuous palette sampled at equally spaced intervals.
-If you want unequal spacing of N discrete colors, use *note defined::
-instead of a single continuous palette.
-
-   The primary use for this is to generate heat maps with discrete
-colors, each representing a range of values.
-
-   A second use is to handle terminals that support only a limited
-number of colors (e.g.  256 colors in gif or sixel).  The default
-gnuplot linetype colors use up some of these, further limiting the
-number available for palette use.  Thus a multiplot using multiple
-palettes could fail because the first palette has used all the available
-color positions.  You can mitigate this by restricting the number of
-colors used by each palette.
-
-
-File: gnuplot.info,  Node: Color_model,  Next: postscript,  Prev: maxcolors,  Up: palette__
-
-3.33.67.11 Color model
-......................
-
-          set palette model { RGB | CMY | HSV {start <radians>} }
-
-   Sometimes RGB color space is not the most convenient color space to
-work in.  You may change the color space 'model' to one of 'RGB', 'HSV',
-'CMY'. RGB stands for Red, Green, Blue; CMY stands for Cyan, Magenta,
-Yellow; HSV stands for Hue, Saturation, Value.  In HSV space the full
-color wheel is traversed as H runs from 0 to 1, so H=0 and H=1 describe
-the same color.  By default the cycle starts and ends at red.  The
-optional parameter 'start' introduces an offset, so after 'set palette
-model HSV start 0.3' H=0 and H=1 both correspond to green.
-
-   For more information on color models see:
-http://en.wikipedia.org/wiki/Color_space
-(http://en.wikipedia.org/wiki/Color_space)
-
-   Documentation for palette options was written for RGB color space, so
-please note that 'R' really means "first color component", which can be
-'H' or 'C' depending on the actual color space in use.
-
-
-File: gnuplot.info,  Node: postscript,  Prev: Color_model,  Up: palette__
-
-3.33.67.12 postscript
-.....................
-
-This section is only relevant to output from 'set term postscript
-color'.  When the palette is defined using *note rgbformulae::, gnuplot
-writes a postscript implementation of the required analytical formulae
-as a header just before a pm3d drawing (see /g and /cF definitions).
-Usually, it makes sense to write definitions of only the 3 formulae used
-in the palette.  This is the default option 'nops_allcF'. The option
-'ps_allcF' instead writes definitions of all 36 formulae.  This allows
-you to edit the postscript file in order to have different palettes for
-different surfaces in one graph.
-
-   If you write a pm3d surface to a postscript file, it may be possible
-to reduce the file size by running the awk script 'pm3dCompress.awk'
-afterward.  If the data lies on a rectangular grid, even greater
-compression may be possible using the awk script
-'pm3dConvertToImage.awk'.  Both scripts are distributed with gnuplot.
-Usage:
-         awk -f pm3dCompress.awk thefile.ps >smallerfile.ps
-         awk -f pm3dConvertToImage.awk thefile.ps >smallerfile.ps
-
-
-
-File: gnuplot.info,  Node: parametric_,  Next: paxis,  Prev: palette__,  Up: set-show
-
-3.33.68 parametric
-------------------
-
-The *note parametric:: command changes the meaning of 'plot' ('splot')
-from normal functions to parametric functions.  The command *note
-parametric:: restores the plotting style to normal, single-valued
-expression plotting.
-
-   Syntax:
-           set parametric
-           unset parametric
-           show parametric
-
-
-   For 2D plotting, a parametric function is determined by a pair of
-parametric functions operating on a parameter.  An example of a 2D
-parametric function would be 'plot sin(t),cos(t)', which draws a circle
-(if the aspect ratio is set correctly--see *note size::).  'gnuplot'
-will display an error message if both functions are not provided for a
-parametric 'plot'.
-
-   For 3D plotting, the surface is described as x=f(u,v), y=g(u,v),
-z=h(u,v).  Therefore a triplet of functions is required.  An example of
-a 3D parametric function would be 'cos(u)*cos(v),cos(u)*sin(v),sin(u)',
-which draws a sphere.  'gnuplot' will display an error message if all
-three functions are not provided for a parametric 'splot'.
-
-   The total set of possible plots is a superset of the simple f(x)
-style plots, since the two functions can describe the x and y values to
-be computed separately.  In fact, plots of the type t,f(t) are
-equivalent to those produced with f(x) because the x values are computed
-using the identity function.  Similarly, 3D plots of the type u,v,f(u,v)
-are equivalent to f(x,y).
-
-   Note that the order the parametric functions are specified is
-xfunction, yfunction (and zfunction) and that each operates over the
-common parametric domain.
-
-   Also, the *note parametric:: function implies a new range of values.
-Whereas the normal f(x) and f(x,y) style plotting assume an xrange and
-yrange (and zrange), the parametric mode additionally specifies a
-trange, urange, and vrange.  These ranges may be set directly with *note
-trange::, *note urange::, and *note vrange::, or by specifying the range
-on the 'plot' or 'splot' commands.  Currently the default range for
-these parametric variables is [-5:5].  Setting the ranges to something
-more meaningful is expected.
-
-
-File: gnuplot.info,  Node: paxis,  Next: pixmap,  Prev: parametric_,  Up: set-show
-
-3.33.69 paxis
--------------
-
-Syntax:
-           set paxis <axisno> {range <range-options> | tics <tic-options>}
-           set paxis <axisno> label <label-options> { offset <radial-offset> }
-           show paxis <axisno> {range | tics}
-
-   The *note paxis:: command is equivalent to the *note xrange:: and
-'set xtics' commands except that it acts on one of the axes p1, p2, ...
-used in parallel axis plots and spiderplots.  See *note parallelaxes::,
-*note xrange::, and 'set xtics'.  The normal options to the range and
-tics commands are accepted although not all options make sense for
-parallel axis plots.
-
-   'set paxis <axisno> label <label-options>' is relevant to spiderplots
-but ignored otherwise.  Axes of a parallel axis plot can be labeled
-using the *note title:: option of the plot command, which generates an
-xtic label.  Note that this may require also 'set xtics'.
-
-   The axis linetype properties are controlled using 'set style
-parallelaxis'.
-
-
-File: gnuplot.info,  Node: pixmap,  Next: pm3d,  Prev: paxis,  Up: set-show
-
-3.33.70 pixmap
---------------
-
-Syntax:
-           set pixmap <index> {"filename" | colormap <name>}
-                      at <position>
-                      {width <w> | height <h> | size <w>,<h>}
-                      {front|back|behind} {center}
-           show pixmaps
-           unset pixmaps
-           unset pixmap <index>
-
-
-   The 'set pixmap' command is similar to *note object:: in that it
-defines an object that will appear on subsequent plots.  The rectangular
-array of red/green/blue/alpha values making up the pixmap are read from
-a png, jpeg, or gif file.  The position and extent occupied by the
-pixmap in the gnuplot output may be specified in any coordinate system
-(see 'coordinates').  The coordinates given by 'at <position>' refer to
-the lower left corner of the pixmap unless keyword 'center' is present.
-
-   If the x-extent of the rendered pixmap is set using 'width
-<x-extent>' the aspect ratio of the original image is retained and
-neither the aspect ratio nor the orientation of the pixmap changes with
-axis scaling or rotation.  Similarly if the y-extent is set using
-'height <y-extent>'.  If both the x-extent and y-extent are given using
-'size <x-extent> <y-extent>' this overrides the original aspect ratio.
-If no size is set then the original size in pixels is used (the
-effective size is then terminal-dependent).
-
-   Pixmaps are not clipped to the border of the plot.  As an exception
-to the general behaviour of objects and layers, a pixmap assigned to
-layer 'behind' is rendered for only the first plot in a multiplot.  This
-allows all panels in a multiplot to share a single background pixmap.
-
-   Examples:
-           # Use a gradient as the background for all plotting
-           # Both x and y will be resized to fill the entire canvas
-           set pixmap 1 "gradient.png"
-           set pixmap 1 at screen 0, 0 size screen 1, 1 behind
-
-
-           # Place a logo at the lower right of each page plotted
-           set pixmap 2 "logo.jpg"
-           set pixmap 2 at screen 0.95, 0 width screen 0.05 behind
-
-
-           # Place a small image at some 3D coordinate
-           # It will move as if attached to the surface being plotted
-           # but will always face forward and remain upright
-           set pixmap 3 "image.png" at my_x, my_y, f(my_x,my_y) width screen .05
-           splot f(x,y)
-
-
-* Menu:
-
-* pixmap_from_colormap::
-
-
-File: gnuplot.info,  Node: pixmap_from_colormap,  Prev: pixmap,  Up: pixmap
-
-3.33.70.1 pixmap from colormap
-..............................
-
-Syntax:
-          set pixmap <index> colormap <name>
-
-
-   Another use of pixmaps is to store a gradient described by a named
-palette.  This is an easy way to specify gradient fill for a rectangular
-area.  It could be used to draw a separate colorbox for that named
-palette, or even as a background for the entire plot or the entire
-canvas.
-          set palette defined (0 "beige", 1 "light-cyan")
-          set colormap new Gradient
-          set pixmap 1 colormap Gradient behind
-          set pixmap 1 at screen 0,0 size screen 1,1
-          plot <something>
-
-
-
-File: gnuplot.info,  Node: pm3d,  Next: pointintervalbox,  Prev: pixmap,  Up: set-show
-
-3.33.71 pm3d
-------------
-
-pm3d is an 'splot' style for drawing palette-mapped 3d and 4d data as
-color/gray maps and surfaces.  It allows plotting gridded or non-gridded
-data without preprocessing.  pm3d style options also affect solid-fill
-polygons used to construct other 3D plot elements.
-
-   Syntax (the options can be given in any order):
-           set pm3d {
-                      { at <position> }
-                      { interpolate <steps/points in scan, between scans> }
-                      { scansautomatic | scansforward | scansbackward
-                                       | depthorder {base} }
-                      { flush { begin | center | end } }
-                      { ftriangles | noftriangles }
-                      { clip | clip1in | clip4in }
-                      { {no}clipcb }
-                      { corners2color
-                        { mean|geomean|harmean|rms|median|min|max|c1|c2|c3|c4 }
-                      }
-                      { {no}lighting
-                        {primary <fraction>} {specular <fraction>} {spec2 <fraction>}
-                      }
-                      { {no}border {retrace} {<linestyle-options>}}
-                      { implicit | explicit }
-                      { map }
-                    }
-           show pm3d
-           unset pm3d
-
-
-   Note that pm3d plots are plotted sequentially in the order given in
-the splot command.  Thus earlier plots may be obscured by later plots.
-To avoid this you can use the 'depthorder' scan option.
-
-   The pm3d surfaces can be projected onto the 'top' or 'bottom' of the
-view box.  See *note position::.  The following command draws three
-color surfaces at different altitudes:
-           set border 4095
-           set pm3d at s
-           splot 10*x with pm3d at b, x*x-y*y, x*x+y*y with pm3d at t
-
-
-   See also help for *note palette::, *note cbrange::, 'set colorbox',
-and the demo file 'demo/pm3d.dem'.
-
-* Menu:
-
-* with_pm3d_(pm3d_explicit)::
-* pm3d_implicit::
-* algorithm::
-* lighting::
-* position::
-* scanorder::
-* clipping::
-* color_assignment::
-* corners2color::
-* border_::
-* fillcolor::
-* interpolate::
-* deprecated_options::
-
-
-File: gnuplot.info,  Node: with_pm3d_(pm3d_explicit),  Next: pm3d_implicit,  Prev: pm3d,  Up: pm3d
-
-3.33.71.1 with pm3d (pm3d explicit)
-...................................
-
-Syntax
-          splot DATA using (x):(y):(z){:(color)} with pm3d
-                     {fs|fillstyle <fillstyle>} {fc|fillcolor <colorspec>}
-                     {zclip [zmin:zmax]}
-
-
-   The rendering properties of all pm3d surfaces are controlled using
-'set pm3d'.  By default the full surface is rendered as a grid of
-quadrangles, each colored by the palette color mapped to that z
-coordinate.  If you provide a fourth input column, the palette mapping
-uses that value rather than z.  See *note fillcolor::, *note
-color_assignment::.
-
-   When you explicitly use 'with pm3d' in the plot command rather than
-using another plot style while 'set pm3 implicit' is active, additional
-rendering options are possible.  This allows you to use separate
-coloring schemes for different surfaces in the same plot.
-
-   EXPERIMENTAL: This gnuplot version introduces an option 'zclip' that
-clips the generated surface smoothly at a pair of limiting z values.
-The example below animates gradual removal of the top portion of a
-two-color 3D surface.
-          set style line 101 lc "gray"
-          set style line 102 lc "blue"
-          set pm3d depthorder
-          do for [i=0:N] {
-              splot f(x,y) with pm3d fillcolor ls 101 zclip [* : zmax-(i*delta)]
-              pause 0.2  # 1/5 second between animation frames
-          }
-
-
-
-File: gnuplot.info,  Node: pm3d_implicit,  Next: algorithm,  Prev: with_pm3d_(pm3d_explicit),  Up: pm3d
-
-3.33.71.2 pm3d implicit
-.......................
-
-A pm3d color surface is drawn if the splot command explicitly specifies
-'with pm3d', if the data or function *note style:: is set to pm3d
-globally, or if the pm3d mode is 'set pm3d implicit'.  For the latter
-two cases the pm3d surface is draw in addition to the mesh produced by
-the style specified in the plot command.  E.g.
-           splot 'fred.dat' with lines, 'lola.dat' with lines
-
-   would draw both a mesh of lines and a pm3d surface for each data set.
-If the option 'explicit' is on (or 'implicit' is off) only plots
-specified by the 'with pm3d' attribute are plotted with a pm3d surface,
-e.g.:
-           splot 'fred.dat' with lines, 'lola.dat' with pm3d
-
-   would plot 'fred.dat' with lines (only) and 'lola.dat' with a pm3d
-surface.
-
-   On gnuplot start-up, the mode is 'explicit'.  For historical and
-compatibility reasons, the commands 'set pm3d;' (i.e.  no options) and
-'set pm3d at X ...'  (i.e.  'at' is the first option) change the mode to
-'implicit'.  The command 'set pm3d;' sets other options to their default
-state.
-
-   If you set the default data or function style to 'pm3d', e.g.:
-           set style data pm3d
-
-   then the options 'implicit' and 'explicit' have no effect.
-
-
-File: gnuplot.info,  Node: algorithm,  Next: lighting,  Prev: pm3d_implicit,  Up: pm3d
-
-3.33.71.3 algorithm
-...................
-
-Let us first describe how a map/surface is drawn.  The input data come
-from an evaluated function or from an 'splot data file'.  Each surface
-consists of a sequence of separate scans (isolines).  The pm3d algorithm
-fills the region between two neighbouring points in one scan with
-another two points in the next scan by a gray (or color) according to
-z-values (or according to an additional 'color' column, see help for
-'using') of these 4 corners; by default the 4 corner values are
-averaged, but this can be changed by the option *note corners2color::.
-In order to get a reasonable surface, the neighbouring scans should not
-cross and the number of points in the neighbouring scans should not
-differ too much; of course, the best plot is with scans having same
-number of points.  There are no other requirements (e.g.  the data need
-not be gridded).  Another advantage is that the pm3d algorithm does not
-draw anything outside of the input (measured or calculated) region.
-
-   Surface coloring works with the following input data:
-
-   1.  splot of function or of data file with one or three data columns:
-The gray/color scale is obtained by mapping the averaged (or *note
-corners2color::) z-coordinate of the four corners of the above-specified
-quadrangle into the range [min_color_z,max_color_z] of *note zrange:: or
-*note cbrange:: providing a gray value in the range [0:1].  This value
-can be used directly as the gray for gray maps.  The normalized gray
-value can be further mapped into a color--see *note palette:: for the
-complete description.
-
-   2.  splot of data file with two or four data columns: The gray/color
-value is obtained by using the last-column coordinate instead of the
-z-value, thus allowing the color and the z-coordinate be mutually
-independent.  This can be used for 4d data drawing.
-
-   Other notes:
-
-   1.  The term 'scan' referenced above is used more among physicists
-than the term 'iso_curve' referenced in gnuplot documentation and
-sources.  You measure maps recorded one scan after another scan, that's
-why.
-
-   2.  The 'gray' or 'color' scale is a linear mapping of a continuous
-variable onto a smoothly varying palette of colors.  The mapping is
-shown in a rectangle next to the main plot.  This documentation refers
-to this as a "colorbox", and refers to the indexing variable as lying on
-the colorbox axis.  See 'set colorbox', *note cbrange::.
-
-
-File: gnuplot.info,  Node: lighting,  Next: position,  Prev: algorithm,  Up: pm3d
-
-3.33.71.4 lighting
-..................
-
-Syntax:
-          set pm3d lighting {primary <frac>} {specular <frac>} {spec2 <frac>}
-          set pm3d spotlight {rgb <color>} {rot_x <angle>} {rot_z <angle>}
-                             {Phong <value>} {default}
-
-
-   By default the colors assigned to pm3d objects are not dependent on
-orientation or viewing angle.  This state corresponds to 'set pm3d
-nolighting'.  The command *note lighting:: selects a simple lighting
-model consisting of a single fixed source of illumination contributing
-50% of the overall lighting.  The strength of this light relative to the
-ambient illumination can be adjusted by 'set pm3d lighting primary
-<fraction>'.  Inclusion of specular highlighting can be adjusted by
-setting a fractional contribution:
-          set pm3d lighting primary 0.50 specular 0.0   # no highlights
-          set pm3d lighting primary 0.50 specular 0.6   # strong highlights
-
-   Solid-color pm3d surfaces tend to look very flat without specular
-highlights.
-
-   Since highlights the primary source only affect one side of the
-surface, it may help to add illumination from a second spotlight shining
-from another direction.  The strength of this second spotlight is set by
-"spec2 <fraction>".  The second spotlight is included in the lighting
-model only if spec2 is greater than zero.  The direction, color, and
-specular model is controlled by "set pm3d spotlight".  Use and
-positioning of this spotlight is illustrated in the interactive demo
-'spotlight.dem'.  See also hidden_compare.dem (comparison of hidden3d
-and pm3d treatment of solid-color surfaces)
-(http://www.gnuplot.info/demo/hidden_compare.html) Example:
-          set pm3d lighting primary 0.8 spec 0.4 spec2 0.4
-          set pm3d spot rgb "blue"
-
-   D spotlight 1
-
-
-File: gnuplot.info,  Node: position,  Next: scanorder,  Prev: lighting,  Up: pm3d
-
-3.33.71.5 position
-..................
-
-The pm3d colored surface can be drawn at the true z position of the
-surface or projected onto the base plane or the top plane.  This is
-controlled by the 'at' option with a string of up to 6 combinations of
-'b', 't' and 's'.  For instance, 'at b' plots at the bottom only, 'at
-st' plots first at the surface and then on the top plane, while 'at
-bstbst' is unlikely to be useful.
-
-   Colored quadrangles are plotted one after another.  That means later
-quadrangles can occlude or overlap the previous ones.  You may try to
-switch between 'scansforward' and 'scansbackward' to force the first
-scan of the data to be plotted first or last.  The default is
-'scansautomatic' where gnuplot makes a guess about scans order.  The
-'depthorder' option completely reorders the quadrangles by sorting on
-the distance from the viewpoint.  This allow to visualize even
-complicated surfaces; see 'pm3d depthorder' for more details.
-
-
-File: gnuplot.info,  Node: scanorder,  Next: clipping,  Prev: position,  Up: pm3d
-
-3.33.71.6 scanorder
-...................
-
-          set pm3d {scansautomatic | scansforward | scansbackward | depthorder}
-
-
-   By default the quadrangles making up a pm3d solid surface are
-rendered in the order they are encountered along the surface grid
-points.  This order may be controlled by the options
-'scansautomatic'|'scansforward'|'scansbackward'.  These scan options are
-not in general compatible with hidden-surface removal.
-
-   If two successive scans do not have same number of points, then it
-has to be decided whether to start taking points for quadrangles from
-the beginning of both scans ('flush begin'), from their ends ('flush
-end') or to center them ('flush center').  Note, that 'flush
-(center|end)' are incompatible with 'scansautomatic': if you specify
-'flush center' or 'flush end' and 'scansautomatic' is set, it is
-silently switched to 'scansforward'.
-
-   If two subsequent scans do not have the same number of points, the
-option 'ftriangles' specifies whether color triangles are drawn at the
-scan tail(s) where there are not enough points in either of the scans.
-This can be used to draw a smooth map boundary.
-
-   Gnuplot does not do true hidden surface removal for solid surfaces,
-but often it is sufficient to render the component quadrangles in order
-from furthest to closest.  This mode may be selected using the option
-           set pm3d depthorder
-
-   Note that the global option *note hidden3d:: does not affect pm3d
-surfaces.
-
-   The 'depthorder' option by itself tends to produce bad results when
-applied to the long thin rectangles generated by *note boxes::.  It
-works better to add the keyword 'base', which performs the depth sort
-using the intersection of the box with the plane at z=0.  This type of
-plot is further improved by adding a lighting model.  Example:
-          set pm3d depthorder base
-          set pm3d lighting
-          set boxdepth 0.4
-          splot $DATA using 1:2:3 with boxes
-
-
-
-File: gnuplot.info,  Node: clipping,  Next: color_assignment,  Prev: scanorder,  Up: pm3d
-
-3.33.71.7 clipping
-..................
-
-Syntax:
-          set pm3d {clip | clip1in | clip4in}
-          set pm3d {no}clipcb
-
-
-   The component quadrangles of a pm3d surface or other 3D object are by
-default smoothly clipped against the current zrange.  This is a change
-from earlier gnuplot versions.  In 2D projection ('set view map') this
-mode also clips against xrange and yrange.
-
-   Alternatively, surfaces can be clipped by rendering whole quadrangles
-but only those with all 4 corners in-range on x, y, and z ('set pm3d
-clip4in'), or only those with at least one corner in-range on x, y, and
-z ('set pm3d clip1in').  The options 'clip', 'clip1in', and 'clip4in'
-are mutually exclusive.
-
-   Separate from clipping based on spatial x, y, and z coordinates,
-quadrangles can be rendered or not based on extreme palette color
-values.  'clipcb': (default) palette color values < cbmin are treated as
-cbmin; palette color values > cbmax are treated as cbmax.  'noclipcb':
-quadrangles with color value outside cbrange are not drawn at all.
-
-
-File: gnuplot.info,  Node: color_assignment,  Next: corners2color,  Prev: clipping,  Up: pm3d
-
-3.33.71.8 color_assignment
-..........................
-
-The default pm3d coloring assigns an individual color to each quadrangle
-of the surface grid.  For alternative coloring schemes that assign
-uniform color to the entire surface, see *note fillcolor::.
-
-   A single gray/color value (i.e.  not a gradient) is assigned to each
-quadrangle.  This value is calculated from the z-coordinates the four
-quadrangle corners according to 'corners2color <option>'.  The value is
-then used to select a color from the current palette.  See *note
-palette::.  It is not possible to change palettes inside a single
-'splot' command.
-
-   If a fourth column of data is provided, the coloring of individual
-quadrangles works as above except that the color value is distinct from
-the z value.  As a separate coloring option, the fourth data column may
-provide instead an RGB color.  See 'rgbcolor variable'.  In this case
-the plotting command must be
-
-           splot ... using 1:2:3:4 with pm3d lc rgb variable
-
-
-   Notice that ranges of z-values and color-values for surfaces are
-adjustable independently by *note zrange::, *note cbrange::, 'set log
-z', 'set log cb', etc.
-
-
-File: gnuplot.info,  Node: corners2color,  Next: border_,  Prev: color_assignment,  Up: pm3d
-
-3.33.71.9 corners2color
-.......................
-
-The color of each quadrangle in a pm3d surface is assigned based on the
-color values of its four bounding vertices.  The options 'mean'
-(default), 'geomean', 'harmean, 'rms', and 'median' produce various
-kinds of surface color smoothing, while options 'min' and 'max' choose
-minimal or maximal value, respectively.  This may not be desired for
-pixel images or for maps with sharp and intense peaks, in which case the
-options 'c1', 'c2', 'c3' or 'c4' can be used instead to assign the
-quadrangle color based on the z-coordinate of only one corner.  Some
-experimentation may be needed to determine which corner corresponds to
-'c1', as the orientation depends on the drawing direction.  Because the
-pm3d algorithm does not extend the colored surface outside the range of
-the input data points, the 'c<j>' coloring options will result in pixels
-along two edges of the grid not contributing to the color of any
-quadrangle.  For example, applying the pm3d algorithm to the 4x4 grid of
-data points in script 'demo/pm3d.dem' (please have a look) produces only
-(4-1)x(4-1)=9 colored rectangles.
-
-
-File: gnuplot.info,  Node: border_,  Next: fillcolor,  Prev: corners2color,  Up: pm3d
-
-3.33.71.10 border
-.................
-
-          set pm3d border {retrace} {line-properties}
-          set pm3d noborder
-
-
-   This option draws bounding lines around each pm3d quadrangle as it is
-rendered.  Additional line properties (linetype, color, linewidth) are
-optional.  By default the border is drawn as a solid black line with
-width 1.
-
-   'set pm3d border retrace' causes a border to be drawn in the same
-color as the quadrangle.  In principle this should give the same result
-as 'noborder', but some output modes can suffer from antialiasing
-artifacts between adjacent filled quadrangles.  Retracing the border
-hides these artifacts, at the cost of a larger output file.
-
-
-File: gnuplot.info,  Node: fillcolor,  Next: interpolate,  Prev: border_,  Up: pm3d
-
-3.33.71.11 fillcolor
-....................
-
-          splot FOO with pm3d fillcolor <colorspec>
-
-
-   Plot style 'with pm3d' accepts an optional fillcolor in the splot
-command.  This specification is applied to the entire pm3d surface.  See
-*note colorspec::.  Most fillcolor specifications will result in a
-single solid color, which is hard to interpret visually unless there is
-also a lighting model present to distinguish surface components based on
-orientation.  See *note lighting::.
-
-   There are a few special cases.  *note palette:: would produce the
-same result as the default pm3d palette-based coloring, and is therefore
-not a useful option.  'with pm3d fillcolor linestyle N' is more
-interesting.  This variant assigns distinct colors to the top and bottom
-of the pm3d surface, similar to the color scheme used by gnuplot's *note
-hidden3d:: mode.  Linestyle N is used for the top surface; linestyle N+1
-for the bottom surface.  Note that "top" and "bottom" depend on the scan
-order, so that the colors are inverted for 'pm3d scansbackward' as
-compared to 'pm3d scansforward'.  This coloring option works best with
-'pm3d depthorder', however, which unfortunately does not allow you to
-control the scan order so you may have to instead swap the colors
-defined for linestyles N and N+1.
-
-
-File: gnuplot.info,  Node: interpolate,  Next: deprecated_options,  Prev: fillcolor,  Up: pm3d
-
-3.33.71.12 interpolate
-......................
-
-The option 'interpolate m,n' will interpolate between grid points to
-generate a finer mesh.  For data files, this smooths the color surface
-and enhances the contrast of spikes in the surface.  When working with
-functions, interpolation makes little sense.  It would usually make more
-sense to increase *note samples:: and *note isosamples::.
-
-   For positive m and n, each quadrangle or triangle is interpolated
-m-times and n-times in the respective direction.  For negative m and n,
-the interpolation frequency is chosen so that there will be at least |m|
-and |n| points drawn; you can consider this as a special gridding
-function.
-
-   Note: 'interpolate 0,0', will automatically choose an optimal number
-of interpolated surface points.
-
-   Note: Currently color interpolation is always linear, even if
-corners2color is set to a nonlinear scheme such as the geometric mean.
-
-
-File: gnuplot.info,  Node: deprecated_options,  Prev: interpolate,  Up: pm3d
-
-3.33.71.13 deprecated_options
-.............................
-
-The deprecated option 'set pm3d map' was equivalent to 'set pm3d at b;
-set view map; set style data pm3d; set style func pm3d;'
-
-   The deprecated option 'set pm3d hidden3d N' was equivalent to 'set
-pm3d border ls N'.
-
-
-File: gnuplot.info,  Node: pointintervalbox,  Next: pointsize,  Prev: pm3d,  Up: set-show
-
-3.33.72 pointintervalbox
-------------------------
-
-The 'pointinterval' and 'pointnumber' properties of a line type are used
-only in plot style *note linespoints::.  A negative value of
-pointinterval or pointnumber, e.g.  -N, means that before the selected
-set of point symbols are drawn a box (actually circle) behind each point
-symbol is blanked out by filling with the background color.  The command
-*note pointintervalbox:: controls the radius of this blanked-out region.
-It is a multiplier for the default radius, which is equal to the point
-size.  *note pointintervalbox:: draws no blanked-out region.
-
-
-File: gnuplot.info,  Node: pointsize,  Next: polar,  Prev: pointintervalbox,  Up: set-show
-
-3.33.73 pointsize
------------------
-
-The *note pointsize:: command scales the size of the points used in
-plots.
-
-   Syntax:
-           set pointsize <multiplier>
-           show pointsize
-
-
-   The default is a multiplier of 1.0.  Larger pointsizes may be useful
-to make points more visible in bitmapped graphics.
-
-   The pointsize of a single plot may be changed on the 'plot' command.
-See 'plot with' for details.
-
-   Please note that the pointsize setting is not supported by all
-terminal types.
-
-
-File: gnuplot.info,  Node: polar,  Next: print_,  Prev: pointsize,  Up: set-show
-
-3.33.74 polar
--------------
-
-The 'set polar' command changes the meaning of the plot from rectangular
-coordinates to polar coordinates.
-
-   Syntax:
-           set polar
-           set polar grid <grid options>
-           unset polar
-           show polar
-
-
-   In polar coordinates, the dummy variable (t) represents an angle
-theta.  The default range of t is [0:2*pi], or [0:360] if degree units
-have been selected (see *note angles::).
-
-   The command 'unset polar' changes the meaning of the plot back to the
-default rectangular coordinate system.
-
-   The 'set polar' command affects only 2D plotting.  See the *note
-mapping:: command for analogous 3D functionality.
-
-   While in polar coordinates the meaning of an expression in t is
-really r = f(t), where t is an angle of rotation.  The trange controls
-the domain (the angle) of the function.  The r, x and y ranges control
-the extent of the graph in the x and y directions.  Each of these
-ranges, as well as the rrange, may be autoscaled or set explicitly.  For
-details, see *note rrange:: and *note xrange::.
-
-   Example:
-           set polar
-           plot t*sin(t)
-           set trange [-2*pi:2*pi]
-           set rrange [0:3]
-           plot t*sin(t)
-
-
-   The first 'plot' uses the default polar angular domain of 0 to 2*pi.
-The radius and the size of the graph are scaled automatically.  The
-second 'plot' expands the domain, and restricts the size of the graph to
-the area within 3 units of the origin.  This has the effect of limiting
-x and y to [-3:3].
-
-   By default polar plots are oriented such that theta=0 is at the far
-right, with theta increasing counterclockwise.  You can change both the
-origin and the sense explicitly.  See *note theta::.
-
-   You may want to 'set size square' to have 'gnuplot' try to make the
-aspect ratio equal to unity, so that circles look circular.  Tic marks
-around the perimeter can be specified using *note ttics::.  See also
-polar demos (polar.dem) (http://www.gnuplot.info/demo/polar.html) and
-polar data plot (poldat.dem).
-(http://www.gnuplot.info/demo/poldat.html)
-
-* Menu:
-
-* polar_grid::
-
-
-File: gnuplot.info,  Node: polar_grid,  Prev: polar,  Up: polar
-
-3.33.74.1 polar grid
-....................
-
-Syntax:
-           set polar grid {<theta_segments>, <radial_segments>}
-                          { qnorm {<power>} | gauss | cauchy | exp | box | hann }
-                          { kdensity } { scale <scale> }
-                          {theta [min:max]} {r [min:max]}
-
-
-   The polar grid settings are used in conjunction with the plot style
-'with surface' to generate a heat map from a set of polar coordinate
-points.  The surface consists of a grid filling a circle divided into
-segments formed by discrete ranges on theta and r.
-
-   Each segment is assigned a value derived from the input set of
-individual scattered points [x,y,z] by applying a filter operation.  The
-default filter is 'qnorm 1', which averages each point's z value
-weighted by the inverse of the point's distance from the center of that
-grid segment.
-
-   Alternative filter operations gauss, cauchy, exp, box, and hann are
-described in more detail elsewhere.  See *note dgrid3d::.
-
-   'kdensity': This keyword tells the program to use the weighted sum of
-contributions from all points rather than the weighted average.
-
-   'scale': This scale facter (default 1.0) is applied to all distances
-prior to using them in the weighting calculation.
-
-   Masking: All input points are used to calculate grid values.  The
-full gridded surface always spans theta range [0:360] and the radial
-defined by autoscaling or by a previous *note rrange:: command.  However
-the portion of the surface that actually appears in the plot can be
-restricted to a truncated wedge bounded by lower and upper limits on
-theta and r.  Theta limits must be given in degrees.
-
-   For example the following commands will generate a plot which is
-auto-scaled in size to show all input points.  The contributions of all
-input points are summed, not averaged ('kdensity'), and only a wedge of
-the resulting gridded surface is displayed.
-
-          set rrange [0:*]
-          set polar grid qnorm kdensity theta [0:190]
-          plot DATA with surface, DATA with points
-
-
-
-File: gnuplot.info,  Node: print_,  Next: psdir,  Prev: polar,  Up: set-show
-
-3.33.75 print
--------------
-
-The 'set print' command redirects the output of the 'print' command.
-
-   Syntax:
-           set print
-           set print "-"
-           set print "<filename>" [append]
-           set print "|<shell_command>"
-           set print $datablock [append]
-
-
-   'set print' with no parameters restores output to <STDERR>.  The
-<filename> "-" means <STDOUT>.  The 'append' flag causes the file to be
-opened in append mode.  A <filename> starting with "|" is opened as a
-pipe to the <shell_command> on platforms that support piping.
-
-   The destination for 'print' commands can also be a named data block.
-Data block names start with '$', see also 'inline data'.  When printing
-a string to a data block, embedded newline characters are expanded to
-generate multiple data block entries.
-
-
-File: gnuplot.info,  Node: psdir,  Next: raxis,  Prev: print_,  Up: set-show
-
-3.33.76 psdir
--------------
-
-The 'set psdir <directory>' command controls the search path used by the
-postscript terminal to find prologue.ps and character encoding files.
-You can use this mechanism to switch between different sets of
-locally-customized prolog files.  The search order is
-           1) The directory specified by *note psdir::, if any
-           2) The directory specified by environmental variable GNUPLOT_PS_DIR
-           3) A built-in header or one from the default system directory
-           4) Directories set by *note loadpath::
-
-
-
-File: gnuplot.info,  Node: raxis,  Next: rgbmax,  Prev: psdir,  Up: set-show
-
-3.33.77 raxis
--------------
-
-The commands *note raxis:: and *note raxis:: toggle whether the polar
-axis is drawn separately from grid lines and the x axis.  If the minimum
-of the current rrange is non-zero (and not autoscaled), then a white
-circle is drawn at the center of the polar plot to indicate that the
-plot lines and axes do not reach 0.  The axis line is drawn using the
-same line type as the plot border.  See 'polar', *note rrange::, *note
-rtics::, *note rlabel::, 'set grid'.
-
-
-File: gnuplot.info,  Node: rgbmax,  Next: rlabel,  Prev: raxis,  Up: set-show
-
-3.33.78 rgbmax
---------------
-
-Syntax:
-          set rgbmax {1.0 | 255}
-          unset rgbmax
-
-   The red/green/blue color components of an rgbimage plot are by
-default interpreted as integers in the range [0:255].  'set rgbmax 1.0'
-tells the program that data values used to generate the color components
-of a plot with *note rgbimage:: or *note rgbalpha:: are floating point
-values in the range [0:1].  *note rgbmax:: returns to the default
-integer range [0:255].
-
-
-File: gnuplot.info,  Node: rlabel,  Next: rmargin,  Prev: rgbmax,  Up: set-show
-
-3.33.79 rlabel
---------------
-
-This command places a label above the r axis.  The label will be drawn
-whether or not the plot is in polar mode.  See *note xlabel:: for
-additional keywords.
-
-
-File: gnuplot.info,  Node: rmargin,  Next: rrange,  Prev: rlabel,  Up: set-show
-
-3.33.80 rmargin
----------------
-
-The command *note rmargin:: sets the size of the right margin.  Please
-see *note margin:: for details.
-
-
-File: gnuplot.info,  Node: rrange,  Next: rtics,  Prev: rmargin,  Up: set-show
-
-3.33.81 rrange
---------------
-
-The *note rrange:: command sets the range of the radial coordinate for a
-graph in polar mode.  This has the effect of setting both xrange and
-yrange as well.  The resulting xrange and yrange are both [-(rmax-rmin)
-: +(rmax-rmin)].  However if you later change the x or y range, for
-example by zooming, this does not change rrange, so data points continue
-to be clipped against rrange.  Unlike other axes, autoscaling the raxis
-always results in rmin = 0.  The 'reverse' autoscaling flag is ignored.
-Note: Setting a negative value for rmin may produce unexpected results.
-
-
-File: gnuplot.info,  Node: rtics,  Next: samples,  Prev: rrange,  Up: set-show
-
-3.33.82 rtics
--------------
-
-The *note rtics:: command places tics along the polar axis.  The tics
-and labels are drawn to the right of the origin.  The 'mirror' keyword
-causes them to be drawn also to the left of the origin.  See 'polar',
-'set xtics', and 'set mxtics' for discussion of keywords.
-
-
-File: gnuplot.info,  Node: samples,  Next: size,  Prev: rtics,  Up: set-show
-
-3.33.83 samples
----------------
-
-Function plots are constructed by sampling the function at a given
-number of x values and drawing line segments to connect the values
-f(x0)..f(x1)..f(x2)...  The default sampling rate for functions, or for
-interpolating data, may be changed by the *note samples:: command.  To
-change the sampling range for a particular component of a 'plot' or
-'splot' command, see *note sampling::.
-
-   Syntax:
-           set samples <samples_1> {,<samples_2>}
-           show samples
-
-
-   By default, sampling is set to 100 points.  A higher sampling rate
-will produce more accurate plots, but will take longer.  This parameter
-has no effect on data file plotting unless one of the
-interpolation/approximation options is used.  See *note smooth::, *note
-cntrparam:: and *note dgrid3d::.
-
-   When a 2D graph is being done, only the value of <samples_1> is
-relevant.
-
-   When a surface plot is being done without the removal of hidden
-lines, the value of samples specifies the number of samples that are to
-be evaluated for the isolines.  Each iso-v line will have <sample_1>
-samples and each iso-u line will have <sample_2> samples.  If you only
-specify <samples_1>, <samples_2> will be set equal to <samples_1>.  See
-also *note isosamples::.
-
-
-File: gnuplot.info,  Node: size,  Next: spiderplot_,  Prev: samples,  Up: set-show
-
-3.33.84 size
-------------
-
-Syntax:
-           set size {{no}square | ratio <r> | noratio} {<xscale>,<yscale>}
-           show size
-
-
-   The <xscale> and <yscale> values are scale factors for the size of
-the plot, which includes the graph, labels, and margins.
-
-   Historical note: In early versions of gnuplot some terminal types
-used *note size:: to control also the size of the output canvas.  Now
-there are two distinct properties: ''set size'' and ''set term ...
-size''.
-
-   'set term <terminal_type> size <x units>, <y units>' controls the
-size of the output file, or 'canvas'.  Please see individual terminal
-documentation for the units of the size parameters.  By default, the
-plot will fill this canvas.
-
-   'set size <xscale>, <yscale>' scales the plot itself relative to the
-size of the canvas.  Scale values less than 1.0 cause the plot to fill
-only part of the canvas.  This can be used together with *note
-multiplot:: to inset a small plot inside a larger plot or to place
-several small plots side-by-side.  Scale values greater than 1.0 are not
-supported and may cause errors.
-
-   'ratio' causes 'gnuplot' to try to create a graph with an aspect
-ratio of <r> (the ratio of the y-axis length to the x-axis length)
-within the portion of the plot specified by <xscale> and <yscale>.
-
-   The meaning of a negative value for <r> is different.  If <r>=-1,
-gnuplot tries to set the scales so that the unit length along on both
-the x and y axes is the same; i.e.  they are isotropic.  See also *note
-isotropic::.  This is the 2D equivalent to the 3D command 'set view
-equal xy'.  If <r>=-2, the unit on y has twice the length of the unit on
-x, and so on.  See also *note isotropic::.
-
-   The success of 'gnuplot' in producing the requested aspect ratio
-depends on the terminal selected.  The graph area will be the largest
-rectangle of aspect ratio <r> that will fit into the specified portion
-of the output (leaving adequate margins, of course).
-
-   'set size square' is a synonym for 'set size ratio 1'.
-
-   Both 'noratio' and 'nosquare' return the graph to the default aspect
-ratio of the terminal, but do not return <xscale> or <yscale> to their
-default values (1.0).
-
-   'ratio' and 'square' have no effect on 3D plots, but do affect 3D
-projections created using 'set view map'.  See also 'set view equal',
-which forces the x and y axes of a 3D onto the same scale.
-
-   Examples:
-
-   To set the size so that the plot fills the available canvas:
-           set size 1,1
-
-
-   To make the graph half size and square use:
-           set size square 0.5,0.5
-
-
-   To make the graph twice as high as wide use:
-           set size ratio 2
-
-
-
-File: gnuplot.info,  Node: spiderplot_,  Next: style,  Prev: size,  Up: set-show
-
-3.33.85 spiderplot
-------------------
-
-The *note spiderplot:: command switches interpretation of coordinates to
-a polar system in which each data point is mapped to a position along a
-radial axis.  paxis 1 is always vertical; axes 2 to N proceed clockwise
-with even spacing.  The command must be issued prior to plotting.  It
-has additional effects equivalent to
-          set style data spiderplot
-          unset border
-          unset tics
-          set key noautotitle
-          set size ratio 1.0
-
-   Use *note reset:: to restore these after plotting.
-
-
-File: gnuplot.info,  Node: style,  Next: surface_,  Prev: spiderplot_,  Up: set-show
-
-3.33.86 style
--------------
-
-Default plotting styles are chosen with the 'set style data' and 'set
-style function' commands.  See 'plot with' for information about how to
-override the default plotting style for individual functions and data
-sets.  See 'plotting styles' or 'plot with' for a complete list of
-styles.
-
-   Syntax:
-           set style function <style>
-           set style data <style>
-           show style function
-           show style data
-
-
-   Default styles for specific plotting elements may also be set.
-
-   Syntax:
-           set style arrow <n> <arrowstyle>
-           set style boxplot <boxplot style options>
-           set style circle radius <size> {clip|noclip}
-           set style ellipse size <size> units {xy|xx|yy} {clip|noclip}
-           set style fill <fillstyle>
-           set style histogram <histogram style options>
-           set style line <n> <linestyle>
-           set style rectangle <object options> <linestyle> <fillstyle>
-           set style textbox {<n>} {opaque|transparent} {{no}border} {fillcolor}
-           set style watchpoint labels <label options>
-
-
-* Menu:
-
-* set_style_arrow::
-* boxplot_::
-* set_style_data::
-* set_style_fill::
-* set_style_function::
-* set_style_histogram::
-* set_style_increment::
-* set_style_line::
-* set_style_circle::
-* set_style_rectangle::
-* set_style_ellipse::
-* set_style_parallelaxis::
-* set_style_spiderplot::
-* set_style_textbox::
-* set_style_watchpoint::
-
-
-File: gnuplot.info,  Node: set_style_arrow,  Next: boxplot_,  Prev: style,  Up: style
-
-3.33.86.1 set style arrow
-.........................
-
-You can use 'set style arrow' to define a set of arrow types.  Each type
-has its own width, point type, color, etc so that you can refer to them
-later by an index instead of repeating all the information at each
-invocation.
-
-   Syntax:
-           set style arrow <index> default
-           set style arrow <index> {nohead | head | backhead | heads}
-                                   {size <length>,<angle>{,<backangle>} {fixed}}
-                                   {filled | empty | nofilled | noborder}
-                                   {front | back}
-                                   { {linestyle | ls <line_style>}
-                                     | {linetype | lt <line_type>}
-                                       {linewidth | lw <line_width}
-                                       {linecolor | lc <colorspec>}
-                                       {dashtype | dt <dashtype>} }
-           unset style arrow
-           show style arrow
-
-
-   <index> is an integer that identifies the arrowstyle.
-
-   If 'default' is given all arrow style parameters are set to their
-default values.
-
-   If the linestyle <index> already exists, only the given parameters
-are changed while all others are preserved.  If not, all undefined
-values are set to the default values.
-
-   An arrow style invoked from a 'plot' or 'splot' command can include a
-data-dependent linecolor ('lc variable' or 'lc rgb variable') that
-consumes an additional column of data in the corresponding 'using'
-specification.  In this case the style is probably not useful for
-individual arrows created by 'set arrow'.
-
-   Specifying 'nohead' produces arrows drawn without a head--a line
-segment.  This gives you yet another way to draw a line segment on the
-plot.  By default, arrows have one head.  Specifying 'heads' draws arrow
-heads on both ends of the line.
-
-   Head size can be modified using 'size <length>,<angle>' or 'size
-<length>,<angle>,<backangle>', where '<length>' defines length of each
-branch of the arrow head and '<angle>' the angle (in degrees) they make
-with the arrow.  '<Length>' is in x-axis units; this can be changed by
-'first', 'second', 'graph', 'screen', or 'character' before the
-<length>; see 'coordinates' for details.
-
-   By default the size of the arrow head is reduced for very short
-arrows.  This can be disabled using the 'fixed' keyword after the *note
-size:: command.
-
-   '<backangle>' is the angle (in degrees) the back branches make with
-the arrow (in the same direction as '<angle>').  It is ignored if the
-style is 'nofilled'.
-
-   Specifying 'filled' produces filled arrow heads with a border line
-around the arrow head.  Specifying 'noborder' produces filled arrow
-heads with no border.  In this case the tip of the arrow head lies
-exactly on the endpoint of the vector and the arrow head is slightly
-smaller overall.  Dashed arrows should always use 'noborder', since a
-dashed border is ugly.  Not all terminals support filled arrow heads.
-
-   The line style may be selected from a user-defined list of line
-styles (see 'set style line') or may be defined here by providing values
-for '<line_type>' (an index from the default list of styles) and/or
-'<line_width>' (which is a multiplier for the default width).
-
-   Note, however, that if a user-defined line style has been selected,
-its properties (type and width) cannot be altered merely by issuing
-another 'set style arrow' command with the appropriate index and 'lt' or
-'lw'.
-
-   If 'front' is given, the arrows are written on top of the graphed
-data.  If 'back' is given (the default), the arrow is written underneath
-the graphed data.  Using 'front' will prevent a arrow from being
-obscured by dense data.
-
-   Examples:
-
-   To draw an arrow without an arrow head and double width, use:
-           set style arrow 1 nohead lw 2
-           set arrow arrowstyle 1
-
-
-   See also 'set arrow' for further examples.
-
-
-File: gnuplot.info,  Node: boxplot_,  Next: set_style_data,  Prev: set_style_arrow,  Up: style
-
-3.33.86.2 boxplot
-.................
-
-The *note boxplot:: command allows you to change the layout of plots
-created using the *note boxplot:: plot style.
-
-   Syntax:
-           set style boxplot {range <r> | fraction <f>}
-                             {{no}outliers} {pointtype <p>}
-                             {candlesticks | financebars}
-                             {medianlinewidth <width>}
-                             {separation <x>}
-                             {labels off | auto | x | x2}
-                             {sorted | unsorted}
-
-
-   The box in the boxplot always spans the range of values from the
-first quartile to the third quartile of the data points.  The limit of
-the whiskers that extend from the box can be controlled in two different
-ways.  By default the whiskers extend from each end of the box for a
-range equal to 1.5 times the interquartile range (i.e.  the vertical
-height of the box proper).  Each whisker is truncated back toward the
-median so that it terminates at a y value belonging to some point in the
-data set.  Since there may be no point whose value is exactly 1.5 times
-the interquartile distance, the whisker may be shorter than its nominal
-range.  This default corresponds to
-           set style boxplot range 1.5
-
-
-   Alternatively, you can specify the fraction of the total number of
-points that the whiskers should span.  In this case the range is
-extended symmetrically from the median value until it encompasses the
-requested fraction of the data set.  Here again each whisker is
-constrained to end at a point in the data set.  To span 95% of the
-points in the set
-           set style boxplot fraction 0.95
-
-
-   Any points that lie outside the range of the whiskers are considered
-outliers.  By default these are drawn as individual circles (pointtype
-7).  The option 'nooutliers' disables this.  If outliers are not drawn
-they do not contribute to autoscaling.
-
-   By default boxplots are drawn in a style similar to candlesticks, but
-you have the option of using instead a style similar to finance bars.
-
-   A crossbar indicating the median is drawn using the same line type as
-box boundary.  If you want a thicker line for the median
-           set style boxplot medianlinewidth 2.0
-
-   If you want no median line, set this to 0.
-
-   If the using specification for a boxplot contains a fourth column,
-the values in that column will be interpreted as a discrete category to
-which this data point belongs.  In this case one boxplot is drawn for
-each category found in the input.  These boxplots will be drawn next to
-each other spaced by 1.0 along x (in x-axis units).  This spacing can be
-changed by the option 'set style boxplot separation'.
-
-   The *note labels:: option governs how and where these boxplots (each
-representing a part of the dataset) are labeled.  By default the
-category identifier is used as a tick label on the horizontal axis - x
-or x2, depending on which one is used for the plot itself.  This setting
-corresponds to option 'labels auto'.  The labels can be forced to use
-either of the x or x2 axes - options 'labels x' and 'labels x2',
-respectively -, or they can be turned off altogether with the option
-'labels off'.
-
-   By default the boxplots corresponding to different categories will be
-drawn in the same order the levels are encountered in the data file.
-This behavior corresponds to the 'unsorted' option.  If the 'sorted'
-option is active, the category identifiers are first sorted
-alphabetically, and the boxplots are drawn in the sorted order.
-
-   The 'separation', *note labels::, 'sorted' and 'unsorted' option only
-have an effect if a fourth column is given the plot specification.
-
-   See *note boxplot::, *note candlesticks::, *note financebars::.
-
-
-File: gnuplot.info,  Node: set_style_data,  Next: set_style_fill,  Prev: boxplot_,  Up: style
-
-3.33.86.3 set style data
-........................
-
-The 'set style data' command changes the default plotting style for data
-plots.
-
-   Syntax:
-           set style data <plotting-style>
-           show style data
-
-
-   See 'plotting styles' for the choices.  'show style data' shows the
-current default data plotting style.
-
-
-File: gnuplot.info,  Node: set_style_fill,  Next: set_style_function,  Prev: set_style_data,  Up: style
-
-3.33.86.4 set style fill
-........................
-
-The 'set style fill' command is used to set the default style of the
-plot elements in plots with boxes, histograms, candlesticks and
-filledcurves.  This default can be superseded by fillstyles attached to
-individual plots.  Note that there is a separate default fill style for
-rectangles created by 'set obj'.  See *note rectangle::.
-
-   Syntax:
-           set style fill {empty
-                           | {transparent} solid {<density>}
-                           | {transparent} pattern {<n>}}
-                          {border {lt} {lc <colorspec>} | noborder}
-
-
-   The default fillstyle is 'empty'.
-
-   The 'solid' option causes filling with a solid color, if the terminal
-supports that.  The <density> parameter specifies the intensity of the
-fill color.  At a <density> of 0.0, the box is empty, at <density> of
-1.0, the inner area is of the same color as the current linetype.  Some
-terminal types can vary the density continuously; others implement only
-a few levels of partial fill.  If no <density> parameter is given, it
-defaults to 1.
-
-   The 'pattern' option causes filling to be done with a fill pattern
-supplied by the terminal driver.  The kind and number of available fill
-patterns depend on the terminal driver.  If multiple datasets using
-filled boxes are plotted, the pattern cycles through all available
-pattern types, starting from pattern <n>, much as the line type cycles
-for multiple line plots.
-
-   The 'empty' option causes filled boxes not to be filled.  This is the
-default.
-
-   Fill color ('fillcolor <colorspec>') is distinct from fill style.
-I.e.  plot elements or objects can share a fillstyle while retaining
-separate colors.  In most places where a fillstyle is accepted you can
-also specify a fill color.  Fillcolor may be abbreviated 'fc'.
-Otherwise the fill color is take from the current linetype.  Example:
-
-           plot FOO with boxes fillstyle solid 1.0 fillcolor "cyan"
-
-
--- SET STYLE FILL BORDER --
-
-   The bare keyword *note border:: causes the filled object to be
-surrounded by a solid line of the current linetype and color.  You can
-change the color of this line by adding either a linetype or a
-linecolor.  'noborder' specifies that no bounding line is drawn.
-Examples:
-          # Half-intensity fill, full intensity border in same color
-          set style fill solid 0.5 border
-          # Half-transparent fill, solid black border (linetype -1)
-          set style fill transparent solid 0.5 border -1
-          # Pattern fill in current color, border using color of linetype 5
-          plot ... with boxes fillstyle pattern 2 border lt 5
-          # Fill area in cyan, border in blue
-          plot ... with boxes fillcolor "cyan" fs solid border linecolor "blue"
-
-
-   Note: The border property of a fill style only affects plots drawn
-*note filledcurves:: in the default mode (closed curve).
-
--- SET STYLE FILL TRANSPARENT --
-
-   Some terminals support the attribute 'transparent' for filled areas.
-In the case of transparent solid fill areas, the 'density' parameter is
-interpreted as an alpha value; that is, density 0 is fully transparent,
-density 1 is fully opaque.  In the case of transparent pattern fill, the
-background of the pattern is either fully transparent or fully opaque.
-
-   Note that there may be additional limitations on the creation or
-viewing of graphs containing transparent fill areas.  For example, the
-png terminal can only use transparent fill if the "truecolor" option is
-set.  Some pdf viewers may not correctly display the fill areas even if
-they are correctly described in the pdf file.  Ghostscript/gv does not
-correctly display pattern-fill areas even though actual PostScript
-printers generally have no problem.
-
-
-File: gnuplot.info,  Node: set_style_function,  Next: set_style_histogram,  Prev: set_style_fill,  Up: style
-
-3.33.86.5 set style function
-............................
-
-The 'set style function' command changes the default plotting style for
-function plots (e.g.  lines, points, filledcurves).  See 'plotting
-styles'.
-
-   Syntax:
-           set style function <plotting-style>
-           show style function
-
-
-
-File: gnuplot.info,  Node: set_style_histogram,  Next: set_style_increment,  Prev: set_style_function,  Up: style
-
-3.33.86.6 set style histogram
-.............................
-
-See *note histograms::.
-
-
-File: gnuplot.info,  Node: set_style_increment,  Next: set_style_line,  Prev: set_style_histogram,  Up: style
-
-3.33.86.7 set style increment
-.............................
-
-By default, successive plots within the same graph will use successive
-linetypes.  'set style increment userstyles' changed this to step
-through successive user-defined line styles instead.
-
-   DEPRECATED. This command is present in gnuplot version 6.0 only if
-your copy was built with configuration option
--enable-backward-compatibility.  Instead use 'set linetype' to redefine
-a convenient range of linetypes for the program to use.  See 'set
-linetype'.
-
-
-File: gnuplot.info,  Node: set_style_line,  Next: set_style_circle,  Prev: set_style_increment,  Up: style
-
-3.33.86.8 set style line
-........................
-
-Each terminal has a default set of line and point types, which can be
-seen by using the command 'test'.  'set style line' defines a set of
-line types and widths and point types and sizes so that you can refer to
-them later by an index instead of repeating all the information at each
-invocation.
-
-   Syntax:
-           set style line <index> default
-           set style line <index> {{linetype  | lt} <line_type> | <colorspec>}
-                                  {{linecolor | lc} <colorspec>}
-                                  {{linewidth | lw} <line_width>}
-                                  {{pointtype | pt} <point_type>}
-                                  {{pointsize | ps} <point_size>}
-                                  {{pointinterval | pi} <interval>}
-                                  {{pointnumber | pn} <max_symbols>}
-                                  {{dashtype | dt} <dashtype>}
-                                  {palette}
-           unset style line
-           show style line
-
-
-   'default' sets all line style parameters to those of the linetype
-with that same index.
-
-   If the linestyle <index> already exists, only the given parameters
-are changed while all others are preserved.  If not, all undefined
-values are set to the default values.
-
-   Line styles created by this mechanism do not replace the default
-linetype styles; both may be used.  Line styles are temporary.  They are
-lost whenever you execute a *note reset:: command.  To redefine the
-linetype itself, please see 'set linetype'.
-
-   The line and point types default to the index value.  The exact
-symbol that is drawn for that index value may vary from one terminal
-type to another.
-
-   The line width and point size are multipliers for the current
-terminal's default width and size (but note that <point_size> here is
-unaffected by the multiplier given by the command*note pointsize::).
-
-   The 'pointinterval' controls the spacing between points in a plot
-drawn with style *note linespoints::.  The default is 0 (every point is
-drawn).  For example, 'set style line N pi 3' defines a linestyle that
-uses pointtype N, pointsize and linewidth equal to the current defaults
-for the terminal, and will draw every 3rd point in plots using *note
-linespoints::.  A negative value for the interval is treated the same as
-a positive value, except that some terminals will try to interrupt the
-line where it passes through the point symbol.
-
-   The 'pointnumber' property is similar to 'pointinterval' except that
-rather than plotting every Nth point it limits the total number of
-points to N.
-
-   Not all terminals support the 'linewidth' and *note pointsize::
-features; if not supported, the option will be ignored.
-
-   Terminal-independent colors may be assigned using either 'linecolor
-<colorspec>' or 'linetype <colorspec>', abbreviated 'lc' or 'lt'.  This
-requires giving a RGB color triple, a known palette color name, a
-fractional index into the current palette, or a constant value from the
-current mapping of the palette onto cbrange.  See 'colors', *note
-colorspec::, *note palette::, *note colornames::, *note cbrange::.
-
-   'set style line <n> linetype <lt>' will set both a terminal-dependent
-dot/dash pattern and color.  The commands'set style line <n> linecolor
-<colorspec>' or 'set style line <n> linetype <colorspec>' will set a new
-line color while leaving the existing dot-dash pattern unchanged.
-
-   In 3d mode ('splot' command), the special keyword *note palette:: is
-allowed as a shorthand for "linetype palette z".  The color value
-corresponds to the z-value (elevation) of the splot, and varies smoothly
-along a line or surface.
-
-   Examples: Suppose that the default lines for indices 1, 2, and 3 are
-red, green, and blue, respectively, and the default point shapes for the
-same indices are a square, a cross, and a triangle, respectively.  Then
-
-           set style line 1 lt 2 lw 2 pt 3 ps 0.5
-
-
-   defines a new linestyle that is green and twice the default width and
-a new pointstyle that is a half-sized triangle.  The commands
-
-           set style function lines
-           plot f(x) lt 3, g(x) ls 1
-
-
-   will create a plot of f(x) using the default blue line and a plot of
-g(x) using the user-defined wide green line.  Similarly the commands
-
-           set style function linespoints
-           plot p(x) lt 1 pt 3, q(x) ls 1
-
-
-   will create a plot of p(x) using the default triangles connected by a
-red line and q(x) using small triangles connected by a green line.
-
-           splot sin(sqrt(x*x+y*y))/sqrt(x*x+y*y) w l pal
-
-
-   creates a surface plot using smooth colors according to *note
-palette::.  Note, that this works only on some terminals.  See also
-*note palette::, 'set pm3d'.
-
-           set style line 10 linetype 1 linecolor rgb "cyan"
-
-
-   will assign linestyle 10 to be a solid cyan line on any terminal that
-supports rgb colors.
-
-
-File: gnuplot.info,  Node: set_style_circle,  Next: set_style_rectangle,  Prev: set_style_line,  Up: style
-
-3.33.86.9 set style circle
-..........................
-
-Syntax:
-           set style circle {radius {graph|screen} <R>}
-                            {{no}wedge}
-                            {clip|noclip}
-
-
-   This command sets the default radius used in plot style "with
-circles".  It applies to data plots with only 2 columns of data (x,y)
-and to function plots.  The default is "set style circle radius graph
-0.02".  'Nowedge' disables drawing of the two radii that connect the
-ends of an arc to the center.  The default is 'wedge'.  This parameter
-has no effect on full circles.  'Clip' clips the circle at the plot
-boundaries, 'noclip' disables this.  Default is 'clip'.
-
-
-File: gnuplot.info,  Node: set_style_rectangle,  Next: set_style_ellipse,  Prev: set_style_circle,  Up: style
-
-3.33.86.10 set style rectangle
-..............................
-
-Rectangles defined with the *note object:: command can have individual
-styles.  However, if the object is not assigned a private style then it
-inherits a default that is taken from the *note rectangle:: command.
-
-   Syntax:
-         set style rectangle {front|back} {lw|linewidth <lw>}
-                             {fillcolor <colorspec>} {fs <fillstyle>}
-
-
-   See *note colorspec:: and 'fillstyle'.  *note fillcolor:: may be
-abbreviated as 'fc'.
-
-   Examples:
-         set style rectangle back fc rgb "white" fs solid 1.0 border lt -1
-         set style rectangle fc linestyle 3 fs pattern 2 noborder
-
-
-   The default values correspond to solid fill with the background color
-and a black border.
-
-
-File: gnuplot.info,  Node: set_style_ellipse,  Next: set_style_parallelaxis,  Prev: set_style_rectangle,  Up: style
-
-3.33.86.11 set style ellipse
-............................
-
-Syntax:
-           set style ellipse {units xx|xy|yy}
-                             {size {graph|screen} <a>, {{graph|screen} <b>}}
-                             {angle <angle>}
-                             {clip|noclip}
-
-
-   This command governs whether the diameters of ellipses are
-interpreted in the same units or not.  Default is 'xy', which means that
-the major diameter (first axis) of ellipses will be interpreted in the
-same units as the x (or x2) axis, while the minor (second) diameter in
-those of the y (or y2) axis.  In this mode the ratio of the ellipse axes
-depends on the scales of the plot axes and aspect ratio of the plot.
-When set to 'xx' or 'yy', both axes of all ellipses will be interpreted
-in the same units.  This means that the ratio of the axes of the plotted
-ellipses will be correct even after rotation, but either their vertical
-or horizontal extent will not be correct.
-
-   This is a global setting that affects all ellipses, both those
-defined as objects and those generated with the 'plot' command, however,
-the value of 'units' can also be redefined on a per-plot and per-object
-basis.
-
-   It is also possible to set a default size for ellipses with the *note
-size:: keyword.  This default size applies to data plots with only 2
-columns of data (x,y) and to function plots.  The two values are
-interpreted as the major and minor diameters (as opposed to semi-major
-and semi-minor axes) of the ellipse.
-
-   The default is "set style ellipse size graph 0.05,0.03".
-
-   Last, but not least it is possible to set the default orientation
-with the 'angle' keyword.  The orientation, which is defined as the
-angle between the major axis of the ellipse and the plot's x axis, must
-be given in degrees.
-
-   'Clip' clips the ellipse at the plot boundaries, 'noclip' disables
-this.  Default is 'clip'.
-
-   For defining ellipse objects, see 'set object ellipse'; for the 2D
-plot style, see *note ellipses::.
-
-
-File: gnuplot.info,  Node: set_style_parallelaxis,  Next: set_style_spiderplot,  Prev: set_style_ellipse,  Up: style
-
-3.33.86.12 set style parallelaxis
-.................................
-
-Syntax:
-           set style parallelaxis {front|back} {line-properties}
-
-
-   Determines the line type and layer for drawing the vertical axes in
-plots *note parallelaxes::.  See *note parallelaxes::, *note paxis::.
-
-
-File: gnuplot.info,  Node: set_style_spiderplot,  Next: set_style_textbox,  Prev: set_style_parallelaxis,  Up: style
-
-3.33.86.13 set style spiderplot
-...............................
-
-Syntax:
-             set style spiderplot
-                       {fillstyle <fillstyle-properties>}
-                       {<line-properties> | <point-properties>}
-
-   This commands controls the default appearance of spider plots.  The
-fill, line, and point properties can be modified in the first component
-of the plot command.  The overall appearance of the plot is also
-affected by other settings such as *note spiderplot::.  See also *note
-paxis::, *note spiderplot::.  Example:
-          # Default spider plot will be a polygon with a thick border but no fill
-          set style spiderplot fillstyle empty border lw 3
-          # This one will additionally place an open circle (pt 6) at each axis
-          plot for [i=1:6] DATA pointtype 6 pointsize 3
-
-
-
-File: gnuplot.info,  Node: set_style_textbox,  Next: set_style_watchpoint,  Prev: set_style_spiderplot,  Up: style
-
-3.33.86.14 set style textbox
-............................
-
-Syntax:
-             set style textbox {<boxstyle-index>}
-                       {opaque|transparent} {fillcolor <color>}
-                       {{no}border {linecolor <colorspec>}}{linewidth <lw>}
-                       {margins <xmargin>,<ymargin>}
-
-
-   This command controls the appearance of labels with the attribute
-'boxed'.  Terminal types that do not support boxed text will ignore this
-style.  Note: Implementation for some terminals (svg, latex) is
-incomplete.  Most terminals cannot place a box correctly around rotated
-text.
-
-   Three numbered textbox styles can be defined.  If no boxstyle index
-<bs> is given, the default (unnumbered) style is changed.  Example:
-
-          # default style has only a black border
-          set style textbox transparent border lc "black"
-          # style 2 (bs 2) has a light blue background with no border
-          set style textbox 2 opaque fc "light-cyan" noborder
-          set label 1 "I'm in a box" boxed
-          set label 2 "I'm blue" boxed bs 2
-
-
-
-File: gnuplot.info,  Node: set_style_watchpoint,  Prev: set_style_textbox,  Up: style
-
-3.33.86.15 set style watchpoint
-...............................
-
-Syntax:
-          set style watchpoint nolabels
-          set style watchpoint labels {label-options}
-
-
-   The watchpoint target "mouse" always prints a label to the plot.
-Other watchpoint targets either print or do not print a label depending
-on whether the style is set to 'label' or 'nolabel'.
-
-   The appearance of watchpoint labels can be customized using the full
-range of label properties available to other gnuplot labels, including
-font, textcolor, point type and size of a point marking the exact x,y
-coordinates.  See 'set label'.
-
-   Currently the text of the label is always autogenerated by the
-program using the axis tic formats for the current plot to produce the
-string " x-coordinate : y-coordinate".
-
-   Examples:
-          set style watchpoint labels point pt 4 ps 2
-          set style watchpoint labels font ":Italic,6" textcolor "blue"
-          set style watchpoint labels boxed offset 1, 0.5
-
-
-
-File: gnuplot.info,  Node: surface_,  Next: table,  Prev: style,  Up: set-show
-
-3.33.87 surface
----------------
-
-The 'set surface' command is only relevant for 3D plots ('splot').
-
-   Syntax:
-           set surface {implicit|explicit}
-           unset surface
-           show surface
-
-
-   'unset surface' will cause 'splot' to not draw points or lines
-corresponding to any of the function or data file points.  This is
-mainly useful for drawing only contour lines rather than the surface
-they were derived from.  Contours may still be drawn on the surface,
-depending on the 'set contour' option.  To turn off the surface for an
-individual function or data file while leaving others active, use the
-'nosurface' keyword in the 'splot' command.  The combination 'unset
-surface; set contour base' is useful for displaying contours on the grid
-base.  See also 'set contour'.
-
-   If a 3D data set is recognizable as a mesh (grid) then by default the
-program implicitly treats the plot style 'with lines' as requesting a
-gridded surface.  See 'grid_data'.  The command 'set surface explicit'
-suppresses this expansion, plotting only the individual lines described
-by separate blocks of data in the input file.  A gridded surface can
-still be plotted by explicitly requesting splot 'with surface'.
-
-
-File: gnuplot.info,  Node: table,  Next: terminal,  Prev: surface_,  Up: set-show
-
-3.33.88 table
--------------
-
-When *note table:: mode is enabled, 'plot' and 'splot' commands print
-out a multicolumn text table of values
-          X Y {Z} <flag>
-
-   rather than creating an actual plot on the current terminal.  The
-flag character is "i" if the point is in the active range, "o" if it is
-out-of-range, or "u" if it is undefined.  The data format is determined
-by the format of the axis tickmarks (see 'set format'), and the columns
-are separated by single spaces.  This can be useful if you want to
-generate contours and then save them for further use.  The same method
-can be used to save interpolated data (see *note samples:: and *note
-dgrid3d::).
-
-   Syntax:
-           set table {"outfile" | $datablock} {append}
-                     {separator {whitespace|tab|comma|"<char>"}}
-           plot <whatever>
-           unset table
-
-
-   Subsequent tabular output is written to "outfile", if specified,
-otherwise it is written to stdout or other current value of *note
-output::.  If 'outfile' exists it will be replaced unless the 'append'
-keyword is given.  Alternatively, tabular output can be redirected to a
-named data block.  Data block names start with '$', see also 'inline
-data'.  You must explicitly *note table:: in order to go back to normal
-plotting on the current terminal.
-
-   The 'separator' character can be used to output csv (comma separated
-value) files.  This mode only affects plot style *note table::.  See
-*note table::.
-
-* Menu:
-
-* plot_with_table::
-
-
-File: gnuplot.info,  Node: plot_with_table,  Prev: table,  Up: table
-
-3.33.88.1 plot with table
-.........................
-
-This discussion applies only to the special plot style *note table::.
-
-   To avoid any style-dependent processing of the input data being
-tabulated (filters, smoothing, errorbar expansion, secondary range
-checking, etc), or to increase the number of columns that can be
-tabulated, use the keyword "table" instead of a normal plot style.  In
-this case the output does not contain an extra column containing a flag
-'i', 'o', 'u' indicating inrange/outrange/undefined.  The destination
-for output must first be specified with 'set table <where>'.  For
-example
-
-          set table $DATABLOCK1
-          plot <file> using 1:2:3:4:($5+$6):(func($7)):8:9:10 with table
-
-
-   Because there is no actual plot style in this case the columns do not
-correspond to specific axes.  Therefore xrange, yrange, etc are ignored.
-
-   If a 'using' term evaluates to a string, the string is tabulated.
-Numerical data is always written with format %g.  If you want some other
-format use sprintf or gprintf to create a formatted string.
-
-          plot <file> using ("File 1"):1:2:3 with table
-          plot <file> using (sprintf("%4.2f",$1)) : (sprintf("%4.2f",$3)) with table
-
-
-   To create a csv file use
-          set table "tab.csv" separator comma
-          plot <foo> using 1:2:3:4 with table
-
-
-   [EXPERIMENTAL] To select only a subset of the data points for
-tabulation you can provide an input filter condition ('if <expression>')
-at the end of the command.  Note that the input filter may reference
-data columns that are not part of the output.  Details of this feature
-may change in a future version.
-
-          plot <file> using 1:2:($4+$5) with table if (strcol(3) eq "Red")
-          plot <file> using 1:2:($4+$5) with table if (10. < $1 && $1 < 100.)
-          plot <file> using 1:2:($4+$5) with table if (filter($6,$7) != 0)
-
-
-
-File: gnuplot.info,  Node: terminal,  Next: termoption,  Prev: table,  Up: set-show
-
-3.33.89 terminal
-----------------
-
-'gnuplot' supports many different graphics devices.  Use *note
-terminal:: to tell 'gnuplot' what kind of output to generate.  Use *note
-output:: to redirect that output to a file or device.
-
-   Syntax:
-           set terminal {<terminal-type> | push | pop}
-           show terminal
-
-
-   If <terminal-type> is omitted, 'gnuplot' will list the available
-terminal types.  <terminal-type> may be abbreviated.
-
-   If both *note terminal:: and *note output:: are used together, it is
-safest to give *note terminal:: first, because some terminals set a flag
-which is needed in some operating systems.
-
-   Some terminals have many additional options.  The options used by a
-previous invocation 'set term <term> <options>' of a given '<term>' are
-remembered, thus subsequent 'set term <term>' does not reset them.  This
-helps in printing, for instance, when switching among different
-terminals--previous options don't have to be repeated.
-
-   The command 'set term push' remembers the current terminal including
-its settings while 'set term pop' restores it.  This is equivalent to
-'save term' and 'load term', but without accessing the filesystem.
-Therefore they can be used to achieve platform independent restoring of
-the terminal after printing, for instance.  After gnuplot's startup, the
-default terminal or that from 'startup' file is pushed automatically.
-Therefore portable scripts can rely that 'set term pop' restores the
-default terminal on a given platform unless another terminal has been
-pushed explicitly.
-
-   For more information, see the 'complete list of terminals'.
-
-
-File: gnuplot.info,  Node: termoption,  Next: theta,  Prev: terminal,  Up: set-show
-
-3.33.90 termoption
-------------------
-
-The *note termoption:: command allows you to change the behaviour of the
-current terminal without requiring a new *note terminal:: command.  Only
-one option can be changed per command, and only a small number of
-options can be changed this way.  Currently the only options accepted
-are
-
-          set termoption {no}enhanced
-          set termoption font "<fontname>{,<fontsize>}"
-          set termoption fontscale <scale>
-          set termoption {linewidth <lw>}{lw <lw>} {dashlength <dl>}{dl <dl>}
-          set termoption {pointscale <scale>} {ps <scale>}
-
-
-
-File: gnuplot.info,  Node: theta,  Next: tics,  Prev: termoption,  Up: set-show
-
-3.33.91 theta
--------------
-
-Polar coordinate plots are by default oriented such that theta = 0 is on
-the right side of the plot, with theta increasing as you proceed
-counterclockwise so that theta = 90 degrees is at the top.  *note
-theta:: allows you to change the origin and direction of the polar
-angular coordinate theta.
-          set theta {right|top|left|bottom}
-          set theta {clockwise|cw|counterclockwise|ccw}
-
-   *note theta:: restores the default state "set theta right ccw".
-
-
-File: gnuplot.info,  Node: tics,  Next: ticslevel,  Prev: theta,  Up: set-show
-
-3.33.92 tics
-------------
-
-The 'set tics' command controls the tic marks and labels on all axes at
-once.
-
-   The tics may be turned off with the 'unset tics' command, and may be
-turned on (the default state) with 'set tics'.  Fine control of tics on
-individual axes is possible using the alternative commands 'set xtics',
-*note ztics::, etc.
-
-   Syntax:
-           set tics {axis | border} {{no}mirror}
-                    {in | out} {front | back}
-                    {{no}rotate {by <ang>}} {offset <offset> | nooffset}
-                    {left | right | center | autojustify}
-                    {format "formatstring"} {font "name{,<size>}"} {{no}enhanced}
-                    { textcolor <colorspec> }
-           set tics scale {default | <major> {,<minor>}}
-           unset tics
-           show tics
-
-
-   The options can be applied to a single axis (x, y, z, x2, y2, cb),
-e.g.
-           set xtics rotate by -90
-           unset cbtics
-
-
-   All tic marks are drawn using the same line properties as the plot
-border (see *note border::).
-
-   Set tics 'back' or 'front' applies to all axes at once, but only for
-2D plots (not splot).  It controls whether the tics are placed behind or
-in front of the plot elements, in the case that there is overlap.
-
-   'axis' or *note border:: tells 'gnuplot' to put the tics (both the
-tics themselves and the accompanying labels) along the axis or the
-border, respectively.  If the axis is very close to the border, the
-'axis' option will move the tic labels to outside the border in case the
-border is printed (see *note border::).  The relevant margin settings
-will usually be sized badly by the automatic layout algorithm in this
-case.
-
-   'mirror' tells 'gnuplot' to put unlabeled tics at the same positions
-on the opposite border.  'nomirror' does what you think it does.
-
-   'in' and 'out' change the tic marks to be drawn inwards or outwards.
-
-   'set tics scale' controls the size of the tic marks.  The first value
-<major> controls the auto-generated or user-specified major tics (level
-0).  The second value controls the auto-generated or user-specified
-minor tics (level 1).  <major> defaults to 1.0, <minor> defaults to
-<major>/2.  Additional values control the size of user-specified tics
-with level 2, 3, ...  Default tic sizes are restored by 'set tics scale
-default'.
-
-   'rotate' asks 'gnuplot' to rotate the text through 90 degrees, which
-will be done if the terminal driver in use supports text rotation.
-'norotate' cancels this.  'rotate by <ang>' asks for rotation by <ang>
-degrees, supported by some terminal types.
-
-   The defaults are 'border mirror norotate' for tics on the x and y
-axes, and 'border nomirror norotate' for tics on the x2 and y2 axes.
-For the z axis, the default is 'nomirror'.
-
-   The <offset> is specified by either x,y or x,y,z, and may be preceded
-by 'first', 'second', 'graph', 'screen', or 'character' to select the
-coordinate system.  <offset> is the offset of the tics texts from their
-default positions, while the default coordinate system is 'character'.
-See 'coordinates' for details.  'nooffset' switches off the offset.
-
-   By default, tic labels are justified automatically depending on the
-axis and rotation angle to produce aesthetically pleasing results.  If
-this is not desired, justification can be overridden with an explicit
-'left', 'right' or 'center' keyword.  'autojustify' restores the default
-behavior.
-
-   'set tics' with no options restores mirrored, inward-facing tic marks
-for the primary axes.  All other settings are retained.
-
-   See also 'set xtics' for more control of major (labeled) tic marks
-and 'set mxtics' for control of minor tic marks.  These commands provide
-control of each axis independently.
-
-
-File: gnuplot.info,  Node: ticslevel,  Next: ticscale,  Prev: tics,  Up: set-show
-
-3.33.93 ticslevel
------------------
-
-Deprecated.  See *note xyplane::.
-
-
-File: gnuplot.info,  Node: ticscale,  Next: timestamp,  Prev: ticslevel,  Up: set-show
-
-3.33.94 ticscale
-----------------
-
-The *note ticscale:: command is deprecated, use 'set tics scale'
-instead.
-
-
-File: gnuplot.info,  Node: timestamp,  Next: timefmt,  Prev: ticscale,  Up: set-show
-
-3.33.95 timestamp
------------------
-
-The command *note timestamp:: places the current time and date in the
-plot margin.
-
-   Syntax:
-           set timestamp {"<format>"} {top|bottom} {{no}rotate}
-                         {offset <xoff>{,<yoff>}} {font "<fontspec>"}
-                         {textcolor <colorspec>}
-           unset timestamp
-           show timestamp
-
-
-   The format string is used to write the date and time.  Its default
-value is what asctime() uses: "%a %b %d %H:%M:%S %Y" (weekday, month
-name, day of the month, hours, minutes, seconds, four-digit year).  With
-'top' or 'bottom' you can place the timestamp along the top left or
-bottom left margin (default: bottom).  'rotate' writes the timestamp
-vertically.  The constants <xoff> and <yoff> are offsets that let you
-adjust the position more finely.  <font> is used to specify the font
-with which the time is to be written.
-
-   Example:
-           set timestamp "%d/%m/%y %H:%M" offset 80,-2 font "Helvetica"
-
-
-   See *note timefmt:: for more information about time format strings.
-
-
-File: gnuplot.info,  Node: timefmt,  Next: title_,  Prev: timestamp,  Up: set-show
-
-3.33.96 timefmt
----------------
-
-This command sets the default format used to input time data.  See 'set
-xdata time', 'timecolumn'.
-
-   Syntax:
-           set timefmt "<format string>"
-           show timefmt
-
-
-   The valid formats for both *note timefmt:: and 'timecolumn' are:
-
-           Format       Explanation
-           %d           day of the month, 1--31
-           %m           month of the year, 1--12
-           %y           year, 0--99
-           %Y           year, 4-digit
-           %j           day of the year, 1--365
-           %H           hour, 0--24
-           %M           minute, 0--60
-           %s           seconds since the Unix epoch (1970-01-01, 00:00 UTC)
-           %S           second, integer 0--60 on output, (double) on input
-           %b           three-character abbreviation of the name of the month
-           %B           name of the month
-           %p           two character match to one of:  am AM pm PM
-
-
-   Any character is allowed in the string, but must match exactly.  \t
-(tab) is recognized.  Backslash-octals (\nnn) are converted to char.  If
-there is no separating character between the time/date elements, then
-%d, %m, %y, %H, %M and %S read two digits each.  If a decimal point
-immediately follows the field read by %S, the decimal and any following
-digits are interpreted as a fractional second.  %Y reads four digits.
-%j reads three digits.  %b requires three characters, and %B requires as
-many as it needs.
-
-   Spaces are treated slightly differently.  A space in the string
-stands for zero or more whitespace characters in the file.  That is, "%H
-%M" can be used to read "1220" and "12 20" as well as "12 20".
-
-   Each set of non-blank characters in the timedata counts as one column
-in the 'using n:n' specification.  Thus '11:11 25/12/76 21.0' consists
-of three columns.  To avoid confusion, 'gnuplot' requires that you
-provide a complete 'using' specification if your file contains timedata.
-
-   If the date format includes the day or month in words, the format
-string must exclude this text.  But it can still be printed with the
-"%a", "%A", "%b", or "%B" specifier.  'gnuplot' will determine the
-proper month and weekday from the numerical values.  See 'set format'
-for more details about these and other options for printing time data.
-
-   When reading two-digit years with %y, values 69-99 refer to the 20th
-century, while values 00-68 refer to the 21st century.  NB: This is in
-accordance with the UNIX98 spec, but conventions vary widely and
-two-digit year values are inherently ambiguous.
-
-   If the %p format returns "am" or "AM", hour 12 will be interpreted as
-hour 0.  If the %p format returns "pm" or "PM", hours < 12 will be
-increased by 12.
-
-   See also *note xdata:: 'time/date' and 'time_specifiers' for more
-information.
-
-   Example:
-           set timefmt "%d/%m/%Y\t%H:%M"
-
-   tells 'gnuplot' to read date and time separated by tab.  (But look
-closely at your data--what began as a tab may have been converted to
-spaces somewhere along the line; the format string must match what is
-actually in the file.)  See also time data demo.
-(http://www.gnuplot.info/demo/timedat.html)
-
-
-File: gnuplot.info,  Node: title_,  Next: tmargin,  Prev: timefmt,  Up: set-show
-
-3.33.97 title
--------------
-
-The *note title:: command produces a plot title that is centered at the
-top of the plot.  *note title:: is a special case of 'set label'.
-
-   Syntax:
-           set title {"<title-text>"} {offset <offset>} {font "<font>{,<size>}"}
-                     {{textcolor | tc} {<colorspec> | default}} {{no}enhanced}
-           show title
-
-
-   If <offset> is specified by either x,y or x,y,z the title is moved by
-the given offset.  It may be preceded by 'first', 'second', 'graph',
-'screen', or 'character' to select the coordinate system.  See
-'coordinates' for details.  By default, the 'character' coordinate
-system is used.  For example, "'set title offset 0,-1'" will change only
-the y offset of the title, moving the title down by roughly the height
-of one character.  The size of a character depends on both the font and
-the terminal.
-
-   <font> is used to specify the font with which the title is to be
-written; the units of the font <size> depend upon which terminal is
-used.
-
-   'textcolor <colorspec>' changes the color of the text.  <colorspec>
-can be a linetype, an rgb color, or a palette mapping.  See help for
-*note colorspec:: and *note palette::.
-
-   'noenhanced' requests that the title not be processed by the enhanced
-text mode parser, even if enhanced text mode is currently active.
-
-   *note title:: with no parameters clears the title.
-
-   See 'syntax' for details about the processing of backslash sequences
-and the distinction between single- and double-quotes.
-
-
-File: gnuplot.info,  Node: tmargin,  Next: trange,  Prev: title_,  Up: set-show
-
-3.33.98 tmargin
----------------
-
-The command *note tmargin:: sets the size of the top margin.  Please see
-*note margin:: for details.
-
-
-File: gnuplot.info,  Node: trange,  Next: ttics,  Prev: tmargin,  Up: set-show
-
-3.33.99 trange
---------------
-
-Syntax: set trange [tmin:tmax] The range of the parametric variable t is
-useful in three contexts.
-   * In parametric mode 'plot' commands it limits the range of sampling
-     for both generating functions.  See *note parametric::, *note
-     samples::.
-   * In polar mode 'plot' commands it limits or defines the acceptable
-     range of the angular parameter theta during input.  Data points
-     with theta value outside this range are excluded from the plot even
-     if they would otherwise lie inside the plot boundary.  See 'polar'.
-   * In 'plot' or 'splot' commands using 1-dimensional sampled data via
-     the pseudofile "+".  See 'sampling 1D', *note special-filenames::.
-
-
-File: gnuplot.info,  Node: ttics,  Next: urange,  Prev: trange,  Up: set-show
-
-3.33.100 ttics
---------------
-
-The *note ttics:: command places tics around the perimeter of a polar
-plot.  This is the border if 'set border polar' is enabled, otherwise
-the outermost circle of the polar grid drawn at the rightmost ticmark
-along the r axis.  See 'set grid', *note rtics::.  The angular position
-is always labeled in degrees.  The full perimeter can be labeled
-regardless of the current trange setting.  The desired range of the tic
-labels should be given as shown below.  Additional properties of the tic
-marks can be set.  See 'xtics'.
-
-          set ttics -180, 30, 180
-          set ttics add ("Theta = 0" 0)
-          set ttics font ":Italic" rotate
-
-   D ttics 3
-
-
-File: gnuplot.info,  Node: urange,  Next: version,  Prev: ttics,  Up: set-show
-
-3.33.101 urange
----------------
-
-Syntax: set urange [umin:umax] The range of the parametric variables u
-and v is useful in two contexts.  1) 'splot' in parametric mode.  See
-*note parametric::, *note isosamples::.  2) generating 2-dimension
-sampled data for either 'plot' or 'splot' using the pseudofile "++".
-See 'sampling 2D'.
-
-
-File: gnuplot.info,  Node: version,  Next: vgrid,  Prev: urange,  Up: set-show
-
-3.33.102 version
-----------------
-
-The *note version:: command lists the version of gnuplot being run, its
-last modification date, the copyright holders, and email addresses for
-the FAQ, the gnuplot-info mailing list, and reporting bugs-in short, the
-information listed on the screen when the program is invoked
-interactively.
-
-   Syntax:
-           show version {long}
-
-
-   Show version 'long' also lists the operating system, configuration
-and compilation options used when this copy of 'gnuplot' was built.
-
-
-File: gnuplot.info,  Node: vgrid,  Next: view,  Prev: version,  Up: set-show
-
-3.33.103 vgrid
---------------
-
-Syntax:
-          set vgrid $gridname {size N}
-          unset vgrid $gridname
-          show vgrid
-
-
-   If the named grid already exists, mark it as active (use it for
-subsequent *note vfill:: and 'voxel' operations).  If a new size is
-given, replace the existing content with a zero-filled N x N x N grid.
-If a grid with this name does not already exist, allocate an N x N x N
-grid (default N=100), zero the contents, and mark it as active.  Note
-that grid names must begin with '$'.
-
-   *note vgrid:: lists all currently defined voxel grids.  Example
-output:
-           $vgrid1: (active)
-                    size 100 X 100 X 100
-                    vxrange [-4:4]  vyrange[-4:4]  vzrange[-4:4]
-                    non-zero voxel values:  min 0.061237 max 94.5604
-                    number of zero voxels:  992070   (99.21%)
-
-
-   'unset vgrid $gridname' releases all data structures associated with
-that voxel grid.  The data structures are also released by 'reset
-session'.  The function 'voxel(x,y,z)' returns the value of the active
-grid point nearest that coordinate.  See also 'splot voxel-grids'.
-
-
-File: gnuplot.info,  Node: view,  Next: vrange,  Prev: vgrid,  Up: set-show
-
-3.33.104 view
--------------
-
-The *note view:: command sets the viewing angle for 'splot's.  It
-controls how the 3D coordinates of the plot are mapped into the 2D
-screen space.  It provides controls for both rotation and scaling of the
-plotted data, but supports orthographic projections only.  It supports
-both 3D projection or orthogonal 2D projection into a 2D plot-like map.
-
-   Syntax:
-           set view <rot_x>{,{<rot_z>}{,{<scale>}{,<scale_z>}}}
-           set view map {scale <scale>}
-           set view projection {xy|xz|yz}
-           set view {no}equal {xy|xyz}
-           set view azimuth <angle>
-           show view
-
-
-   where <rot_x> and <rot_z> control the rotation angles (in degrees) in
-a virtual 3D coordinate system aligned with the screen such that
-initially (that is, before the rotations are performed) the screen
-horizontal axis is x, screen vertical axis is y, and the axis
-perpendicular to the screen is z.  The first rotation applied is <rot_x>
-around the x axis.  The second rotation applied is <rot_z> around the
-new z axis.
-
-   Command 'set view map' is used to represent the drawing as a map.  It
-is useful for 'contour' plots or 2D heatmaps using pm3d mode rather than
-'with image'.  In the latter case, take care that you properly use *note
-zrange:: and *note cbrange:: for input data point filtering and color
-range scaling, respectively.
-
-   <rot_x> is bounded to the [0:180] range with a default of 60 degrees,
-while <rot_z> is bounded to the [0:360] range with a default of 30
-degrees.  <scale> controls the scaling of the entire 'splot', while
-<scale_z> scales the z axis only.  Both scales default to 1.0.
-
-   Examples:
-           set view 60, 30, 1, 1
-           set view ,,0.5
-
-
-   The first sets all the four default values.  The second changes only
-scale, to 0.5.
-
-* Menu:
-
-* azimuth::
-* equal_axes::
-* projection::
-
-
-File: gnuplot.info,  Node: azimuth,  Next: equal_axes,  Prev: view,  Up: view
-
-3.33.104.1 azimuth
-..................
-
-           set view azimuth <angle-in-degrees>
-
-   The setting of azimuth affects the orientation of the z axis in a 3D
-graph (splot).  At the default azimuth = 0 the z axis of the plot lies
-in the plane orthogonal to the screen horizontal.  I.e.  the projection
-of the z axis lies along the screen vertical.  Non-zero azimuth rotates
-the plot about the line of sight through the origin so that a projection
-of the z axis is no longer vertical.  When azimuth = 90 the z axis is
-horizontal rather than vertical.  During interactive viewing, hot-key
-'z' resets azimuth to 0.
-
-
-File: gnuplot.info,  Node: equal_axes,  Next: projection,  Prev: azimuth,  Up: view
-
-3.33.104.2 equal_axes
-.....................
-
-The command 'set view equal xy' forces the unit length of the x and y
-axes to be on the same scale, and chooses that scale so that the plot
-will fit on the page.  The command 'set view equal xyz' additionally
-sets the z axis scale to match the x and y axes; however there is no
-guarantee that the z axis range will fit within the plot boundary.  See
-also *note isotropic::.  By default all three axes are scaled
-independently to fill the available area.
-
-   See also *note xyplane::.
-
-
-File: gnuplot.info,  Node: projection,  Prev: equal_axes,  Up: view
-
-3.33.104.3 projection
-.....................
-
-Syntax:
-          set view projection {xy|xz|yz}
-
-   Rotates the view angles of a 3D plot so that one of the primary
-planes xy, xz, or yz lies in the plane of the plot.  Axis label and tic
-positioning is adjusted accordingly; tics and labels on the third axis
-are disabled.  The plot is scaled up to approximately match the size
-that 'plot' would generate for the same axis ranges.  'set view
-projection xy' is equivalent to 'set view map'.
-
-   When the x and y coordinates used to specify objects, labels, arrows
-and other elements are both provided as "graph" coordinates, then in
-projection views they are interpreted as "horizontal/vertical" rather
-than "x/y".
-
-         set key top right at graph 0.95, graph 0.95     # works in any projection
-
-
-
-File: gnuplot.info,  Node: vrange,  Next: vxrange,  Prev: view,  Up: set-show
-
-3.33.105 vrange
----------------
-
-Syntax: set vrange [vmin:vmax] The range of the parametric variables u
-and v is useful in two contexts.  1) 'splot' in parametric mode.  See
-*note parametric::, *note isosamples::.  2) generating 2-dimension
-sampled data for either 'plot' or 'splot' using the pseudofile "++".
-See 'sampling 2D'.
-
-
-File: gnuplot.info,  Node: vxrange,  Next: vyrange,  Prev: vrange,  Up: set-show
-
-3.33.106 vxrange
-----------------
-
-Syntax: set vxrange [vxmin:vxmax]
-
-   Establishes the range of x coordinates spanned by the active voxel
-grid.  Analogous commands *note vyrange:: and *note vzrange:: exist for
-the other two dimensions of the voxel grid.  If no explicit ranges have
-been set prior to the first *note vclear::, *note vfill::, or
-'voxel(x,y,z) = ' command, vmin and vmax will be copied from the current
-values of *note xrange::.
-
-
-File: gnuplot.info,  Node: vyrange,  Next: vzrange,  Prev: vxrange,  Up: set-show
-
-3.33.107 vyrange
-----------------
-
-See *note vxrange::
-
-
-File: gnuplot.info,  Node: vzrange,  Next: walls,  Prev: vyrange,  Up: set-show
-
-3.33.108 vzrange
-----------------
-
-See *note vxrange::
-
-
-File: gnuplot.info,  Node: walls,  Next: watchpoints,  Prev: vzrange,  Up: set-show
-
-3.33.109 walls
---------------
-
-Syntax:
-          set walls
-          set wall {x0|y0|z0|x1|y1} {<fillstyle>} {fc <fillcolor>}
-
-
-   3D surfaces drawn by 'splot' lie within a normalized unit cube
-regardless of the x y and z axis ranges.  The bounding walls of this
-cube are described by the planes (graph coord x == 0), (graph coord x ==
-1), etc.  The *note walls:: command renders the walls x0 y0 and z0 as
-solid surfaces.  By default these surfaces are semi-transparent
-(fillstyle transparent solid 0.5).  You can customize which walls are
-drawn and also their individual color and fill style.  If you choose to
-enable walls, you may also want to use 'set xyplane 0'.
-
-   Example:
-          set wall x0; set wall y1; set wall z0 fillstyle solid 1.0 fillcolor "gray"
-          splot f(x,y) with pm3d fc "goldenrod"
-
-
-
-File: gnuplot.info,  Node: watchpoints,  Next: x2data,  Prev: walls,  Up: set-show
-
-3.33.110 watchpoints
---------------------
-
-One or more watchpoints may be set for each component plot in a plot
-command.  All watchpoint targets and hits from the previous plot command
-are summarized by the command *note watchpoints::.
-
-   Example:
-          plot DATA using 1:2 smooth cnormal watch y=0.25 watch y=0.5 watch y=0.75
-          show watchpoints
-
-
-              Plot title:     "DATA using 1:2 smooth cnormal"
-                Watch 1 target y = 0.25         (1 hits)
-                        hit 1   x 50.6  y 0.25
-                Watch 2 target y = 0.5          (1 hits)
-                        hit 1   x 63.6  y 0.5
-                Watch 3 target y = 0.75         (1 hits)
-                        hit 1   x 68.3  y 0.75
-
-
-   The coordinates of all points satisfying the first watchpoint
-(y=0.25) are stored in an array WATCH_1.  The points satisfying (y=0.5)
-are stored in an array WATCH_2, and so on.
-
-   Each hit is stored as a complex number with x as the real component
-and y as the imaginary component.  So the first hit of watchpoint 2 has
-x = real(WATCH_2[1]) y = imag(WATCH_2[1]).  In this example only the x
-coordinates of the hits are interesting, as the y coordinates will
-always match the corresponding target y value.  However if the
-watchpoint target is a z value or a function f(x,y), neither the x or
-the y coordinate of a hit is known in advance.
-
-
-File: gnuplot.info,  Node: x2data,  Next: x2dtics,  Prev: watchpoints,  Up: set-show
-
-3.33.111 x2data
----------------
-
-The *note x2data:: command sets data on the x2 (top) axis to timeseries
-(dates/times).  Please see *note xdata::.
-
-
-File: gnuplot.info,  Node: x2dtics,  Next: x2label,  Prev: x2data,  Up: set-show
-
-3.33.112 x2dtics
-----------------
-
-The *note x2dtics:: command changes tics on the x2 (top) axis to days of
-the week.  Please see *note xdtics:: for details.
-
-
-File: gnuplot.info,  Node: x2label,  Next: x2mtics,  Prev: x2dtics,  Up: set-show
-
-3.33.113 x2label
-----------------
-
-The *note x2label:: command sets the label for the x2 (top) axis.
-Please see *note xlabel::.
-
-
-File: gnuplot.info,  Node: x2mtics,  Next: x2range,  Prev: x2label,  Up: set-show
-
-3.33.114 x2mtics
-----------------
-
-The *note x2mtics:: command changes tics on the x2 (top) axis to months
-of the year.  Please see *note xmtics:: for details.
-
-
-File: gnuplot.info,  Node: x2range,  Next: x2tics,  Prev: x2mtics,  Up: set-show
-
-3.33.115 x2range
-----------------
-
-The *note x2range:: command sets the horizontal range that will be
-displayed on the x2 (top) axis.  See *note xrange:: for the full set of
-command options.  See also *note link::.
-
-
-File: gnuplot.info,  Node: x2tics,  Next: x2zeroaxis,  Prev: x2range,  Up: set-show
-
-3.33.116 x2tics
----------------
-
-The *note x2tics:: command controls major (labeled) tics on the x2 (top)
-axis.  Please see 'set xtics' for details.
-
-
-File: gnuplot.info,  Node: x2zeroaxis,  Next: xdata,  Prev: x2tics,  Up: set-show
-
-3.33.117 x2zeroaxis
--------------------
-
-The *note x2zeroaxis:: command draws a line at the origin of the x2
-(top) axis (y2 = 0).  For details, please see *note zeroaxis::.
-
-
-File: gnuplot.info,  Node: xdata,  Next: xdtics,  Prev: x2zeroaxis,  Up: set-show
-
-3.33.118 xdata
---------------
-
-This command controls interpretation of data on the x axis.  An
-analogous command acts on each of the other axes.
-
-   Syntax:
-           set xdata {time}
-           show xdata
-
-
-   The same syntax applies to *note ydata::, *note zdata::, *note
-x2data::, *note y2data:: and *note cbdata::.
-
-   The 'time' option signals that data represents a time/date in
-seconds.  Gnuplot version 6 stores time to millisecond precision.
-
-   *note xdata:: (with no 'time' keyword) restores data interpretation
-to normal.
-
-* Menu:
-
-* time_::
-
-
-File: gnuplot.info,  Node: time_,  Prev: xdata,  Up: xdata
-
-3.33.118.1 time
-...............
-
-'set xdata time' indicates that the x coordinate represents a date or
-time to millisecond precision.  There is an analogous command 'set ydata
-time'.
-
-   There are separate format mechanisms for interpretation of time data
-on input and output.  Input data is read from a file either by using the
-global *note timefmt:: or by using the function timecolumn() as part of
-the plot command.  These input mechanisms also apply to using time
-values to set an axis range.  See *note timefmt::, 'timecolumn'.
-
-   Example:
-
-          set xdata time
-          set timefmt "%d-%b-%Y"
-          set xrange ["01-Jan-2013" : "31-Dec-2014"]
-          plot DATA using 1:2
-
-   or
-          plot DATA using (timecolumn(1,"%d-%b-%Y")):2
-
-
-   For output, i.e.  tick labels along that axis or coordinates output
-by mousing, the function 'strftime' (type "man strftime" on unix to look
-it up) is used to convert from the internal time in seconds to a string
-representation of a date.  'gnuplot' tries to figure out a reasonable
-format for this.  You can customize the format using either 'set format
-x' or 'set xtics format'.  See 'time_specifiers' for a special set of
-time format specifiers.  See also 'time/date' for more information.
-
-
-File: gnuplot.info,  Node: xdtics,  Next: xlabel,  Prev: xdata,  Up: set-show
-
-3.33.119 xdtics
----------------
-
-The *note xdtics:: commands converts the x-axis tic marks to days of the
-week where 0=Sun and 6=Sat.  Overflows are converted modulo 7 to dates.
-'set noxdtics' returns the labels to their default values.  Similar
-commands do the same things for the other axes.
-
-   Syntax:
-           set xdtics
-           unset xdtics
-           show xdtics
-
-
-   The same syntax applies to *note ydtics::, *note zdtics::, *note
-x2dtics::, *note y2dtics:: and *note cbdtics::.
-
-   See also the 'set format' command.
-
-
-File: gnuplot.info,  Node: xlabel,  Next: xmtics,  Prev: xdtics,  Up: set-show
-
-3.33.120 xlabel
----------------
-
-The *note xlabel:: command sets the x axis label.  Similar commands set
-labels on the other axes.
-
-   Syntax:
-           set xlabel {"<label>"} {offset <offset>} {font "<font>{,<size>}"}
-                      {textcolor <colorspec>} {{no}enhanced}
-                      {rotate by <degrees> | rotate parallel | norotate}
-           show xlabel
-
-
-   The same syntax applies to *note x2label::, *note ylabel::, *note
-y2label::, *note zlabel:: and *note cblabel::.
-
-   If <offset> is specified by either x,y or x,y,z the label is moved by
-the given offset.  It may be preceded by 'first', 'second', 'graph',
-'screen', or 'character' to select the coordinate system.  See
-'coordinates' for details.  By default, the 'character' coordinate
-system is used.  For example, "'set xlabel offset -1,0'" will change
-only the x offset of the title, moving the label roughly one character
-width to the left.  The size of a character depends on both the font and
-the terminal.
-
-   <font> is used to specify the font in which the label is written; the
-units of the font <size> depend upon which terminal is used.
-
-   'noenhanced' requests that the label text not be processed by the
-enhanced text mode parser, even if enhanced text mode is currently
-active.
-
-   To clear a label, put no options on the command line, e.g., "*note
-y2label::".
-
-   The default positions of the axis labels are as follows:
-
-   xlabel: The x-axis label is centered below the bottom of the plot.
-
-   ylabel: The y-axis label is centered to the left of the plot,
-defaulting to either horizontal or vertical orientation depending on the
-terminal type.  The program may not reserve enough space to the left of
-the plot to hold long non-rotated ylabel text.  You can adjust this with
-*note lmargin::.
-
-   zlabel: The z-axis label is centered along the z axis and placed in
-the space above the grid level.
-
-   cblabel: The color box axis label is centered along the box and
-placed below or to the right according to horizontal or vertical color
-box gradient.
-
-   y2label: The y2-axis label is placed to the right of the y2 axis.
-The position is terminal-dependent in the same manner as is the y-axis
-label.
-
-   x2label: The x2-axis label is placed above the plot but below the
-title.  It is also possible to create an x2-axis label by using new-line
-characters to make a multi-line plot title, e.g.,
-
-           set title "This is the title\n\nThis is the x2label"
-
-
-   Note that double quotes must be used.  The same font will be used for
-both lines, of course.
-
-   The orientation (rotation angle) of the x, x2, y and y2 axis labels
-in 2D plots can be changed by specifying 'rotate by <degrees>'.  The
-orientation of the x and y axis labels in 3D plots defaults to
-horizontal but can be changed to run parallel to the axis by specifying
-'rotate parallel'.
-
-   If you are not satisfied with the default position of an axis label,
-use 'set label' instead-that command gives you much more control over
-where text is placed.
-
-   Please see 'syntax' for further information about backslash
-processing and the difference between single- and double-quoted strings.
-
-
-File: gnuplot.info,  Node: xmtics,  Next: xrange,  Prev: xlabel,  Up: set-show
-
-3.33.121 xmtics
----------------
-
-The *note xmtics:: command converts the x-axis tic marks to months of
-the year where 1=Jan and 12=Dec.  Overflows are converted modulo 12 to
-months.  The tics are returned to their default labels by *note
-xmtics::.  Similar commands perform the same duties for the other axes.
-
-   Syntax:
-           set xmtics
-           unset xmtics
-           show xmtics
-
-
-   The same syntax applies to *note x2mtics::, *note ymtics::, *note
-y2mtics::, *note zmtics:: and *note cbmtics::.
-
-   See also the 'set format' command.
-
-
-File: gnuplot.info,  Node: xrange,  Next: xtics,  Prev: xmtics,  Up: set-show
-
-3.33.122 xrange
----------------
-
-The *note xrange:: command sets the horizontal range that will be
-displayed.  A similar command exists for each of the other axes, as well
-as for the polar radius r and the parametric variables t, u, and v.
-
-   Syntax:
-           set xrange [{{<min>}:{<max>}}] {{no}reverse} {{no}writeback} {{no}extend}
-                      | restore
-           show xrange
-
-
-   where <min> and <max> terms are constants, expressions or an asterisk
-to set autoscaling.  If the data are time/date, you must give the range
-as a quoted string according to the *note timefmt:: format.  If <min> or
-<max> is omitted the current value will not be changed.  See below for
-full autoscaling syntax.  See also *note noextend::.
-
-   The same syntax applies to *note yrange::, *note zrange::, *note
-x2range::, *note y2range::, *note cbrange::, *note rrange::, *note
-trange::, *note urange:: and *note vrange::.
-
-   See *note link:: for options that link the ranges of x and x2, or y
-and y2.
-
-   The 'reverse' option reverses the direction of an autoscaled axis.
-For example, if the data values range from 10 to 100, it will autoscale
-to the equivalent of set xrange [100:10].  The 'reverse' flag has no
-effect if the axis is not autoscaled.
-
-   Autoscaling: If <min> (the same applies for correspondingly to <max>)
-is an asterisk "*" autoscaling is turned on.  The range in which
-autoscaling is being performed may be limited by a lower bound <lb> or
-an upper bound <ub> or both.  The syntax is
-           { <lb> < } * { < <ub> }
-
-   For example,
-           0 < * < 200
-
-   sets <lb> = 0 and <ub> = 200.  With such a setting <min> would be
-autoscaled, but its final value will be between 0 and 200 (both
-inclusive despite the '<' sign).  If no lower or upper bound is
-specified, the '<' to also be omitted.  If <ub> is lower than <lb> the
-constraints will be turned off and full autoscaling will happen.  This
-feature is useful to plot measured data with autoscaling but providing a
-limit on the range, to clip outliers, or to guarantee a minimum range
-that will be displayed even if the data would not need such a big range.
-
-   The 'writeback' option essentially saves the range found by *note
-autoscale:: in the buffers that would be filled by *note xrange::.  This
-is useful if you wish to plot several functions together but have the
-range determined by only some of them.  The 'writeback' operation is
-performed during the 'plot' execution, so it must be specified before
-that command.  To restore, the last saved horizontal range use 'set
-xrange restore'.  For example,
-
-           set xrange [-10:10]
-           set yrange [] writeback
-           plot sin(x)
-           set yrange restore
-           replot x/2
-
-
-   results in a yrange of [-1:1] as found only from the range of sin(x);
-the [-5:5] range of x/2 is ignored.  Executing *note yrange:: after each
-command in the above example should help you understand what is going
-on.
-
-   In 2D, *note xrange:: and *note yrange:: determine the extent of the
-axes, *note trange:: determines the range of the parametric variable in
-parametric mode or the range of the angle in polar mode.  Similarly in
-parametric 3D, *note xrange::, *note yrange::, and *note zrange:: govern
-the axes and *note urange:: and *note vrange:: govern the parametric
-variables.
-
-   In polar mode, *note rrange:: determines the radial range plotted.
-<rmin> acts as an additive constant to the radius, whereas <rmax> acts
-as a clip to the radius--no point with radius greater than <rmax> will
-be plotted.  *note xrange:: and *note yrange:: are affected--the ranges
-can be set as if the graph was of r(t)-rmin, with rmin added to all the
-labels.
-
-   Any range may be partially or totally autoscaled, although it may not
-make sense to autoscale a parametric variable unless it is plotted with
-data.
-
-   Ranges may also be specified on the 'plot' command line.  A range
-given on the plot line will be used for that single 'plot' command; a
-range given by a 'set' command will be used for all subsequent plots
-that do not specify their own ranges.  The same holds true for 'splot'.
-
-* Menu:
-
-* examples__::
-* extend::
-
-
-File: gnuplot.info,  Node: examples__,  Next: extend,  Prev: xrange,  Up: xrange
-
-3.33.122.1 examples
-...................
-
-Examples:
-
-   To set the xrange to the default:
-           set xrange [-10:10]
-
-
-   To set the yrange to increase downwards:
-           set yrange [10:-10]
-
-
-   To change zmax to 10 without affecting zmin (which may still be
-autoscaled):
-           set zrange [:10]
-
-
-   To autoscale xmin while leaving xmax unchanged:
-           set xrange [*:]
-
-
-   To autoscale xmin but keeping xmin positive:
-           set xrange [0<*:]
-
-
-   To autoscale x but keep minimum range of 10 to 50 (actual might be
-larger):
-           set xrange [*<10:50<*]
-
-
-   Autoscaling but limit maximum xrange to -1000 to 1000, i.e.
-autoscaling within [-1000:1000]
-           set xrange [-1000<*:*<1000]
-
-
-   Make sure xmin is somewhere between -200 and 100:
-           set xrange [-200<*<100:]
-
-
-
-File: gnuplot.info,  Node: extend,  Prev: examples__,  Up: xrange
-
-3.33.122.2 extend
-.................
-
-*note noextend:: is the same as *note noextend::.  See *note noextend::.
-
-
-File: gnuplot.info,  Node: xtics,  Next: xyplane,  Prev: xrange,  Up: set-show
-
-3.33.123 xtics
---------------
-
-Fine control of the major (labeled) tics on the x axis is possible with
-the 'set xtics' command.  The tics may be turned off with the 'unset
-xtics' command, and may be turned on (the default state) with 'set
-xtics'.  Similar commands control the major tics on the y, z, x2 and y2
-axes.
-
-   Syntax:
-           set xtics {axis | border} {{no}mirror}
-                     {in | out} {scale {default | <major> {,<minor>}}}
-                     {{no}rotate {by <ang>}} {offset <offset> | nooffset}
-                     {left | right | center | autojustify}
-                     {add}
-                     {  autofreq
-                      | <incr>
-                      | <start>, <incr> {,<end>}
-                      | ({"<label>"} <pos> {<level>} {,{"<label>"}...) }
-                     {format "formatstring"} {font "name{,<size>}"} {{no}enhanced}
-                     { numeric | timedate | geographic }
-                     {{no}logscale}
-                     { rangelimited }
-                     { textcolor <colorspec> }
-           unset xtics
-           show xtics
-
-
-   The same syntax applies to *note ytics::, *note ztics::, *note
-x2tics::, *note y2tics:: and *note cbtics::.
-
-   'axis' or *note border:: tells 'gnuplot' to put the tics (both the
-tics themselves and the accompanying labels) along the axis or the
-border, respectively.  If the axis is very close to the border, the
-'axis' option will move the tic labels to outside the border.  The
-relevant margin settings will usually be sized badly by the automatic
-layout algorithm in this case.
-
-   'mirror' tells 'gnuplot' to put unlabeled tics at the same positions
-on the opposite border.  'nomirror' does what you think it does.
-
-   'in' and 'out' change the tic marks to be drawn inwards or outwards.
-
-   With 'scale', the size of the tic marks can be adjusted.  If <minor>
-is not specified, it is 0.5*<major>.  The default size 1.0 for major
-tics and 0.5 for minor tics is requested by 'scale default'.
-
-   'rotate' asks 'gnuplot' to rotate the text through 90 degrees, which
-will be done if the terminal driver in use supports text rotation.
-'norotate' cancels this.  'rotate by <ang>' asks for rotation by <ang>
-degrees, supported by some terminal types.
-
-   The defaults are 'border mirror norotate' for tics on the x and y
-axes, and 'border nomirror norotate' for tics on the x2 and y2 axes.
-For the z axis, the '{axis | border}' option is not available and the
-default is 'nomirror'.  If you do want to mirror the z-axis tics, you
-might want to create a bit more room for them with *note border::.
-
-   The <offset> is specified by either x,y or x,y,z, and may be preceded
-by 'first', 'second', 'graph', 'screen', or 'character' to select the
-coordinate system.  <offset> is the offset of the tics texts from their
-default positions, while the default coordinate system is 'character'.
-See 'coordinates' for details.  'nooffset' switches off the offset.
-
-   Example:
-
-   Move xtics more closely to the plot.
-           set xtics offset 0,graph 0.05
-
-
-   To change the relative order of drawing axis tics and the plot
-itself, use the 'set grid' command with options 'front', 'back' or
-'layerdefault'.  There is no option to assign different axis tics or
-grid lines to different layers.
-
-   By default, tic labels are justified automatically depending on the
-axis and rotation angle to produce aesthetically pleasing results.  If
-this is not desired, justification can be overridden with an explicit
-'left', 'right' or 'center' keyword.  'autojustify' restores the default
-behavior.
-
-   'set xtics' with no options restores the default border or axis if
-xtics are being displayed; otherwise it has no effect.  Any previously
-specified tic frequency or position {and labels} are retained.
-
-   Tic positions are calculated automatically by default or if the
-'autofreq' option is given.
-
-   A series of tic positions can be specified by giving either a tic
-interval alone, or a start point, interval, and end point (see 'xtics
-series').
-
-   Individual tic positions can be specified individually by providing
-an explicit list of positions, where each position may have an
-associated text label.  See 'xtics list'.
-
-   However they are specified, tics will only be plotted when in range.
-
-   Format (or omission) of the tic labels is controlled by 'set format',
-unless the explicit text of a label is included in the 'set xtics
-("<label>")' form.
-
-   Minor (unlabeled) tics can be added automatically by the 'set mxtics'
-command, or at explicit positions by the 'set xtics ("" <pos> 1, ...)'
-form.
-
-   The appearance of the tics (line style, line width etc.)  is
-determined by the border line (see *note border::), even if the tics are
-drawn at the axes.
-
-* Menu:
-
-* xtics_series::
-* xtics_list::
-* xtics_timedata::
-* geographic::
-* xtics_logscale::
-* xtics_rangelimited::
-
-
-File: gnuplot.info,  Node: xtics_series,  Next: xtics_list,  Prev: xtics,  Up: xtics
-
-3.33.123.1 xtics series
-.......................
-
-Syntax:
-          set xtics <incr>
-          set xtics <start>, <incr>, <end>
-
-   The implicit <start>, <incr>, <end> form specifies that a series of
-tics will be plotted on the axis between the values <start> and <end>
-with an increment of <incr>.  If <end> is not given, it is assumed to be
-infinity.  The increment may be negative.  If neither <start> nor <end>
-is given, <start> is assumed to be negative infinity, <end> is assumed
-to be positive infinity, and the tics will be drawn at integral
-multiples of <incr>.  If the axis is logarithmic, the increment will be
-used as a multiplicative factor.
-
-   If you specify to a negative <start> or <incr> after a numerical
-value (e.g., 'rotate by <angle>' or 'offset <offset>'), the parser fails
-because it subtracts <start> or <incr> from that value.  As a
-workaround, specify '0-<start>' resp.  '0-<incr>' in that case.
-
-   Example:
-           set xtics border offset 0,0.5 -5,1,5
-
-   Fails with 'invalid expression' at the last comma.  Use instead
-           set xtics border offset 0,0.5 0-5,1,5
-
-   or
-           set xtics offset 0,0.5 border -5,1,5
-
-   These place tics at the border, tics text with an offset of 0,0.5
-characters, and sets the start, increment, and end to -5, 1, and 5, as
-requested.
-
-   Examples:
-
-   Make tics at 0, 0.5, 1, 1.5, ..., 9.5, 10.
-           set xtics 0,.5,10
-
-
-   Make tics at ..., -10, -5, 0, 5, 10, ...
-           set xtics 5
-
-
-   Make tics at 1, 100, 1e4, 1e6, 1e8.
-           set logscale x; set xtics 1,100,1e8
-
-
-
-File: gnuplot.info,  Node: xtics_list,  Next: xtics_timedata,  Prev: xtics_series,  Up: xtics
-
-3.33.123.2 xtics list
-.....................
-
-Syntax:
-          set xtics {add} ("label1" <pos1> <level1>, "label2" <pos2> <level2>, ...)
-
-
-   The explicit ("label" <pos> <level>, ...)  form allows arbitrary tic
-positions or non-numeric tic labels.  In this form, the tics do not need
-to be listed in numerical order.  Each tic has a position, optionally
-with a label.
-
-   The label is a string enclosed by quotes or a string-valued
-expression.  It may contain formatting information for converting the
-position into its label, such as "%3f clients", or it may be the empty
-string "".  See 'set format' for more information.  If no string is
-given, the default label (numerical) is used.
-
-   An explicit tic mark has a third parameter, the level.  The default
-is level 0, a major tic.  Level 1 generates a minor tic.  Labels are
-never printed for minor tics.  Major and minor tics may be
-auto-generated by the program or specified explicitly by the user.  Tics
-with level 2 and higher must be explicitly specified by the user, and
-take priority over auto-generated tics.  The size of tics marks at each
-level is controlled by the command 'set tics scale'.
-
-   Examples:
-           set xtics ("low" 0, "medium" 50, "high" 100)
-           set xtics (1,2,4,8,16,32,64,128,256,512,1024)
-           set ytics ("bottom" 0, "" 10, "top" 20)
-           set ytics ("bottom" 0, "" 10 1, "top" 20)
-
-
-   In the second example, all tics are labeled.  In the third, only the
-end tics are labeled.  In the fourth, the unlabeled tic is a minor tic.
-
-   Normally if explicit tics are given, they are used instead of
-auto-generated tics.  Conversely if you specify 'set xtics auto' or the
-like it will erase any previously specified explicit tics.  You can mix
-explicit and auto- generated tics by using the keyword 'add', which must
-appear before the tic style being added.
-
-   Example:
-           set xtics 0,.5,10
-           set xtics add ("Pi" 3.14159)
-
-
-   This will automatically generate tic marks every 0.5 along x, but
-will also add an explicit labeled tic mark at pi.
-
-
-File: gnuplot.info,  Node: xtics_timedata,  Next: geographic,  Prev: xtics_list,  Up: xtics
-
-3.33.123.3 xtics timedata
-.........................
-
-Times and dates are stored internally as a number of seconds.
-
-   Input: Non-numeric time and date values are converted to seconds on
-input using the format specifier in *note timefmt::.  Axis range limits,
-tic placement, and plot coordinates may be given as quoted dates or
-times interpreted using *note timefmt::.
-
-   Output: Axis tic labels are generated using a separate format
-specified either by 'set format' or 'set xtics format'.  By default the
-usual numeric format specifiers are expected ('set xtics numeric').
-Other options are geographic coordinates (*note geographic::), or times
-or dates ('set xtics time').
-
-   Note: For backward compatibility with earlier gnuplot versions, the
-command 'set xdata time' will implicitly also do 'set xtics time', and
-*note xdata:: or *note xdata:: will implicitly reset to 'set xtics
-numeric'.  However you can change this with a later call to 'set xtics'.
-
-   Examples:
-           set xdata time           # controls interpretation of input data
-           set timefmt "%d/%m"      # format used to read input data
-           set xtics timedate       # controls interpretation of output format
-           set xtics format "%b %d" # format used for tic labels
-           set xrange ["01/12":"06/12"]
-           set xtics "01/12", 172800, "05/12"
-
-
-           set xdata time
-           set timefmt "%d/%m"
-           set xtics format "%b %d" time
-           set xrange ["01/12":"06/12"]
-           set xtics ("01/12", "" "03/12", "05/12")
-
-   Both of these will produce tics "Dec 1", "Dec 3", and "Dec 5", but in
-the second example the tic at "Dec 3" will be unlabeled.
-
-   If the <start>, <incr>, <end> form is used, <incr> defaults to
-seconds but an explicit time unit of 'minutes', 'hours', 'days',
-'weeks', 'months', or 'years' can be appended.  The same is true if only
-an interval <incr> is given.
-
-   Examples
-          set xtics time 5 years     # place labeled tics at five year intervals
-          set xtics "01-Jan-2000", 1 month, "01-Jan-2001"
-
-
-   There is also a special time mode for minor tics.  See 'set mxtics
-time'.
-
-
-File: gnuplot.info,  Node: geographic,  Next: xtics_logscale,  Prev: xtics_timedata,  Up: xtics
-
-3.33.123.4 geographic
-.....................
-
-*note geographic:: indicates that x-axis values are to be interpreted as
-a geographic coordinate measured in degrees.  Use 'set xtics format' or
-'set format x' to specify the appearance of the axis tick labels.  The
-format specifiers for geographic data are as follows:
-            %D                   = integer degrees
-            %<width.precision>d  = floating point degrees
-            %M                   = integer minutes
-            %<width.precision>m  = floating point minutes
-            %S                   = integer seconds
-            %<width.precision>s  = floating point seconds
-            %E                   = label with E/W instead of +/-
-            %N                   = label with N/S instead of +/-
-
-   For example, the command 'set format x "%Ddeg %5.2mmin %E"' will
-cause x coordinate -1.51 to be labeled as '" 1deg 30.60min W"'.
-
-   If the xtics are left in the default state ('set xtics numeric') the
-coordinate will be reported as a decimal number of degrees, and 'format'
-will be assumed to contain normal numeric format specifiers rather than
-the special set above.
-
-   To output degrees/minutes/seconds in a context other than axis tics,
-such as placing labels on a map, you can use the relative time format
-specifiers %tH %tM %tS for strptime.  See 'time_specifiers', *note
-strptime::.
-
-
-File: gnuplot.info,  Node: xtics_logscale,  Next: xtics_rangelimited,  Prev: geographic,  Up: xtics
-
-3.33.123.5 xtics logscale
-.........................
-
-If the *note logscale:: attribute is set for a tic series along a
-log-scaled axis, the tic interval is interpreted as a multiplicative
-factor rather than a constant.  For example:
-          # generate a series of tics at y=20 y=200 y=2000 y=20000
-          set log y
-          set ytics 20, 10, 50000 logscale
-
-   Note that no tic is placed at y=50000 because it is not in the series
-2*10^x.  If the logscale property is disabled, the tic increment will be
-treated as an additive constant even for a log-scaled axis.  For
-example:
-          # generate a series of tics at y=20 y=40 y=60 ... y=200
-          set log y
-          set yrange [20:200]
-          set ytics 20 nologscale
-
-   The *note logscale:: attribute is set automatically by the 'set log'
-command, so normally you do not need this keyword unless you want to
-force a constant tic interval as in the second example above.
-
-
-File: gnuplot.info,  Node: xtics_rangelimited,  Prev: xtics_logscale,  Up: xtics
-
-3.33.123.6 xtics rangelimited
-.............................
-
-This option limits both the auto-generated axis tic labels and the
-corresponding plot border to the range of values actually present in the
-data that has been plotted.  Note that this is independent of the
-current range limits for the plot.  For example, suppose that the data
-in "file.dat" all lies in the range 2 < y < 4.  Then the following
-commands will create a plot for which the left-hand plot border (y axis)
-is drawn for only this portion of the total y range, and only the axis
-tics in this region are generated.  I.e., the plot will be scaled to the
-full range on y, but there will be a gap between 0 and 2 on the left
-border and another gap between 4 and 10.  This style is sometimes
-referred to as a 'range-frame' graph.
-           set border 3
-           set yrange [0:10]
-           set ytics nomirror rangelimited
-           plot "file.dat"
-
-
-
-File: gnuplot.info,  Node: xyplane,  Next: xzeroaxis,  Prev: xtics,  Up: set-show
-
-3.33.124 xyplane
-----------------
-
-The *note xyplane:: command adjusts the position at which the xy plane
-is drawn in a 3D plot.  The synonym "set ticslevel" is accepted for
-backwards compatibility.
-
-   Syntax:
-           set xyplane at <zvalue>
-           set xyplane relative <frac>
-           set ticslevel <frac>        # equivalent to set xyplane relative
-           show xyplane
-
-
-   The form 'set xyplane relative <frac>' places the xy plane below the
-range in Z, where the distance from the xy plane to Zmin is given as a
-fraction of the total range in z.  The default value is 0.5.  Negative
-values are permitted, but tic labels on the three axes may overlap.
-
-   The alternative form 'set xyplane at <zvalue>' fixes the placement of
-the xy plane at a specific Z value regardless of the current z range.
-Thus to force the x, y, and z axes to meet at a common origin one would
-specify 'set xyplane at 0'.
-
-   See also *note view::, and *note zeroaxis::.
-
-
-File: gnuplot.info,  Node: xzeroaxis,  Next: y2data,  Prev: xyplane,  Up: set-show
-
-3.33.125 xzeroaxis
-------------------
-
-The *note xzeroaxis:: command draws a line at y = 0.  For details,
-please see *note zeroaxis::.
-
-
-File: gnuplot.info,  Node: y2data,  Next: y2dtics,  Prev: xzeroaxis,  Up: set-show
-
-3.33.126 y2data
----------------
-
-The *note y2data:: command sets y2 (right-hand) axis data to timeseries
-(dates/times).  Please see *note xdata::.
-
-
-File: gnuplot.info,  Node: y2dtics,  Next: y2label,  Prev: y2data,  Up: set-show
-
-3.33.127 y2dtics
-----------------
-
-The *note y2dtics:: command changes tics on the y2 (right-hand) axis to
-days of the week.  Please see *note xdtics:: for details.
-
-
-File: gnuplot.info,  Node: y2label,  Next: y2mtics,  Prev: y2dtics,  Up: set-show
-
-3.33.128 y2label
-----------------
-
-The *note y2label:: command sets the label for the y2 (right-hand) axis.
-Please see *note xlabel::.
-
-
-File: gnuplot.info,  Node: y2mtics,  Next: y2range,  Prev: y2label,  Up: set-show
-
-3.33.129 y2mtics
-----------------
-
-The *note y2mtics:: command changes tics on the y2 (right-hand) axis to
-months of the year.  Please see *note xmtics:: for details.
-
-
-File: gnuplot.info,  Node: y2range,  Next: y2tics,  Prev: y2mtics,  Up: set-show
-
-3.33.130 y2range
-----------------
-
-The *note y2range:: command sets the vertical range that will be
-displayed on the y2 (right) axis.  See *note xrange:: for the full set
-of command options.  See also *note link::.
-
-
-File: gnuplot.info,  Node: y2tics,  Next: y2zeroaxis,  Prev: y2range,  Up: set-show
-
-3.33.131 y2tics
----------------
-
-The *note y2tics:: command controls major (labeled) tics on the y2
-(right-hand) axis.  Please see 'set xtics' for details.
-
-
-File: gnuplot.info,  Node: y2zeroaxis,  Next: ydata,  Prev: y2tics,  Up: set-show
-
-3.33.132 y2zeroaxis
--------------------
-
-The *note y2zeroaxis:: command draws a line at the origin of the y2
-(right-hand) axis (x2 = 0).  For details, please see *note zeroaxis::.
-
-
-File: gnuplot.info,  Node: ydata,  Next: ydtics,  Prev: y2zeroaxis,  Up: set-show
-
-3.33.133 ydata
---------------
-
-The *note ydata:: commands sets y-axis data to timeseries (dates/times).
-Please see *note xdata::.
-
-
-File: gnuplot.info,  Node: ydtics,  Next: ylabel,  Prev: ydata,  Up: set-show
-
-3.33.134 ydtics
----------------
-
-The *note ydtics:: command changes tics on the y axis to days of the
-week.  Please see *note xdtics:: for details.
-
-
-File: gnuplot.info,  Node: ylabel,  Next: ymtics,  Prev: ydtics,  Up: set-show
-
-3.33.135 ylabel
----------------
-
-This command sets the label for the y axis.  Please see *note xlabel::.
-
-
-File: gnuplot.info,  Node: ymtics,  Next: yrange,  Prev: ylabel,  Up: set-show
-
-3.33.136 ymtics
----------------
-
-The *note ymtics:: command changes tics on the y axis to months of the
-year.  Please see *note xmtics:: for details.
-
-
-File: gnuplot.info,  Node: yrange,  Next: ytics,  Prev: ymtics,  Up: set-show
-
-3.33.137 yrange
----------------
-
-The *note yrange:: command sets the vertical range that will be
-displayed on the y axis.  Please see *note xrange:: for details.
-
-
-File: gnuplot.info,  Node: ytics,  Next: yzeroaxis,  Prev: yrange,  Up: set-show
-
-3.33.138 ytics
---------------
-
-The *note ytics:: command controls major (labeled) tics on the y axis.
-Please see 'set xtics' for details.
-
-
-File: gnuplot.info,  Node: yzeroaxis,  Next: zdata,  Prev: ytics,  Up: set-show
-
-3.33.139 yzeroaxis
-------------------
-
-The *note yzeroaxis:: command draws a line at x = 0.  For details,
-please see *note zeroaxis::.
-
-
-File: gnuplot.info,  Node: zdata,  Next: zdtics,  Prev: yzeroaxis,  Up: set-show
-
-3.33.140 zdata
---------------
-
-The *note zdata:: command sets zaxis data to timeseries (dates/times).
-Please see *note xdata::.
-
-
-File: gnuplot.info,  Node: zdtics,  Next: zzeroaxis,  Prev: zdata,  Up: set-show
-
-3.33.141 zdtics
----------------
-
-The *note zdtics:: command changes tics on the z axis to days of the
-week.  Please see *note xdtics:: for details.
-
-
-File: gnuplot.info,  Node: zzeroaxis,  Next: cbdata,  Prev: zdtics,  Up: set-show
-
-3.33.142 zzeroaxis
-------------------
-
-The *note zzeroaxis:: command draws a line through (x=0,y=0).  This has
-no effect on 2D plots, including splot with 'set view map'.  For
-details, please see *note zeroaxis:: and *note xyplane::.
-
-
-File: gnuplot.info,  Node: cbdata,  Next: cbdtics,  Prev: zzeroaxis,  Up: set-show
-
-3.33.143 cbdata
----------------
-
-Set color box axis data to timeseries (dates/times).  Please see *note
-xdata::.
-
-
-File: gnuplot.info,  Node: cbdtics,  Next: zero,  Prev: cbdata,  Up: set-show
-
-3.33.144 cbdtics
-----------------
-
-The *note cbdtics:: command changes tics on the color box axis to days
-of the week.  Please see *note xdtics:: for details.
-
-
-File: gnuplot.info,  Node: zero,  Next: zeroaxis,  Prev: cbdtics,  Up: set-show
-
-3.33.145 zero
--------------
-
-The 'zero' value is the default threshold for values approaching 0.0.
-
-   Syntax:
-           set zero <expression>
-           show zero
-
-
-   'gnuplot' will not plot a point if its imaginary part is greater in
-magnitude than the 'zero' threshold.  This threshold is also used in
-various other parts of 'gnuplot' as a (crude) numerical-error threshold.
-The default 'zero' value is 1e-8.  'zero' values larger than 1e-3 (the
-reciprocal of the number of pixels in a typical bitmap display) should
-probably be avoided, but it is not unreasonable to set 'zero' to 0.0.
-
-
-File: gnuplot.info,  Node: zeroaxis,  Next: zlabel,  Prev: zero,  Up: set-show
-
-3.33.146 zeroaxis
------------------
-
-The x axis may be drawn by *note xzeroaxis:: and removed by *note
-xzeroaxis::.  Similar commands behave similarly for the y, x2, y2, and z
-axes.  'set zeroaxis ...'  (no prefix) acts on the x, y, and z axes
-jointly.
-
-   Syntax:
-           set {x|x2|y|y2|z}zeroaxis { {linestyle | ls <line_style>}
-                                      | {linetype | lt <line_type>}
-                                        {linewidth | lw <line_width>}
-                                        {linecolor | lc <colorspec>}
-                                        {dashtype | dt <dashtype>} }
-           unset {x|x2|y|y2|z}zeroaxis
-           show {x|y|z}zeroaxis
-
-
-   By default, these options are off.  The selected zero axis is drawn
-with a line of type <line_type>, width <line_width>, color <colorspec>,
-and dash type <dashtype> (if supported by the terminal driver currently
-in use), or a user-defined style <line_style> (see 'set style line').
-
-   If no linetype is specified, any zero axes selected will be drawn
-using the axis linetype (linetype 0).
-
-   Examples:
-
-   To simply have the y=0 axis drawn visibly:
-
-            set xzeroaxis
-
-
-   If you want a thick line in a different color or pattern, instead:
-
-            set xzeroaxis linetype 3 linewidth 2.5
-
-
-
-File: gnuplot.info,  Node: zlabel,  Next: zmtics,  Prev: zeroaxis,  Up: set-show
-
-3.33.147 zlabel
----------------
-
-This command sets the label for the z axis.  Please see *note xlabel::.
-
-
-File: gnuplot.info,  Node: zmtics,  Next: zrange,  Prev: zlabel,  Up: set-show
-
-3.33.148 zmtics
----------------
-
-The *note zmtics:: command changes tics on the z axis to months of the
-year.  Please see *note xmtics:: for details.
-
-
-File: gnuplot.info,  Node: zrange,  Next: ztics,  Prev: zmtics,  Up: set-show
-
-3.33.149 zrange
----------------
-
-The *note zrange:: command sets the range that will be displayed on the
-z axis.  The zrange is used only by 'splot' and is ignored by 'plot'.
-Please see *note xrange:: for details.
-
-
-File: gnuplot.info,  Node: ztics,  Next: cblabel,  Prev: zrange,  Up: set-show
-
-3.33.150 ztics
---------------
-
-The *note ztics:: command controls major (labeled) tics on the z axis.
-Please see 'set xtics' for details.
-
-
-File: gnuplot.info,  Node: cblabel,  Next: cbmtics,  Prev: ztics,  Up: set-show
-
-3.33.151 cblabel
-----------------
-
-This command sets the label for the color box axis.  Please see *note
-xlabel::.
-
-
-File: gnuplot.info,  Node: cbmtics,  Next: cbrange,  Prev: cblabel,  Up: set-show
-
-3.33.152 cbmtics
-----------------
-
-The *note cbmtics:: command changes tics on the color box axis to months
-of the year.  Please see *note xmtics:: for details.
-
-
-File: gnuplot.info,  Node: cbrange,  Next: cbtics,  Prev: cbmtics,  Up: set-show
-
-3.33.153 cbrange
-----------------
-
-The *note cbrange:: command sets the range of values which are colored
-using the current *note palette:: by styles 'with pm3d', 'with image'
-and *note palette::.  Values outside of the color range use color of the
-nearest extreme.
-
-   If the cb-axis is autoscaled in 'splot', then the colorbox range is
-taken from *note zrange::.  Points drawn in 'splot ...  pm3d|palette'
-can be filtered by using different *note zrange:: and *note cbrange::.
-
-   Please see *note xrange:: for details on *note cbrange:: syntax.  See
-also *note palette:: and 'set colorbox'.
-
-
-File: gnuplot.info,  Node: cbtics,  Prev: cbrange,  Up: set-show
-
-3.33.154 cbtics
----------------
-
-The *note cbtics:: command controls major (labeled) tics on the color
-box axis.  Please see 'set xtics' for details.
-
-
-File: gnuplot.info,  Node: shell,  Next: show,  Prev: set-show,  Up: Commands
-
-3.34 shell
-==========
-
-The *note shell:: command spawns an interactive shell.  To return to
-'gnuplot', type *note exit:: or the END-OF-FILE character if using Unix,
-or *note exit:: if using MS-DOS or OS/2.
-
-   The *note shell:: command ignores anything else on the gnuplot
-command line.  If instead you want to pass a command string to a shell
-for immediate execution, use the *note system:: function or the shortcut
-'!'.  See *note system::.
-
-   Examples:
-
-           shell
-           system "print previous_plot.ps"
-           ! print previous_plot.ps
-           current_time = system("date")
-
-
-
-File: gnuplot.info,  Node: show,  Next: splot,  Prev: shell,  Up: Commands
-
-3.35 show
-=========
-
-Most 'set' commands have a corresponding show command with no special
-options.  For example
-          show linetype 3
-
-   will report the current properties in effect from previous commands
-like
-          set linetype 3 linewidth 2 dashpattern '.-'
-
-   A few 'show' commands that diverge from this pattern are documented
-separately.
-
-* Menu:
-
-* show_colornames::
-* show_functions::
-* show_palette::
-* show_plot::
-* show_variables::
-
-
-File: gnuplot.info,  Node: show_colornames,  Next: show_functions,  Prev: show,  Up: show
-
-3.35.1 show colornames
-----------------------
-
-Gnuplot knows about 100 colors by name (see *note colornames::).  You
-can dump a list of these to the terminal by using the command *note
-colornames::.  There is currently no way to set new names.
-
-
-File: gnuplot.info,  Node: show_functions,  Next: show_palette,  Prev: show_colornames,  Up: show
-
-3.35.2 show functions
----------------------
-
-The *note functions:: command lists all user-defined functions and their
-definitions.
-
-   Syntax:
-           show functions
-
-
-   For information about the definition and usage of functions in
-'gnuplot', please see 'expressions'.  See also splines as user defined
-functions (spline.dem) (http://www.gnuplot.info/demo/spline.html) and
-use of functions and complex variables for airfoils (airfoil.dem).
-(http://www.gnuplot.info/demo/airfoil.html)
-
-
-File: gnuplot.info,  Node: show_palette,  Next: show_plot,  Prev: show_functions,  Up: show
-
-3.35.3 show palette
--------------------
-
-Syntax:
-           show palette
-           show palette palette {<ncolors>} {{float | int | hex}}
-           show palette gradient
-           show palette rgbformulae
-           test palette
-
-
-   The *note palette:: command will plot the R,G,B profiles for the
-current palette and store the profile values in a datablock $PALETTE.
-
-* Menu:
-
-* show_palette_gradient::
-* show_palette_palette::
-* show_palette_rgbformulae::
-
-
-File: gnuplot.info,  Node: show_palette_gradient,  Next: show_palette_palette,  Prev: show_palette,  Up: show_palette
-
-3.35.3.1 show palette gradient
-..............................
-
-'show palette gradient' displays the piecewise gradient established by a
-prior *note defined:: command.  If the current palette is based on
-rgbformulae or a set of predefined values then this command does
-nothing.
-
-
-File: gnuplot.info,  Node: show_palette_palette,  Next: show_palette_rgbformulae,  Prev: show_palette_gradient,  Up: show_palette
-
-3.35.3.2 show palette palette
-.............................
-
-           show palette palette {<ncolors>} {{float | int | hex}}
-
-
-   'show palette palette <n>' prints to the screen or to the file given
-by 'set print' a table of color components for each entry in the current
-palette.  By default the continuous palette is sampled in 128
-increments.  Specifying <ncolors> will sample the palette evenly at this
-number of increments (rather than 128).  The default is a long listing
-in the form
-          0. gray=0.0000, (r,g,b)=(0.0000,0.0000,0.0000), #000000 =   0   0   0
-          1. gray=0.1111, (r,g,b)=(0.3333,0.0014,0.6428), #5500a4 =  85   0 164
-          2. gray=0.2222, (r,g,b)=(0.4714,0.0110,0.9848), #7803fb = 120   3 251
-          ...
-
-   An optional trailing keyword *note float::, 'int', or 'hex' instead
-prints only single representation of the color components per entry:
-             int:        85       0     164
-           float:    0.3333  0.0014  0.6428
-             hex:  0x5500a4
-
-
-   By using 'set print' to direct this output to a file, the current
-gnuplot color palette can be loaded into other imaging applications such
-as Octave.
-
-   By using 'set print' to direct output to a datablock, the current
-palette can be saved so that it is available to future plot commands
-even if the active palette is redefined.  This allows creating plots
-that draw from multiple palettes, although the colorbox still represents
-only the current active palette.
-
-
-File: gnuplot.info,  Node: show_palette_rgbformulae,  Prev: show_palette_palette,  Up: show_palette
-
-3.35.3.3 show palette rgbformulae
-.................................
-
-*note rgbformulae:: prints the available fixed gray -> color
-transformation formulae.  It does _not_ show the state of the current
-palette.
-
-
-File: gnuplot.info,  Node: show_plot,  Next: show_variables,  Prev: show_palette,  Up: show
-
-3.35.4 show plot
-----------------
-
-The 'show plot' command shows the most recent plotting command as it
-results from the last 'plot' and/or 'splot' and possible subsequent
-*note replot:: commands.
-
-   In addition, the 'show plot add2history' command adds this current
-plot command into the *note history::.  It is useful if you have used
-*note replot:: to add more curves to the current plot and you want to
-edit the whole command now.
-
-
-File: gnuplot.info,  Node: show_variables,  Prev: show_plot,  Up: show
-
-3.35.5 show variables
----------------------
-
-The 'show variables' command lists the current value of user-defined and
-internal variables.  Gnuplot internally defines variables whose names
-begin with GPVAL_, MOUSE_, FIT_, and TERM_.
-
-   Syntax:
-           show variables      # show variables that do not begin with GPVAL_
-           show variables all  # show all variables including those beginning GPVAL_
-           show variables NAME # show only variables beginning with NAME
-
-
-
-File: gnuplot.info,  Node: splot,  Next: stats_(Statistical_Summary),  Prev: show,  Up: Commands
-
-3.36 splot
-==========
-
-'splot' is the command for drawing 3D plots (well, actually projections
-on a 2D surface, but you knew that).  It is the 3D equivalent of the
-'plot' command.  'splot' provides only a single x, y, and z axis; there
-is no equivalent to the x2 and y2 secondary axes provided by 'plot'.
-
-   See the 'plot' command for many options available in both 2D and 3D
-plots.
-
-   Syntax:
-           splot {<ranges>}
-                 {<iteration>}
-                 <function> | {{<file name> | <datablock name>} {datafile-modifiers}}
-                            | <voxelgridname>
-                            | keyentry
-                 {<title-spec>} {with <style>}
-                 {, {definitions{,}} <function> ...}
-
-
-   The 'splot' command operates on a data generated by a function, read
-from a data file, or stored previously in a named data block.  Data file
-names are usually provided as a quoted string.  The function can be a
-mathematical expression, or a triple of mathematical expressions in
-parametric mode.
-
-   Starting in version 5.4 'splot' can operate on voxel data.  See
-'voxel-grids', *note vgrid::, *note vxrange::.  At present voxel grids
-can be be plotted using styles *note dots::, 'with points', or *note
-isosurface::.  Voxel grid values can also be referenced in the 'using'
-specifiers of other plot styles, for example to assign colors.
-
-   By default 'splot' draws the xy plane completely below the plotted
-data.  The offset between the lowest ztic and the xy plane can be
-changed by *note xyplane::.  The orientation of a 'splot' projection is
-controlled by *note view::.  See *note view:: and *note xyplane:: for
-more information.
-
-   The syntax for setting ranges on the 'splot' command is the same as
-for 'plot'.  In non-parametric mode, ranges must be given in the order
-           splot [<xrange>][<yrange>][<zrange>] ...
-
-   In parametric mode, the order is
-           splot [<urange>][<vrange>][<xrange>][<yrange>][<zrange>] ...
-
-
-   The *note title:: option is the same as in 'plot'.  The operation of
-'with' is also the same as in 'plot' except that not all 2D plotting
-styles are available.
-
-   The *note datafile:: options have more differences.
-
-   As an alternative to surfaces drawn using parametric or function
-mode, the pseudo-file '++' can be used to generate samples on a grid in
-the xy plane.
-
-   See also 'show plot', 'set view map', and *note sampling::.
-
-* Menu:
-
-* data-file::
-* grid_data::
-* splot_surfaces::
-* voxel-grid::
-
-
-File: gnuplot.info,  Node: data-file,  Next: grid_data,  Prev: splot,  Up: splot
-
-3.36.1 data-file
-----------------
-
-'Splot', like 'plot', can display from a file.
-
-   Syntax:
-           splot '<file_name>' {binary <binary list>}
-                               {{nonuniform|sparse} matrix}
-                               {index <index list>}
-                               {every <every list>}
-                               {using <using list>}
-
-
-   The special filenames '""' and '"-"' are permitted, as in 'plot'.
-See *note special-filenames::.
-
-   Keywords *note binary:: and *note matrix:: indicate that the data are
-in a special form, *note index:: selects which data sets in a
-multi-data-set file are plotted, *note every:: specifies a subset of
-lines within a single data set, 'using' determines how the columns
-within a single record are interpreted.
-
-   The options *note index:: and *note every:: behave the same way as
-with 'plot'; 'using' does so also, except that the 'using' list must
-provide three entries instead of two.
-
-   The 'plot' option *note smooth:: is not available for 'splot', but
-*note cntrparam:: and *note dgrid3d:: provide limited smoothing
-capabilities.
-
-   Data file organization is essentially the same as for 'plot', except
-that each point is an (x,y,z) triple.  If only a single value is
-provided, it will be used for z, the block number will be used for y,
-and the index of the data point in the block will be used for x.  If two
-or four values are provided, 'gnuplot' uses the last value for
-calculating the color in pm3d plots.  Three values are interpreted as an
-(x,y,z) triple.  Additional values are generally used as errors, which
-can be used by *note fit::.
-
-   Single blank records separate blocks of data in a 'splot' datafile;
-'splot' treats blocks as the equivalent of function y-isolines.  No line
-will join points separated by a blank record.  If all blocks contain the
-same number of points, 'gnuplot' will draw cross-isolines between points
-in the blocks, connecting corresponding points.  This is termed "grid
-data", and is required for drawing a surface, for contouring ('set
-contour') and hidden-line removal (*note hidden3d::).  See also 'splot
-grid_data'.
-
-* Menu:
-
-* matrix::
-* example_datafile_::
-
-
-File: gnuplot.info,  Node: matrix,  Next: example_datafile_,  Prev: data-file,  Up: data-file
-
-3.36.1.1 matrix
-...............
-
-Matrix data can be input in several formats ('uniform', 'nonuniform',
-'sparse') from either text or binary files.
-
-   The first variant assumes a uniform grid of x and y coordinates and
-assigns each value in the input matrix to one element M[i,j] of this
-uniform grid.  The assigned x coordinates are the integers [0:NCOLS-1].
-The assigned y coordinates are the integers [0:NROWS-1].  This is the
-default for text data input, but not for binary input.  See 'uniform'
-for examples and additional keywords.
-
-   The second variant handles a non-uniform grid with explicit x and y
-coordinates.  The first row of input data contains the y coordinates;
-the first column of input data contains the x coordinates.  For binary
-input data, the first element of the first row must contain the number
-of columns.  This is the default for *note matrix:: input, but requires
-an additional keyword 'nonuniform' for text input data.  See
-'nonuniform' for examples.
-
-   The *note matrix:: variant defines a uniform grid into which any
-number of individual point values are read from the input file, one per
-line, in any order.  This is primarily intended for the generation of
-heatmaps from incomplete data.  See 'sparse' for examples.
-
--- UNIFORM MATRIX --
-
-   Example commands for plotting uniform matrix data:
-          splot 'file' matrix using 1:2:3          # text input
-          splot 'file' binary general using 1:2:3  # binary input
-
-
-   In a uniform grid matrix the z-values are read in a row at a time, i.
-e.,
-         z11 z12 z13 z14 ...
-         z21 z22 z23 z24 ...
-         z31 z32 z33 z34 ...
-
-   and so forth.
-
-   For text input, if the first row contains column labels rather than
-data, use the additional keyword *note columnheaders::.  Similarly if
-the first field in each row contains a label rather than data, use the
-additional keyword 'rowheaders'.  Here is an example that uses both:
-         $DATA << EOD
-         xxx A   B   C   D
-         aa  z11 z12 z13 z14
-         bb  z21 z22 z23 z24
-         cc  z31 z32 z33 z34
-         EOD
-         plot $DATA matrix columnheaders rowheaders with image
-
-
-   For text input, a blank line or comment line ends the matrix, and
-starts a new data block.  You can select among the data blocks in a file
-by the *note index:: option to the 'splot' command, as usual.  The
-columnheaders option, if present, is applied only to the first data
-block.
-
--- NONUNIFORM MATRIX --
-
-   The first row of input data contains the y coordinates.  The first
-column of input data contains the x coordinates.  For binary input data,
-the first field of the first row must contain the number of columns.
-(This number is ignored for text input).
-
-   Example commands for plotting non-uniform matrix data:
-          splot 'file' nonuniform matrix using 1:2:3  # text input
-          splot 'file' binary matrix using 1:2:3      # binary input
-
-
-   Thus the data organization for non-uniform matrix input is
-
-           <N+1>  <x0>   <x1>   <x2>  ...  <xN>
-            <y0> <z0,0> <z0,1> <z0,2> ... <z0,N>
-            <y1> <z1,0> <z1,1> <z1,2> ... <z1,N>
-             :      :      :      :   ...    :
-
-
-   which is then converted into triplets:
-           <x0> <y0> <z0,0>
-           <x0> <y1> <z0,1>
-           <x0> <y2> <z0,2>
-            :    :     :
-           <x0> <yN> <z0,N>
-
-
-           <x1> <y0> <z1,0>
-           <x1> <y1> <z1,1>
-            :    :     :
-
-
-   These triplets are then converted into 'gnuplot' iso-curves and then
-'gnuplot' proceeds in the usual manner to do the rest of the plotting.
-
--- SPARSE MATRIX --
-
-   Syntax:
-           sparse matrix=(cols,rows) origin=(x0,y0) dx=<delx> dy=<dely>
-
-   The 'sparse' matrix variant defines a uniform grid as part of the
-'plot' or 'splot' command line.  The grid is initially empty.  Any
-number of individual points are then read from the input file, one per
-line, and assigned to the nearest grid point.  I.e.  a data line
-           x y value
-
-   is evaluated as
-           i = (x - x0) / delx
-           j = (y - y0) / dely
-           matrix[i,j] = value
-
-   The size of the matrix is required.  *note origin:: (optional)
-defaults to origin=(0,0).  'dx' (optional) defaults to dx=1.  'dy'
-(optional) defaults to dy=dx.
-
-   The intended use of this variant is to generate heatmaps from
-unordered, possibly incomplete, data using the 'image', *note
-rgbimage::, or *note rgbalpha:: plot styles.  The example below
-generates a distance matrix in the form of a 4x4 heatmap with only the
-upper triangle elements present:
-           $DATA << EOD
-           1 1 10
-           1 2 20
-           1 3 30
-           1 4 40
-           2 2 10
-           2 3 50
-           2 4 60
-           3 3 10
-           3 4 20
-           4 4 10
-           EOD
-           plot $DATA sparse matrix=(4,4) origin=(1,1) with image
-
-
--- EVERY --
-
-   The *note every:: keyword has special meaning when used with matrix
-data.  Rather than applying to blocks of single points, it applies to
-rows and column values.  Note that matrix rows and columns are indexed
-starting from 0, so the row with index N is the (N+1)th row.  Syntax:
-           plot 'file' matrix every {<column_incr>}
-                                    {:{<row_incr>}
-                                      {:{<start_column>}
-                                        {:{<start_row>}
-                                          {:{<end_column>}
-                                            {:<end_row>}}}}}
-
-   Examples:
-           plot 'file' matrix every :::N::N   # plot all values in row with index N
-           plot 'file' matrix every ::3::7    # plot columns 3 to 7 for all rows
-           plot 'file' matrix every ::3:0:7:4 # submatrix bounded by [3,0] and [7,4]
-
-
--- EXAMPLES --
-
-   A collection of matrix and vector manipulation routines (in C) is
-provided in 'binary.c'.  The routine to write binary data is
-
-           int fwrite_matrix(file,m,nrl,nrl,ncl,nch,row_title,column_title)
-
-
-   An example of using these routines is provided in the file
-'bf_test.c', which generates binary files for the demo file
-'demo/binary.dem'.
-
-   Usage in 'plot':
-         plot 'a.dat' matrix
-         plot 'a.dat' matrix using 1:3
-         plot 'a.gpbin' {matrix} binary using 1:3
-
-   will plot rows of the matrix, while using 2:3 will plot matrix
-columns, and using 1:2 the point coordinates (rather useless).  Applying
-the *note every:: option you can specify explicit rows and columns.
-
-   Example - rescale axes of a matrix in a text file:
-         splot `a.dat` matrix using (1+$1):(1+$2*10):3
-
-
-   Example - plot the 3rd row of a matrix in a text file:
-         plot 'a.dat' matrix using 1:3 every 1:999:1:2
-
-   (rows are enumerated from 0, thus 2 instead of 3).
-
-   Gnuplot can read matrix binary files by use of the option *note
-binary:: appearing without keyword qualifications unique to general
-binary, i.e., 'array', *note record::, 'format', or *note filetype::.
-Other general binary keywords for translation should also apply to
-matrix binary.  (See *note general:: for more details.)
-
-
-File: gnuplot.info,  Node: example_datafile_,  Prev: matrix,  Up: data-file
-
-3.36.1.2 example datafile
-.........................
-
-A simple example of plotting a 3D data file is
-
-           splot 'datafile.dat'
-
-
-   where the file "datafile.dat" might contain:
-
-           # The valley of the Gnu.
-              0 0 10
-              0 1 10
-              0 2 10
-
-
-              1 0 10
-              1 1 5
-              1 2 10
-
-
-              2 0 10
-              2 1 1
-              2 2 10
-
-
-              3 0 10
-              3 1 0
-              3 2 10
-
-
-   Note that "datafile.dat" defines a 4 by 3 grid ( 4 rows of 3 points
-each ).  Rows (blocks) are separated by blank records.
-
-   Note also that the x value is held constant within each dataline.  If
-you instead keep y constant, and plot with hidden-line removal enabled,
-you will find that the surface is drawn 'inside-out'.
-
-   Actually for grid data it is not necessary to keep the x values
-constant within a block, nor is it necessary to keep the same sequence
-of y values.  'gnuplot' requires only that the number of points be the
-same for each block.  However since the surface mesh, from which
-contours are derived, connects sequentially corresponding points, the
-effect of an irregular grid on a surface plot is unpredictable and
-should be examined on a case-by-case basis.
-
-
-File: gnuplot.info,  Node: grid_data,  Next: splot_surfaces,  Prev: data-file,  Up: splot
-
-3.36.2 grid data
-----------------
-
-The 3D routines are designed for points in a grid format, with one
-sample, datapoint, at each mesh intersection; the datapoints may
-originate from either evaluating a function, see *note isosamples::, or
-reading a datafile, see *note datafile::.  The term "isoline" is applied
-to the mesh lines for both functions and data.  Note that the mesh need
-not be rectangular in x and y, as it may be parameterized in u and v,
-see *note isosamples::.
-
-   However, 'gnuplot' does not require that format.  In the case of
-functions, 'samples' need not be equal to 'isosamples', i.e., not every
-x-isoline sample need intersect a y-isoline.  In the case of data files,
-if there are an equal number of scattered data points in each block,
-then "isolines" will connect the points in a block, and "cross-isolines"
-will connect the corresponding points in each block to generate a
-"surface".  In either case, contour and hidden3d modes may give
-different plots than if the points were in the intended format.
-
-   Scattered data can be fit to a grid before plotting.  See *note
-dgrid3d::.
-
-   The contour code tests for z intensity along a line between a point
-on a y-isoline and the corresponding point in the next y-isoline.  Thus
-a 'splot' contour of a surface with samples on the x-isolines that do
-not coincide with a y-isoline intersection will ignore such samples.
-Try:
-            set xrange [-pi/2:pi/2]; set yrange [-pi/2:pi/2]
-            set style function lp
-            set contour
-            set isosamples 10,10; set samples 10,10;
-            splot cos(x)*cos(y)
-            set samples 4,10; replot
-            set samples 10,4; replot
-
-
-
-File: gnuplot.info,  Node: splot_surfaces,  Next: voxel-grid,  Prev: grid_data,  Up: splot
-
-3.36.3 splot surfaces
----------------------
-
-'splot' can display a surface as a collection of points, or by
-connecting those points.  As with 'plot', the points may be read from a
-data file or result from evaluation of a function at specified
-intervals, see *note isosamples::.  The surface may be approximated by
-connecting the points with straight line segments, see 'set surface', in
-which case the surface can be made opaque with 'set hidden3d.'  The
-orientation from which the 3d surface is viewed can be changed with
-*note view::.
-
-   Additionally, for points in a grid format, 'splot' can interpolate
-points having a common amplitude (see 'set contour') and can then
-connect those new points to display contour lines, either directly with
-straight-line segments or smoothed lines (see *note cntrparam::).
-Functions are already evaluated in a grid format, determined by *note
-isosamples:: and *note samples::, while file data must either be in a
-grid format, as described in *note data-file::, or be used to generate a
-grid (see *note dgrid3d::).
-
-   Contour lines may be displayed either on the surface or projected
-onto the base.  The base projections of the contour lines may be written
-to a file, and then read with 'plot', to take advantage of 'plot''s
-additional formatting capabilities.
-
-
-File: gnuplot.info,  Node: voxel-grid,  Prev: splot_surfaces,  Up: splot
-
-3.36.4 voxel-grid
------------------
-
-Syntax:
-          splot $voxelgridname with {dots|points} {above <threshold>} ...
-          splot $voxelgridname with isosurface {level <threshold>} ...
-
-
-   Voxel data can be plotted with dots or points marking individual
-voxels whose value is above the specified threshold value (default
-threshold = 0).  Color/pointtype/linewidth properties can be appended as
-usual.
-
-   At many view angles the voxel grid points will occlude each other or
-create Moiré artifacts on the display.  These effects can be avoided by
-introducing jitter so that the displayed dot or point is displaced
-randomly from the true voxel grid coordinate.  See *note jitter::.
-
-   Dense voxel grids can be down-sampled by using the 'pointinterval'
-property ('pi' for short) to reduce the number of points drawn.
-          splot $vgrid with points pointtype 6 pointinterval 2
-
-
-   *note isosurface:: will create a tessellated surface in 3D enclosing
-all voxels with value greater than the requested threshold.  The surface
-placement is adjusted by linear interpolation to pass through the
-threshold value itself.
-
-   See *note vgrid::, *note vfill::.  See demos 'vplot.dem',
-'isosurface.dem'.
-
-
-File: gnuplot.info,  Node: stats_(Statistical_Summary),  Next: system_,  Prev: splot,  Up: Commands
-
-3.37 stats (Statistical Summary)
-================================
-
-Syntax:
-          stats {<ranges>} 'filename' {matrix | using N{:M}} {name 'prefix'} {{no}output}
-          stats $voxelgridname {name 'prefix'}
-
-
-   This command prepares a statistical summary of the data in one or two
-columns of a file.  The using specifier is interpreted in the same way
-as for plot commands.  See 'plot' for details on the *note index::,
-*note every::, and 'using' directives.  Data points are filtered against
-both xrange and yrange before analysis.  See *note xrange::.  The
-summary is printed to the screen by default.  Output can be redirected
-to a file by prior use of the command 'set print', or suppressed
-altogether using the 'nooutput' option.
-
-   If the file cannot be found or cannot be read, a non-fatal warning is
-issued.  This can be used to test for the existence of a file without
-generating a program error.  See 'stats test'.
-
-   In addition to printed output, the program stores the individual
-statistics into three sets of variables.  The first set of variables
-reports how the data is laid out in the file.  The array of column
-headers is generated only if option *note columnheaders:: is in effect:
-
-          STATS_records           # total number N of in-range data records
-          STATS_outofrange        # number of records filtered out by range limits
-          STATS_invalid           # number of invalid/incomplete/missing records
-          STATS_blank             # number of blank lines in the file
-          STATS_blocks            # number of indexable blocks of data in the file
-          STATS_columns           # number of data columns in the first row of data
-          STATS_column_header     # array of strings holding column headers found
-
-
-   The second set reports properties of the in-range data from a single
-column.  This column is treated as y.  If the y axis is autoscaled then
-no range limits are applied.  Otherwise only values in the range
-[ymin:ymax] are considered.
-
-   If two columns are analysed jointly by a single 'stats' command, the
-suffix "_x" or "_y" is appended to each variable name.  I.e.
-STATS_min_x is the minimum value found in the first column, while
-STATS_min_y is the minimum value found in the second column.  In this
-case points are filtered by testing against both xrange and yrange.
-
-          STATS_min               # minimum value of in-range data points
-          STATS_max               # maximum value of in-range data points
-          STATS_index_min         # index i for which data[i] == STATS_min
-          STATS_index_max         # index i for which data[i] == STATS_max
-          STATS_lo_quartile       # value of the lower (1st) quartile boundary
-          STATS_median            # median value
-          STATS_up_quartile       # value of the upper (3rd) quartile boundary
-          STATS_mean              # mean value of the in-range data points
-          STATS_ssd               # sample standard deviation of the in-range data
-                                       = sqrt( Sum[(y-ymean)^2] / (N-1) )
-          STATS_stddev            # population standard deviation of the in-range data
-                                       = sqrt( Sum[(y-ymean)^2] / N )
-          STATS_sum               # sum
-          STATS_sumsq             # sum of squares
-          STATS_skewness          # skewness of the in-range data points
-          STATS_kurtosis          # kurtosis of the in-range data points
-          STATS_adev              # mean absolute deviation of the in-range data points
-          STATS_mean_err          # standard error of the mean value
-          STATS_stddev_err        # standard error of the standard deviation
-          STATS_skewness_err      # standard error of the skewness
-          STATS_kurtosis_err      # standard error of the kurtosis
-
-
-   The third set of variables is only relevant to analysis of two data
-columns.
-
-          STATS_correlation       # sample correlation coefficient between x and y values
-          STATS_slope             # A corresponding to a linear fit y = Ax + B
-          STATS_slope_err         # uncertainty of A
-          STATS_intercept         # B corresponding to a linear fit y = Ax + B
-          STATS_intercept_err     # uncertainty of B
-          STATS_sumxy             # sum of x*y
-          STATS_pos_min_y         # x coordinate of a point with minimum y value
-          STATS_pos_max_y         # x coordinate of a point with maximum y value
-
-
-   Keyword *note matrix:: indicates that the input consists of a matrix
-(see *note matrix::); the usual statistics are generated by considering
-all matrix elements.  The matrix dimensions are saved in variables
-STATS_size_x and STATS_size_y.
-
-          STATS_size_x            # number of matrix columns
-          STATS_size_y            # number of matrix rows
-
-
-   The index reported in STATS_index_xxx corresponds to the value of
-pseudo-column 0 ($0) in plot commands.  I.e.  the first point has index
-0, the last point has index N-1.
-
-   Data values are sorted to find the median and quartile boundaries.
-If the total number of points N is odd, then the median value is taken
-as the value of data point (N+1)/2.  If N is even, then the median is
-reported as the mean value of points N/2 and (N+2)/2.  Equivalent
-treatment is used for the quartile boundaries.
-
-   For an example of using the 'stats' command to annotate a subsequent
-plot, see stats.dem.  (http://www.gnuplot.info/demo/stats.html)
-
-   The 'stats' command in this version of gnuplot can handle log-scaled
-data, but not the content of time/date fields ('set xdata time' or 'set
-ydata time').  This restriction may be relaxed in a future version.
-
-* Menu:
-
-* name::
-* test_for_existence_of_a_file::
-* voxelgrid::
-
-
-File: gnuplot.info,  Node: name,  Next: test_for_existence_of_a_file,  Prev: stats_(Statistical_Summary),  Up: stats_(Statistical_Summary)
-
-3.37.1 name
------------
-
-It may be convenient to track the statistics from more than one file or
-data column in parallel.  The *note name:: option causes the default
-prefix "STATS" to be replaced by a user-specified string.  For example,
-the mean value of column 2 data from two different files could be
-compared by
-          stats "file1.dat" using 2 name "A"
-          stats "file2.dat" using 2 name "B"
-          if (A_mean < B_mean) {...}
-
-
-   Instead of providing a string constant as the name, the keyword
-'columnheader' or function 'columnheader(N)' can be used to generate the
-name from whatever string is found in that column in the first row of
-the data file:
-          do for [COL=5:8] { stats 'datafile' using COL name columnheader }
-
-
-
-File: gnuplot.info,  Node: test_for_existence_of_a_file,  Next: voxelgrid,  Prev: name,  Up: stats_(Statistical_Summary)
-
-3.37.2 test for existence of a file
------------------------------------
-
-Trying to plot a nonexistent or unreadable file will generate an error
-that halts the progress of a script or iteration.  The stats command can
-be used to avoid this as in the example below
-          do for [i=first:last] {
-              filename = sprintf("file%02d.dat", i)
-              stats filename nooutput
-              if (GPVAL_ERRNO) {
-                  print GPVAL_ERRMSG
-                  continue
-              }
-              plot filename title filename
-          }
-
-
-
-File: gnuplot.info,  Node: voxelgrid,  Prev: test_for_existence_of_a_file,  Up: stats_(Statistical_Summary)
-
-3.37.3 voxelgrid
-----------------
-
-          stats $vgridname {name "prefix"}
-
-   The stats command can be used to interrogate the content of a voxel
-grid.  It yields the same information as *note vgrid:: but saves it in
-variables accessible for use in a script.
-
-          STATS_min               # minimum non-zero value over all voxels in grid
-          STATS_max               # maximum value over all voxels in grid
-          STATS_mean              # mean value of non-zero voxels in grid
-          STATS_stderr            # standard deviation of non-zero voxel values
-          STATS_sum               # sum over all values in grid
-          STATS_nonzero           # number of non-zero voxels
-
-
-
-File: gnuplot.info,  Node: system_,  Next: test,  Prev: stats_(Statistical_Summary),  Up: Commands
-
-3.38 system
-===========
-
-Syntax:
-           system "command string"
-           ! command string
-           output = system("command string")
-           show variable GPVAL_SYSTEM
-
-
-   'system "command"' executes "command" in a subprocess by invoking the
-operating system's default shell.  If called as a function,
-'system("command")' returns the character stream from the subprocess's
-stdout as a string.  One trailing newline is stripped from the resulting
-string if present.  See also 'backquotes'.
-
-   The exit status of the subprocess is reported in variables
-GPVAL_SYSTEM_ERRNO and GPVAL_SYSTEM_ERRMSG. Note that if the command
-string invokes more than one programs, the subprocess may return
-"Success" even if one of the programs produced an error.  E.g.  file =
-system("ls -1 *.plt | tail -1") will return "Success" even if there are
-no *.plt files because 'tail' succeeds even if 'ls' does not.
-
-
-File: gnuplot.info,  Node: test,  Next: toggle,  Prev: system_,  Up: Commands
-
-3.39 test
-=========
-
-This command graphically tests or presents terminal and palette
-capabilities.
-
-   Syntax:
-           test {terminal | palette}
-
-
-   'test' or *note terminal:: creates a display of line and point styles
-and other useful things supported by the *note terminal:: you are
-currently using.
-
-   *note palette:: plots profiles of R(z),G(z),B(z), where 0<=z<=1.
-These are the RGB components of the current color palette as defined by
-*note palette::.  It also plots the apparent net intensity as calculated
-using NTSC coefficients to map RGB onto a grayscale.  The command also
-loads the profile values into a datablock named $PALETTE. D viridis 1
-
-
-File: gnuplot.info,  Node: toggle,  Next: undefine,  Prev: test,  Up: Commands
-
-3.40 toggle
-===========
-
-Syntax:
-           toggle {<plotno> | "plottitle" | all}
-
-
-   This command has the same effect as left-clicking on the key entry
-for a plot currently displayed by an interactive terminal (qt, wxt,
-x11).  If the plot is showing, it is toggled off; if it is currently
-hidden, it is toggled on.  'toggle all' acts on all active plots,
-equivalent to the hotkey "i".  'toggle "title"' requires an exact match
-to the plot title.  'toggle "ti*"' acts on the first plot whose title
-matches the characters before the final '*'.  If the current terminal is
-not interactive, the toggle command has no effect.
-
-
-File: gnuplot.info,  Node: undefine,  Next: unset,  Prev: toggle,  Up: Commands
-
-3.41 undefine
-=============
-
-Clear one or more previously defined user variables.  This is useful in
-order to reset the state of a script containing an initialization test.
-
-   A variable name can contain the wildcard character '*' as last
-character.  If the wildcard character is found, all variables with names
-that begin with the prefix preceding the wildcard will be removed.  This
-is useful to remove several variables sharing a common prefix.  Note
-that the wildcard character is only allowed at the end of the variable
-name!  Specifying the wildcard character as sole argument to 'undefine'
-has no effect.
-
-   Example:
-
-           undefine foo foo1 foo2
-           if (!exists("foo")) load "initialize.gp"
-
-
-           bar = 1; bar1 = 2; bar2 = 3
-           undefine bar*                 # removes all three variables
-
-
-
-File: gnuplot.info,  Node: unset,  Next: update,  Prev: undefine,  Up: Commands
-
-3.42 unset
-==========
-
-Options set using the 'set' command may be returned to their default
-state by the corresponding *note unset:: command.  The *note unset::
-command may contain an optional iteration clause.  See 'plot for'.
-
-   Examples:
-           set xtics mirror rotate by -45 0,10,100
-           ...
-           unset xtics
-
-
-           # Unset labels numbered between 100 and 200
-           unset for [i=100:200] label i
-
-
-* Menu:
-
-* linetype_::
-* monochrome_::
-* output_::
-* terminal_::
-* warnings::
-
-
-File: gnuplot.info,  Node: linetype_,  Next: monochrome_,  Prev: unset,  Up: unset
-
-3.42.1 linetype
----------------
-
-Syntax:
-           unset linetype N
-
-   Remove all characteristics previously associated with a single
-linetype.  Subsequent use of this linetype will use whatever
-characteristics and color that is native to the current terminal type
-(i.e.  the default linetypes properties available in gnuplot versions
-prior to 4.6).
-
-
-File: gnuplot.info,  Node: monochrome_,  Next: output_,  Prev: linetype_,  Up: unset
-
-3.42.2 monochrome
------------------
-
-Switches the active set of linetypes from monochrome to color.
-Equivalent to 'set color'.
-
-
-File: gnuplot.info,  Node: output_,  Next: terminal_,  Prev: monochrome_,  Up: unset
-
-3.42.3 output
--------------
-
-Because some terminal types allow multiple plots to be written into a
-single output file, the output file is not automatically closed after
-plotting.  In order to print or otherwise use the file safely, it should
-first be closed explicitly by using *note output:: or by using *note
-output:: to close the previous file and then open a new one.
-
-
-File: gnuplot.info,  Node: terminal_,  Next: warnings,  Prev: output_,  Up: unset
-
-3.42.4 terminal
----------------
-
-The default terminal that is active at the time of program entry depends
-on the system platform, gnuplot build options, and the environmental
-variable GNUTERM. Whatever this default may be, gnuplot saves it to
-internal variable GNUTERM. The *note terminal:: command restores the
-initial terminal type.  It is equivalent to 'set terminal GNUTERM'.
-However if the string in GNUTERM contains terminal options in addition
-to the bare terminal name, you may want to instead use 'set terminal
-@GNUTERM'.
-
-
-File: gnuplot.info,  Node: warnings,  Prev: terminal_,  Up: unset
-
-3.42.5 warnings
----------------
-
-          set warnings
-          unset warnings
-
-
-   Warning messages for non-fatal errors are normally printed to stderr
-after echoing the file name, line number, and command line that
-triggered the warning.  Warnings may be suppressed by the command *note
-warnings::.  A warning may be generated on demand by the command 'warn
-"message"'.  They remain suppressed until explicitly reenabled by *note
-warnings::.
-
-
-File: gnuplot.info,  Node: update,  Next: vclear,  Prev: unset,  Up: Commands
-
-3.43 update
-===========
-
-Note: This command is DEPRECATED. Use *note fit:: instead.
-
-
-File: gnuplot.info,  Node: vclear,  Next: vfill,  Prev: update,  Up: Commands
-
-3.44 vclear
-===========
-
-Syntax:
-          vclear {$gridname}
-
-   Resets the value of all voxels in an existing grid to zero.  If no
-grid name is given, clears the currently active grid.
-
-
-File: gnuplot.info,  Node: vfill,  Next: warn,  Prev: vclear,  Up: Commands
-
-3.45 vfill
-==========
-
-Syntax:
-          vfill  FILE using x:y:z:radius:(<expression>)
-          vgfill FILE using x:y:z:radius:(<expression>)
-
-
-   The *note vfill:: command acts analogously to a 'plot' command except
-that instead of creating a plot it modifies voxels in the currently
-active voxel grid.  For each point read from the input file, the voxel
-containing that point and also all other voxels within a sphere of given
-radius centered about (x,y,z) are incremented as follows:
-   * user variable VoxelDistance is set to the distance from (x,y,z) to
-     that voxel's origin in user coordinates (vx,vy,vz).
-   * user variable GridDistance is set to the distance from (x,y,z) to
-     that voxel's origin in grid coordinates.
-   * The expression provided in the 5th 'using' specifier is evaluated.
-     This expression can use the new value of VoxelDistance and/or
-     GridDistance.
-   * voxel(vx,vy,vz) += result of evaluating <expression>
-   Examples:
-          vfill "file.dat" using 1:2:3:(3.0):(1.0)
-
-   This command adds 1 to the value of every voxel within a sphere of
-radius 3.0 around each point in file.dat.  The number of voxels that
-this sphere impinges on depends on the grid spacing in user coordinates,
-which may be different along the x, y, and z directions.
-
-          vgfill "file.dat" using 1:2:3:(2):(1.0)
-
-   This command adds 1 to the value of voxels within a 5x5x5 cube of
-voxels centered on the current point.  The radius "2" is interpreted as
-extending exactly 2 voxels in either direction along x, 2 voxels in
-either direction along y, etc, regardless of the relative scaling of
-user coordinates along those axes.
-
-   Example:
-          vfill "file.dat" using 1:2:3:4:(VoxelDistance < 1 ? 1 : 1/VoxelDistance)
-
-   This command modifies all voxels in a sphere whose radius is
-determined for each point by the content of column 4.  The increment
-added to a voxel decreases with its distance from the data point.
-
-   Note that *note vfill:: and 'vgfill' always increments existing
-values in the current voxel grid.  To reset a single voxel to zero, use
-'voxel(x,y,z) = 0'.  To reset the entire grid to zero, use *note
-vclear::.
-
-
-File: gnuplot.info,  Node: warn,  Next: While,  Prev: vfill,  Up: Commands
-
-3.46 warn
-=========
-
-Syntax:
-           warn "message"
-
-   The 'warn' command is essentially the same as *note printerr:: except
-that it prepends the current filename or function block name and the
-current line number before printing the requested message to stderr.
-Unlike *note printerr:: the output from 'warn' is suppressed by *note
-warnings::.
-
-
-File: gnuplot.info,  Node: While,  Prev: warn,  Up: Commands
-
-3.47 While
-==========
-
-Syntax:
-           while (<expr>) {
-               <commands>
-           }
-
-   Execute a block of commands repeatedly so long as <expr> evaluates to
-a non-zero value.  This command cannot be mixed with old-style
-(un-bracketed) if/else statements.  See also 'do', 'continue', 'break'.
-
-
-File: gnuplot.info,  Node: Terminal_types,  Next: Concept_Index,  Prev: Commands,  Up: Top
-
-4 Terminal types
-****************
-
-* Menu:
-
-* complete_list_of_terminals::
-
-
-File: gnuplot.info,  Node: complete_list_of_terminals,  Prev: Terminal_types,  Up: Terminal_types
-
-4.1 complete list of terminals
-==============================
-
-Gnuplot supports a large number of output formats.  These are selected
-by choosing an appropriate terminal type, possibly with additional
-modifying options.  See *note terminal::.
-
-   This document may describe terminal types that are not available to
-you because they were not configured or installed on your system.
-Terminals marked 'legacy' are not built by default in recent gnuplot
-versions and may not actually work.  To see a list of terminals
-available in a particular gnuplot session, type 'set terminal' with no
-modifiers.
-
-   Several terminals are designed for use with TeX/LaTeX document
-preparation.  A summary of TeX-friendly terminals is available here:
-http://www.gnuplot.info/docs/latex_demo.pdf
-(http://www.gnuplot.info/docs/latex_demo.pdf)
-
-* Menu:
-
-* aifm::
-* aqua::
-* be::
-* epscairo::
-* canvas::
-* cgm::
-* context::
-* corel::
-* debug::
-* svga::
-* dumb::
-* dxf::
-* dxy800a::
-* eepic::
-* emf::
-* epson_180dpi::
-* excl::
-* fig::
-* png_::
-* ggi::
-* gpic::
-* grass::
-* hp2623a::
-* hp2648::
-* hp500c::
-* hpgl::
-* hpljii::
-* hppj::
-* imagen::
-* kyo::
-* latex::
-* lua::
-* mf::
-* mp::
-* mif::
-* pbm::
-* dospc::
-* pdf::
-* pstricks::
-* qms::
-* regis::
-* svg::
-* tek410x::
-* tek40::
-* texdraw::
-* tgif::
-* tkcanvas::
-* tpic::
-* windows::
-* wxt::
-* x11::
-* xlib::
-
-
-File: gnuplot.info,  Node: aifm,  Next: aqua,  Prev: complete_list_of_terminals,  Up: complete_list_of_terminals
-
-4.1.1 aifm
-----------
-
-*note terminal::, originally written for Adobe Illustrator 3.0+.  Since
-Adobe Illustrator understands PostScript level 1 commands directly, you
-should use 'set terminal post level1' instead.
-
-   Syntax:
-           set terminal aifm {color|monochrome} {"<fontname>"} {<fontsize>}
-
-
-
-File: gnuplot.info,  Node: aqua,  Next: be,  Prev: aifm,  Up: complete_list_of_terminals
-
-4.1.2 aqua
-----------
-
-This terminal relies on AquaTerm.app for display on MacOS.
-
-   Syntax:
-           set terminal aqua {<n>} {title "<wintitle>"} {size <x> <y>}
-                             {font "<fontname>{,<fontsize>}"}
-                             {linewidth <lw>}"}
-                             {{no}enhanced} {solid|dashed} {dl <dashlength>}}
-
-
-   where <n> is the number of the window to draw in (default is 0),
-<wintitle> is the name shown in the title bar (default "Figure <n>"),
-<x> <y> is the size of the plot (default is 846x594 pt = 11.75x8.25 in).
-
-   Use <fontname> to specify the font (default is "Times-Roman"), and
-<fontsize> to specify the font size (default is 14.0 pt).
-
-   The aqua terminal supports enhanced text mode (see 'enhanced'),
-except for overprint.  Font support is limited to the fonts available on
-the system.  Character encoding can be selected by *note encoding:: and
-currently supports iso_latin_1, iso_latin_2, cp1250, and UTF8 (default).
-
-   Lines can be drawn either solid or dashed, (default is solid) and the
-dash spacing can be modified by <dashlength> which is a multiplier > 0.
-
-
-File: gnuplot.info,  Node: be,  Next: epscairo,  Prev: aqua,  Up: complete_list_of_terminals
-
-4.1.3 be
---------
-
-The 'be' terminal type is present if gnuplot is built for the 'beos'
-operating system and for use with X servers.  It is selected at program
-startup if the 'DISPLAY' environment variable is set, if the 'TERM'
-environment variable is set to 'xterm', or if the '-display' command
-line option is used.
-
-   Syntax:
-               set terminal be {reset} {<n>}
-
-
-   Multiple plot windows are supported: 'set terminal be <n>' directs
-the output to plot window number n.  If n>0, the terminal number will be
-appended to the window title and the icon will be labeled 'gplt <n>'.
-The active window may distinguished by a change in cursor (from default
-to crosshair.)
-
-   Plot windows remain open even when the 'gnuplot' driver is changed to
-a different device.  A plot window can be closed by pressing the letter
-q while that window has input focus, or by choosing 'close' from a
-window manager menu.  All plot windows can be closed by specifying *note
-reset::, which actually terminates the subprocess which maintains the
-windows (unless '-persist' was specified).
-
-   Plot windows will automatically be closed at the end of the session
-unless the '-persist' option was given.
-
-   The size or aspect ratio of a plot may be changed by resizing the
-'gnuplot' window.
-
-   Linewidths and pointsizes may be changed from within 'gnuplot' with
-'set linestyle'.
-
-   For terminal type 'be', 'gnuplot' accepts (when initialized) the
-standard X Toolkit options and resources such as geometry, font, and
-name from the command line arguments or a configuration file.  See the
-X(1) man page (or its equivalent) for a description of such options.
-
-   A number of other 'gnuplot' options are available for the 'be'
-terminal.  These may be specified either as command-line options when
-'gnuplot' is invoked or as resources in the configuration file
-".Xdefaults".  They are set upon initialization and cannot be altered
-during a 'gnuplot' session.
-
-* Menu:
-
-* command-line_options::
-* monochrome_options::
-* color_resources::
-* grayscale_resources::
-* line_resources::
-
-
-File: gnuplot.info,  Node: command-line_options,  Next: monochrome_options,  Prev: be,  Up: be
-
-4.1.3.1 command-line_options
-............................
-
-In addition to the X Toolkit options, the following options may be
-specified on the command line when starting 'gnuplot' or as resources in
-your ".Xdefaults" file:
-
-      `-mono`        forces monochrome rendering on color displays.
-      `-gray`        requests grayscale rendering on grayscale or color displays.
-                             (Grayscale displays receive monochrome rendering by default.)
-      `-clear`   requests that the window be cleared momentarily before a
-                             new plot is displayed.
-      `-raise`   raises plot window after each plot
-      `-noraise` does not raise plot window after each plot
-      `-persist` plots windows survive after main gnuplot program exits
-
-
-   The options are shown above in their command-line syntax.  When
-entered as resources in ".Xdefaults", they require a different syntax.
-
-   Example:
-               gnuplot*gray: on
-
-
-   'gnuplot' also provides a command line option ('-pointsize <v>') and
-a resource, 'gnuplot*pointsize: <v>', to control the size of points
-plotted with the 'points' plotting style.  The value 'v' is a real
-number (greater than 0 and less than or equal to ten) used as a scaling
-factor for point sizes.  For example, '-pointsize 2' uses points twice
-the default size, and '-pointsize 0.5' uses points half the normal size.
-
-
-File: gnuplot.info,  Node: monochrome_options,  Next: color_resources,  Prev: command-line_options,  Up: be
-
-4.1.3.2 monochrome_options
-..........................
-
-For monochrome displays, 'gnuplot' does not honor foreground or
-background colors.  The default is black-on-white.  '-rv' or
-'gnuplot*reverseVideo: on' requests white-on-black.
-
-
-File: gnuplot.info,  Node: color_resources,  Next: grayscale_resources,  Prev: monochrome_options,  Up: be
-
-4.1.3.3 color_resources
-.......................
-
-For color displays, 'gnuplot' honors the following resources (shown here
-with their default values) or the greyscale resources.  The values may
-be color names as listed in the BE rgb.txt file on your system,
-hexadecimal RGB color specifications (see BE documentation), or a color
-name followed by a comma and an 'intensity' value from 0 to 1.  For
-example, 'blue, 0.5' means a half intensity blue.
-
-      gnuplot*background:  white
-      gnuplot*textColor:   black
-      gnuplot*borderColor: black
-      gnuplot*axisColor:   black
-      gnuplot*line1Color:  red
-      gnuplot*line2Color:  green
-      gnuplot*line3Color:  blue
-      gnuplot*line4Color:  magenta
-      gnuplot*line5Color:  cyan
-      gnuplot*line6Color:  sienna
-      gnuplot*line7Color:  orange
-      gnuplot*line8Color:  coral
-
-
-   The command-line syntax for these is, for example,
-
-   Example:
-               gnuplot -background coral
-
-
-
-File: gnuplot.info,  Node: grayscale_resources,  Next: line_resources,  Prev: color_resources,  Up: be
-
-4.1.3.4 grayscale_resources
-...........................
-
-When '-gray' is selected, 'gnuplot' honors the following resources for
-grayscale or color displays (shown here with their default values).
-Note that the default background is black.
-
-      gnuplot*background: black
-      gnuplot*textGray:   white
-      gnuplot*borderGray: gray50
-      gnuplot*axisGray:   gray50
-      gnuplot*line1Gray:  gray100
-      gnuplot*line2Gray:  gray60
-      gnuplot*line3Gray:  gray80
-      gnuplot*line4Gray:  gray40
-      gnuplot*line5Gray:  gray90
-      gnuplot*line6Gray:  gray50
-      gnuplot*line7Gray:  gray70
-      gnuplot*line8Gray:  gray30
-
-
-
-File: gnuplot.info,  Node: line_resources,  Prev: grayscale_resources,  Up: be
-
-4.1.3.5 line_resources
-......................
-
-'gnuplot' honors the following resources for setting the width (in
-pixels) of plot lines (shown here with their default values.)  0 or 1
-means a minimal width line of 1 pixel width.  A value of 2 or 3 may
-improve the appearance of some plots.
-
-      gnuplot*borderWidth: 2
-      gnuplot*axisWidth:   0
-      gnuplot*line1Width:  0
-      gnuplot*line2Width:  0
-      gnuplot*line3Width:  0
-      gnuplot*line4Width:  0
-      gnuplot*line5Width:  0
-      gnuplot*line6Width:  0
-      gnuplot*line7Width:  0
-      gnuplot*line8Width:  0
-
-
-   'gnuplot' honors the following resources for setting the dash style
-used for plotting lines.  0 means a solid line.  A two-digit number 'jk'
-('j' and 'k' are >= 1 and <= 9) means a dashed line with a repeated
-pattern of 'j' pixels on followed by 'k' pixels off.  For example, '16'
-is a "dotted" line with one pixel on followed by six pixels off.  More
-elaborate on/off patterns can be specified with a four-digit value.  For
-example, '4441' is four on, four off, four on, one off.  The default
-values shown below are for monochrome displays or monochrome rendering
-on color or grayscale displays.  For color displays, the default for
-each is 0 (solid line) except for 'axisDashes' which defaults to a '16'
-dotted line.
-
-      gnuplot*borderDashes:   0
-      gnuplot*axisDashes:        16
-      gnuplot*line1Dashes:        0
-      gnuplot*line2Dashes:   42
-      gnuplot*line3Dashes:   13
-      gnuplot*line4Dashes:   44
-      gnuplot*line5Dashes:   15
-      gnuplot*line6Dashes: 4441
-      gnuplot*line7Dashes:   42
-      gnuplot*line8Dashes:   13
-
-
-
-File: gnuplot.info,  Node: epscairo,  Next: canvas,  Prev: be,  Up: complete_list_of_terminals
-
-4.1.4 epscairo
---------------
-
-The 'epscairo' terminal device generates encapsulated PostScript (*.eps)
-using the cairo and pango support libraries.  cairo version >= 1.6 is
-required.
-
-   Please read the help for the 'pdfcairo' terminal."
-
-
-File: gnuplot.info,  Node: canvas,  Next: cgm,  Prev: epscairo,  Up: complete_list_of_terminals
-
-4.1.5 canvas
-------------
-
-The 'canvas' terminal creates a set of javascript commands that draw
-onto the HTML5 canvas element.  Syntax:
-           set terminal canvas {size <xsize>, <ysize>} {background <rgb_color>}
-                               {font {<fontname>}{,<fontsize>}} | {fsize <fontsize>}
-                               {{no}enhanced} {linewidth <lw>}
-                               {rounded | butt | square}
-                               {dashlength <dl>}
-                               {standalone {mousing} | name '<funcname>'}
-                               {jsdir 'URL/for/javascripts'}
-                               {title '<some string>'}
-
-
-   where <xsize> and <ysize> set the size of the plot area in pixels.
-The default size in standalone mode is 600 by 400 pixels.  The default
-font size is 10.
-
-   NB: Only one font is available, the ascii portion of Hershey simplex
-Roman provided in the file canvastext.js.  You can replace this with the
-file canvasmath.js, which contains also UTF-8 encoded Hershey simplex
-Greek and math symbols.  For consistency with other terminals, it is
-also possible to use 'font "name,size"'.  Currently the font *note
-name:: is ignored, but browser support for named fonts is likely to
-arrive eventually.
-
-   The default 'standalone' mode creates an html page containing
-javascript code that renders the plot using the HTML 5 canvas element.
-The html page links to two required javascript files 'canvastext.js' and
-'gnuplot_common.js'.  An additional file 'gnuplot_dashedlines.js' is
-needed to support dashed lines.  By default these point to local files,
-on unix-like systems usually in directory
-/usr/local/share/gnuplot/<version>/js.  See installation notes for other
-platforms.  You can change this by using the 'jsdir' option to specify
-either a different local directory or a general URL. The latter is
-usually appropriate if the plot is exported for viewing on remote client
-machines.
-
-   All plots produced by the canvas terminal are mouseable.  The
-additional keyword 'mousing' causes the 'standalone' mode to add a
-mouse-tracking box underneath the plot.  It also adds a link to a
-javascript file 'gnuplot_mouse.js' and to a stylesheet for the mouse box
-'gnuplot_mouse.css' in the same local or URL directory as
-'canvastext.js'.
-
-   The *note name:: option creates a file containing only javascript.
-Both the javascript function it contains and the id of the canvas
-element that it draws onto are taken from the following string
-parameter.  The commands
-           set term canvas name 'fishplot'
-           set output 'fishplot.js'
-
-   will create a file containing a javascript function fishplot() that
-will draw onto a canvas with id=fishplot.  An html page that invokes
-this javascript function must also load the canvastext.js function as
-described above.  A minimal html file to wrap the fishplot created above
-might be:
-
-           <html>
-           <head>
-               <script src="canvastext.js"></script>
-               <script src="gnuplot_common.js"></script>
-           </head>
-           <body onload="fishplot();">
-               <script src="fishplot.js"></script>
-               <canvas id="fishplot" width=600 height=400>
-                   <div id="err_msg">No support for HTML 5 canvas element</div>
-               </canvas>
-           </body>
-           </html>
-
-
-   The individual plots drawn on this canvas will have names
-fishplot_plot_1, fishplot_plot_2, and so on.  These can be referenced by
-external javascript routines, for example
-gnuplot.toggle_visibility("fishplot_plot_2").
-
-
-File: gnuplot.info,  Node: cgm,  Next: context,  Prev: canvas,  Up: complete_list_of_terminals
-
-4.1.6 cgm
----------
-
-The 'cgm' terminal generates a Computer Graphics Metafile, Version 1.
-This file format is a subset of the ANSI X3.122-1986 standard entitled
-"Computer Graphics - Metafile for the Storage and Transfer of Picture
-Description Information".
-
-   Syntax:
-           set terminal cgm {color | monochrome} {solid | dashed} {{no}rotate}
-                            {<mode>} {width <plot_width>} {linewidth <line_width>}
-                            {font "<fontname>,<fontsize>"}
-                            {background <rgb_color>}
-       [deprecated]         {<color0> <color1> <color2> ...}
-
-
-   'solid' draws all curves with solid lines, overriding any dashed
-patterns; <mode> is 'landscape', 'portrait', or 'default'; <plot_width>
-is the assumed width of the plot in points; <line_width> is the line
-width in points (default 1); <fontname> is the name of a font (see list
-of fonts below) <fontsize> is the size of the font in points (default
-12).
-
-   The first six options can be in any order.  Selecting 'default' sets
-all options to their default values.
-
-   The mechanism of setting line colors in the 'set term' command is
-deprecated.  Instead you should set the background using a separate
-keyword and set the line colors using 'set linetype'.  The deprecated
-mechanism accepted colors of the form 'xrrggbb', where x is the literal
-character 'x' and 'rrggbb' are the red, green and blue components in
-hex.  The first color was used for the background, subsequent colors are
-assigned to successive line types.
-
-   Examples:
-           set terminal cgm landscape color rotate dashed width 432 \\
-                          linewidth 1  'Helvetica Bold' 12       # defaults
-           set terminal cgm linewidth 2  14  # wider lines & larger font
-           set terminal cgm portrait "Times Italic" 12
-           set terminal cgm color solid      # no pesky dashes!
-
-
-* Menu:
-
-* cgm_font::
-* cgm_fontsize::
-* cgm_linewidth::
-* cgm_rotate::
-* cgm_solid::
-* cgm_size::
-* cgm_width::
-* cgm_nofontlist::
-
-
-File: gnuplot.info,  Node: cgm_font,  Next: cgm_fontsize,  Prev: cgm,  Up: cgm
-
-4.1.6.1 cgm font
-................
-
-The first part of a Computer Graphics Metafile, the metafile
-description, includes a font table.  In the picture body, a font is
-designated by an index into this table.  By default, this terminal
-generates a table with the following 35 fonts, plus six more with
-'italic' replaced by 'oblique', or vice-versa (since at least the
-Microsoft Office and Corel Draw CGM import filters treat 'italic' and
-'oblique' as equivalent):
-
-           Helvetica
-           Helvetica Bold
-           Helvetica Oblique
-           Helvetica Bold Oblique
-           Times Roman
-           Times Bold
-           Times Italic
-           Times Bold Italic
-           Courier
-           Courier Bold
-           Courier Oblique
-           Courier Bold Oblique
-           Symbol
-           Hershey/Cartographic_Roman
-           Hershey/Cartographic_Greek
-           Hershey/Simplex_Roman
-           Hershey/Simplex_Greek
-           Hershey/Simplex_Script
-           Hershey/Complex_Roman
-           Hershey/Complex_Greek
-           Hershey/Complex_Script
-           Hershey/Complex_Italic
-           Hershey/Complex_Cyrillic
-           Hershey/Duplex_Roman
-           Hershey/Triplex_Roman
-           Hershey/Triplex_Italic
-           Hershey/Gothic_German
-           Hershey/Gothic_English
-           Hershey/Gothic_Italian
-           Hershey/Symbol_Set_1
-           Hershey/Symbol_Set_2
-           Hershey/Symbol_Math
-           ZapfDingbats
-           Script
-           15
-
-
-   The first thirteen of these fonts are required for WebCGM. The
-Microsoft Office CGM import filter implements the 13 standard fonts
-listed above, and also 'ZapfDingbats' and 'Script'.  However, the script
-font may only be accessed under the name '15'.  For more on Microsoft
-import filter font substitutions, check its help file which you may find
-here:
-       C:\\Program Files\\Microsoft Office\\Office\\Cgmimp32.hlp
-
-   and/or its configuration file, which you may find here:
-       C:\\Program Files\\Common Files\\Microsoft Shared\\Grphflt\\Cgmimp32.cfg
-
-
-   In the 'set term' command, you may specify a font name which does not
-appear in the default font table.  In that case, a new font table is
-constructed with the specified font as its first entry.  You must ensure
-that the spelling, capitalization, and spacing of the name are
-appropriate for the application that will read the CGM file.  (Gnuplot
-and any MIL-D-28003A compliant application ignore case in font names.)
-If you need to add several new fonts, use several 'set term' commands.
-
-   Example:
-           set terminal cgm 'Old English'
-           set terminal cgm 'Tengwar'
-           set terminal cgm 'Arabic'
-           set output 'myfile.cgm'
-           plot ...
-           set output
-
-
-   You cannot introduce a new font in a 'set label' command.
-
-
-File: gnuplot.info,  Node: cgm_fontsize,  Next: cgm_linewidth,  Prev: cgm_font,  Up: cgm
-
-4.1.6.2 cgm fontsize
-....................
-
-Fonts are scaled assuming the page is 6 inches wide.  If the *note
-size:: command is used to change the aspect ratio of the page or the CGM
-file is converted to a different width, the resulting font sizes will be
-scaled up or down accordingly.  To change the assumed width, use the
-'width' option.
-
-
-File: gnuplot.info,  Node: cgm_linewidth,  Next: cgm_rotate,  Prev: cgm_fontsize,  Up: cgm
-
-4.1.6.3 cgm linewidth
-.....................
-
-The 'linewidth' option sets the width of lines in pt.  The default width
-is 1 pt.  Scaling is affected by the actual width of the page, as
-discussed under the 'fontsize' and 'width' options.
-
-
-File: gnuplot.info,  Node: cgm_rotate,  Next: cgm_solid,  Prev: cgm_linewidth,  Up: cgm
-
-4.1.6.4 cgm rotate
-..................
-
-The 'norotate' option may be used to disable text rotation.  For
-example, the CGM input filter for Word for Windows 6.0c can accept
-rotated text, but the DRAW editor within Word cannot.  If you edit a
-graph (for example, to label a curve), all rotated text is restored to
-horizontal.  The Y axis label will then extend beyond the clip boundary.
-With 'norotate', the Y axis label starts in a less attractive location,
-but the page can be edited without damage.  The 'rotate' option confirms
-the default behavior.
-
-
-File: gnuplot.info,  Node: cgm_solid,  Next: cgm_size,  Prev: cgm_rotate,  Up: cgm
-
-4.1.6.5 cgm solid
-.................
-
-The 'solid' option may be used to disable dashed line styles in the
-plots.  This is useful when color is enabled and the dashing of the
-lines detracts from the appearance of the plot.  The 'dashed' option
-confirms the default behavior, which gives a different dash pattern to
-each line type.
-
-
-File: gnuplot.info,  Node: cgm_size,  Next: cgm_width,  Prev: cgm_solid,  Up: cgm
-
-4.1.6.6 cgm size
-................
-
-Default size of a CGM plot is 32599 units wide and 23457 units high for
-landscape, or 23457 units wide by 32599 units high for portrait.
-
-
-File: gnuplot.info,  Node: cgm_width,  Next: cgm_nofontlist,  Prev: cgm_size,  Up: cgm
-
-4.1.6.7 cgm width
-.................
-
-All distances in the CGM file are in abstract units.  The application
-that reads the file determines the size of the final plot.  By default,
-the width of the final plot is assumed to be 6 inches (15.24 cm).  This
-distance is used to calculate the correct font size, and may be changed
-with the 'width' option.  The keyword should be followed by the width in
-points.  (Here, a point is 1/72 inch, as in PostScript.  This unit is
-known as a "big point" in TeX.) Gnuplot 'expressions' can be used to
-convert from other units.
-
-   Example:
-           set terminal cgm width 432            # default
-           set terminal cgm width 6*72           # same as above
-           set terminal cgm width 10/2.54*72     # 10 cm wide
-
-
-
-File: gnuplot.info,  Node: cgm_nofontlist,  Prev: cgm_width,  Up: cgm
-
-4.1.6.8 cgm nofontlist
-......................
-
-The default font table includes the fonts recommended for WebCGM, which
-are compatible with the Computer Graphics Metafile input filter for
-Microsoft Office and Corel Draw.  Another application might use
-different fonts and/or different font names, which may not be
-documented.  The 'nofontlist' (synonym 'winword6') option deletes the
-font table from the CGM file.  In this case, the reading application
-should use a default table.  Gnuplot will still use its own default font
-table to select font indices.  Thus, 'Helvetica' will give you an index
-of 1, which should get you the first entry in your application's default
-font table.  'Helvetica Bold' will give you its second entry, etc.
-
-
-File: gnuplot.info,  Node: context,  Next: corel,  Prev: cgm,  Up: complete_list_of_terminals
-
-4.1.7 context
--------------
-
-ConTeXt is a macro package for TeX, highly integrated with Metapost (for
-drawing figures) and intended for creation of high-quality PDF
-documents.  The terminal outputs Metafun source, which can be edited
-manually, but you should be able to configure most things from outside.
-
-   For an average user of ConTeXt + gnuplot module it's recommended to
-refer to 'Using ConTeXt' rather than reading this page or to read the
-manual of the gnuplot module for ConTeXt.
-
-   The 'context' terminal supports the following options:
-
-   Syntax:
-          set term context {default}
-                  {defaultsize | size <scale> | size <xsize>{in|cm}, <ysize>{in|cm}}
-                  {input | standalone}
-                  {timestamp | notimestamp}
-                  {noheader | header "<header>"}
-                  {color | colour | monochrome}
-                  {rounded | mitered | beveled} {round | butt | squared}
-                  {dashed | solid} {dashlength | dl <dl>}
-                  {linewidth | lw <lw>}
-                  {fontscale <fontscale>}
-                  {mppoints | texpoints}
-                  {inlineimages | externalimages}
-                  {defaultfont | font "{<fontname>}{,<fontsize>}"}
-
-
-   In non-standalone ('input') graphic only parameters *note size:: to
-select graphic size, 'fontscale' to scale all the labels for a factor
-<fontscale> and font size, make sense, the rest is silently ignored and
-should be configured in the .tex file which inputs the graphic.  It's
-highly recommended to set the proper fontsize if document font differs
-from 12pt, so that gnuplot will know how much space to reserve for
-labels.
-
-   'default' resets all the options to their default values.
-
-   'defaultsize' sets the plot size to 5in,3in.  *note size:: <scale>
-sets the plot size to <scale> times <default value>.  If two arguments
-are given (separated with ','), the first one sets the horizontal size
-and the second one the vertical size.  Size may be given without units
-(in which case it means relative to the default value), with inches
-('in') or centimeters ('cm').
-
-   'input' (default) creates a graphic that can be included into another
-ConTeXt document.  'standalone' adds some lines, so that the document
-might be compiled as-is.  You might also want to add 'header' in that
-case.
-
-   Use 'header' for any additional settings/definitions/macros that you
-might want to include in a standalone graphic.  'noheader' is the
-default.
-
-   'notimestamp' prevents printing creation time in comments (if version
-control is used, one may prefer not to commit new version when only date
-changes).
-
-   'color' to make color plots is the default, but *note monochrome::
-doesn't do anything special yet.  If you have any good ideas how the
-behaviour should differ to suit the monochrome printers better, your
-suggestions are welcome.
-
-   'rounded' (default), 'mitered' and 'beveled' control the shape of
-line joins.  'round' (default), 'butt' and 'squared' control the shape
-of line caps.  See PostScript or PDF Reference Manual for explanation.
-For wild-behaving functions and thick lines it is better to use
-'rounded' and 'round' to prevent sharp corners in line joins.  (Some
-general support for this should be added to Gnuplot, so that the same
-options could be set for each line (style) separately).
-
-   'dashed' (default) uses different dash patterns for different line
-types, 'solid' draws all plots with solid lines.
-
-   'dashlength' or 'dl' scales the length of the dashed-line segments by
-<dl>.  'linewidth' or 'lw' scales all linewidths by <lw>.  (lw 1 stands
-for 0.5bp, which is the default line width when drawing with Metapost.)
-'fontscale' scales text labels for factor <fontscale> relative to
-default document font.
-
-   'mppoints' uses predefined point shapes, drawn in Metapost.
-'texpoints' uses easily configurable set of symbols, defined with
-ConTeXt in the following way:
-          \\defineconversion[my own points][+,{\\ss x},\\mathematics{\\circ}]
-          \\setupGNUPLOTterminal[context][points=tex,pointset=my own points]
-
-
-   'inlineimages' writes binary images to a string and only works in
-ConTeXt MKIV. 'externalimages' writes PNG files to disk and also works
-with ConTeXt MKII. Gnuplot needs to have support for PNG images built in
-for this to work.
-
-   With 'font' you can set font name and size in standalone graphics.
-In non-standalone ('input') mode only the font size is important to
-reserve enough space for text labels.  The command
-          set term context font "myfont,ss,10"
-
-   will result in
-          \\setupbodyfont[myfont,ss,10pt]
-
-   If you additionally set 'fontscale' to 0.8 for example, then the
-resulting font will be 8pt big and
-          set label ... font "myfont,12"
-
-   will come out as 9.6pt.
-
-   It is your own responsibility to provide proper typescripts (and
-header), otherwise switching the font will have no effect.  For a
-standard font in ConTeXt MKII (pdfTeX) you could use:
-          set terminal context standalone header '\\usetypescript[iwona][ec]' \\
-              font "iwona,ss,11"
-
-   Please take a look into ConTeXt documentation, wiki or mailing list
-(archives) for any up-to-date information about font usage.
-
-   Examples:
-          set terminal context size 10cm, 5cm     # 10cm, 5cm
-          set terminal context size 4in, 3in      # 4in, 3in
-
-   For standalone (whole-page) plots with labels in UTF-8 encoding:
-          set terminal context standalone header '\\enableregime[utf-8]'
-
-   , /* TODO: LaTeX formatting */
-
-* Menu:
-
-* Requirements::
-* Calling_gnuplot_from_ConTeXt::
-
-
-File: gnuplot.info,  Node: Requirements,  Next: Calling_gnuplot_from_ConTeXt,  Prev: context,  Up: context
-
-4.1.7.1 Requirements
-....................
-
-You need gnuplot module for ConTeXt http://ctan.org/pkg/context-gnuplot
-(http://ctan.org/pkg/context-gnuplot) and a recent version of ConTeXt.
-If you want to call gnuplot on-the-fly, you also need write18 enabled.
-In most TeX distributions this can be set with shell_escape=t in
-texmf.cnf.
-
-   See http://wiki.contextgarden.net/Gnuplot
-(http://wiki.contextgarden.net/Gnuplot) for details about this terminal
-and for more exhaustive help & examples.
-
-
-File: gnuplot.info,  Node: Calling_gnuplot_from_ConTeXt,  Prev: Requirements,  Up: context
-
-4.1.7.2 Calling gnuplot from ConTeXt
-....................................
-
-The easiest way to make plots in ConTeXt documents is
-          \\usemodule[gnuplot]
-          \\starttext
-          \\title{How to draw nice plots with {\\sc gnuplot}?}
-          \\startGNUPLOTscript[sin]
-          set format y "%.1f"
-          plot sin(x) t '$\\sin(x)$'
-          \\stopGNUPLOTscript
-          \\useGNUPLOTgraphic[sin]
-          \\stoptext
-
-   This will run gnuplot automatically and include the resulting figure
-in the document."
-
-
-File: gnuplot.info,  Node: corel,  Next: debug,  Prev: context,  Up: complete_list_of_terminals
-
-4.1.8 corel
------------
-
-Legacy terminal for CorelDraw (circa 1995).
-
-   Syntax:
-           set terminal corel {monochrome | color} {"<font>" {<fontsize>}}
-                              {<xsize> <ysize> {<linewidth> }}
-
-
-   where the fontsize and linewidth are specified in points and the
-sizes in inches.  The defaults are monochrome, "SwitzerlandLight", 22,
-8.2, 10 and 1.2."
-
-
-File: gnuplot.info,  Node: debug,  Next: svga,  Prev: corel,  Up: complete_list_of_terminals
-
-4.1.9 debug
------------
-
-This terminal is provided to allow for the debugging of 'gnuplot'.  It
-is likely to be of use only for users who are modifying the source
-code."
-
-
-File: gnuplot.info,  Node: svga,  Next: dumb,  Prev: debug,  Up: complete_list_of_terminals
-
-4.1.10 svga
------------
-
-Legacy terminal.  The 'svga' terminal driver supports PCs with SVGA
-graphics.  It is typically only compiled with DJGPP and uses the GRX
-graphics library.  There is also a variant for Windows 32bit, which is
-mainly used for debugging.  The underlying library also supports X11,
-Linux console and SDL, but these targets are currently not supported.
-
-   Syntax:
-           set terminal svga {font "<fontname>"}
-                             {{no}enhanced}
-                             {background <rgb color>}
-                             {linewidth|lw <lw>}
-                             {pointscale|ps <scale>}
-                             {fontscale|fs <scale>}
-
-
-   Enhanced text support can be activated using the 'enhanced' option, "
-see 'enhanced text'.  Note that changing the font size in enhanced text
-is currently not supported.  Hence, super- and subscripts will have the
-same size.
-
-   The 'linewidth' parameter scales the width of lines.  The
-'pointscale' parameter sets the scale factor for point symbols.  You can
-use 'fontscale' to scale the bitmap font.  This might be useful if you
-have a hi-res display.  Note that integer factors give best results."
-
-
-File: gnuplot.info,  Node: dumb,  Next: dxf,  Prev: svga,  Up: complete_list_of_terminals
-
-4.1.11 dumb
------------
-
-The 'dumb' terminal driver plots into a text block using ascii
-characters.  It has an optional size specification and a trailing
-linefeed flag.
-
-   Syntax:
-           set terminal dumb {size <xchars>,<ychars>} {[no]feed}
-                             {aspect <htic>{,<vtic>}}
-                             {[no]enhanced}
-                             {fillchar {solid|"<char>"}}
-                             {[no]attributes}
-                             {mono|ansi|ansi256|ansirgb}
-
-
-   where <xchars> and <ychars> set the size of the text block.  The
-default is 79 by 24.  The last newline is printed only if 'feed' is
-enabled.
-
-   The 'aspect' option can be used to control the aspect ratio of the
-plot by setting the length of the horizontal and vertical tic marks.
-Only integer values are allowed.  Default is 2,1 - corresponding to the
-aspect ratio of common screen fonts.
-
-   The character "#" is used for area-fill.  You can replace this with
-any character available in the terminal font.  'fillchar solid' is short
-for 'fillchar "\\U+2588"' (unicode FULL BLOCK).
-
-   The 'ansi', 'ansi256', and 'ansirgb' options will include escape
-sequences in the output to handle colors.  Note that these might not be
-handled by your terminal.  Default is 'mono'.  To obtain the best color
-match in 'ansi' mode, you should use 'set colorsequence classic'.
-Depending on the mode, the 'dumb' terminal will emit the following
-sequences (without the additional whitespace):
-
-           ESC [ 0 m           reset attributes to defaults
-           foreground color:
-           ESC [ 1 m           set intense/bold
-           ESC [ 22 m          intense/bold off
-           ESC [ <fg> m        with color code 30 <= <fg> <= 37
-           ESC [ 39 m          reset to default
-           ESC [ 38; 5; <c> m  with palette index 16 <= <c> <= 255
-           ESC [ 38; 2; <r>; <g>; <b> m  with components 0 <= <r,g,b> <= 255
-           background color:
-           ESC [ <bg> m        with color code 40 <= <bg> <= 47
-           ESC [ 49 m          reset to default
-           ESC [ 48; 5; <c> m  with palette index 16 <= <c> <= 231
-           ESC [ 48; 2; <r>; <g>; <b> m  with components 0 <= <r,g,b> <= 255
-
-
-   See also e.g.  the description at
-https://en.wikipedia.org/wiki/ANSI_escape_code#Colors
-(https://en.wikipedia.org/wiki/ANSI_escape_code#Colors)
-
-   The 'attributes' option enables bold and italic text on terminals or
-emulators that support the escape sequences
-           ESC [ 1 m / 22 m    for bold on/off and
-           ESC [ 3 m / 23 m    for italic on /off.
-
-
-   Example:
-           set term dumb mono size 60,15 aspect 1
-           set tics nomirror scale 0.5
-           plot [-5:6.5] sin(x) with impulse ls -1
-
-
-               1 +-------------------------------------------------+
-             0.8 +|||++                   ++||||++                 |
-             0.6 +|||||+                 ++|||||||+  sin(x) +----+ |
-             0.4 +||||||+               ++|||||||||+               |
-             0.2 +|||||||+             ++|||||||||||+             +|
-               0 ++++++++++++++++++++++++++++++++++++++++++++++++++|
-            -0.2 +        +|||||||||||+              +|||||||||||+ |
-            -0.4 +         +|||||||||+                +|||||||||+  |
-            -0.6 +          +|||||||+                  +|||||||+   |
-            -0.8 +           ++||||+                    ++||||+    |
-              -1 +---+--------+--------+-------+--------+--------+-+
-                    -4       -2        0       2        4        6  "
-
-
-
-File: gnuplot.info,  Node: dxf,  Next: dxy800a,  Prev: dumb,  Up: complete_list_of_terminals
-
-4.1.12 dxf
-----------
-
-Terminal driver 'dxf' for export to AutoCad (Release 10.x).  It has no
-options.  The default size is 120x80 AutoCad units.  'dxf' uses seven
-colors (white, red, yellow, green, cyan, blue and magenta) that can be
-changed only by modifying the source file.  If a black-and-white
-plotting device is used the colors are mapped to differing line
-thicknesses.  Note: someone please update this terminal to the 2012 DXF
-standard!"
-
-
-File: gnuplot.info,  Node: dxy800a,  Next: eepic,  Prev: dxf,  Up: complete_list_of_terminals
-
-4.1.13 dxy800a
---------------
-
-Note: legacy terminal.  This terminal driver supports the Roland DXY800A
-plotter.  It has no options."
-
-
-File: gnuplot.info,  Node: eepic,  Next: emf,  Prev: dxy800a,  Up: complete_list_of_terminals
-
-4.1.14 eepic
-------------
-
-Note: Legacy terminal (not built by default).  The latex, emtex, eepic,
-and tpic terminals in older versions of gnuplot provided minimal support
-for graphics styles beyond simple lines and points.  They have been
-directly superseded by the 'pict2e' terminal.  For more capable
-TeX/LaTeX compatible terminal types see 'cairolatex', 'context',
-'epslatex', 'mp', 'pstricks', and 'tikz'.
-
-   The output of this terminal is intended for use with the "eepic.sty"
-macro package for LaTeX. To use it, you need "eepic.sty", "epic.sty" and
-a DVI driver that supports the "tpic" \\specials.  If your driver
-doesn't support those \\specials, "eepicemu.sty" will enable you to use
-some of them.  dvips and dvipdfm do support the "tpic" \\specials,
-pdflatex does not.
-
-   Syntax:
-        set terminal eepic {default} {color|monochrome|dashed}
-                           {rotate} {size XX,YY}
-                           {small|tiny|<fontsize>}
-
-
-   'color' causes gnuplot to produce \\color{...} commands so that the
-graphs are colored.  Using this option, you must include
-\\usepackage{color} in the preamble of your latex document.
-
-   'dashed' will allow dashed line types; without this option, only
-solid lines with varying thickness will be used.  'dashed' and 'color'
-are mutually exclusive; if 'color' is specified, then 'dashed' will be
-ignored.
-
-   'rotate' will enable true rotated text (by 90 degrees).  Otherwise,
-rotated text will be typeset with letters stacked above each other.  If
-you use this option you must include \\usepackage{graphicx} in the
-preamble.
-
-   'small' will use \\scriptsize symbols as point markers.  Default is
-to use the" default math size.  'tiny' uses \\scriptscriptstyle symbols.
-
-   The default size of an eepic plot is 5x3 inches.  You can change this
-using the *note size:: terminal option.
-
-   <fontsize> is a number which specifies the font size inside the
-picture environment; the unit is pt (points), i.e., 10 pt equals approx.
-3.5 mm.  If fontsize is not specified, then all text inside the picture
-will be set in \\footnotesize.
-
-   'default' resets all options to their defaults = no color, no dashed
-lines, pseudo-rotated (stacked) text, large point symbols.
-
-   Notes:
-
-   Remember to escape the # character (or other chars meaningful to
-(La-)TeX) by \\\\ (2 backslashes).
-
-   It seems that dashed lines become solid lines when the vertices of a
-plot are too close.  (I do not know if that is a general problem with
-the tpic specials, or if it is caused by a bug in eepic.sty or
-dvips/dvipdfm.)
-
-   Points, among other things, are drawn using the LaTeX commands
-"\\Diamond", "\\Box", etc.  These commands no longer belong to the
-LaTeX2e core; they are included in the latexsym package, which is part
-of the base distribution and thus part of any LaTeX implementation.
-Please do not forget to use this package.  Instead of latexsym, you can
-also include the amssymb package.
-
-   All drivers for LaTeX offer a special way of controlling text
-positioning: If any text string begins with '{', you also need to
-include a '}' at the end of the text, and the whole text will be
-centered both horizontally and vertically.  If the text string begins
-with '[', you need to follow this with a position specification (up to
-two out of t,b,l,r), ']{', the text itself, and finally '}'.  The text
-itself may be anything LaTeX can typeset as an LR-box.  '\\rule{}{}'s
-may help for best positioning.
-
-   Examples:
-            set term eepic
-
-   output graphs as eepic macros inside a picture environment; \\input
-the resulting file in your LaTeX document.
-            set term eepic color tiny rotate 8
-
-   eepic macros with \\color macros, \\scripscriptsize point markers,
-true rotated text, and all text set with 8pt.
-
-   About label positioning: Use gnuplot defaults (mostly sensible, but
-sometimes not really best):
-            set title '\\LaTeX\\ -- $ \\gamma $'
-
-   Force centering both horizontally and vertically:
-            set label '{\\LaTeX\\ -- $ \\gamma $}' at 0,0
-
-   Specify own positioning (top here):
-            set xlabel '[t]{\\LaTeX\\ -- $ \\gamma $}'
-
-   The other label - account for long ticlabels:
-            set ylabel '[r]{\\LaTeX\\ -- $ \\gamma $\\rule{7mm}{0pt}}'"
-
-
-
-File: gnuplot.info,  Node: emf,  Next: epson_180dpi,  Prev: eepic,  Up: complete_list_of_terminals
-
-4.1.15 emf
-----------
-
-The 'emf' terminal generates an Enhanced Metafile Format file.  This
-file format is recognized by many Windows applications.
-
-   Syntax:
-           set terminal emf {color | monochrome}
-                            {enhanced {noproportional}}
-                            {rounded | butt}
-                            {linewidth <LW>} {dashlength <DL>}
-                            {size XX,YY} {background <rgb_color>}
-                            {font "<fontname>{,<fontsize>}"}
-                            {fontscale <scale>}
-
-
-   In *note monochrome:: mode successive line types cycle through dash
-patterns.  'linewidth <factor>' multiplies all line widths by this
-factor.  'dashlength <factor>' is useful for thick lines.  <fontname> is
-the name of a font; and '<fontsize>' is the size of the font in points.
-
-   The nominal size of the output image defaults to 1024x768 in
-arbitrary units.  You may specify a different nominal size using the
-*note size:: option.
-
-   Enhanced text mode tries to approximate proportional character
-spacing.  If you are using a monospaced font, or don't like the
-approximation, you can turn off this correction using the
-'noproportional' option.
-
-   The default settings are 'color font "Arial,12" size 1024,768'
-Selecting 'default' sets all options to their default values.
-
-   Examples:
-           set terminal emf 'Times Roman Italic, 12'"
-
-
-
-File: gnuplot.info,  Node: epson_180dpi,  Next: excl,  Prev: emf,  Up: complete_list_of_terminals
-
-4.1.16 epson_180dpi
--------------------
-
-Note: only available if gnuplot is configured -with-bitmap-terminals.
-This driver supports a family of Epson printers and derivatives.
-
-   'epson_180dpi' and 'epson_60dpi' are drivers for Epson LQ-style
-24-pin printers with resolutions of 180 and 60 dots per inch,
-respectively.
-
-   'epson_lx800' is a generic 9-pin driver appropriate for printers like
-the Epson LX-800, the Star NL-10 and NX-1000, the PROPRINTER, and so
-forth.
-
-   'nec_cp6' is generic 24-pin driver that can be used for printers like
-the NEC CP6 and the Epson LQ-800.
-
-   The 'okidata' driver supports the 9-pin OKIDATA 320/321 Standard
-printers.
-
-   The 'starc' driver is for the Star Color Printer.
-
-   The 'tandy_60dpi' driver is for the Tandy DMP-130 series of 9-pin,
-60-dpi printers.
-
-   The 'dpu414' driver is for the Seiko DPU-414 thermal printer.
-
-   'nec_cp6' has the options:
-
-   Syntax:
-           set terminal nec_cp6 {monochrome | colour | draft}
-
-
-   which defaults to monochrome.
-
-   'dpu414' has the options:
-
-   Syntax:
-           set terminal dpu414 {small | medium | large} {normal | draft}
-
-
-   which defaults to medium (=font size) and normal.  Preferred
-combinations are 'medium normal' and 'small draft'.
-
-   With each of these drivers, a binary copy is required on a PC to
-print.  Do not use 'print'--use instead 'copy file /b lpt1:'.
-
-
-File: gnuplot.info,  Node: excl,  Next: fig,  Prev: epson_180dpi,  Up: complete_list_of_terminals
-
-4.1.17 excl
------------
-
-Note: legacy terminal.  The 'excl' terminal driver supports Talaris
-printers such as the EXCL Laser printer and the 1590.  It has no
-options."
-
-
-File: gnuplot.info,  Node: fig,  Next: png_,  Prev: excl,  Up: complete_list_of_terminals
-
-4.1.18 fig
-----------
-
-The 'fig' terminal device generates output in the Fig graphics language
-for import into the xfig interactive drawing tool.  Notes:
-           The fig terminal was significantly revised in gnuplot version 5.3.
-           Currently only version 3.2 of the fig file format is supported.
-           Use of dash patterns may require Xfig 3.2.6 or newer.
-
-
-   Syntax:
-           set terminal fig {monochrome | color}
-                            {small | big | size <xsize>{in|cm},<ysize>{in|cm}}
-                            {landscape | portrait}
-                            {pointsmax <max_points>}
-                            {font "<fontname>{,<fontsize>}"} {fontsize <size>}
-                            {textnormal | {textspecial texthidden textrigid}}
-                            {{linewidth|lw} <multiplier>}
-
-
-   The default settings are
-           set term fig color small landscape font "Times Roman,10" lw 1.0
-
-
-   *note size:: sets the size of the drawing area to <xsize>*<ysize> in
-units of inches (default) or centimeters.  The default is 'size
-5in,3in'.  'small' is shorthand for 'size 5in,3in' (3in,5in in portrait
-mode).  'big' is shorthand for 'size 8in,5in'.
-
-   'pointsmax' sets the maximum number of vertices in a polyline; longer
-polylines will be broken into segments.
-
-   'font' sets the text font face to <fontname> and its size to
-<fontsize> points.  Choice is limited to the 35 standard PostScript
-fonts.  'textnormal' resets the text flags and selects postscript fonts,
-'textspecial' sets the text flags for LaTeX specials, 'texthidden' sets
-the hidden flag and 'textrigid' the rigid flag.
-
-   'linewidth' is a multiplier for the linewidth property of all lines.
-
-   Additional point-plot symbols are also available in the 'fig' driver.
-The symbols can be used through 'pointtype' values % 100 above 50, with
-different fill intensities controlled by <pointtype> % 5 and outlines in
-black (for <pointtype> % 10 < 5) or in the current color.  Available
-symbols are
-             50 - 59:  circles
-             60 - 69:  squares
-             70 - 79:  diamonds
-             80 - 89:  upwards triangles
-             90 - 99:  downwards triangles
-
-   The size of these symbols scales with the font size.
-
-   RGB colors will be replaced with gray unless they have been defined
-in a linetype prior to plotting or match a known named color or palette
-value.  See *note colornames::.  E.g.
-           set linetype 999 lc rgb '#aabbcc'
-           plot $data with fillecurve fillcolor rgb '#aabbcc'
-
-
-
-File: gnuplot.info,  Node: png_,  Next: ggi,  Prev: fig,  Up: complete_list_of_terminals
-
-4.1.19 png
-----------
-
-Syntax:
-           set terminal png
-                  {{no}enhanced}
-                  {{no}transparent} {{no}interlace}
-                  {{no}truecolor} {rounded|butt}
-                  {linewidth <lw>} {dashlength <dl>}
-                  {tiny | small | medium | large | giant}
-                  {font "<face> {,<pointsize>}"} {fontscale <scale>}
-                  {size <x>,<y>} {{no}crop}
-                  {background <rgb_color>}
-
-
-   PNG, JPEG and GIF images are created using the external library
-libgd.  PNG plots may be viewed interactively by piping the output to
-the 'display' program from the ImageMagick package as follows:
-                    set term png
-                    set output '| display png:-'
-
-   You can view the output from successive plot commands interactively
-by typing <space> in the display window.  To save the current plot to a
-file, left click in the display window and choose *note save::.
-
-   'transparent' instructs the driver to make the background color
-transparent.  Default is 'notransparent'.
-
-   'interlace' instructs the driver to generate interlaced PNGs.
-Default is 'nointerlace'.
-
-   The 'linewidth' and 'dashlength' options are scaling factors that
-affect all lines drawn, i.e.  they are multiplied by values requested in
-various drawing commands.
-
-   By default the png terminal creates TrueColor images with 24 bits of
-color information per pixel.  The 'notruecolor' option instead uses only
-8 bits, (256 indexed colors).  Transparent fill styles require the
-'truecolor' option.  See 'fillstyle'.  A transparent background is
-possible in either indexed or TrueColor images.  Antialiasing also
-requires TrueColor.
-
-   'butt' instructs the driver to use a line drawing method that does
-not overshoot the desired end point of a line.  This setting is only
-relevant for line widths greater than 1.  The alternative is 'rounded',
-which produces somewhat more uniform curved lines if antialiasing is not
-available ('notruecolor') but can be much slower.
-
-   The details of font selection are complicated.  Two equivalent simple
-examples are given below:
-          set term png font arial 11
-          set term png font "arial,11"
-
-   For more information please see the separate section under 'fonts'.
-
-   The output plot size <x,y> is given in pixels--it defaults to
-640x480.  Please see additional information under 'canvas' and *note
-size::.  Blank space at the edges of the finished plot may be trimmed
-using the 'crop' option, resulting in a smaller final image size.
-Default is 'nocrop'.
-
-* Menu:
-
-* examples____::
-
-
-File: gnuplot.info,  Node: examples____,  Prev: png_,  Up: png_
-
-4.1.19.1 examples
-.................
-
-           set terminal png font "arial,14" size 800,600 background "white"
-
-
-   Searches for a scalable font with face name 'arial' and sets the font
-size to 14pt.  Please see 'fonts' for details of how the font search is
-done.
-
-           set terminal png transparent enhanced
-
-
-   Use 24 bits of color information per pixel, with a transparent
-background.  Use the 'enhanced text' mode to control the layout of
-strings to be printed.
-
-
-File: gnuplot.info,  Node: ggi,  Next: gpic,  Prev: png_,  Up: complete_list_of_terminals
-
-4.1.20 ggi
-----------
-
-Legacy terminal driver for the GGI (General Graphics Interface)
-project."
-
-   Syntax:
-        set terminal ggi [acceleration <integer>] [[mode] {mode}]
-
-
-   In X the window cannot be resized using window manager handles, but
-the mode can be given with the mode option, e.g.:
-      - V1024x768
-      - V800x600
-      - V640x480
-      - V320x200
-
-   Please refer to the ggi documentation for other modes.  The 'mode'
-keyword is optional.  It is recommended to select the target by
-environment variables as explained in the libggi manual page.  To get
-DGA on X, you should for example
-        bash> export GGI_DISPLAY=DGA
-        csh>  setenv GGI_DISPLAY DGA
-
-
-   'acceleration' is only used for targets which report relative pointer
-motion events (e.g.  DGA) and is a strictly positive integer
-multiplication factor for the relative distances.  The default for
-acceleration is 7.
-
-   Examples:
-        set term ggi acc 10
-        set term ggi acc 1 mode V1024x768
-        set term ggi V1024x768"
-
-
-
-File: gnuplot.info,  Node: gpic,  Next: grass,  Prev: ggi,  Up: complete_list_of_terminals
-
-4.1.21 gpic
------------
-
-Note: Legacy terminal (present only if gnuplot was configured
--with-gpic).  The 'gpic' terminal driver generates GPIC graphs in the
-Free Software Foundations's "groff" package.  The default size is 5 x 3
-inches.  The only option is the origin, which defaults to (0,0).
-
-   Syntax:
-           set terminal gpic {<x> <y>}
-
-
-   where 'x' and 'y' are in inches.
-
-   A simple graph can be formatted using
-
-           groff -p -mpic -Tps file.pic > file.ps.
-
-
-   The output from pic can be pipe-lined into eqn, so it is possible to
-put complex functions in a graph with the 'set label' and 'set
-{x/y}label' commands.  For instance,
-
-           set ylab '@space 0 int from 0 to x alpha ( t ) roman d t@'
-
-
-   will label the y axis with a nice integral if formatted with the
-command:
-
-           gpic filename.pic | geqn -d@@ -Tps | groff -m[macro-package] -Tps
-               > filename.ps
-
-
-   Figures made this way can be scaled to fit into a document.  The pic
-language is easy to understand, so the graphs can be edited by hand if
-need be.  All co-ordinates in the pic-file produced by 'gnuplot' are
-given as x+gnuplotx and y+gnuploty.  By default x and y are given the
-value 0.  If this line is removed with an editor in a number of files,
-one can put several graphs in one figure like this (default size is
-5.0x3.0 inches):
-
-           .PS 8.0
-           x=0;y=3
-           copy "figa.pic"
-           x=5;y=3
-           copy "figb.pic"
-           x=0;y=0
-           copy "figc.pic"
-           x=5;y=0
-           copy "figd.pic"
-           .PE
-
-
-   This will produce an 8-inch-wide figure with four graphs in two rows
-on top of each other.
-
-   One can also achieve the same thing by specifying x and y in the
-command
-
-           set terminal gpic x y
-
-
-
-File: gnuplot.info,  Node: grass,  Next: hp2623a,  Prev: gpic,  Up: complete_list_of_terminals
-
-4.1.22 grass
-------------
-
-Note: legacy terminal.  The 'grass' terminal driver gives 'gnuplot'
-capabilities to users of the GRASS geographic information system.
-Contact grassp-list@moon.cecer.army.mil for more information.  Pages are
-written to the current frame of the GRASS Graphics Window.  There are no
-options."
-
-
-File: gnuplot.info,  Node: hp2623a,  Next: hp2648,  Prev: grass,  Up: complete_list_of_terminals
-
-4.1.23 hp2623a
---------------
-
-The 'hp2623a' terminal driver supports the Hewlett Packard HP2623A. It
-has no options."
-
-
-File: gnuplot.info,  Node: hp2648,  Next: hp500c,  Prev: hp2623a,  Up: complete_list_of_terminals
-
-4.1.24 hp2648
--------------
-
-The 'hp2648' terminal driver supports the Hewlett Packard HP2647 and
-HP2648.  It has no options."
-
-
-File: gnuplot.info,  Node: hp500c,  Next: hpgl,  Prev: hp2648,  Up: complete_list_of_terminals
-
-4.1.25 hp500c
--------------
-
-Note: only available if gnuplot is configured -with-bitmap-terminals.
-The 'hp500c' terminal driver supports the Hewlett Packard HP DeskJet
-500c.  It has options for resolution and compression.
-
-   Syntax:
-           set terminal hp500c {<res>} {<comp>}
-
-
-   where 'res' can be 75, 100, 150 or 300 dots per inch and 'comp' can
-be "rle", or "tiff".  Any other inputs are replaced by the defaults,
-which are 75 dpi and no compression.  Rasterization at the higher
-resolutions may require a large amount of memory."
-
-
-File: gnuplot.info,  Node: hpgl,  Next: hpljii,  Prev: hp500c,  Up: complete_list_of_terminals
-
-4.1.26 hpgl
------------
-
-Syntax:
-           set terminal hpgl {<number_of_pens>} {eject} {fontscale <scale>}
-
-
-   The 'hpgl' driver produces HPGL output for Hewlett Packard pen
-plotters like the HP7475A and many other plotters dating back to the
-1970s.  Also, HPGL graphics can be imported by many software packages.
-The HPGL command language was largely superseded in later printers by
-the PCL command language.  See 'set term pcl5'.
-
-   Terminal options control the number of pens used and whether or not
-the plotter ejects a page when done.  The default is to use 6 pens and
-not eject the page.
-
-   All text is drawn in a uniform size.  The 'fontscale' option applies
-a scale factor to make this size larger or smaller.  If gnuplot's
-current encoding is set to either iso_8859_1 cp850, non-ascii characters
-are translated for handling by some printer models that support the
-corresponding character set.  If your printer model does not support
-this, do not set these encodings.
-
-
-File: gnuplot.info,  Node: hpljii,  Next: hppj,  Prev: hpgl,  Up: complete_list_of_terminals
-
-4.1.27 hpljii
--------------
-
-Note: only available if gnuplot is configured -with-bitmap-terminals.
-The 'hpljii' terminal driver supports the HP Laserjet Series II printer.
-The 'hpdj' driver supports the HP DeskJet 500 printer.  These drivers
-allow a choice of resolutions.
-
-   Syntax:
-           set terminal hpljii | hpdj {<res>}
-
-
-   where 'res' may be 75, 100, 150 or 300 dots per inch; the default is
-75.  Rasterization at the higher resolutions may require a large amount
-of memory.
-
-   The 'hp500c' terminal is similar to 'hpdj'; 'hp500c' additionally
-supports color and compression."
-
-
-File: gnuplot.info,  Node: hppj,  Next: imagen,  Prev: hpljii,  Up: complete_list_of_terminals
-
-4.1.28 hppj
------------
-
-Note: only available if gnuplot is configured -with-bitmap-terminals.
-The 'hppj' terminal driver supports the HP PaintJet and HP3630 printers.
-The only option is the choice of font.
-
-   Syntax:
-           set terminal hppj {FNT5X9 | FNT9X17 | FNT13X25}
-
-
-   with the middle-sized font (FNT9X17) being the default."
-
-
-File: gnuplot.info,  Node: imagen,  Next: kyo,  Prev: hppj,  Up: complete_list_of_terminals
-
-4.1.29 imagen
--------------
-
-The 'imagen' terminal driver supports Imagen laser printers.  It is
-capable of placing multiple graphs on a single page.
-
-   Syntax:
-           set terminal imagen {<fontsize>} {portrait | landscape}
-                               {[<horiz>,<vert>]}
-
-
-   where 'fontsize' defaults to 12 points and the layout defaults to
-'landscape'.  '<horiz>' and '<vert>' are the number of graphs in the
-horizontal and vertical directions; these default to unity.
-
-   Example:
-           set terminal imagen portrait [2,3]
-
-
-   puts six graphs on the page in three rows of two in portrait
-orientation."
-
-
-File: gnuplot.info,  Node: kyo,  Next: latex,  Prev: imagen,  Up: complete_list_of_terminals
-
-4.1.30 kyo
-----------
-
-The 'kyo' and 'prescribe' terminal drivers support the Kyocera laser
-printer.  The only difference between the two is that 'kyo' uses
-"Helvetica" whereas 'prescribe' uses "Courier".  There are no options.
-Note: legacy terminal."
-
-
-File: gnuplot.info,  Node: latex,  Next: lua,  Prev: kyo,  Up: complete_list_of_terminals
-
-4.1.31 latex
-------------
-
-Note: Legacy terminal (not built by default).  The latex, emtex, eepic,
-and tpic terminals in older versions of gnuplot provided minimal support
-for graphics styles beyond simple lines and points.  They have been
-directly superseded by the 'pict2e' terminal.  For more capable
-TeX/LaTeX compatible terminal types see 'cairolatex', 'context',
-'epslatex', 'mp', 'pstricks', and 'tikz'.
-
-   Syntax:
-           set terminal {latex | emtex} {default | {courier|roman} {<fontsize>}}
-                        {size <XX>{unit}, <YY>{unit}} {rotate | norotate}
-                        {color | monochrome}
-
-
-   By default the plot will inherit font settings from the embedding
-document.  You have the option of forcing either Courier (cmtt) or Roman
-(cmr) fonts instead.  In this case you may also specify a fontsize.
-Unless your driver is capable of building fonts at any size (e.g.
-dvips), stick to the standard 10, 11 and 12 point sizes.
-
-   METAFONT users beware: METAFONT does not like odd sizes.
-
-   All drivers for LaTeX offer a special way of controlling text
-positioning: If any text string begins with '{', you also need to
-include a '}' at the end of the text, and the whole text will be
-centered both horizontally and vertically.  If the text string begins
-with '[', you need to follow this with a position specification (up to
-two out of t,b,l,r), ']{', the text itself, and finally '}'.  The text
-itself may be anything LaTeX can typeset as an LR-box.  '\\rule{}{}'s
-may help for best positioning.
-
-   Points, among other things, are drawn using the LaTeX commands
-"\\Diamond" and "\\Box".  These commands no longer belong to the LaTeX2e
-core; they are included in the latexsym package, which is part of the
-base distribution and thus part of any LaTeX implementation.  Please do
-not forget to use this package.  Other point types use symbols from the
-amssymb package.
-
-   The default size for the plot is 5 inches by 3 inches.  The *note
-size:: option changes this to whatever the user requests.  By default
-the X and Y sizes are taken to be in inches, but other units are
-possible (currently only cm).
-
-   If 'rotate' is specified, rotated text, especially a rotated y-axis
-label, is possible (the packages graphics or graphicx are needed).  The
-'stacked' y-axis label mechanism is then deactivated.  This will also
-significantly improve the quality of line drawing, and is default since
-version 5.3.
-
-   The option 'color' enables color, while *note monochrome:: uses only
-black and white drawing elements.  You need to load the color or xcolor
-package in the preamble of your latex document.
-
-   Examples: About label positioning: Use gnuplot defaults (mostly
-sensible, but sometimes not really best):
-            set title '\\LaTeX\\ -- $ \\gamma $'
-
-   Force centering both horizontally and vertically:
-            set label '{\\LaTeX\\ -- $ \\gamma $}' at 0,0
-
-   Specify own positioning (top here):
-            set xlabel '[t]{\\LaTeX\\ -- $ \\gamma $}'
-
-   The other label - account for long ticlabels:
-            set ylabel '[r]{\\LaTeX\\ -- $ \\gamma $\\rule{7mm}{0pt}}'"
-
-
-
-File: gnuplot.info,  Node: lua,  Next: mf,  Prev: latex,  Up: complete_list_of_terminals
-
-4.1.32 lua
-----------
-
-The 'lua' generic terminal driver works in conjunction with an external
-Lua script to create a target-specific plot file.  Currently the only
-supported target is TikZ -> pdflatex.
-
-   Information about Lua is available at http://www.lua.org .
-
-   Syntax:
-        set terminal lua <target name> | "<file name>"
-                            {<script_args> ...}
-                            {help}
-
-
-   A 'target name' or 'file name' (in quotes) for a script is mandatory.
-If a 'target name' for the script is given, the terminal will look for
-"gnuplot-<target name>.lua" in the local directory and on failure in the
-environmental variable GNUPLOT_LUA_DIR.
-
-   All arguments will be provided to the selected script for further
-evaluation.  E.g.  'set term lua tikz help' will cause the script itself
-to print additional help on options and choices for the script.
-
-
-File: gnuplot.info,  Node: mf,  Next: mp,  Prev: lua,  Up: complete_list_of_terminals
-
-4.1.33 mf
----------
-
-Note: legacy terminal (not built by default).  The 'mf' terminal driver
-creates an input file to the METAFONT program.  Thus a figure may be
-used in the TeX document in the same way as is a character.
-
-   To use a picture in a document, the METAFONT program must be run with
-the output file from 'gnuplot' as input.  Thus, the user needs a basic
-knowledge of the font creating process and the procedure for including a
-new font in a document.  However, if the METAFONT program is set up
-properly at the local site, an unexperienced user could perform the
-operation without much trouble.
-
-   The text support is based on a METAFONT character set.  Currently the
-Computer Modern Roman font set is input, but the user is in principal
-free to choose whatever fonts he or she needs.  The METAFONT source
-files for the chosen font must be available.  Each character is stored
-in a separate picture variable in METAFONT. These variables may be
-manipulated (rotated, scaled etc.)  when characters are needed.  The
-drawback is the interpretation time in the METAFONT program.  On some
-machines (i.e.  PC) the limited amount of memory available may also
-cause problems if too many pictures are stored.
-
-   The 'mf' terminal has no options.
-
-* Menu:
-
-* METAFONT_Instructions::
-
-
-File: gnuplot.info,  Node: METAFONT_Instructions,  Prev: mf,  Up: mf
-
-4.1.33.1 METAFONT Instructions
-..............................
-
-- Set your terminal to METAFONT:
-       set terminal mf
-
-   - Select an output-file, e.g.:
-       set output "myfigures.mf"
-
-   - Create your pictures.  Each picture will generate a separate
-character.  Its default size will be 5*3 inches.  You can change the
-size by saying 'set size 0.5,0.5' or whatever fraction of the default
-size you want to have.
-
-   - Quit 'gnuplot'.
-
-   - Generate a TFM and GF file by running METAFONT on the output of
-'gnuplot'.  Since the picture is quite large (5*3 in), you will have to
-use a version of METAFONT that has a value of at least 150000 for
-memmax.  On Unix systems these are conventionally installed under the
-name bigmf.  For the following assume that the command virmf stands for
-a big version of METAFONT. For example:
-
-   - Invoke METAFONT:
-         virmf '&plain'
-
-   - Select the output device: At the METAFONT prompt ('*') type:
-         \\mode:=CanonCX;     % or whatever printer you use
-
-   - Optionally select a magnification:
-         mag:=1;             % or whatever you wish
-
-   - Input the 'gnuplot'-file:
-         input myfigures.mf
-
-   On a typical Unix machine there will usually be a script called "mf"
-that executes virmf '&plain', so you probably can substitute mf for
-virmf &plain.  This will generate two files: mfput.tfm and mfput.$$$gf
-(where $$$ indicates the resolution of your device).  The above can be
-conveniently achieved by typing everything on the command line, e.g.:
-virmf '&plain' '\\mode:=CanonCX; mag:=1; input myfigures.mf' In this
-case the output files will be named myfigures.tfm and myfigures.300gf.
-
-   - Generate a PK file from the GF file using gftopk:
-       gftopk myfigures.300gf myfigures.300pk
-
-   The name of the output file for gftopk depends on the DVI driver you
-use.  Ask your local TeX administrator about the naming conventions.
-Next, either install the TFM and PK files in the appropriate
-directories, or set your environment variables properly.  Usually this
-involves setting TEXFONTS to include the current directory and doing the
-same thing for the environment variable that your DVI driver uses (no
-standard name here...).  This step is necessary so that TeX will find
-the font metric file and your DVI driver will find the PK file.
-
-   - To include your pictures in your document you have to tell TeX the
-font:
-       \\font\\gnufigs=myfigures
-
-   Each picture you made is stored in a single character.  The first
-picture is character 0, the second is character 1, and so on...  After
-doing the above step, you can use the pictures just like any other
-characters.  Therefore, to place pictures 1 and 2 centered in your
-document, all you have to do is:
-       \\centerline{\\gnufigs\\char0}
-       \\centerline{\\gnufigs\\char1}
-
-   in plain TeX. For LaTeX you can, of course, use the picture
-environment and place the picture wherever you wish by using the
-\\makebox and \\put macros.
-
-   This conversion saves you a lot of time once you have generated the
-font; TeX handles the pictures as characters and uses minimal time to
-place them, and the documents you make change more often than the
-pictures do.  It also saves a lot of TeX memory.  One last advantage of
-using the METAFONT driver is that the DVI file really remains device
-independent, because no \\special commands are used as in the eepic and
-tpic drivers."
-
-
-File: gnuplot.info,  Node: mp,  Next: mif,  Prev: mf,  Up: complete_list_of_terminals
-
-4.1.34 mp
----------
-
-Note: legacy terminal (not built by default).  The 'mp' driver produces
-output intended to be input to the Metapost program.  Running Metapost
-on the file creates EPS files containing the plots.  By default,
-Metapost passes all text through TeX. This has the advantage of allowing
-essentially any TeX symbols in titles and labels.
-
-   Syntax:
-        set term mp {color | colour | monochrome}
-                    {solid | dashed}
-                    {notex | tex | latex}
-                    {magnification <magsize>}
-                    {psnfss | psnfss-version7 | nopsnfss}
-                    {prologues <value>}
-                    {a4paper}
-                    {amstex}
-                    {"<fontname> {,<fontsize>}"}
-
-
-   The option 'color' causes lines to be drawn in color (on a printer or
-display that supports it), *note monochrome:: (or nothing) selects black
-lines.  The option 'solid' draws solid lines, while 'dashed' (or
-nothing) selects lines with different patterns of dashes.  If 'solid' is
-selected but 'color' is not, nearly all lines will be identical.  This
-may occasionally be useful, so it is allowed.
-
-   The option 'notex' bypasses TeX entirely, therefore no TeX code can
-be used in labels under this option.  This is intended for use on old
-plot files or files that make frequent use of common characters like '$'
-and '%' that require special handling in TeX.
-
-   The option 'tex' sets the terminal to output its text for TeX to
-process.
-
-   The option 'latex' sets the terminal to output its text for
-processing by LaTeX. This allows things like \\frac for fractions which
-LaTeX knows about but TeX does not.  Note that you must set the
-environment variable TEX to the name of your LaTeX executable (normally
-latex) if you use this option or use 'mpost -tex=<name of LaTeX
-executable> ...'.  Otherwise metapost will try and use TeX to process
-the text and it won't work.
-
-   Changing font sizes in TeX has no effect on the size of mathematics,
-and there is no foolproof way to make such a change, except by globally
-setting a magnification factor.  This is the purpose of the
-'magnification' option.  It must be followed by a scaling factor.  All
-text (NOT the graphs) will be scaled by this factor.  Use this if you
-have math that you want at some size other than the default 10pt.
-Unfortunately, all math will be the same size, but see the discussion
-below on editing the MP output.  'mag' will also work under 'notex' but
-there seems no point in using it as the font size option (below) works
-as well.
-
-   The option 'psnfss' uses postscript fonts in combination with LaTeX.
-Since this option only makes sense, if LaTeX is being used, the 'latex'
-option is selected automatically.  This option includes the following
-packages for LaTeX: inputenc(latin1), fontenc(T1), mathptmx,
-helvet(scaled=09.2), courier, latexsym and textcomp.
-
-   The option 'psnfss-version7' uses also postscript fonts in LaTeX
-(option 'latex' is also automatically selected), but uses the following
-packages with LaTeX: inputenc(latin1), fontenc(T1), times, mathptmx,
-helvet and courier.
-
-   The option 'nopsnfss' is the default and uses the standard font
-(cmr10 if not otherwise specified).
-
-   The option 'prologues' takes a value as an additional argument and
-adds the line 'prologues:=<value>' to the metapost file.  If a value of
-'2' is specified metapost uses postscript fonts to generate the
-eps-file, so that the result can be viewed using e.g.  ghostscript.
-Normally the output of metapost uses TeX fonts and therefore has to be
-included in a (La)TeX file before you can look at it.
-
-   The option 'noprologues' is the default.  No additional line
-specifying the prologue will be added.
-
-   The option 'a4paper' adds a '[a4paper]' to the documentclass.
-Normally letter paper is used (default).  Since this option is only used
-in case of LaTeX, the 'latex' option is selected automatically.
-
-   The option 'amstex' automatically selects the 'latex' option and
-includes the following LaTeX packages: amsfonts, amsmath(intlimits).  By
-default these packages are not included.
-
-   A name in quotes selects the font that will be used when no explicit
-font is given in a 'set label' or *note title::.  A name recognized by
-TeX (a TFM file exists) must be used.  The default is "cmr10" unless
-'notex' is selected, then it is "pcrr8r" (Courier).  Even under 'notex',
-a TFM file is needed by Metapost.  The file 'pcrr8r.tfm' is the name
-given to Courier in LaTeX's psnfss package.  If you change the font from
-the 'notex' default, choose a font that matches the ASCII encoding at
-least in the range 32-126.  'cmtt10' almost works, but it has a nonblank
-character in position 32 (space).
-
-   The size can be any number between 5.0 and 99.99.  If it is omitted,
-10.0 is used.  It is advisable to use 'magstep' sizes: 10 times an
-integer or half-integer power of 1.2, rounded to two decimals, because
-those are the most available sizes of fonts in TeX systems.
-
-   All the options are optional.  If font information is given, it must
-be at the end, with size (if present) last.  The size is needed to
-select a size for the font, even if the font name includes size
-information.  For example, 'set term mp "cmtt12"' selects cmtt12 shrunk
-to the default size 10.  This is probably not what you want or you would
-have used cmtt10.
-
-   The following common ascii characters need special treatment in TeX:
-        $, &, #, %, _;  |, <, >;  ^, ~,  \\, {, and }
-
-   The five characters $, #, &, _, and % can simply be escaped, e.g.,
-'\\$'.  The three characters <, >, and | can be wrapped in math mode,
-e.g., '$<$'.  The remainder require some TeX work-arounds.  Any good
-book on TeX will give some guidance.
-
-   If you type your labels inside double quotes, backslashes in TeX code
-need to be escaped (doubled).  Using single quotes will avoid having to
-do this, but then you cannot use '\\n' for line breaks.  As of this
-writing, version 3.7 of gnuplot processes titles given in a 'plot'
-command differently than in other places, and backslashes in TeX
-commands need to be doubled regardless of the style of quotes.
-
-   Metapost pictures are typically used in TeX documents.  Metapost
-deals with fonts pretty much the same way TeX does, which is different
-from most other document preparation programs.  If the picture is
-included in a LaTeX document using the graphics package, or in a
-plainTeX document via epsf.tex, and then converted to PostScript with
-dvips (or other dvi-to-ps converter), the text in the plot will usually
-be handled correctly.  However, the text may not appear if you send the
-Metapost output as-is to a PostScript interpreter.
-
-* Menu:
-
-* Metapost_Instructions::
-
-
-File: gnuplot.info,  Node: Metapost_Instructions,  Prev: mp,  Up: mp
-
-4.1.34.1 Metapost Instructions
-..............................
-
-- Set your terminal to Metapost, e.g.:
-        set terminal mp mono "cmtt12" 12
-
-
-   - Select an output-file, e.g.:
-        set output "figure.mp"
-
-
-   - Create your pictures.  Each plot (or multiplot group) will generate
-a separate Metapost beginfig...endfig group.  Its default size will be 5
-by 3 inches.  You can change the size by saying 'set size 0.5,0.5' or
-whatever fraction of the default size you want to have.
-
-   - Quit gnuplot.
-
-   - Generate EPS files by running Metapost on the output of gnuplot:
-        mpost figure.mp  OR  mp figure.mp
-
-   The name of the Metapost program depends on the system, typically
-'mpost' for a Unix machine and 'mp' on many others.  Metapost will
-generate one EPS file for each picture.
-
-   - To include your pictures in your document you can use the graphics
-package in LaTeX or epsf.tex in plainTeX:
-        \\usepackage{graphics} % LaTeX
-        \\input epsf.tex       % plainTeX
-
-   If you use a driver other than dvips for converting TeX DVI output to
-PS, you may need to add the following line in your LaTeX document:
-        \\DeclareGraphicsRule{*}{eps}{*}{}
-
-   Each picture you made is in a separate file.  The first picture is
-in, e.g., figure.0, the second in figure.1, and so on....  To place the
-third picture in your document, for example, all you have to do is:
-        \\includegraphics{figure.2} % LaTeX
-        \\epsfbox{figure.2}         % plainTeX
-
-
-   The advantage, if any, of the mp terminal over a postscript terminal
-is editable output.  Considerable effort went into making this output as
-clean as possible.  For those knowledgeable in the Metapost language,
-the default line types and colors can be changed by editing the arrays
-'lt[]' and 'col[]'.  The choice of solid vs dashed lines, and color vs
-black lines can be change by changing the values assigned to the
-booleans 'dashedlines' and 'colorlines'.  If the default 'tex' option
-was in effect, global changes to the text of labels can be achieved by
-editing the 'vebatimtex...etex' block.  In particular, a LaTeX preamble
-can be added if desired, and then LaTeX's built-in size changing
-commands can be used for maximum flexibility.  Be sure to set the
-appropriate MP configuration variable to force Metapost to run LaTeX
-instead of plainTeX."
-
-
-File: gnuplot.info,  Node: mif,  Next: pbm,  Prev: mp,  Up: complete_list_of_terminals
-
-4.1.35 mif
-----------
-
-Note: Legacy terminal.  The 'mif' terminal driver produces Frame Maker
-MIF format version 3.00.  It plots in MIF Frames with the size 15*10 cm,
-and plot primitives with the same pen will be grouped in the same MIF
-group.  Plot primitives in a 'gnuplot' page will be plotted in a MIF
-Frame, and several MIF Frames are collected in one large MIF Frame.  The
-MIF font used for text is "Times".
-
-   Several options may be set in the MIF 3.00 driver.
-
-   Syntax:
-           set terminal mif {color | colour | monochrome} {polyline | vectors}
-                            {help | ?}
-
-
-   'colour' plots lines with line types >= 0 in colour (MIF sep.  2-7)
-and *note monochrome:: plots all line types in black (MIF sep.  0).
-'polyline' plots curves as continuous curves and *note vectors:: plots
-curves as collections of vectors.  *note help:: and '?'  print online
-help on standard error output--both print a short description of the
-usage; *note help:: also lists the options.
-
-   Examples:
-           set term mif colour polylines    # defaults
-           set term mif                     # defaults
-           set term mif vectors
-           set term mif help"
-
-
-
-File: gnuplot.info,  Node: pbm,  Next: dospc,  Prev: mif,  Up: complete_list_of_terminals
-
-4.1.36 pbm
-----------
-
-Note: only available if gnuplot is configured -with-bitmap-terminals.
-Syntax:
-           set terminal pbm {<fontsize>} {<mode>} {size <x>,<y>}
-
-
-   where <fontsize> is 'small', 'medium', or 'large' and <mode> is *note
-monochrome::, *note gray:: or 'color'.  The default plot size is 640
-pixels wide and 480 pixels high.  The output size is white-space padded
-to the nearest multiple of 8 pixels on both x and y.  This empty space
-may be cropped later if needed.
-
-   The output of the 'pbm' driver depends upon <mode>: *note
-monochrome:: produces a portable bitmap (one bit per pixel), *note
-gray:: a portable graymap (three bits per pixel) and 'color' a portable
-pixmap (color, four bits per pixel).
-
-   The output of this driver can be used with various image conversion
-and manipulation utilities provided by NETPBM. Based on Jef Poskanzer's
-PBMPLUS package, NETPBM provides programs to convert the above PBM
-formats to GIF, TIFF, MacPaint, Macintosh PICT, PCX, X11 bitmap and many
-others.  Complete information is available at
-http://netpbm.sourceforge.net/.
-
-   Examples:
-           set terminal pbm small monochrome                # defaults
-           set terminal pbm color medium size 800,600
-           set output '| pnmrotate 45 | pnmtopng > tilted.png'  # uses NETPBM"
-
-
-
-File: gnuplot.info,  Node: dospc,  Next: pdf,  Prev: pbm,  Up: complete_list_of_terminals
-
-4.1.37 dospc
-------------
-
-Note: legacy terminal.  The 'dospc' interactive terminal supports PCs
-with arbitrary graphics boards, which will be automatically detected.
-It uses the OpenWatcom graphics library.
-
-   Syntax:
-           set terminal dospc
-               {{no}{enhanced}}
-               {fontscale <scale>} {pointsize <scale>} {linewidth <scale}
-               {background <rgbcolor>}
-
-
-   Line widths, and point and font sizes can be scaled using the
-'linewidth', 'pointscale', or 'fontscale' options, respectively.
-
-   'background' sets the background color (default: black).  It is only
-supported with adapters with 16 or more colors.
-
-   {'no'}'enhanced' toggles enhanced text mode features like sub- and
-superscripts, see 'enhanced text' for more information.
-
-   To select a particular (S)VGA graphics mode, set the environment
-variable PCTRM to one of S640, S800, S1024, S1280, or S1600.  Only 256
-color SVGA modes are supported at this time.  For other adapters the
-resolution will be selected automatically.
-
-   Limitations: This terminal supports a maximum of 256 colors.
-Transparency is not available.  Thick lines are approximated very
-crudely, so expect ugly output for non-vertical or non-horizontal
-lines."
-
-
-File: gnuplot.info,  Node: pdf,  Next: pstricks,  Prev: dospc,  Up: complete_list_of_terminals
-
-4.1.38 pdf
-----------
-
-[DEPRECATED] This terminal uses the non-free library PDFlib (GmbH
-Munchen)" to produce files in Portable Document Format.  Unless you have
-a commercial license for PDFlib and need some special feature it
-provides you would do better to use the cairo pdf terminal instead.
-Gnuplot can also export PDF files from wxt or qt interactive terminal
-sessions.
-
-   Syntax:
-           set terminal pdf {monochrome|color|colour}
-                            {{no}enhanced}
-                            {fname "<font>"} {fsize <fontsize>}
-                            {font "<fontname>{,<fontsize>}"} {fontscale <scale>}
-                            {linewidth <lw>} {rounded|butt}
-                            {dl <dashlength>}}
-                            {size <XX>{unit},<YY>{unit}}
-
-
-   The default is to use a different color for each line type.
-Selecting 'monochome' will use black for all linetypes, Even in in mono
-mode you can still use explicit colors for filled areas or linestyles.
-
-   where <font> is the name of the default font to use (default
-Helvetica) and <fontsize> is the font size (in points, default 12).  For
-help on which fonts are available or how to install new ones, please see
-the documentation for your local installation of pdflib.
-
-   The 'enhanced' option enables enhanced text processing features
-(subscripts, superscripts and mixed fonts).  See 'enhanced'.
-
-   The width of all lines in the plot can be increased by the factor <n>
-specified in 'linewidth'.  Similarly 'dashlength' is a multiplier for
-the default dash spacing.
-
-   'rounded' sets line caps and line joins to be rounded; 'butt' is the
-default, butt caps and mitered joins.
-
-   The default size for PDF output is 5 inches by 3 inches.  The *note
-size:: option changes this to whatever the user requests.  By default
-the X and Y sizes are taken to be in inches, but other units are
-possible (currently only cm).
-
-   * does not work.
-
-
-File: gnuplot.info,  Node: pstricks,  Next: qms,  Prev: pdf,  Up: complete_list_of_terminals
-
-4.1.39 pstricks
----------------
-
-The 'pstricks' driver is intended for use with the "pstricks.sty" macro
-package for TeX or LaTeX. You need "pstricks.sty", and, of course, a
-printer that understands PostScript, or a converter such as Ghostscript.
-
-   PSTricks is available at http://tug.org/PSTricks/.
-(http://tug.org/PSTricks/) This driver definitely does not come close to
-using the full capability of the PSTricks package.
-
-   Syntax:
-           set terminal pstricks
-                          {unit | size <XX>{unit},<YY>{unit}}
-                          {standalone | input}
-                          {blacktext | colortext | colourtext}
-                          {linewidth <lw>} {rounded | butt}
-                          {pointscale <ps>}
-                          {psarrows | gparrows}
-                          {background <rgbcolor>}
-                          {pstricks | pdftricks2}
-
-
-   The 'unit' option produces a plot with internal dimensions 1x1.  The
-default is a plot of 'size 5in,3in'.
-
-   'standalone' produces a LaTeX file with possibly multiple plots,
-ready to be compiled.  The default is 'input' to produce a TeX file
-which can be included.
-
-   'blacktext' forces all text to be written in black.  'colortext'
-enables colored text.  The default is 'blacktext'.
-
-   'rounded' sets line caps and line joins to be rounded.  'butt' sets
-butt caps and mitered joins and is the default.
-
-   'linewidth' and 'pointscale' scale the width of lines and the size of
-point symbols, respectively.
-
-   'psarrows' draws 'arrow's using PSTricks commands which are shorter
-but do not offer all options.  'gparrows' selects drawing arrows using
-gnuplot's own routine for full functionality instead.
-
-   With the option 'pdftricks2' you can create output for the
-'pdftricks2' macro package, which can be used with pdflatex/lualatex.
-Otherwise, output for the 'pstricks' package with traditional tex/latex
-or xelatex is produced.
-
-   The old 'hacktext' option has been replaced by the new default format
-(%h), see 'format specifiers'.
-
-   Transparency requires support by Ghostscript or conversion to PDF."
-
-
-File: gnuplot.info,  Node: qms,  Next: regis,  Prev: pstricks,  Up: complete_list_of_terminals
-
-4.1.40 qms
-----------
-
-The 'qms' terminal driver supports the QMS/QUIC Laser printer, the
-Talaris 1200 and others.  It has no options."
-
-
-File: gnuplot.info,  Node: regis,  Next: svg,  Prev: qms,  Up: complete_list_of_terminals
-
-4.1.41 regis
-------------
-
-Note: legacy terminal.  The 'regis' terminal device generates output in
-the REGIS graphics language.  It has the option of using 4 (the default)
-or 16 colors.
-
-   Syntax:
-           set terminal regis {4 | 16}"
-
-
-
-File: gnuplot.info,  Node: svg,  Next: tek410x,  Prev: regis,  Up: complete_list_of_terminals
-
-4.1.42 svg
-----------
-
-This terminal produces files in the W3C Scalable Vector Graphics format.
-
-   Syntax:
-           set terminal svg {size <x>,<y> {|fixed|dynamic}}
-                            {mouse} {standalone | jsdir <dirname>}
-                            {name <plotname>}
-                            {font "<fontname>{,<fontsize>}"} {{no}enhanced}
-                            {fontscale <multiplier>}
-                            {rounded|butt|square} {solid|dashed} {linewidth <lw>}
-                            {background <rgb_color>}
-
-
-   where <x> and <y> are the size of the SVG plot to generate, 'dynamic'
-allows a svg-viewer to resize plot, whereas the default setting,
-'fixed', will request an absolute size.
-
-   'linewidth <w>' increases the width of all lines used in the figure
-by a factor of <w>.
-
-   <font> is the name of the default font to use (default Arial) and
-<fontsize> is the font size (in points, default 12).  SVG viewing
-programs may substitute other fonts when the file is displayed.
-
-   The enhanced text mode syntax is shared with other gnuplot terminal
-types.  See 'enhanced' for more details.
-
-   The 'mouse' option tells gnuplot to add support for mouse tracking
-and for toggling individual plots on/off by clicking on the
-corresponding key entry.  By default this is done by including a link
-that points to a script in a local directory, usually
-/usr/local/share/gnuplot/<version>/js.  You can change this by using the
-'jsdir' option to specify either a different local directory or a
-general URL. The latter is usually appropriate if you are embedding the
-svg into a web page.  Alternatively, the 'standalone' option embeds the
-mousing code in the svg document itself rather than linking to an
-external resource.
-
-   When an SVG file will be used in conjunction with external files,
-e.g.  if it is referenced by javascript code in a web page or parent
-document, then a unique name is required to avoid potential conflicting
-references to other SVG plots.  Use the *note name:: option to ensure
-uniqueness.
-
-
-File: gnuplot.info,  Node: tek410x,  Next: tek40,  Prev: svg,  Up: complete_list_of_terminals
-
-4.1.43 tek410x
---------------
-
-The 'tek410x' terminal driver supports the 410x and 420x family of
-Tektronix terminals.  It has no options."
-
-
-File: gnuplot.info,  Node: tek40,  Next: texdraw,  Prev: tek410x,  Up: complete_list_of_terminals
-
-4.1.44 tek40
-------------
-
-Syntax:
-        set terminal sixeltek {<fontsize>} {mono|color|colors <n>} {size <x>,<y>}
-                              {animate}
-
-
-   The 'sixel' output format was originally used by DEC terminals and
-printers.  This driver supports palette images with a maximum of 256
-colors.  The default is 16 which can be changed using the 'colors'
-option.
-
-   The font size can be specified as 'small', 'medium' or 'large'.
-
-   'anchor' causes each new plot to be anchored at the top left of the
-window.  'scroll' intead draws each plot at the current cursor position
-and allows it to scroll with the text.
-
-   For use with xterm, xterm must be compiled/configured with
-"-enable-sixel-graphics" and started with "-ti 340" on the command line.
-
-   Note that gnuplot also supports another sixel output terminal,
-'sixelgd', that offers more options and features."
-
-   This family of terminal drivers supports a variety of VT-like
-terminals.  'tek40xx' supports Tektronix 4010 and others as well as most
-TEK emulators.  'vttek' supports VT-like tek40xx terminal emulators.
-The following are present only if selected when gnuplot is built:
-'kc-tek40xx' supports MS-DOS Kermit Tek4010 terminal emulators in color;
-'km-tek40xx' supports them in monochrome.  'selanar' supports Selanar
-graphics.  'bitgraph' supports BBN Bitgraph terminals.  None have any
-options."
-
-
-File: gnuplot.info,  Node: texdraw,  Next: tgif,  Prev: tek40,  Up: complete_list_of_terminals
-
-4.1.45 texdraw
---------------
-
-The 'texdraw' terminal driver supports the (La)TeX texdraw environment.
-It is intended for use with the texdraw package, see
-https://www.ctan.org/tex-archive/graphics/texdraw/ .
-
-           set terminal texdraw
-                          {size <XX>{unit},<YY>{unit}}
-                          {standalone | input}
-                          {blacktext | colortext | colourtext}
-                          {linewidth <lw>} {rounded | butt}
-                          {pointscale <ps>}
-                          {psarrows | gparrows} {texpoints | gppoints}
-                          {background <rgbcolor>}
-
-
-   Note: Graphics are in grayscale only.  Text is always black.  Boxes
-and polygons are filled using solid gray levels only.  Patterns are not
-available.
-
-   Points, among other things, are drawn using the LaTeX commands
-"\\Diamond" and "\\Box".  These commands no longer belong to the LaTeX2e
-core; they are included in the latexsym package, which is part of the
-base distribution and thus part of any LaTeX implementation.  Please do
-not forget to use this package.  Other point types use symbols from the
-amssymb package.  For compatibility with plain TeX you need to specify
-the 'gppoints' option.
-
-   'standalone' produces a LaTeX file with possibly multiple plots,
-ready to be compiled.  The default is 'input' to produce a TeX file
-which can be included.
-
-   'blacktext' forces all text to be written in black.  'colortext'
-enables "colored" text.  The default is 'blacktext' and "color" means
-grayscale really.
-
-   'rounded' sets line caps and line joins to be rounded; 'butt' sets
-butt caps and mitered joins and is the default.
-
-   'linewidth' and 'pointscale' scale the width of lines and the size of
-point symbols, respectively.  'pointscale' only applies to 'gppoints'.
-
-   'psarrows' draws 'arrow's using TeXdraw commands which are shorter
-but do not offer all options.  'gparrows' selects drawing arrows using
-gnuplot's own routine for full functionality instead.  Similarly,
-'texpoints', and 'gppoints' select LaTeX symbols or gnuplot's point
-drawing routines."
-
-
-File: gnuplot.info,  Node: tgif,  Next: tkcanvas,  Prev: texdraw,  Up: complete_list_of_terminals
-
-4.1.46 tgif
------------
-
-Legacy terminal (present only if gnuplot was configured -with-tgif).
-Tgif is/was an Xlib based interactive 2-D vector graphics drawing tool
-also capable of importing and marking up bitmap images.
-
-   The 'tgif' driver supports a choice of font and font size and
-multiple graphs on the page.  The proportions of the axes are not
-changed.
-
-   Syntax:
-           set terminal tgif {portrait | landscape | default} {<[x,y]>}
-                             {monochrome | color}
-                             {{linewidth | lw} <LW>}
-                             {solid | dashed}
-                             {font "<fontname>{,<fontsize>}"}
-
-
-   where <[x,y]> specifies the number of graphs in the x and y
-directions on the page, 'color' enables color, 'linewidth' scales all
-linewidths by <LW>, "<fontname>" is the name of a valid PostScript font,
-and <fontsize> specifies the size of the PostScript font.  'defaults'
-sets all options to their defaults: 'portrait', '[1,1]', 'color',
-'linewidth 1.0', 'dashed', '"Helvetica,18"'.
-
-   The 'solid' option is usually preferred if lines are colored, as they
-often are in the editor.  Hardcopy will be black-and-white, so 'dashed'
-should be chosen for that.
-
-   Multiplot is implemented in two different ways.
-
-   The first multiplot implementation is the standard gnuplot multiplot
-feature:
-
-           set terminal tgif
-           set output "file.obj"
-           set multiplot
-           set origin x01,y01
-           set size  xs,ys
-           plot ...
-                ...
-           set origin x02,y02
-           plot ...
-           unset multiplot
-
-
-   See *note multiplot:: for further information.
-
-   The second version is the [x,y] option for the driver itself.  The
-advantage of this implementation is that everything is scaled and placed
-automatically without the need for setting origins and sizes; the graphs
-keep their natural x/y proportions of 3/2 (or whatever is fixed by *note
-size::).
-
-   If both multiplot methods are selected, the standard method is chosen
-and a warning message is given.
-
-   Examples of single plots (or standard multiplot):
-           set terminal tgif                  # defaults
-           set terminal tgif "Times-Roman,24"
-           set terminal tgif landscape
-           set terminal tgif landscape solid
-
-
-   Examples using the built-in multiplot mechanism:
-           set terminal tgif portrait [2,4]  # portrait; 2 plots in the x-
-                                             # and 4 in the y-direction
-           set terminal tgif [1,2]           # portrait; 1 plot in the x-
-                                             # and 2 in the y-direction
-           set terminal tgif landscape [3,3] # landscape; 3 plots in both
-                                             # directions"
-
-
-
-File: gnuplot.info,  Node: tkcanvas,  Next: tpic,  Prev: tgif,  Up: complete_list_of_terminals
-
-4.1.47 tkcanvas
----------------
-
-This terminal driver generates Tk canvas widget commands in one of the
-following scripting languages: Tcl (default), Perl, Python, Ruby, or
-REXX.
-
-   Syntax:
-           set terminal tkcanvas {tcl | perl | perltkx | python | ruby | rexx}
-                                 {standalone | input}
-                                 {interactive}
-                                 {rounded | butt}
-                                 {nobackground | background <rgb color>}
-                                 {{no}rottext}
-                                 {size <width>,<height>}
-                                 {{no}enhanced}
-                                 {externalimages | pixels}
-
-
-   Execute the following sequence of Tcl/Tk commands to display the
-result:
-
-           package require Tk
-           # the following two lines are only required to support external images
-           package require img::png
-           source resize.tcl
-           source plot.tcl
-           canvas .c -width 800 -height 600
-           pack .c
-           gnuplot .c
-
-
-   Or, for Perl/Tk use a program like this:
-
-           use Tk;
-           my $top = MainWindow->new;
-           my $c = $top->Canvas(-width => 800, -height => 600)->pack;
-           my $gnuplot = do "plot.pl";
-           $gnuplot->($c);
-           MainLoop;
-
-
-   Or, for Perl/Tkx use a program like this:
-
-           use Tkx;
-           my $top = Tkx::widget->new(".");
-           my $c = $top->new_tk__canvas(-width => 800, -height => 600);
-           $c->g_pack;
-           my $gnuplot = do "plot.pl";
-           $gnuplot->($c);
-           Tkx::MainLoop();
-
-
-   Or, for Python/Tkinter use a program like this:
-
-           from tkinter import *
-           from tkinter import font
-           root = Tk()
-           c = Canvas(root, width=800, height=600)
-           c.pack()
-           exec(open('plot.py').read())
-           gnuplot(c)
-           root.mainloop()
-
-
-   Or, for Ruby/Tk use a program like this:
-
-           require 'tk'
-           root = TkRoot.new { title 'Ruby/Tk' }
-           c = TkCanvas.new(root, 'width'=>800, 'height'=>600) { pack  { } }
-           load('plot.rb')
-           gnuplot(c)
-           Tk.mainloop
-
-
-   Or, for Rexx/Tk use a program like this:
-
-           /**/
-           call RxFuncAdd 'TkLoadFuncs', 'rexxtk', 'TkLoadFuncs'
-           call TkLoadFuncs
-           cv = TkCanvas('.c', '-width', 800, '-height', 600)
-           call TkPack cv
-           call 'plot.rex' cv
-           do forever
-               cmd = TkWait()
-               if cmd = 'AWinClose' then leave
-               interpret 'call' cmd
-           end
-
-
-   The code generated by 'gnuplot' (in the above examples, this code is
-written to "plot.<ext>") contains the following procedures:
-
-   gnuplot(canvas)
-        takes the name of a canvas as its argument.
-        When called, it clears the canvas, finds the size of the canvas and
-        draws the plot in it, scaled to fit.
-
-
-   gnuplot_plotarea()
-        returns a list containing the borders of the plotting area
-        (xleft, xright, ytop, ybot) in canvas screen coordinates."
-        It works only for 2-dimensional plotting (`plot`).
-
-
-   gnuplot_axisranges()
-        returns the ranges of the two axes in plot coordinates
-        (x1min, x1max, y1min, y1max, x2min, x2max, y2min, y2max).
-        It works only for 2-dimensional plotting (`plot`).
-
-
-   You can create self-contained, minimal scripts using the 'standalone'
-option.  The default is 'input' which creates scripts which have to be
-source'd (or loaded or called or whatever the adequate term is for the
-language selected).
-
-   If the 'interactive' option is specified, mouse clicking on a line
-segment will print the coordinates of its midpoint to stdout.  The user
-can supersede this behavior by supplying a procedure
-user_gnuplot_coordinates which takes the following arguments:
-       win id x1s y1s x2s y2s x1e y1e x2e y2e x1m y1m x2m y2m,
-
-   i.e.  the name of the canvas and the id of the line segment followed
-by the coordinates of its start and end point in the two possible axis
-ranges; the coordinates of the midpoint are only filled for logarithmic
-axes.
-
-   By default the canvas is 'transparent', but an explicit background
-color can be set with the 'background' option.
-
-   'rounded' sets line caps and line joins to be rounded; 'butt' is the
-default: butt caps and mitered joins.
-
-   Text at arbitrary angles can be activated with the 'rottext' option,
-which requires Tcl/Tk 8.6 or later.  The default is 'norottext'.
-
-   The *note size:: option tries to optimize the tic and font sizes for
-the given canvas size.  By default an output size of 800 x 600 pixels is
-assumed.
-
-   'enhanced' selects 'enhanced text' processing (default), but is
-currently only available for Tcl.
-
-   The 'pixels' (default) option selects the failsafe pixel-by-pixel
-image handler, see also 'image pixels'.  The 'externalimages' option
-saves images as external png images, which are later loaded and scaled
-by the tkcanvas code.  This option is only available for Tcl and display
-may be slow in some situations since the Tk image handler does not
-provide arbitrary scaling.  Scripts need to source the provided
-rescale.tcl.
-
-   Interactive mode is not yet implemented for Python/Tk and Rexx/Tk.
-Interactive mode for Ruby/Tk does not yet support
-user_gnuplot_coordinates."
-
-
-File: gnuplot.info,  Node: tpic,  Next: windows,  Prev: tkcanvas,  Up: complete_list_of_terminals
-
-4.1.48 tpic
------------
-
-Note: Legacy terminal (not built by default).  The latex, emtex, eepic,
-and tpic terminals in older versions of gnuplot provided minimal support
-for graphics styles beyond simple lines and points.  They have been
-directly superseded by the 'pict2e' terminal.  For more capable
-TeX/LaTeX compatible terminal types see 'cairolatex', 'context',
-'epslatex', 'mp', 'pstricks', and 'tikz'.
-
-   The 'tpic' terminal driver supports the LaTeX picture environment
-with tpic \\specials.  Options are the point size, line width, and
-dot-dash interval.
-
-   Syntax:
-           set terminal tpic <pointsize> <linewidth> <interval>
-
-
-   where *note pointsize:: and 'linewidth' are integers in milli-inches
-and 'interval' is a float in inches.  If a non-positive value is
-specified, the default is chosen: pointsize = 40, linewidth = 6,
-interval = 0.1.
-
-   All drivers for LaTeX offer a special way of controlling text
-positioning: If any text string begins with '{', you also need to
-include a '}' at the end of the text, and the whole text will be
-centered both horizontally and vertically by LaTeX. -- If the text
-string begins with '[', you need to continue it with: a position
-specification (up to two out of t,b,l,r), ']{', the text itself, and
-finally, '}'.  The text itself may be anything LaTeX can typeset as an
-LR-box.  \\rule{}{}'s may help for best positioning.
-
-   Examples: About label positioning: Use gnuplot defaults (mostly
-sensible, but sometimes not really best):
-            set title '\\LaTeX\\ -- $ \\gamma $'
-
-   Force centering both horizontally and vertically:
-            set label '{\\LaTeX\\ -- $ \\gamma $}' at 0,0
-
-   Specify own positioning (top here):
-            set xlabel '[t]{\\LaTeX\\ -- $ \\gamma $}'
-
-   The other label - account for long ticlabels:
-            set ylabel '[r]{\\LaTeX\\ -- $ \\gamma $\\rule{7mm}{0pt}}'"
-
-
-
-File: gnuplot.info,  Node: windows,  Next: wxt,  Prev: tpic,  Up: complete_list_of_terminals
-
-4.1.49 windows
---------------
-
-The 'windows' terminal is a fast interactive terminal driver that uses
-the Windows GDI to draw and write text.  The cross-platform 'terminal
-wxt' and 'terminal qt' are also supported on Windows.
-
-   Syntax:
-           set terminal windows {<n>}
-                                {color | monochrome}
-                                {solid | dashed}
-                                {rounded | butt}
-                                {enhanced | noenhanced}
-                                {font <fontspec>}
-                                {fontscale <scale>}
-                                {linewidth <scale>}
-                                {pointscale <scale>}
-                                {background <rgb color>}
-                                {title "Plot Window Title"}
-                                {{size | wsize} <width>,<height>}
-                                {position <x>,<y>}
-                                {docked {layout <rows>,<cols>} | standalone}
-                                {close}
-
-
-   Multiple plot windows are supported: 'set terminal win <n>' directs
-the output to plot window number n.
-
-   'color' and *note monochrome:: select colored or mono output,
-'dashed' and 'solid' select dashed or solid lines.  Note that 'color'
-defaults to 'solid', whereas *note monochrome:: defaults to 'dashed'.
-'rounded' sets line caps and line joins to be rounded; 'butt' is the
-default, butt caps and mitered joins.  'enhanced' enables enhanced text
-mode features (subscripts, superscripts and mixed fonts, see 'enhanced
-text' for more information).  '<fontspec>' is in the format
-"<fontface>,<fontsize>", where "<fontface>" is the name of a valid
-Windows font, and <fontsize> is the size of the font in points and both
-components are optional.  Note that in previous versions of gnuplot the
-'font' statement could be left out and <fontsize> could be given as a
-number without double quotes.  This is no longer supported.
-'linewidth', 'fontscale', 'pointscale' can be used to scale the width of
-lines, the size of text, or the size of the point symbols.  *note
-title:: changes the title of the graph window.  *note size:: defines the
-width and height of the window's drawing area in pixels, 'wsize' defines
-the actual size of the window itself and *note position:: defines the
-origin of the window i.e.  the position of the top left corner on the
-screen (again in pixel).  These options override any default settings
-from the 'wgnuplot.ini' file.
-
-   'docked' embeds the graph window in the wgnuplot text window and the
-*note size:: and *note position:: options are ignored.  Note that
-'docked' is not available for console-mode gnuplot.  Setting this option
-changes the default for new" windows.  The initial default is
-'standalone'.  The 'layout' option allows to reserve a minimal number of
-columns and rows for graphs in docked mode.  If there are more graphs
-than fit the given layout, additional rows will be added.  Graphs are
-sorted by the numerical id, filling rows first.
-
-   Other options may be changed using the 'graph-menu' or the
-initialization file 'wgnuplot.ini'.
-
-   /* FIXME: Move to persist section */ The Windows version normally
-terminates immediately as soon as the end of any files given as command
-line arguments is reached (i.e.  in non-interactive mode), unless you
-specify '-' as the last command line option.  It will also not show the
-text-window at all, in this mode, only the plot.  By giving the optional
-argument '-persist' (same as for gnuplot under x11; former Windows-only
-options '/noend' or '-noend' are still accepted as well), will not close
-gnuplot.  Contrary to gnuplot on other operating systems, gnuplot's
-interactive command line is accessible after the -persist option.
-
-   The plot window remains open when the gnuplot terminal is changed
-with a 'set term' command.  The plot window can be closed with 'set term
-windows close'.
-
-   'gnuplot' supports different methods to create printed output on
-Windows, see 'windows printing'.  The windows terminal supports data
-exchange with other programs via clipboard and EMF files, see
-'graph-menu'.  You can also use the 'terminal emf' to create EMF files.
-
-* Menu:
-
-* graph-menu::
-* printing::
-* text-menu"::
-* wgnuplot.mnu"::
-* wgnuplot.ini::
-
-
-File: gnuplot.info,  Node: graph-menu,  Next: printing,  Prev: windows,  Up: windows
-
-4.1.49.1 graph-menu
-...................
-
-The 'gnuplot graph' window has the following options on a pop-up menu
-accessed by pressing the right mouse button(*) or selecting 'Options'
-from the system menu or the toolbar:
-
-   'Copy to Clipboard' copies a bitmap and an enhanced metafile picture.
-
-   'Save as EMF...' allows the user to save the current graph window as
-enhanced metafile (EMF or EMF+).
-
-   'Save as Bitmap...'  allows the user to save a copy of the graph as
-bitmap file.
-
-   'Print...'  prints the graphics windows using a Windows printer
-driver and allows selection of the printer and scaling of the output."
-See also 'windows printing'.
-
-   'Bring to Top' when checked raises the graph window to the top after
-every plot.
-
-   'Color' when checked enables color output.  When unchecked it forces
-all grayscale output.  This is e.g.  useful to test appearance of
-monochrome printouts.
-
-   'GDI backend' draws to the screen using Windows GDI. This is the
-classical windows terminal, which is fast, but lacks many features such
-as anti-aliasing, oversampling and full transparency support.  It is now
-deprecated.  The 'GDI backend' which uses the classic GDI API is
-deprecated and has been disabled in this version.
-
-   'GDI+ backend' draws to the screen using the GDI+ Windows API. It
-supports full antialiasing, oversampling, transparency and custom dash
-patterns.  This was the default in versions 5.0 and 5.2.
-
-   'Direct2D backend' uses Direct2D & DirectWrite APIs to draw.  It uses
-graphic card acceleration and is hence typically much faster.  Since
-Direct2D can" not create EMF data, saving and copying to clipboard of
-EMF data fall back" to GDI+ while bitmap data is generated by D2d.  This
-is the recommended and default backend since version 5.3.
-
-   'Oversampling' draws diagonal lines at fractional pixel positions to
-avoid "wobbling" effects.  Vertical or horizontal lines are still
-snapped to integer pixel positions to avoid blurry lines.
-
-   'Antialiasing' enables smoothing of lines and edges.  Note that this
-slows down drawing.  *note polygons:: is enabled by default but might
-slow down drawing with the GDI+ backend.
-
-   'Fast rotation' switches antialiasing temporarily off while rotating
-the graph with the mouse.  This speeds up drawing considerably at the
-expense of an additional redraw after releasing the mouse button.
-
-   'Background...'  sets the window background color.
-
-   'Choose Font...'  selects the font used in the graphics window.
-
-   'Line Styles...'  allows customization of the line colors and styles.
-
-   'Update wgnuplot.ini' saves the current window locations, window
-sizes, text window font, text window font size, graph window font, graph
-window font size, background color to the initialization file
-'wgnuplot.ini'.
-
-   (*) Note that this menu is only available by pressing the right mouse
-button with 'unset mouse'.
-
-
-File: gnuplot.info,  Node: printing,  Next: text-menu",  Prev: graph-menu,  Up: windows
-
-4.1.49.2 printing
-.................
-
-In order of preference, graphs may be printed in the following ways:
-
-   '1.'  Use the 'gnuplot' command *note terminal:: to select a printer
-and *note output:: to redirect output to a file.
-
-   '2.'  Select the 'Print...'  command from the 'gnuplot graph' window.
-An extra command 'screendump' does this from the text window.
-
-   '3.'  If 'set output "PRN"' is used, output will go to a temporary
-file.  When you exit from 'gnuplot' or when you change the output with
-another *note output:: command, a dialog box will appear for you to
-select a printer port.  If you choose OK, the output will be printed on
-the selected port, passing unmodified through the print manager.  It is
-possible to accidentally (or deliberately) send printer output meant for
-one printer to an incompatible printer.
-
-
-File: gnuplot.info,  Node: text-menu",  Next: wgnuplot.mnu",  Prev: printing,  Up: windows
-
-4.1.49.3 text-menu", /* FIXME: this is not really related to the windows driver, but the windows platform */
-............................................................................................................
-
-The 'gnuplot text' window has the following options on a pop-up menu
-accessed by pressing the right mouse button or selecting 'Options' from
-the system menu:
-
-   'Copy to Clipboard' copies marked text to the clipboard.
-
-   'Paste' copies text from the clipboard as if typed by the user.
-
-   'Choose Font...'  selects the font used in the text window.
-
-   'System Colors' when selected makes the text window honor the System
-Colors set using the Control Panel.  When unselected, text is black or
-blue on a white background.
-
-   'Wrap long lines' when selected lines longer than the current window
-width are wrapped.
-
-   'Update wgnuplot.ini' saves the current settings to the
-initialisation file 'wgnuplot.ini', which is located in the user's
-application data directory.
-
-
-File: gnuplot.info,  Node: wgnuplot.mnu",  Next: wgnuplot.ini,  Prev: text-menu",  Up: windows
-
-4.1.49.4 wgnuplot.mnu", /* FIXME: this is not really related to the windows driver, but the windows platform */
-...............................................................................................................
-
-If the menu file 'wgnuplot.mnu' is found in the same directory as
-'gnuplot', then the menu specified in 'wgnuplot.mnu' will be loaded.
-Menu commands:
-
-      [Menu]      starts a new menu with the name on the following line.
-      [EndMenu]   ends the current menu.
-      [--]        inserts a horizontal menu separator.
-      [|]         inserts a vertical menu separator.
-      [Button]    puts the next macro on a push button instead of a menu.
-
-
-   Macros take two lines with the macro name (menu entry) on the first
-line and the macro on the second line.  Leading spaces are ignored.
-Macro commands:
-
-      [INPUT]     Input string with prompt terminated by [EOS] or {ENTER}
-      [EOS]       End Of String terminator. Generates no output.
-      [OPEN]      Get name of a file to open, with the title of the dialog
-                  terminated by [EOS], followed by a default filename terminated
-                  by [EOS] or {ENTER}.
-      [SAVE]      Get name of a file to save.  Parameters like [OPEN]
-      [DIRECTORY] Get name of a directory, with the title of the dialog
-                  terminated by [EOS] or {ENTER}
-
-
-   Macro character substitutions:
-
-      {ENTER}     Carriage Return '\\r'
-      {TAB}       Tab '\\011'
-      {ESC}       Escape '\\033'
-      {^A}        '\\001'
-      ...
-      {^_}        '\\031'
-
-
-   Macros are limited to 256 characters after expansion.
-
-
-File: gnuplot.info,  Node: wgnuplot.ini,  Prev: wgnuplot.mnu",  Up: windows
-
-4.1.49.5 wgnuplot.ini
-.....................
-
-The Windows text window and the 'windows' terminal will read some of
-their options from the '[WGNUPLOT]' section of 'wgnuplot.ini'.  This
-file is located in the user's application data directory.  Here's a
-sample 'wgnuplot.ini' file:
-
-           [WGNUPLOT]
-           TextOrigin=0 0
-           TextSize=640 150
-           TextFont=Consolas,9
-           TextWrap=1
-           TextLines=400
-           TextMaximized=0
-           SysColors=0
-           GraphOrigin=0 150
-           GraphSize=640 330
-           GraphFont=Tahoma,10
-           GraphColor=1
-           GraphToTop=1
-           GraphGDI+=1
-           GraphD2D=0
-           GraphGDI+Oversampling=1
-           GraphAntialiasing=1
-           GraphPolygonAA=1
-           GraphFastRotation=1
-           GraphBackground=255 255 255
-           DockVerticalTextFrac=350
-           DockHorizontalTextFrac=400
-           Border=0 0 0 0 0
-           Axis=192 192 192 2 2
-           Line1=0 0 255 0 0
-           Line2=0 255 0 0 1
-           Line3=255 0 0 0 2
-           Line4=255 0 255 0 3
-           Line5=0 0 128 0 4
-
-
-   These settings apply to the wgnuplot text-window only."
-
-   The 'TextOrigin' and 'TextSize' entries specify the location and size
-of the text window.  If 'TextMaximized' is non-zero, the window will be
-maximized.
-
-   The 'TextFont' entry specifies the text window font and size.
-
-   The 'TextWrap' entry selects wrapping of long text lines.
-
-   The 'TextLines' entry specifies the number of (unwrapped) lines the
-internal buffer of the text window can hold.  This value currently
-cannot be changed from within wgnuplot.
-
-   See 'text-menu'.
-
-   'DockVerticalTextFrac' and 'DockHorizontalTextFrac' set the fraction
-of the window reserved for the text window in permille of the vertical
-or horizontal layout.
-
-   The 'GraphFont' entry specifies the font name and size in points.
-
-   The five numbers given in the 'Border', 'Axis' and 'Line' entries are
-the 'Red' intensity (0-255), 'Green' intensity, 'Blue' intensity, 'Color
-Linestyle' and 'Mono Linestyle'.  'Linestyles' are 0=SOLID, 1=DASH,
-2=DOT, 3=DASHDOT, 4=DASHDOTDOT. In the sample 'wgnuplot.ini' file above,
-Line 2 is a green solid line in color mode, or a dashed line in
-monochrome mode.  The default line width is 1 pixel.  If 'Linestyle' is
-negative, it specifies the width of a SOLID line in pixels.  Line1 and
-any linestyle used with the 'points' style must be SOLID with unit
-width.
-
-   See 'graph-menu'."
-
-
-File: gnuplot.info,  Node: wxt,  Next: x11,  Prev: windows,  Up: complete_list_of_terminals
-
-4.1.50 wxt
-----------
-
-The 'wxt' terminal device generates output in a separate window.  The
-window is created by the wxWidgets library, where the 'wxt' comes from.
-The actual drawing is done via cairo, a 2D graphics library, and pango,
-a library for laying out and rendering text.
-
-   Syntax:
-             set term wxt {<n>}
-                          {size <width>,<height>} {position <x>,<y>}
-                          {background <rgb_color> | nobackground}
-                          {{no}enhanced}
-                          {font <font>} {fontscale <scale>}
-                          {title "title"}
-                          {linewidth <lw>} {butt|rounded|square}
-                          {dashlength <dl>}
-                          {{no}persist}
-                          {{no}raise}
-                          {{no}ctrl}
-                          {close}
-
-
-   Multiple plot windows are supported: 'set terminal wxt <n>' directs
-the output to plot window number n.
-
-   The default window title is based on the window number.  This title
-can also be specified with the keyword "title".
-
-   Plot windows remain open even when the 'gnuplot' driver is changed to
-a different device.  A plot window can be closed by pressing the letter
-'q' while that window has input focus, by choosing 'close' from a window
-manager menu, or with 'set term wxt <n> close'.
-
-   The size of the plot area is given in pixels, it defaults to 640x384.
-In addition to that, the actual size of the window also includes the
-space reserved for the toolbar and the status bar.  When you resize a
-window, the plot is immediately scaled to fit in the new size of the
-window.  Unlike other interactive terminals, the 'wxt' terminal scales
-the whole plot, including fonts and linewidths, and keeps its global
-aspect ratio constant, leaving an empty space painted in gray.  If you
-type *note replot::, click the *note replot:: icon in the terminal
-toolbar or type a new 'plot' command, the new plot will completely fit
-in the window and the font size and the linewidths will be reset to
-their defaults.
-
-   The position option can be used to set the position of the plot
-window.  The position option only applies to the first plot after the
-'set term' command.
-
-   The active plot window (the one selected by 'set term wxt <n>') is
-interactive.  Its behaviour is shared with other terminal types.  See
-'mouse' for details.  It also has some extra icons, which are supposed
-to be self-explanatory.
-
-   This terminal supports an enhanced text mode, which allows font and
-other formatting commands (subscripts, superscripts, etc.)  to be
-embedded in labels and other text strings.  The enhanced text mode
-syntax is shared with other gnuplot terminal types.  See 'enhanced' for
-more details.
-
-   <font> is in the format "FontFace,FontSize", i.e.  the face and the
-size comma-separated in a single string.  FontFace is a usual font face
-name, such as \'Arial\'.  If you do not provide FontFace, the wxt
-terminal will use \'Sans\'.  FontSize is the font size, in points.  If
-you do not provide it, the wxt terminal will use a size of 10 points.
-        For example :
-           set term wxt font "Arial,12"
-           set term wxt font "Arial" # to change the font face only
-           set term wxt font ",12" # to change the font size only
-           set term wxt font "" # to reset the font name and size
-
-
-   The fonts are retrieved from the usual fonts subsystems.  Under
-Windows, those fonts are to be found and configured in the entry "Fonts"
-of the control panel.  Under UNIX, they are handled by "fontconfig".
-
-   Pango, the library used to layout the text, is based on utf-8.  Thus,
-the wxt terminal has to convert from your encoding to utf-8.  The
-default input encoding is based on your \'locale\'.  If you want to use
-another encoding, make sure gnuplot knows which one you are using.  See
-*note encoding:: for more details.
-
-   Pango may give unexpected results with fonts that do not respect the
-unicode mapping.  With the Symbol font, for example, the wxt terminal
-will use the map provided by http://www.unicode.org/ to translate
-character codes to unicode.  Pango will do its best to find a font
-containing this character, looking for your Symbol font, or other fonts
-with a broad unicode coverage, like the DejaVu fonts.  Note that "the
-Symbol font" is to be understood as the Adobe Symbol font, distributed
-with Acrobat Reader as "SY______.PFB". Alternatively, the OpenSymbol
-font, distributed with OpenOffice.org as "opens___.ttf", offers the same
-characters.  Microsoft has distributed a Symbol font ("symbol.ttf"), but
-it has a different character set with several missing or moved
-mathematic characters.  If you experience problems with your default
-setup (if the demo enhancedtext.dem is not displayed properly for
-example), you probably have to install one of the Adobe or OpenOffice
-Symbol fonts, and remove the Microsoft one.  Other non-conform fonts,
-such as "wingdings" have been observed working.
-
-   The rendering of the plot can be altered with a dialog available from
-the toolbar.  To obtain the best output possible, the rendering involves
-three mechanisms : antialiasing, oversampling and hinting.  Antialiasing
-allows to display non-horizontal and non-vertical lines smoother.
-Oversampling combined with antialiasing provides subpixel accuracy, so
-that gnuplot can draw a line from non-integer coordinates.  This avoids
-wobbling effects on diagonal lines ('plot x' for example).  Hinting
-avoids the blur on horizontal and vertical lines caused by oversampling.
-The terminal will snap these lines to integer coordinates so that a
-one-pixel-wide line will actually be drawn on one and only one pixel.
-
-   By default, the window is raised to the top of your desktop when a
-plot is drawn.  This can be controlled with the keyword "raise".  The
-keyword "persist" will prevent gnuplot from exiting before you
-explicitly close all the plot windows.  Finally, by default the key
-<space> raises the gnuplot console window, and 'q' closes the plot
-window.  The keyword "ctrl" allows you to replace those bindings by
-<ctrl>+<space> and <ctrl>+'q', respectively.  These three keywords
-(raise, persist and ctrl) can also be set and remembered between
-sessions through the configuration dialog."
-
-
-File: gnuplot.info,  Node: x11,  Next: xlib,  Prev: wxt,  Up: complete_list_of_terminals
-
-4.1.51 x11
-----------
-
-Syntax:
-        set terminal x11 {<n> | window "<string>"}
-                         {title "<string>"}
-                         {{no}enhanced} {font <fontspec>}
-                         {linewidth LW}
-                         {{no}persist} {{no}raise} {{no}ctrlq}
-                         {{no}replotonresize}
-                         {close}
-                         {size XX,YY} {position XX,YY}
-        set terminal x11 {reset}
-
-
-   Multiple plot windows are supported: 'set terminal x11 <n>' directs
-the output to plot window number n.  If n is not 0, the terminal number
-will be appended to the window title (unless a title has been supplied
-manually) and the icon will be labeled 'Gnuplot <n>'.  The active window
-may be distinguished by a change in cursor (from default to crosshair).
-
-   The 'x11' terminal can connect to X windows previously created by an
-outside application via the option 'window' followed by a string
-containing the X ID for the window in hexadecimal format.  Gnuplot uses
-that external X window as a container since X does not allow for
-multiple clients selecting the ButtonPress event.  In this way,
-gnuplot's mouse features work within the contained plot window.
-
-        set term x11 window "220001e"
-
-
-   The x11 terminal supports enhanced text mode (see 'enhanced'),
-subject to the available fonts.  In order for font size commands
-embedded in text to have any effect, the default x11 font must be
-scalable.  Thus the first example below will work as expected, but the
-second will not.
-
-        set term x11 enhanced font "arial,15"
-        set title '{/=20 Big} Medium {/=5 Small}'
-
-
-        set term x11 enhanced font "terminal-14"
-        set title '{/=20 Big} Medium {/=5 Small}'
-
-
-   Plot windows remain open even when the 'gnuplot' driver is changed to
-a different device.  A plot window can be closed by pressing the letter
-q while that window has input focus, or by choosing 'close' from a
-window manager menu.  All plot windows can be closed by specifying *note
-reset::, which actually terminates the subprocess which maintains the
-windows (unless '-persist' was specified).  The 'close' command can be
-used to close individual plot windows by number.  However, after a *note
-reset::, those plot windows left due to persist cannot be closed with
-the command 'close'.  A 'close' without a number closes the current
-active plot window.
-
-   The gnuplot outboard driver, gnuplot_x11, is searched in a default
-place chosen when the program is compiled.  You can override that by
-defining the environment variable GNUPLOT_DRIVER_DIR to point to a
-different location.
-
-   Plot windows will automatically be closed at the end of the session
-unless the '-persist' option was given.
-
-   The options 'persist' and *note raise:: are unset by default, which
-means that the defaults (persist == no and raise == yes) or the command
-line options -persist / -raise or the Xresources are taken.  If
-[no]persist or [no]raise are specified, they will override command line
-options and Xresources.  Setting one of these options takes place
-immediately, so the behaviour of an already running driver can be
-modified.  If the window does not get raised, see discussion in *note
-raise::.
-
-   The option 'replotonresize' (active by default) replots the data when
-the plot window is resized.  Without this option, the even-aspect-ratio
-scaling may result in the plot filling only part of the window after
-resizing.  With this option, gnuplot does a full replot on each resize
-event, resulting in better space utilization.  This option is generally
-desirable, unless the potentially CPU-intensive replotting during
-resizing is a concern.  Replots can be manually initiated with hotkey
-'e' or the 'replot' command.
-      "
-
-   The option 'title "<title name>"' will supply the title name of the
-window for the current plot window or plot window <n> if a number is
-given.  Where (or if) this title is shown depends on your X window
-manager.
-
-   The size option can be used to set the size of the plot window.  The
-size option will only apply to newly created windows.
-
-   The position option can be used to set the position of the plot
-window.  The position option will only apply to newly created windows.
-
-   The size or aspect ratio of a plot may be changed by resizing the
-'gnuplot' window.
-
-   Linewidths and pointsizes may be changed from within 'gnuplot' with
-'set linestyle'.
-
-   For terminal type 'x11', 'gnuplot' accepts (when initialized) the
-standard X Toolkit options and resources such as geometry, font, and
-name from the command line arguments or a configuration file.  See the
-X(1) man page (or its equivalent) for a description of such options.
-
-   A number of other 'gnuplot' options are available for the 'x11'
-terminal.  These may be specified either as command-line options when
-'gnuplot' is invoked or as resources in the configuration file
-".Xdefaults".  They are set upon initialization and cannot be altered
-during a 'gnuplot' session.  (except 'persist' and *note raise::)
-
-* Menu:
-
-* x11_fonts::
-* command-line_options_::
-* color_resources_::
-* grayscale_resources_::
-* line_resources_::
-* x11_pm3d_resources::
-* x11_other_resources::
-
-
-File: gnuplot.info,  Node: x11_fonts,  Next: command-line_options_,  Prev: x11,  Up: x11
-
-4.1.51.1 x11_fonts
-..................
-
-Upon initial startup, the default font is taken from the X11 resources
-as set in the system or user .Xdefaults file or on the command line.
-
-   Example:
-           gnuplot*font: lucidasans-bold-12
-
-   A new default font may be specified to the x11 driver from inside
-gnuplot using
-          `set term x11 font "<fontspec>"`
-
-   The driver first queries the X-server for a font of the exact name
-given.  If this query fails, then it tries to interpret <fontspec> as
-"<font>,<size>,<slant>,<weight>" and to construct a full X11 font name
-of the form
-           -*-<font>-<weight>-<s>-*-*-<size>-*-*-*-*-*-<encoding>
-
-
-      <font> is the base name of the font (e.g. Times or Symbol)
-      <size> is the point size (defaults to 12 if not specified)
-      <s> is 'i' if <slant>=="italic" 'o' if <slant>=="oblique" 'r' otherwise
-      <weight> is 'medium' or 'bold' if explicitly requested, otherwise '*'
-      <encoding> is set based on the current character set.
-
-   So 'set term x11 font "arial,15,italic"' will be translated to
--*-arial-*-i-*-*-15-*-*-*-*-*-iso8859-1 (assuming default encoding).
-The <size>, <slant>, and <weight> specifications are all optional.  If
-you do not specify <slant> or <weight> then you will get whatever font
-variant the font server offers first.  You may set a default encoding
-via the corresponding X11 resource.  E.g.
-           gnuplot*encoding: iso8859-15
-
-   The driver also recognizes some common PostScript font names and
-replaces them with possible X11 or TrueType equivalents.  This same
-sequence is used to process font requests from 'set label'.
-
-   If your gnuplot was built with configuration option
--enable-x11-mbfonts, you can specify multi-byte fonts by using the
-prefix "mbfont:" on the font name.  An additional font may be given,
-separated by a semicolon.  Since multi-byte font encodings are
-interpreted according to the locale setting, you must make sure that the
-environmental variable LC_CTYPE is set to some appropriate locale value
-such as ja_JP.eucJP, ko_KR.EUC, or zh_CN.EUC.
-
-   Example:
-           set term x11 font 'mbfont:kana14;k14'
-                 # 'kana14' and 'k14' are Japanese X11 font aliases, and ';'
-                 # is the separator of font names.
-           set term x11 font 'mbfont:fixed,16,r,medium'
-                 # <font>,<size>,<slant>,<weight> form is also usable.
-           set title '(mb strings)' font 'mbfont:*-fixed-medium-r-normal--14-*'
-
-
-   The same syntax applies to the default font in Xresources settings,
-for example,
-           gnuplot*font: \\
-               mbfont:-misc-fixed-medium-r-normal--14-*-*-*-c-*-jisx0208.1983-0
-
-
-   If gnuplot is built with -enable-x11-mbfonts, you can use two special
-PostScript font names 'Ryumin-Light-*' and 'GothicBBB-Medium-*'
-(standard Japanese PS fonts) without the prefix "mbfont:".
-
-
-File: gnuplot.info,  Node: command-line_options_,  Next: color_resources_,  Prev: x11_fonts,  Up: x11
-
-4.1.51.2 command-line_options
-.............................
-
-In addition to the X Toolkit options, the following options may be
-specified on the command line when starting 'gnuplot' or as resources in
-your ".Xdefaults" file (note that *note raise:: and 'persist' can be
-overridden later by 'set term x11 [no]raise [no]persist)':
-
-      `-mono`     forces monochrome rendering on color displays.
-      `-gray`     requests grayscale rendering on grayscale or color displays.
-                  (Grayscale displays receive monochrome rendering by default.)
-      `-clear`    requests that the window be cleared momentarily before a
-                  new plot is displayed.
-      `-tvtwm`    requests that geometry specifications for position of the
-                  window be made relative to the currently displayed portion
-                  of the virtual root.
-      `-raise`    raises plot window after each plot
-      `-noraise`  does not raise plot window after each plot
-      `-ctrlq   ` closes window on ctrl-q rather than q
-      `-persist`  plot windows survive after main gnuplot program exits
-
-
-   The options are shown above in their command-line syntax.  When
-entered as resources in ".Xdefaults", they require a different syntax.
-
-   Example:
-           gnuplot*gray:  on
-           gnuplot*ctrlq: on
-
-
-   'gnuplot' also provides a command line option ('-pointsize <v>') and
-a resource, 'gnuplot*pointsize: <v>', to control the size of points
-plotted with the 'points' plotting style.  The value 'v' is a real
-number (greater than 0 and less than or equal to ten) used as a scaling
-factor for point sizes.  For example, '-pointsize 2' uses points twice
-the default size, and '-pointsize 0.5' uses points half the normal size.
-
-   The '-ctrlq' switch changes the hot-key that closes a plot window
-from 'q' to '<ctrl>q'.  This is useful is you are using the
-keystroke-capture feature 'pause mouse keystroke', since it allows the
-character 'q' to be captured just as all other alphanumeric characters.
-The '-ctrlq' switch similarly replaces the <space> hot-key with
-<ctrl><space> for the same reason.
-
-
-File: gnuplot.info,  Node: color_resources_,  Next: grayscale_resources_,  Prev: command-line_options_,  Up: x11
-
-4.1.51.3 color_resources
-........................
-
-NB: THIS SECTION IS LARGELY IRRELEVANT IN GNUPLOT VERSION 5 The X11
-terminal honors the following resources (shown here with their default
-values) or the greyscale resources.  The values may be color names as
-listed in the X11 rgb.txt file on your system, hexadecimal RGB color
-specifications (see X11 documentation), or a color name followed by a
-comma and an 'intensity' value from 0 to 1.  For example, 'blue, 0.5'
-means a half intensity blue.
-
-      gnuplot*background:  white
-      gnuplot*textColor:   black
-      gnuplot*borderColor: black
-      gnuplot*axisColor:   black
-      gnuplot*line1Color:  red
-      gnuplot*line2Color:  green
-      gnuplot*line3Color:  blue
-      gnuplot*line4Color:  magenta
-      gnuplot*line5Color:  cyan
-      gnuplot*line6Color:  sienna
-      gnuplot*line7Color:  orange
-      gnuplot*line8Color:  coral
-
-
-   The command-line syntax for these is simple only for background,
-which maps directly to the usual X11 toolkit option "-bg".  All others
-can only be set on the command line by use of the generic "-xrm"
-resource override option
-
-   Examples:
-
-           gnuplot -background coral
-
-   to change the background color.
-
-           gnuplot -xrm 'gnuplot*line1Color:blue'
-
-   to override the first linetype color.
-
-
-File: gnuplot.info,  Node: grayscale_resources_,  Next: line_resources_,  Prev: color_resources_,  Up: x11
-
-4.1.51.4 grayscale_resources
-............................
-
-When '-gray' is selected, 'gnuplot' honors the following resources for
-grayscale or color displays (shown here with their default values).
-Note that the default background is black.
-
-      gnuplot*background: black
-      gnuplot*textGray:   white
-      gnuplot*borderGray: gray50
-      gnuplot*axisGray:   gray50
-      gnuplot*line1Gray:  gray100
-      gnuplot*line2Gray:  gray60
-      gnuplot*line3Gray:  gray80
-      gnuplot*line4Gray:  gray40
-      gnuplot*line5Gray:  gray90
-      gnuplot*line6Gray:  gray50
-      gnuplot*line7Gray:  gray70
-      gnuplot*line8Gray:  gray30
-
-
-
-File: gnuplot.info,  Node: line_resources_,  Next: x11_pm3d_resources,  Prev: grayscale_resources_,  Up: x11
-
-4.1.51.5 line_resources
-.......................
-
-NB: THIS SECTION IS LARGELY IRRELEVANT IN GNUPLOT VERSION 5 'gnuplot'
-honors the following resources for setting the width (in pixels) of plot
-lines (shown here with their default values.)  0 or 1 means a minimal
-width line of 1 pixel width.  A value of 2 or 3 may improve the
-appearance of some plots.
-
-      gnuplot*borderWidth: 1
-      gnuplot*axisWidth:   0
-      gnuplot*line1Width:  0
-      gnuplot*line2Width:  0
-      gnuplot*line3Width:  0
-      gnuplot*line4Width:  0
-      gnuplot*line5Width:  0
-      gnuplot*line6Width:  0
-      gnuplot*line7Width:  0
-      gnuplot*line8Width:  0
-
-
-   'gnuplot' honors the following resources for setting the dash style
-used for plotting lines.  0 means a solid line.  A two-digit number 'jk'
-('j' and 'k' are >= 1 and <= 9) means a dashed line with a repeated
-pattern of 'j' pixels on followed by 'k' pixels off.  For example, '16'
-is a dotted line with one pixel on followed by six pixels off.  More
-elaborate on/off patterns can be specified with a four-digit value.  For
-example, '4441' is four on, four off, four on, one off.  The default
-values shown below are for monochrome displays or monochrome rendering
-on color or grayscale displays.  Color displays default to dashed:off
-
-      gnuplot*dashed:       off
-      gnuplot*borderDashes:   0
-      gnuplot*axisDashes:    16
-      gnuplot*line1Dashes:    0
-      gnuplot*line2Dashes:   42
-      gnuplot*line3Dashes:   13
-      gnuplot*line4Dashes:   44
-      gnuplot*line5Dashes:   15
-      gnuplot*line6Dashes: 4441
-      gnuplot*line7Dashes:   42
-      gnuplot*line8Dashes:   13
-
-
-   , "
-
-
-File: gnuplot.info,  Node: x11_pm3d_resources,  Next: x11_other_resources,  Prev: line_resources_,  Up: x11
-
-4.1.51.6 x11 pm3d_resources
-...........................
-
-NB: THIS SECTION IS LARGELY IRRELEVANT IN GNUPLOT VERSION 5
-
-   By default 'gnuplot' uses the default visual of the screen.  The
-number of colors which can be allocated depends on the visual class
-chosen.  On a visual class with a depth > 12bit, gnuplot starts with a
-maximal number of 0x200 colors.  On a visual class with a depth > 8bit
-(but <= 12 bit) the maximal number of colors is 0x100, on <= 8bit
-displays the maximum number of colors is 240 (16 are left for line
-colors).
-
-   Gnuplot first starts to allocate the maximal number of colors as
-stated above.  If this fails, the number of colors is reduced by the
-factor 2 until gnuplot gets all colors which are requested.  If dividing
-*note maxcolors:: by 2 repeatedly results in a number which is smaller
-than 'mincolors' 'gnuplot' tries to install a private colormap.  In this
-case the window manager is responsible for swapping colormaps when the
-pointer is moved in and out the x11 driver's window.
-
-   The default for 'mincolors' is maxcolors / (num_colormaps > 1 ?  2 :
-8), where num_colormaps is the number of colormaps which are currently
-used by gnuplot (usually 1, if only one x11 window is open).
-
-
-File: gnuplot.info,  Node: x11_other_resources,  Prev: x11_pm3d_resources,  Up: x11
-
-4.1.51.7 x11 other_resources
-............................
-
-By default the contents of the current plot window are exported to the
-X11 clipboard in response to X events in the window.  Setting the
-resource 'gnuplot*exportselection' to 'off' or 'false' will disable
-this.
-
-   By default text rotation is done using a method that is fast, but can
-corrupt nearby colors depending on the background.  If this is a
-problem, you can set the resource 'gnuplot.fastrotate' to 'off'
-
-      gnuplot*exportselection:  off
-      gnuplot*fastrotate:  on
-      gnuplot*ctrlq:  off
-
-
-
-File: gnuplot.info,  Node: xlib,  Prev: x11,  Up: complete_list_of_terminals
-
-4.1.52 xlib
------------
-
-The 'xlib' terminal driver supports the X11 Windows System.  It
-generates gnuplot_x11 commands, but sends them to the output file
-specified by 'set output '<filename>''.  'set term x11' is equivalent to
-'set output "|gnuplot_x11 -noevents"; set term xlib'.  'xlib' takes the
-same set of options as 'x11'."
-
-
-File: gnuplot.info,  Node: Concept_Index,  Next: Command_Index,  Prev: Terminal_types,  Up: Top
-
-Concept Index
-*************
-
-[index]
-* Menu:
-
-* '+':                                   special-filenames.   (line   6)
-* '++':                                  special-filenames.   (line   6)
-* '-':                                   special-filenames.   (line   6)
-* .gnuplot:                              Start-up_(initialization).
-                                                              (line   6)
-* 3D:                                    3D_plots.            (line   6)
-* ?:                                     cbrt.                (line   6)
-* ? <1>:                                 exp.                 (line   7)
-* ? <2>:                                 exp.                 (line   9)
-* ? <3>:                                 gamma.               (line   9)
-* ? <4>:                                 inverf.              (line   7)
-* ? <5>:                                 imag.                (line   7)
-* ? <6>:                                 invnorm.             (line  10)
-* ? <7>:                                 invnorm.             (line   9)
-* ? <8>:                                 real.                (line   6)
-* ? <9>:                                 sqrt.                (line   8)
-* ? <10>:                                tanh.                (line   7)
-* ? <11>:                                voigt.               (line  10)
-* ? <12>:                                erfi.                (line   7)
-* ? <13>:                                erfi.                (line   8)
-* ? <14>:                                words.               (line   9)
-* ? <15>:                                words.               (line   9)
-* ? <16>:                                words.               (line   9)
-* ? <17>:                                words.               (line  11)
-* ? <18>:                                words.               (line  15)
-* ? <19>:                                words.               (line  19)
-* ? <20>:                                words.               (line  23)
-* ? <21>:                                words.               (line  27)
-* ? <22>:                                words.               (line  31)
-* ? <23>:                                words.               (line  33)
-* ? <24>:                                words.               (line  35)
-* ? <25>:                                words.               (line  38)
-* ? <26>:                                words.               (line  40)
-* ? <27>:                                words.               (line  40)
-* ? <28>:                                words.               (line  40)
-* ? <29>:                                words.               (line  39)
-* ? <30>:                                hsv2rgb.             (line   7)
-* ? <31>:                                rgbcolor.            (line  11)
-* ? <32>:                                rgbcolor.            (line  13)
-* ? <33>:                                rgbcolor.            (line  12)
-* abs:                                   abs.                 (line   6)
-* acos:                                  acos.                (line   6)
-* acosh:                                 acosh.               (line   6)
-* acsplines:                             smooth.              (line  61)
-* Ai:                                    Complex_Airy_functions.
-                                                              (line   6)
-* aifm:                                  aifm.                (line   6)
-* airy:                                  airy.                (line   6)
-* alpha channel:                         rgbcolor.            (line   6)
-* alpha channel <1>:                     image.               (line  57)
-* alpha channel <2>:                     colormap.            (line   6)
-* Amos:                                  Special_functions_with_complex_arguments.
-                                                              (line   6)
-* angles:                                angles.              (line   6)
-* animation:                             Animation.           (line   6)
-* aqua:                                  aqua.                (line   6)
-* arg:                                   arg.                 (line   6)
-* argv:                                  ARGV[_].             (line   6)
-* ARGV:                                  ARGV[_].             (line   6)
-* arrays:                                arrays.              (line   6)
-* arrow:                                 arrow.               (line   6)
-* arrows:                                arrows.              (line   6)
-* arrowstyle:                            set_style_arrow.     (line   6)
-* asin:                                  asin.                (line   6)
-* asinh:                                 asinh.               (line   6)
-* atan:                                  atan.                (line   6)
-* atan2:                                 atan2.               (line   6)
-* atanh:                                 atanh.               (line   6)
-* automated:                             automated_iteration_over_multiple_columns.
-                                                              (line   6)
-* autoscale:                             autoscale.           (line   6)
-* autotitle:                             key_autotitle.       (line   6)
-* avs:                                   filetype.            (line  21)
-* axes:                                  Coordinates.         (line   6)
-* axes <1>:                              Plotting.            (line  30)
-* axes <2>:                              axes.                (line   6)
-* azimuth:                               azimuth.             (line   6)
-* back:                                  layers.              (line   6)
-* background:                            background_color.    (line   6)
-* background <1>:                        special_linetypes.   (line   6)
-* backquotes:                            Substitution_of_system_commands_in_backquotes.
-                                                              (line   6)
-* bars:                                  errorbars.           (line   6)
-* batch/interactive:                     Batch/Interactive_Operation.
-                                                              (line   6)
-* be:                                    be.                  (line   6)
-* BE:                                    be.                  (line   6)
-* beeswarm:                              Bee_swarm_plots.     (line   6)
-* beeswarm <1>:                          jitter.              (line   6)
-* behind:                                layers.              (line   6)
-* besi0:                                 besi0.               (line   6)
-* besi1:                                 besi1.               (line   6)
-* besin:                                 besin.               (line   6)
-* besj0:                                 besj0.               (line   6)
-* besj1:                                 besj1.               (line   6)
-* besjn:                                 besjn.               (line   6)
-* BesselH1:                              Complex_Bessel_functions.
-                                                              (line  26)
-* BesselH2:                              Complex_Bessel_functions.
-                                                              (line  26)
-* BesselI:                               Complex_Bessel_functions.
-                                                              (line  16)
-* BesselJ:                               Complex_Bessel_functions.
-                                                              (line   6)
-* BesselK:                               Complex_Bessel_functions.
-                                                              (line  21)
-* BesselY:                               Complex_Bessel_functions.
-                                                              (line  11)
-* besy0:                                 besy0.               (line   6)
-* besy1:                                 besy1.               (line   6)
-* besyn:                                 besyn.               (line   6)
-* bezier:                                smooth.              (line  98)
-* bgnd:                                  colorspec.           (line  67)
-* bgnd <1>:                              background_color.    (line   6)
-* bgnd <2>:                              special_linetypes.   (line   6)
-* Bi:                                    Complex_Airy_functions.
-                                                              (line   6)
-* binary:                                binary.              (line   6)
-* bind:                                  bind.                (line   6)
-* bind <1>:                              reset.               (line  37)
-* bind <2>:                              bind_.               (line   6)
-* bins:                                  filters.             (line  15)
-* bitgraph:                              tek40.               (line  26)
-* bitwise operators:                     Binary.              (line  34)
-* black:                                 colorspec.           (line  69)
-* black <1>:                             special_linetypes.   (line   6)
-* block:                                 Glossary.            (line   6)
-* bmargin:                               bmargin.             (line   6)
-* bold:                                  Enhanced_text_mode.  (line   6)
-* border:                                fill_properties.     (line   6)
-* border <1>:                            border.              (line   6)
-* border <2>:                            set_style_fill.      (line  50)
-* boxdepth:                              boxdepth.            (line   6)
-* boxed:                                 set_style_textbox.   (line   6)
-* boxerrorbars:                          boxerrorbars.        (line   6)
-* boxes:                                 boxes.               (line   6)
-* boxplot:                               boxplot.             (line   6)
-* boxwidth:                              boxwidth.            (line   6)
-* boxxyerror:                            boxxyerror.          (line   6)
-* branch:                                multi-branch.        (line   6)
-* break:                                 Break.               (line   6)
-* broken axis:                           nonlinear.           (line  59)
-* bugs:                                  Seeking-assistance_/_Bugs.
-                                                              (line   6)
-* call:                                  call.                (line   6)
-* candlesticks:                          candlesticks.        (line   6)
-* canvas:                                Canvas_size.         (line   6)
-* canvas terminal:                       canvas.              (line   6)
-* cardinality:                           Unary.               (line  17)
-* cardinality <1>:                       Unary.               (line  24)
-* cardinality <2>:                       arrays.              (line   6)
-* cbdata:                                cbdata.              (line   6)
-* cbdtics:                               cbdtics.             (line   6)
-* cblabel:                               cblabel.             (line   6)
-* cbmtics:                               cbmtics.             (line   6)
-* cbrange:                               cbrange.             (line   6)
-* cbrt:                                  cbrt.                (line   6)
-* cbtics:                                cbtics.              (line   6)
-* cd:                                    cd.                  (line   6)
-* cdawson:                               cdawson.             (line   6)
-* ceil:                                  integer_conversion_functions_(int_floor_ceil_round).
-                                                              (line  36)
-* center:                                keywords.            (line  81)
-* cerf:                                  cerf.                (line   6)
-* cgm:                                   cgm.                 (line   6)
-* chi_shapes:                            chi_shapes.          (line   6)
-* circle:                                circle.              (line   6)
-* circles:                               circles.             (line   6)
-* clabel:                                clabel.              (line   6)
-* clear:                                 clear.               (line   6)
-* clip:                                  clip.                (line   6)
-* clip1in:                               clipping.            (line   6)
-* clip4in:                               clipping.            (line   6)
-* clipcb:                                clipping.            (line   6)
-* CMY:                                   Color_model.         (line   6)
-* cnormal:                               smooth.              (line 208)
-* cntrlabel:                             cntrlabel.           (line   6)
-* cntrparam:                             cntrparam.           (line   6)
-* colorbox:                              color_box.           (line   6)
-* colormap:                              colormap.            (line   6)
-* colornames:                            colornames.          (line   6)
-* colors:                                linetypes.           (line   6)
-* colors <1>:                            colorspec.           (line   6)
-* colors <2>:                            rgbformulae.         (line   6)
-* colors <3>:                            defined.             (line   6)
-* colorsequence:                         colorsequence.       (line   6)
-* colorspec:                             colorspec.           (line   6)
-* column:                                using_specifier_functions.
-                                                              (line  15)
-* column <1>:                            using.               (line  31)
-* columnhead:                            using_specifier_functions.
-                                                              (line  23)
-* columnheader:                          Datastrings.         (line  34)
-* columnheader <1>:                      using.               (line  33)
-* columnheader <2>:                      title.               (line   6)
-* columnheader <3>:                      key_autotitle.       (line   9)
-* columnheader <4>:                      name.                (line  16)
-* columnheaders:                         columnheaders.       (line   6)
-* columnheaders <1>:                     set_datafile_columnheaders.
-                                                              (line   6)
-* command-line-editing:                  Command-line-editing.
-                                                              (line   6)
-* command-line-options:                  command_line_options.
-                                                              (line   6)
-* commands:                              Commands.            (line   6)
-* comments:                              Comments.            (line   6)
-* commentschars:                         set_datafile_commentschars.
-                                                              (line   6)
-* complex:                               Complex_values.      (line   6)
-* concavehull:                           filters.             (line  96)
-* conj:                                  conj.                (line   6)
-* constants:                             Constants.           (line   6)
-* context:                               context.             (line   6)
-* continue:                              Continue.            (line   6)
-* contour:                               contour.             (line   6)
-* contourfill:                           contourfill.         (line   6)
-* contours:                              contour.             (line   6)
-* convexhull:                            filters.             (line  66)
-* coordinates:                           Coordinates.         (line   6)
-* copyright:                             Copyright.           (line   6)
-* corel:                                 corel.               (line   6)
-* cornerpoles:                           cornerpoles.         (line   6)
-* corners2color:                         corners2color.       (line   6)
-* cos:                                   cos.                 (line   6)
-* cosh:                                  cosh.                (line   6)
-* counting_words:                        Counting_and_extracting_words.
-                                                              (line   6)
-* csplines:                              smooth.              (line 107)
-* csv:                                   plot_with_table.     (line  32)
-* cubehelix:                             cubehelix.           (line   6)
-* cumulative:                            smooth.              (line 199)
-* cycle:                                 linetype.            (line  48)
-* dashtype:                              dashtype.            (line   6)
-* dashtype <1>:                          dashtype.            (line   6)
-* data:                                  data.                (line   6)
-* data-file:                             data.                (line   6)
-* datablocks:                            inline_data_and_datablocks.
-                                                              (line   6)
-* datafile:                              data.                (line   6)
-* datastrings:                           Datastrings.         (line   6)
-* date_specifiers:                       time/date_specifiers.
-                                                              (line   6)
-* Dawson's integral:                     cdawson.             (line   6)
-* debug:                                 debug.               (line   6)
-* decimalsign:                           decimalsign.         (line   6)
-* degrees:                               angles.              (line   6)
-* demos:                                 Demos_and_Online_Examples.
-                                                              (line   6)
-* depthorder:                            scanorder.           (line   6)
-* dgrid3d:                               dgrid3d.             (line   6)
-* division:                              Expressions.         (line   6)
-* do:                                    Do.                  (line   6)
-* dospc:                                 dospc.               (line   6)
-* dots:                                  dots.                (line   6)
-* dpu414:                                epson_180dpi.        (line   6)
-* dumb:                                  dumb.                (line   6)
-* dummy:                                 dummy.               (line   6)
-* dx:                                    keywords.            (line  45)
-* dxf:                                   dxf.                 (line   6)
-* dxy800a:                               dxy800a.             (line   6)
-* dy:                                    keywords.            (line  45)
-* edf:                                   filetype.            (line  29)
-* editing:                               Command-line-editing.
-                                                              (line   6)
-* eepic:                                 eepic.               (line   6)
-* ehf:                                   filetype.            (line  29)
-* ellipse:                               ellipse.             (line   6)
-* ellipses:                              ellipses.            (line   6)
-* elliptic:                              elliptic_integrals.  (line   6)
-* elliptic integrals:                    elliptic_integrals.  (line   6)
-* EllipticE:                             EllipticK.           (line   7)
-* EllipticK:                             cosh.                (line   7)
-* EllipticPi:                            EllipticE.           (line   7)
-* emf:                                   emf.                 (line   6)
-* emtex:                                 latex.               (line   6)
-* encoding:                              encoding.            (line   6)
-* encodings:                             encoding.            (line   6)
-* enhanced:                              Enhanced_text_mode.  (line   6)
-* environment:                           Environment.         (line   6)
-* epidemiological week:                  Time_functions.      (line  48)
-* epidemiological week <1>:              Time_functions.      (line  99)
-* epoch:                                 Time_functions.      (line  30)
-* eps:                                   postscript__(also_encapsulated_postscript_*.eps).
-                                                              (line   6)
-* epscairo:                              epscairo.            (line   6)
-* epson_180dpi:                          epson_180dpi.        (line   6)
-* epson_60dpi:                           epson_180dpi.        (line   6)
-* epson_lx800:                           epson_180dpi.        (line   6)
-* equal_axes:                            equal_axes.          (line   6)
-* erf:                                   erf.                 (line   6)
-* erfc:                                  erfc.                (line   6)
-* erfi:                                  erfi.                (line   6)
-* error state:                           Gnuplot-defined_variables.
-                                                              (line  24)
-* error state <1>:                       reset.               (line  34)
-* errorbars:                             yerrorbars.          (line   6)
-* errorbars <1>:                         errorbars.           (line   6)
-* errorlines:                            yerrorlines.         (line   6)
-* errors:                                Gnuplot-defined_variables.
-                                                              (line  24)
-* evaluate:                              evaluate.            (line   6)
-* every:                                 every.               (line   6)
-* example:                               example_datafile.    (line   6)
-* examples:                              Demos_and_Online_Examples.
-                                                              (line   6)
-* excl:                                  excl.                (line   6)
-* exists:                                exists.              (line   6)
-* exists <1>:                            Substitution_of_string_variables_as_macros.
-                                                              (line   6)
-* exit:                                  exit.                (line   6)
-* exp:                                   exp.                 (line   6)
-* expint:                                Expint.              (line   6)
-* exponentiation:                        Binary.              (line  34)
-* expressions:                           Expressions.         (line   6)
-* factorial:                             Unary.               (line  17)
-* faddeeva:                              faddeeva.            (line   6)
-* faq:                                   Seeking-assistance_/_Bugs.
-                                                              (line   6)
-* FAQ:                                   Seeking-assistance_/_Bugs.
-                                                              (line   6)
-* fc:                                    set_style_fill.      (line  39)
-* fenceplots:                            Fence_plots.         (line   6)
-* fig:                                   fig.                 (line   6)
-* file:                                  data.                (line   6)
-* filetype:                              filetype.            (line   6)
-* fillcolor:                             colorspec.           (line   6)
-* fillcolor <1>:                         set_style_fill.      (line  39)
-* filledcurves:                          filledcurves.        (line   6)
-* fillsteps:                             fillsteps.           (line   6)
-* fillstyle:                             set_style_fill.      (line   6)
-* filter:                                using.               (line 109)
-* filter <1>:                            stats_(Statistical_Summary).
-                                                              (line   6)
-* filters:                               filters.             (line   6)
-* financebars:                           financebars.         (line   6)
-* fit:                                   fit.                 (line   6)
-* fitting:                               short_introduction.  (line   6)
-* FIT_LOG:                               control.             (line   6)
-* fit_parameters:                        adjustable_parameters.
-                                                              (line   6)
-* FIT_SCRIPT:                            control.             (line   6)
-* fix:                                   noextend.            (line   6)
-* flipx:                                 keywords.            (line  60)
-* flipy:                                 keywords.            (line  60)
-* flipz:                                 keywords.            (line  60)
-* floating point exceptions:             set_datafile_nofpe_trap.
-                                                              (line   6)
-* floor:                                 integer_conversion_functions_(int_floor_ceil_round).
-                                                              (line  32)
-* flush:                                 scanorder.           (line   6)
-* fnormal:                               smooth.              (line 188)
-* fontconfig:                            cairo_(pdfcairo.     (line   6)
-* fontpath:                              fontpath.            (line   6)
-* fonts:                                 Fonts.               (line   6)
-* fonts <1>:                             cairo_(pdfcairo.     (line   6)
-* fonts <2>:                             gd_(png.             (line   6)
-* fonts <3>:                             postscript__(also_encapsulated_postscript_*.eps).
-                                                              (line   6)
-* fonts <4>:                             x11_fonts.           (line   6)
-* for:                                   for.                 (line   6)
-* format:                                format__.            (line   6)
-* format_specifiers:                     format_specifiers.   (line   6)
-* fortran:                               set_datafile_fortran.
-                                                              (line   6)
-* fpe_trap:                              set_datafile_nofpe_trap.
-                                                              (line   6)
-* frequency:                             smooth.              (line 173)
-* FresnelC:                              Fresnel_integrals_FresnelC(x)_and_FresnelS(x).
-                                                              (line   6)
-* FresnelS:                              Fresnel_integrals_FresnelC(x)_and_FresnelS(x).
-                                                              (line   6)
-* front:                                 layers.              (line   6)
-* fsteps:                                fsteps.              (line   6)
-* ftriangles:                            scanorder.           (line   6)
-* functionblocks:                        function_blocks.     (line   6)
-* functions:                             functions.           (line   6)
-* gamma:                                 Gamma.               (line   6)
-* gamma-correction:                      gamma_correction.    (line   6)
-* gd:                                    gd_(png.             (line   6)
-* geographic:                            geographic.          (line   6)
-* geomean:                               corners2color.       (line   6)
-* ggi:                                   ggi.                 (line   6)
-* gif:                                   gd_(png.             (line   6)
-* global:                                Scope_of_variables.  (line   6)
-* glossary:                              Glossary.            (line   6)
-* gnuplot:                               Gnuplot.             (line   6)
-* gnuplot-defined:                       Gnuplot-defined_variables.
-                                                              (line   6)
-* gnuplotrc:                             Start-up_(initialization).
-                                                              (line   6)
-* gpic:                                  gpic.                (line   6)
-* gprintf:                               gprintf_.            (line   6)
-* GPVAL:                                 Gnuplot-defined_variables.
-                                                              (line   6)
-* gpval:                                 Gnuplot-defined_variables.
-                                                              (line   6)
-* gradient:                              pixmap_from_colormap.
-                                                              (line   6)
-* graph-menu:                            graph-menu.          (line   6)
-* grass:                                 grass.               (line   6)
-* grayscale_resources:                   grayscale_resources_.
-                                                              (line   6)
-* grid:                                  grid.                (line   6)
-* GridDistance:                          vfill.               (line   6)
-* GridDistance <1>:                      vfill.               (line   6)
-* grid_data:                             grid_data.           (line   6)
-* Hankel:                                Complex_Bessel_functions.
-                                                              (line  26)
-* harmean:                               corners2color.       (line   6)
-* heatmaps:                              heatmaps.            (line   6)
-* heatmaps <1>:                          image_pixels.        (line   6)
-* help:                                  help.                (line   6)
-* help-desk:                             Seeking-assistance_/_Bugs.
-                                                              (line   6)
-* hexadecimal:                           Constants.           (line   6)
-* hidden3d:                              hidden3d.            (line   6)
-* histeps:                               histeps.             (line   6)
-* histogram:                             smooth.              (line 173)
-* histograms:                            histograms.          (line   6)
-* history:                               history.             (line   6)
-* hotkey:                                bind.                (line   6)
-* hotkeys:                               bind.                (line   6)
-* hp2623a:                               hp2623a.             (line   6)
-* hp2648:                                hp2648.              (line   6)
-* hp500c:                                hp500c.              (line   6)
-* hpdj:                                  hpljii.              (line   6)
-* hpgl:                                  hpgl.                (line   6)
-* hpljii:                                hpljii.              (line   6)
-* hppj:                                  hppj.                (line   6)
-* hsteps:                                hsteps.              (line   6)
-* hsv:                                   hsv2rgb.             (line   6)
-* HSV:                                   Color_model.         (line   6)
-* hsv2rgb:                               hsv2rgb.             (line   6)
-* hypertext:                             hypertext.           (line   6)
-* ibeta:                                 Ibeta.               (line   6)
-* if:                                    if.                  (line   6)
-* igamma:                                Igamma.              (line   6)
-* imag:                                  imag.                (line   6)
-* image:                                 image.               (line   6)
-* imagen:                                imagen.              (line   6)
-* import:                                import.              (line   6)
-* impulses:                              impulses.            (line   6)
-* index:                                 Array_indexing.      (line   6)
-* index <1>:                             index.               (line   6)
-* initialization:                        Start-up_(initialization).
-                                                              (line   6)
-* inline:                                inline_data_and_datablocks.
-                                                              (line   6)
-* inset:                                 Plotting.            (line  15)
-* inset <1>:                             clear.               (line   6)
-* inset <2>:                             clear.               (line   6)
-* inset <3>:                             multiplot.           (line  28)
-* int:                                   integer_conversion_functions_(int_floor_ceil_round).
-                                                              (line  26)
-* integer:                               integer_conversion_functions_(int_floor_ceil_round).
-                                                              (line   6)
-* interval:                              set_style_line.      (line   6)
-* introduction:                          Introduction.        (line   6)
-* inverf:                                inverf.              (line   6)
-* invibeta:                              Invibeta.            (line   6)
-* invigamma:                             Invigamma.           (line   6)
-* invnorm:                               invnorm.             (line   6)
-* isosamples:                            isosamples.          (line   6)
-* isosurface:                            isosurface.          (line   6)
-* isotropic:                             isotropic.           (line   6)
-* italic:                                Enhanced_text_mode.  (line   6)
-* iterate:                               iteration.           (line   6)
-* iteration:                             iteration.           (line   6)
-* iteration <1>:                         for_loops_in_plot_command.
-                                                              (line   6)
-* iteration <2>:                         set-show.            (line  19)
-* iteration <3>:                         unset.               (line   6)
-* iteration-specifier:                   iteration.           (line  23)
-* jitter:                                Bee_swarm_plots.     (line   6)
-* jitter <1>:                            jitter.              (line   6)
-* join:                                  Counting_and_extracting_words.
-                                                              (line  61)
-* join <1>:                              Counting_and_extracting_words.
-                                                              (line  61)
-* jpeg:                                  gd_(png.             (line   6)
-* kc-tek40xx:                            tek40.               (line   6)
-* kdensity:                              smooth.              (line 220)
-* kdensity <1>:                          dgrid3d.             (line   6)
-* keepfix:                               noextend.            (line   6)
-* key:                                   key_.                (line   6)
-* keyentry:                              extra_key_entries.   (line   6)
-* km-tek40xx:                            tek40.               (line   6)
-* kyo:                                   kyo.                 (line   6)
-* label:                                 label.               (line   6)
-* labels:                                labels.              (line   6)
-* labels <1>:                            mouse.               (line  51)
-* lambertw:                              lambertw.            (line   6)
-* LambertW:                              LambertW.            (line   6)
-* latex:                                 latex.               (line   6)
-* layers:                                layers.              (line   6)
-* layout:                                multiplot.           (line   6)
-* lc:                                    colorspec.           (line   6)
-* least-squares:                         fit.                 (line   6)
-* legend:                                key_.                (line   6)
-* legend <1>:                            multiple_keys.       (line   6)
-* lgamma:                                lgamma.              (line   6)
-* libcerf:                               Special_functions_with_complex_arguments.
-                                                              (line   6)
-* libopenspecfun:                        Special_functions_with_complex_arguments.
-                                                              (line   6)
-* license:                               Copyright.           (line   6)
-* lighting:                              lighting.            (line   6)
-* line-editing:                          Command-line-editing.
-                                                              (line   6)
-* linecolor:                             colorspec.           (line   6)
-* lines:                                 lines.               (line   6)
-* linespoints:                           linespoints.         (line   6)
-* linespoints <1>:                       set_style_line.      (line   6)
-* linestyle:                             set_style_line.      (line   6)
-* linetypes:                             linetypes.           (line   6)
-* linewidth:                             set_style_line.      (line   6)
-* linewidth <1>:                         set_style_line.      (line   6)
-* link:                                  link.                (line   6)
-* lmargin:                               lmargin.             (line   6)
-* lnGamma:                               lnGamma.             (line   6)
-* load:                                  load.                (line   6)
-* loadpath:                              loadpath.            (line   6)
-* local:                                 Scope_of_variables.  (line   6)
-* local <1>:                             local.               (line   6)
-* locale:                                decimalsign.         (line   6)
-* locale <1>:                            locale.              (line   6)
-* log:                                   log.                 (line   6)
-* log10:                                 log10.               (line   6)
-* logit:                                 nonlinear.           (line  47)
-* logscale:                              logscale.            (line   6)
-* logscale <1>:                          xtics_logscale.      (line   6)
-* lower:                                 raise.               (line   6)
-* lp:                                    linespoints.         (line   6)
-* lua:                                   lua.                 (line   6)
-* macros:                                Substitution_of_string_variables_as_macros.
-                                                              (line   6)
-* map:                                   deprecated_options.  (line   6)
-* mapping:                               mapping.             (line   6)
-* margins:                               margin.              (line   6)
-* markup:                                Enhanced_text_mode.  (line   6)
-* Marquardt:                             fit.                 (line   6)
-* mask:                                  filters.             (line 143)
-* masking:                               masking.             (line   6)
-* matrix:                                matrix.              (line   6)
-* max:                                   corners2color.       (line   6)
-* mcsplines:                             smooth.              (line 129)
-* mean:                                  corners2color.       (line   6)
-* median:                                corners2color.       (line   6)
-* metafont:                              mf.                  (line   6)
-* metapost:                              mp.                  (line   6)
-* mf:                                    mf.                  (line   6)
-* micro:                                 micro.               (line   6)
-* mif:                                   mif.                 (line   6)
-* min:                                   corners2color.       (line   6)
-* minussign:                             minussign.           (line   6)
-* missing:                               set_datafile_missing.
-                                                              (line   6)
-* mixing_macros_backquotes:              String_variables.    (line   6)
-* modulo:                                Binary.              (line  34)
-* modulus:                               abs.                 (line   9)
-* monochrome:                            monochrome.          (line   6)
-* mouse:                                 mouse.               (line   6)
-* mouseformat:                           mouseformat.         (line   6)
-* mousewheel:                            scrolling.           (line   6)
-* mousing:                               mouse.               (line   6)
-* mp:                                    mp.                  (line   6)
-* mttics:                                mttics.              (line   6)
-* multi-branch:                          multi-branch.        (line   6)
-* multiplot:                             Plotting.            (line  15)
-* multiplot <1>:                         multiplot.           (line   6)
-* mx2tics:                               mx2tics.             (line   6)
-* mxtics:                                mxtics.              (line   6)
-* my2tics:                               my2tics.             (line   6)
-* mytics:                                mytics.              (line   6)
-* mztics:                                mztics.              (line   6)
-* NaN:                                   Expressions.         (line  25)
-* NaN <1>:                               User-defined_variables_and_functions.
-                                                              (line  43)
-* NaN <2>:                               using.               (line 109)
-* nec_cp6:                               epson_180dpi.        (line   6)
-* negation:                              Unary.               (line  17)
-* new:                                   New_features_in_version_6.
-                                                              (line   6)
-* newhistogram:                          newhistogram.        (line   6)
-* newspiderplot:                         newspiderplot.       (line   6)
-* noarrow:                               arrow.               (line   6)
-* noautoscale:                           autoscale.           (line   6)
-* noborder:                              border.              (line   6)
-* nocbdtics:                             cbdtics.             (line   6)
-* nocbmtics:                             cbmtics.             (line   6)
-* nocbtics:                              cbtics.              (line   6)
-* noclipcb:                              clipping.            (line   6)
-* nocontour:                             contour.             (line   6)
-* nodgrid3d:                             dgrid3d.             (line   6)
-* nodraw:                                special_linetypes.   (line   6)
-* noextend:                              noextend.            (line   6)
-* nofpe_trap:                            set_datafile_nofpe_trap.
-                                                              (line   6)
-* nogrid:                                dgrid3d.             (line   6)
-* nohidden3d:                            hidden3d.            (line   6)
-* nokey:                                 key_.                (line   6)
-* nolabel:                               label.               (line   6)
-* nologscale:                            logscale.            (line   6)
-* nomouse:                               mouse.               (line   6)
-* nomttics:                              mttics.              (line   6)
-* nomultiplot:                           multiplot.           (line   6)
-* nomx2tics:                             mx2tics.             (line   6)
-* nomxtics:                              mxtics.              (line   6)
-* nomy2tics:                             my2tics.             (line   6)
-* nomytics:                              mytics.              (line   6)
-* nomztics:                              mztics.              (line   6)
-* nonlinear:                             nonlinear.           (line   6)
-* nonuniform:                            matrix.              (line  65)
-* nooffsets:                             offsets.             (line   6)
-* noparametric:                          parametric_.         (line   6)
-* nopolar:                               polar.               (line   6)
-* norm:                                  abs.                 (line   9)
-* norm <1>:                              norm.                (line   6)
-* nosurface:                             surface_.            (line   6)
-* notimestamp:                           timestamp.           (line   6)
-* nox2dtics:                             x2dtics.             (line   6)
-* nox2mtics:                             x2mtics.             (line   6)
-* nox2tics:                              x2tics.              (line   6)
-* nox2zeroaxis:                          x2zeroaxis.          (line   6)
-* noxdtics:                              xdtics.              (line   6)
-* noxmtics:                              xmtics.              (line   6)
-* noxtics:                               xtics.               (line   6)
-* noxzeroaxis:                           xzeroaxis.           (line   6)
-* noy2dtics:                             y2dtics.             (line   6)
-* noy2mtics:                             y2mtics.             (line   6)
-* noy2tics:                              y2tics.              (line   6)
-* noy2zeroaxis:                          y2zeroaxis.          (line   6)
-* noydtics:                              ydtics.              (line   6)
-* noymtics:                              ymtics.              (line   6)
-* noytics:                               ytics.               (line   6)
-* noyzeroaxis:                           yzeroaxis.           (line   6)
-* nozdtics:                              zdtics.              (line   6)
-* nozmtics:                              zmtics.              (line   6)
-* noztics:                               ztics.               (line   6)
-* nozzeroaxis:                           zzeroaxis.           (line   6)
-* objects:                               object.              (line   6)
-* octal:                                 Constants.           (line   6)
-* offsets:                               offsets.             (line   6)
-* okidata:                               epson_180dpi.        (line   6)
-* one's complement:                      Unary.               (line  17)
-* operator precedence:                   Unary.               (line  17)
-* operators:                             operators.           (line   6)
-* origin:                                origin.              (line   6)
-* output:                                output.              (line   6)
-* overflow:                              overflow.            (line   6)
-* palette:                               palette.             (line   6)
-* palette <1>:                           colormap.            (line   6)
-* palette <2>:                           palette__.           (line   6)
-* palette <3>:                           show_palette.        (line   6)
-* parallel:                              parallelaxes.        (line   6)
-* parallelaxes:                          parallelaxes.        (line   6)
-* parametric:                            parametric_.         (line   6)
-* path:                                  smooth.              (line 138)
-* pause:                                 pause.               (line   6)
-* paxis:                                 paxis.               (line   6)
-* pbm:                                   pbm.                 (line   6)
-* pdf:                                   cairo_(pdfcairo.     (line   6)
-* pdf <1>:                               pdf.                 (line   6)
-* perpendicular:                         keywords.            (line 107)
-* persist:                               Persist.             (line   6)
-* pi:                                    User-defined_variables_and_functions.
-                                                              (line  43)
-* piechart:                              circles.             (line  55)
-* piped-data:                            piped-data.          (line   6)
-* pipes:                                 piped-data.          (line   6)
-* pipes <1>:                             piped-data.          (line   6)
-* pixels:                                image_pixels.        (line   6)
-* pixmap:                                pixmap.              (line   6)
-* plot:                                  plot.                (line   6)
-* plot styles:                           Plotting_styles.     (line   6)
-* plotting:                              Plotting.            (line   6)
-* plugins:                               Plugins.             (line   6)
-* plugins <1>:                           import.              (line   6)
-* pm3d:                                  pm3d.                (line   6)
-* png:                                   cairo_(pdfcairo.     (line   6)
-* png <1>:                               gd_(png.             (line   6)
-* png <2>:                               png_.                (line   6)
-* pointinterval:                         linespoints.         (line   6)
-* pointinterval <1>:                     set_style_line.      (line   6)
-* pointintervalbox:                      pointintervalbox.    (line   6)
-* pointnumber:                           linespoints.         (line   6)
-* pointnumber <1>:                       set_style_line.      (line   6)
-* points:                                points.              (line   6)
-* pointsize:                             pointsize.           (line   6)
-* pointtype:                             points.              (line   6)
-* polar:                                 Polar_plots.         (line   6)
-* polar <1>:                             polar.               (line   6)
-* polygon:                               polygon.             (line   6)
-* polygons:                              polygons.            (line   6)
-* pop:                                   terminal.            (line   6)
-* postscript:                            postscript__(also_encapsulated_postscript_*.eps).
-                                                              (line   6)
-* precision:                             integer_conversion_functions_(int_floor_ceil_round).
-                                                              (line   6)
-* prescribe:                             kyo.                 (line   6)
-* print:                                 print.               (line   6)
-* printerr:                              printerr.            (line   6)
-* printing:                              printing.            (line   6)
-* projection:                            projection.          (line   6)
-* psdir:                                 psdir.               (line   6)
-* pseudo-mousing:                        pseudo-mousing_during_pause.
-                                                              (line   6)
-* pseudocolumns:                         using.               (line 147)
-* pseudofiles:                           special-filenames.   (line   6)
-* pstricks:                              pstricks.            (line   6)
-* punctuation:                           Syntax.              (line   6)
-* push:                                  terminal.            (line   6)
-* pwd:                                   pwd.                 (line   6)
-* qms:                                   qms.                 (line   6)
-* quit:                                  quit.                (line   6)
-* quotes:                                quote_marks.         (line   6)
-* raise:                                 raise.               (line   6)
-* rand:                                  rand.                (line   6)
-* rand <1>:                              Random_number_generator.
-                                                              (line   6)
-* random:                                Random_number_generator.
-                                                              (line   6)
-* range-frame:                           xtics_rangelimited.  (line   6)
-* rangelimited:                          xtics_rangelimited.  (line   6)
-* ranges:                                ranges.              (line   6)
-* ratio:                                 size.                (line   6)
-* raxis:                                 raxis.               (line   6)
-* real:                                  real.                (line   6)
-* record:                                Glossary.            (line   6)
-* rectangle:                             rectangle.           (line   6)
-* refresh:                               refresh.             (line   6)
-* regis:                                 regis.               (line   6)
-* remultiplot:                           remultiplot.         (line   6)
-* replot:                                replot.              (line   6)
-* reread:                                reread.              (line   6)
-* reset:                                 reset.               (line   6)
-* restore:                               xrange.              (line   6)
-* return:                                return.              (line   6)
-* RGB:                                   Color_model.         (line   6)
-* rgbalpha:                              image.               (line   6)
-* rgbcolor:                              rgbcolor.            (line   6)
-* rgbformulae:                           rgbformulae.         (line   6)
-* rgbimage:                              image.               (line   6)
-* rgbimage <1>:                          rgbmax.              (line   6)
-* rgbmax:                                rgbmax.              (line   6)
-* Riemann:                               zeta.                (line   6)
-* rlabel:                                rlabel.              (line   6)
-* rmargin:                               rmargin.             (line   6)
-* rms:                                   corners2color.       (line   6)
-* rotate:                                keywords.            (line  88)
-* round:                                 integer_conversion_functions_(int_floor_ceil_round).
-                                                              (line  40)
-* rrange:                                rrange.              (line   6)
-* rtics:                                 rtics.               (line   6)
-* sample:                                sampling.            (line   6)
-* samples:                               samples.             (line   6)
-* sampling:                              sampling.            (line   6)
-* save:                                  save.                (line   6)
-* sbezier:                               smooth.              (line 153)
-* scan:                                  keywords.            (line  12)
-* scansautomatic:                        scanorder.           (line   6)
-* scansbackward:                         scanorder.           (line   6)
-* scansforward:                          scanorder.           (line   6)
-* scope:                                 iteration.           (line  38)
-* scope <1>:                             Scope_of_variables.  (line   6)
-* screen:                                Glossary.            (line   6)
-* screendump:                            printing.            (line   6)
-* scrolling:                             scrolling.           (line   6)
-* sectors:                               sectors.             (line   6)
-* seeking-assistance:                    Seeking-assistance_/_Bugs.
-                                                              (line   6)
-* selanar:                               tek40.               (line   6)
-* separator:                             set_datafile_separator.
-                                                              (line   6)
-* session:                               reset.               (line  28)
-* set:                                   set-show.            (line   6)
-* sgn:                                   sgn.                 (line   6)
-* sharpen:                               filters.             (line 151)
-* shell:                                 shell.               (line   6)
-* show:                                  set-show.            (line   6)
-* sin:                                   sin.                 (line   6)
-* sinh:                                  sinh.                (line   6)
-* sixel:                                 gd_(png.             (line   6)
-* sixeltek:                              tek40.               (line   6)
-* size:                                  size.                (line   6)
-* sjis:                                  encoding.            (line   6)
-* SJIS:                                  encoding.            (line   6)
-* skip:                                  example_datafile.    (line  24)
-* skip <1>:                              skip_.               (line   6)
-* slice:                                 Array_functions.     (line   6)
-* smooth:                                smooth.              (line   6)
-* sparse:                                matrix.              (line 101)
-* special-filenames:                     special-filenames.   (line   6)
-* special_filenames:                     special-filenames.   (line   6)
-* special_functions:                     Special_functions_with_complex_arguments.
-                                                              (line   6)
-* special_linetypes:                     special_linetypes.   (line   6)
-* specify:                               Syntax.              (line   6)
-* spiderplot:                            spiderplot.          (line   6)
-* splines:                               smooth.              (line   6)
-* split:                                 Counting_and_extracting_words.
-                                                              (line  35)
-* split <1>:                             Counting_and_extracting_words.
-                                                              (line  35)
-* split <2>:                             Array_functions.     (line   6)
-* splot:                                 splot.               (line   6)
-* spotlight:                             lighting.            (line   6)
-* sprintf:                               sprintf.             (line   6)
-* sqrt:                                  sqrt.                (line   6)
-* square:                                size.                (line   6)
-* square <1>:                            size.                (line  45)
-* starc:                                 epson_180dpi.        (line   6)
-* start:                                 Start-up_(initialization).
-                                                              (line   6)
-* start-up:                              Start-up_(initialization).
-                                                              (line   6)
-* starting_values:                       starting_values.     (line   6)
-* startup:                               Start-up_(initialization).
-                                                              (line   6)
-* statistical_overview:                  statistical_overview.
-                                                              (line   6)
-* statistics:                            stats_(Statistical_Summary).
-                                                              (line   6)
-* stats:                                 stats_(Statistical_Summary).
-                                                              (line   6)
-* steps:                                 steps.               (line   6)
-* strcol:                                using_specifier_functions.
-                                                              (line  34)
-* strftime:                              strftime.            (line   6)
-* string:                                String_constants.    (line   6)
-* string operators:                      Binary.              (line  34)
-* stringcolumn:                          using_specifier_functions.
-                                                              (line  34)
-* strings:                               String_constants.    (line   6)
-* strlen:                                strlen.              (line   6)
-* strptime:                              strptime.            (line   6)
-* strstrt:                               strstrt.             (line   6)
-* style:                                 with.                (line   6)
-* subfigures:                            Plotting.            (line  15)
-* substitution:                          Substitution_and_Command_line_macros.
-                                                              (line   6)
-* substr:                                substr.              (line   6)
-* substring:                             substr.              (line   6)
-* substrings:                            substrings.          (line   6)
-* summation:                             summation.           (line   6)
-* surface:                               surface_plots.       (line   6)
-* surface <1>:                           surface_.            (line   6)
-* svg:                                   svg.                 (line   6)
-* svga:                                  svga.                (line   6)
-* SynchrotronF:                          Synchrotron_function.
-                                                              (line   6)
-* syntax:                                Syntax.              (line   6)
-* system:                                system.              (line   6)
-* system <1>:                            system_.             (line   6)
-* table:                                 table.               (line   6)
-* tan:                                   tan.                 (line   6)
-* tandy_60dpi:                           epson_180dpi.        (line   6)
-* tanh:                                  tanh.                (line   6)
-* tc:                                    colorspec.           (line   6)
-* tek40:                                 tek40.               (line   6)
-* tek410x:                               tek410x.             (line   6)
-* term:                                  complete_list_of_terminals.
-                                                              (line   6)
-* terminal:                              Glossary.            (line   6)
-* terminal <1>:                          complete_list_of_terminals.
-                                                              (line   6)
-* termoption:                            termoption.          (line   6)
-* ternary:                               Ternary.             (line   6)
-* test:                                  test.                (line   6)
-* texdraw:                               texdraw.             (line   6)
-* text-menu:                             text-menu".          (line   6)
-* textbox:                               set_style_textbox.   (line   6)
-* textcolor:                             colorspec.           (line   6)
-* text_markup:                           Enhanced_text_mode.  (line   6)
-* tgif:                                  tgif.                (line   6)
-* theta:                                 theta.               (line   6)
-* tics:                                  tics.                (line   6)
-* ticscale:                              ticscale.            (line   6)
-* ticslevel:                             ticslevel.           (line   6)
-* time:                                  Time_functions.      (line   8)
-* time/date:                             Time/Date_data.      (line   6)
-* timecolumn:                            Time_functions.      (line  21)
-* timefmt:                               timefmt.             (line   6)
-* timestamp:                             timestamp.           (line   6)
-* time_specifiers:                       time/date_specifiers.
-                                                              (line   6)
-* tips:                                  tips.                (line   6)
-* title:                                 title_.              (line   6)
-* tkcanvas:                              tkcanvas.            (line   6)
-* tmargin:                               tmargin.             (line   6)
-* tm_hour:                               words.               (line   9)
-* tm_mday:                               words.               (line  13)
-* tm_min:                                words.               (line  17)
-* tm_mon:                                words.               (line  21)
-* tm_sec:                                words.               (line  25)
-* tm_wday:                               words.               (line  29)
-* tm_week:                               Time_functions.      (line  48)
-* tm_yday:                               words.               (line  33)
-* tm_year:                               words.               (line  37)
-* toggle:                                toggle.              (line   6)
-* tpic:                                  tpic.                (line   6)
-* trange:                                trange.              (line   6)
-* transparency:                          transparency.        (line   6)
-* transparency <1>:                      colormap.            (line   6)
-* transparent:                           set_style_fill.      (line  70)
-* transpose:                             keywords.            (line  37)
-* trim:                                  trim.                (line   6)
-* trim <1>:                              Counting_and_extracting_words.
-                                                              (line  71)
-* trim <2>:                              Counting_and_extracting_words.
-                                                              (line  71)
-* ttics:                                 ttics.               (line   6)
-* uigamma:                               uigamma.             (line   6)
-* unary:                                 Unary.               (line   6)
-* undefine:                              undefine.            (line   6)
-* unicode:                               escape_sequences.    (line   6)
-* uniform:                               matrix.              (line  31)
-* unique:                                smooth.              (line 158)
-* unset:                                 unset.               (line   6)
-* unwrap:                                smooth.              (line 165)
-* update:                                update.              (line   6)
-* urange:                                urange.              (line   6)
-* user-defined:                          User-defined_variables_and_functions.
-                                                              (line   6)
-* using:                                 using.               (line   6)
-* UTF-8:                                 encoding.            (line   6)
-* utf8:                                  string_encoding.     (line   6)
-* utf8 <1>:                              encoding.            (line   6)
-* v6_changes:                            Plot_style_details.  (line   6)
-* valid:                                 using_specifier_functions.
-                                                              (line  43)
-* value:                                 value.               (line   6)
-* variable:                              variable_point_properties.
-                                                              (line   6)
-* variable <1>:                          variable_point_properties.
-                                                              (line   6)
-* variables:                             User-defined_variables_and_functions.
-                                                              (line   6)
-* vclear:                                vclear.              (line   6)
-* vectors:                               vectors.             (line   6)
-* version:                               New_features_in_version_6.
-                                                              (line   6)
-* version_5:                             Brief_summary_of_features_introduced_in_version_5.
-                                                              (line   6)
-* vfill:                                 vfill.               (line   6)
-* vgfill:                                vfill.               (line   6)
-* vgrid:                                 vgrid.               (line   6)
-* view:                                  view.                (line   6)
-* viridis:                               viridis.             (line   6)
-* voigt:                                 voigt.               (line   6)
-* volatile:                              volatile.            (line   6)
-* voxel:                                 voxel.               (line   6)
-* voxel-grids:                           voxel-grid.          (line   6)
-* VoxelDistance:                         vfill.               (line   6)
-* VoxelDistance <1>:                     vfill.               (line   6)
-* VP:                                    Voigt_Profile.       (line   6)
-* VP_fwhm:                               Voigt_Profile.       (line   6)
-* vrange:                                vrange.              (line   6)
-* vttek:                                 tek40.               (line   6)
-* vxrange:                               vxrange.             (line   6)
-* vyrange:                               vyrange.             (line   6)
-* vzrange:                               vzrange.             (line   6)
-* walls:                                 walls.               (line   6)
-* warn:                                  warn.                (line   6)
-* watch:                                 Watchpoints_.        (line   6)
-* watchpoints:                           Watchpoints_.        (line   6)
-* waterfallplots:                        3D_waterfall_plots.  (line   6)
-* weekdate_cdc:                          Time_functions.      (line  99)
-* weekdate_iso:                          Time_functions.      (line  73)
-* wgnuplot.ini:                          wgnuplot.ini.        (line   6)
-* wgnuplot.mnu:                          wgnuplot.mnu".       (line   6)
-* while:                                 While.               (line   6)
-* windows:                               windows.             (line   6)
-* windrose:                              sectors.             (line   6)
-* with:                                  with.                (line   6)
-* word:                                  word.                (line   6)
-* word <1>:                              Counting_and_extracting_words.
-                                                              (line   6)
-* words:                                 words.               (line   6)
-* words <1>:                             Counting_and_extracting_words.
-                                                              (line   6)
-* writeback:                             xrange.              (line   6)
-* wxt:                                   cairo_(pdfcairo.     (line   6)
-* wxt <1>:                               wxt.                 (line   6)
-* X resources:                           x11.                 (line 108)
-* X resources <1>:                       command-line_options_.
-                                                              (line  25)
-* X resources <2>:                       color_resources_.    (line   6)
-* X resources <3>:                       grayscale_resources_.
-                                                              (line   6)
-* X resources <4>:                       line_resources_.     (line   6)
-* X resources <5>:                       x11_pm3d_resources.  (line   6)
-* X resources <6>:                       x11_other_resources. (line   6)
-* x11:                                   x11.                 (line   6)
-* X11:                                   x11.                 (line   6)
-* x11_fonts:                             x11_fonts.           (line   6)
-* x2data:                                x2data.              (line   6)
-* x2dtics:                               x2dtics.             (line   6)
-* x2label:                               x2label.             (line   6)
-* x2mtics:                               x2mtics.             (line   6)
-* x2range:                               x2range.             (line   6)
-* x2tics:                                x2tics.              (line   6)
-* x2zeroaxis:                            x2zeroaxis.          (line   6)
-* xdata:                                 xdata.               (line   6)
-* xdtics:                                xdtics.              (line   6)
-* xerrorbars:                            xerrorbars.          (line   6)
-* xerrorlines:                           xerrorlines.         (line   6)
-* xfig:                                  fig.                 (line   6)
-* xlabel:                                xlabel.              (line   6)
-* xlib:                                  xlib.                (line   6)
-* xmtics:                                xmtics.              (line   6)
-* xrange:                                xrange.              (line   6)
-* xterm:                                 tek40.               (line   6)
-* xticlabels:                            using.               (line 194)
-* xtics:                                 xtics.               (line   6)
-* xyerrorbars:                           xyerrorbars.         (line   6)
-* xyerrorlines:                          xyerrorlines.        (line   6)
-* xyplane:                               xyplane.             (line   6)
-* xzeroaxis:                             xzeroaxis.           (line   6)
-* y2data:                                y2data.              (line   6)
-* y2dtics:                               y2dtics.             (line   6)
-* y2label:                               y2label.             (line   6)
-* y2mtics:                               y2mtics.             (line   6)
-* y2range:                               y2range.             (line   6)
-* y2tics:                                y2tics.              (line   6)
-* y2zeroaxis:                            y2zeroaxis.          (line   6)
-* ydata:                                 ydata.               (line   6)
-* ydtics:                                ydtics.              (line   6)
-* yerrorbars:                            yerrorbars.          (line   6)
-* yerrorlines:                           yerrorlines.         (line   6)
-* ylabel:                                ylabel.              (line   6)
-* ymtics:                                ymtics.              (line   6)
-* yrange:                                yrange.              (line   6)
-* ytics:                                 ytics.               (line   6)
-* yzeroaxis:                             yzeroaxis.           (line   6)
-* zclip:                                 with_pm3d_(pm3d_explicit).
-                                                              (line   6)
-* zdata:                                 zdata.               (line   6)
-* zdtics:                                zdtics.              (line   6)
-* zero:                                  zero.                (line   6)
-* zeroaxis:                              zeroaxis.            (line   6)
-* zerrorfill:                            Fence_plots.         (line   6)
-* zerrorfill <1>:                        Zerrorfill.          (line   6)
-* zeta:                                  zeta.                (line   6)
-* zlabel:                                zlabel.              (line   6)
-* zmtics:                                zmtics.              (line   6)
-* zoom:                                  zoom.                (line   6)
-* zrange:                                zrange.              (line   6)
-* zsort:                                 filters.             (line 173)
-* ztics:                                 ztics.               (line   6)
-* zzeroaxis:                             zzeroaxis.           (line   6)
-
-
-File: gnuplot.info,  Node: Command_Index,  Next: Options_Index,  Prev: Concept_Index,  Up: Top
-
-Command Index
-*************
-
-[index]
-* Menu:
-
-* call:                                  call.                  (line 6)
-* cd:                                    cd.                    (line 6)
-* clear:                                 clear.                 (line 6)
-* evaluate:                              evaluate.              (line 6)
-* exit:                                  exit.                  (line 6)
-* fit:                                   fit.                   (line 6)
-* for:                                   for.                   (line 6)
-* help:                                  help.                  (line 6)
-* history:                               history.               (line 6)
-* if:                                    if.                    (line 6)
-* import:                                import.                (line 6)
-* load:                                  load.                  (line 6)
-* local:                                 Scope_of_variables.    (line 6)
-* local <1>:                             local.                 (line 6)
-* lower:                                 raise.                 (line 6)
-* pause:                                 pause.                 (line 6)
-* plot:                                  plot.                  (line 6)
-* print:                                 print.                 (line 6)
-* printerr:                              printerr.              (line 6)
-* pwd:                                   pwd.                   (line 6)
-* quit:                                  quit.                  (line 6)
-* raise:                                 raise.                 (line 6)
-* refresh:                               refresh.               (line 6)
-* remultiplot:                           remultiplot.           (line 6)
-* replot:                                replot.                (line 6)
-* reread:                                reread.                (line 6)
-* reset:                                 reset.                 (line 6)
-* return:                                return.                (line 6)
-* save:                                  save.                  (line 6)
-* shell:                                 shell.                 (line 6)
-* show:                                  set-show.              (line 6)
-* splot:                                 splot.                 (line 6)
-* system:                                system.                (line 6)
-* system <1>:                            system_.               (line 6)
-* test:                                  test.                  (line 6)
-* toggle:                                toggle.                (line 6)
-* undefine:                              undefine.              (line 6)
-* unset:                                 unset.                 (line 6)
-* update:                                update.                (line 6)
-* vclear:                                vclear.                (line 6)
-* vfill:                                 vfill.                 (line 6)
-* warn:                                  warn.                  (line 6)
-
-
-File: gnuplot.info,  Node: Options_Index,  Next: Function_Index,  Prev: Command_Index,  Up: Top
-
-Options Index
-*************
-
-[index]
-* Menu:
-
-* angles:                                angles.               (line  6)
-* arrow:                                 arrow.                (line  6)
-* autoscale:                             autoscale.            (line  6)
-* bind:                                  bind.                 (line  6)
-* bind <1>:                              reset.                (line 37)
-* bind <2>:                              bind_.                (line  6)
-* bmargin:                               bmargin.              (line  6)
-* border:                                fill_properties.      (line  6)
-* border <1>:                            border.               (line  6)
-* border <2>:                            set_style_fill.       (line 50)
-* boxdepth:                              boxdepth.             (line  6)
-* boxwidth:                              boxwidth.             (line  6)
-* cbdata:                                cbdata.               (line  6)
-* cbdtics:                               cbdtics.              (line  6)
-* cblabel:                               cblabel.              (line  6)
-* cbmtics:                               cbmtics.              (line  6)
-* cbrange:                               cbrange.              (line  6)
-* cbtics:                                cbtics.               (line  6)
-* chi_shapes:                            chi_shapes.           (line  6)
-* clabel:                                clabel.               (line  6)
-* clip:                                  clip.                 (line  6)
-* cntrlabel:                             cntrlabel.            (line  6)
-* cntrparam:                             cntrparam.            (line  6)
-* colormap:                              colormap.             (line  6)
-* colornames:                            colornames.           (line  6)
-* colorsequence:                         colorsequence.        (line  6)
-* contour:                               contour.              (line  6)
-* contourfill:                           contourfill.          (line  6)
-* cornerpoles:                           cornerpoles.          (line  6)
-* dashtype:                              dashtype.             (line  6)
-* dashtype <1>:                          dashtype.             (line  6)
-* datafile:                              data.                 (line  6)
-* decimalsign:                           decimalsign.          (line  6)
-* dgrid3d:                               dgrid3d.              (line  6)
-* dummy:                                 dummy.                (line  6)
-* encoding:                              encoding.             (line  6)
-* errorbars:                             yerrorbars.           (line  6)
-* errorbars <1>:                         errorbars.            (line  6)
-* fontpath:                              fontpath.             (line  6)
-* format:                                format__.             (line  6)
-* grid:                                  grid.                 (line  6)
-* hidden3d:                              hidden3d.             (line  6)
-* isosamples:                            isosamples.           (line  6)
-* isosurface:                            isosurface.           (line  6)
-* isotropic:                             isotropic.            (line  6)
-* jitter:                                Bee_swarm_plots.      (line  6)
-* jitter <1>:                            jitter.               (line  6)
-* key:                                   key_.                 (line  6)
-* label:                                 label.                (line  6)
-* link:                                  link.                 (line  6)
-* lmargin:                               lmargin.              (line  6)
-* loadpath:                              loadpath.             (line  6)
-* locale:                                decimalsign.          (line  6)
-* locale <1>:                            locale.               (line  6)
-* logscale:                              logscale.             (line  6)
-* logscale <1>:                          xtics_logscale.       (line  6)
-* macros:                                Substitution_of_string_variables_as_macros.
-                                                               (line  6)
-* mapping:                               mapping.              (line  6)
-* micro:                                 micro.                (line  6)
-* minussign:                             minussign.            (line  6)
-* monochrome:                            monochrome.           (line  6)
-* mouse:                                 mouse.                (line  6)
-* mttics:                                mttics.               (line  6)
-* multiplot:                             Plotting.             (line 15)
-* multiplot <1>:                         multiplot.            (line  6)
-* mx2tics:                               mx2tics.              (line  6)
-* mxtics:                                mxtics.               (line  6)
-* my2tics:                               my2tics.              (line  6)
-* mytics:                                mytics.               (line  6)
-* mztics:                                mztics.               (line  6)
-* nonlinear:                             nonlinear.            (line  6)
-* offsets:                               offsets.              (line  6)
-* origin:                                origin.               (line  6)
-* output:                                output.               (line  6)
-* overflow:                              overflow.             (line  6)
-* palette:                               palette.              (line  6)
-* palette <1>:                           colormap.             (line  6)
-* palette <2>:                           palette__.            (line  6)
-* palette <3>:                           show_palette.         (line  6)
-* parametric:                            parametric_.          (line  6)
-* paxis:                                 paxis.                (line  6)
-* pixmap:                                pixmap.               (line  6)
-* pm3d:                                  pm3d.                 (line  6)
-* pointintervalbox:                      pointintervalbox.     (line  6)
-* pointsize:                             pointsize.            (line  6)
-* polar:                                 Polar_plots.          (line  6)
-* polar <1>:                             polar.                (line  6)
-* psdir:                                 psdir.                (line  6)
-* raxis:                                 raxis.                (line  6)
-* rgbmax:                                rgbmax.               (line  6)
-* rlabel:                                rlabel.               (line  6)
-* rmargin:                               rmargin.              (line  6)
-* rrange:                                rrange.               (line  6)
-* rtics:                                 rtics.                (line  6)
-* samples:                               samples.              (line  6)
-* size:                                  size.                 (line  6)
-* spiderplot:                            spiderplot.           (line  6)
-* style:                                 with.                 (line  6)
-* surface:                               surface_plots.        (line  6)
-* surface <1>:                           surface_.             (line  6)
-* table:                                 table.                (line  6)
-* terminal:                              Glossary.             (line  6)
-* terminal <1>:                          complete_list_of_terminals.
-                                                               (line  6)
-* termoption:                            termoption.           (line  6)
-* theta:                                 theta.                (line  6)
-* tics:                                  tics.                 (line  6)
-* ticscale:                              ticscale.             (line  6)
-* ticslevel:                             ticslevel.            (line  6)
-* timefmt:                               timefmt.              (line  6)
-* timestamp:                             timestamp.            (line  6)
-* title:                                 title_.               (line  6)
-* tmargin:                               tmargin.              (line  6)
-* trange:                                trange.               (line  6)
-* ttics:                                 ttics.                (line  6)
-* urange:                                urange.               (line  6)
-* version:                               New_features_in_version_6.
-                                                               (line  6)
-* vgrid:                                 vgrid.                (line  6)
-* view:                                  view.                 (line  6)
-* vrange:                                vrange.               (line  6)
-* vxrange:                               vxrange.              (line  6)
-* vyrange:                               vyrange.              (line  6)
-* vzrange:                               vzrange.              (line  6)
-* walls:                                 walls.                (line  6)
-* watchpoints:                           Watchpoints_.         (line  6)
-* x2data:                                x2data.               (line  6)
-* x2dtics:                               x2dtics.              (line  6)
-* x2label:                               x2label.              (line  6)
-* x2mtics:                               x2mtics.              (line  6)
-* x2range:                               x2range.              (line  6)
-* x2tics:                                x2tics.               (line  6)
-* x2zeroaxis:                            x2zeroaxis.           (line  6)
-* xdata:                                 xdata.                (line  6)
-* xdtics:                                xdtics.               (line  6)
-* xlabel:                                xlabel.               (line  6)
-* xmtics:                                xmtics.               (line  6)
-* xrange:                                xrange.               (line  6)
-* xtics:                                 xtics.                (line  6)
-* xyplane:                               xyplane.              (line  6)
-* xzeroaxis:                             xzeroaxis.            (line  6)
-* y2data:                                y2data.               (line  6)
-* y2dtics:                               y2dtics.              (line  6)
-* y2label:                               y2label.              (line  6)
-* y2mtics:                               y2mtics.              (line  6)
-* y2range:                               y2range.              (line  6)
-* y2tics:                                y2tics.               (line  6)
-* y2zeroaxis:                            y2zeroaxis.           (line  6)
-* ydata:                                 ydata.                (line  6)
-* ydtics:                                ydtics.               (line  6)
-* ylabel:                                ylabel.               (line  6)
-* ymtics:                                ymtics.               (line  6)
-* yrange:                                yrange.               (line  6)
-* ytics:                                 ytics.                (line  6)
-* yzeroaxis:                             yzeroaxis.            (line  6)
-* zdata:                                 zdata.                (line  6)
-* zdtics:                                zdtics.               (line  6)
-* zero:                                  zero.                 (line  6)
-* zeroaxis:                              zeroaxis.             (line  6)
-* zlabel:                                zlabel.               (line  6)
-* zmtics:                                zmtics.               (line  6)
-* zrange:                                zrange.               (line  6)
-* ztics:                                 ztics.                (line  6)
-* zzeroaxis:                             zzeroaxis.            (line  6)
-
-
-File: gnuplot.info,  Node: Function_Index,  Next: Terminal_Index,  Prev: Options_Index,  Up: Top
-
-Function Index
-**************
-
-[index]
-* Menu:
-
-* abs:                                   abs.                  (line  6)
-* acos:                                  acos.                 (line  6)
-* acosh:                                 acosh.                (line  6)
-* airy:                                  airy.                 (line  6)
-* arg:                                   arg.                  (line  6)
-* asin:                                  asin.                 (line  6)
-* asinh:                                 asinh.                (line  6)
-* atan:                                  atan.                 (line  6)
-* atan2:                                 atan2.                (line  6)
-* atanh:                                 atanh.                (line  6)
-* besi0:                                 besi0.                (line  6)
-* besi1:                                 besi1.                (line  6)
-* besin:                                 besin.                (line  6)
-* besj0:                                 besj0.                (line  6)
-* besj1:                                 besj1.                (line  6)
-* besjn:                                 besjn.                (line  6)
-* besy0:                                 besy0.                (line  6)
-* besy1:                                 besy1.                (line  6)
-* besyn:                                 besyn.                (line  6)
-* cbrt:                                  cbrt.                 (line  6)
-* cdawson:                               cdawson.              (line  6)
-* cerf:                                  cerf.                 (line  6)
-* conj:                                  conj.                 (line  6)
-* cos:                                   cos.                  (line  6)
-* cosh:                                  cosh.                 (line  6)
-* elliptic integrals:                    elliptic_integrals.   (line  6)
-* EllipticE:                             EllipticK.            (line  7)
-* EllipticK:                             cosh.                 (line  7)
-* EllipticPi:                            EllipticE.            (line  7)
-* erf:                                   erf.                  (line  6)
-* erfc:                                  erfc.                 (line  6)
-* erfi:                                  erfi.                 (line  6)
-* exists:                                exists.               (line  6)
-* exists <1>:                            Substitution_of_string_variables_as_macros.
-                                                               (line  6)
-* exp:                                   exp.                  (line  6)
-* faddeeva:                              faddeeva.             (line  6)
-* gamma:                                 Gamma.                (line  6)
-* gprintf:                               gprintf_.             (line  6)
-* hsv2rgb:                               hsv2rgb.              (line  6)
-* imag:                                  imag.                 (line  6)
-* inverf:                                inverf.               (line  6)
-* invnorm:                               invnorm.              (line  6)
-* join:                                  Counting_and_extracting_words.
-                                                               (line 61)
-* join <1>:                              Counting_and_extracting_words.
-                                                               (line 61)
-* lambertw:                              lambertw.             (line  6)
-* LambertW:                              LambertW.             (line  6)
-* lgamma:                                lgamma.               (line  6)
-* lnGamma:                               lnGamma.              (line  6)
-* log:                                   log.                  (line  6)
-* log10:                                 log10.                (line  6)
-* norm:                                  abs.                  (line  9)
-* norm <1>:                              norm.                 (line  6)
-* rand:                                  rand.                 (line  6)
-* rand <1>:                              Random_number_generator.
-                                                               (line  6)
-* real:                                  real.                 (line  6)
-* rgbcolor:                              rgbcolor.             (line  6)
-* sgn:                                   sgn.                  (line  6)
-* sin:                                   sin.                  (line  6)
-* sinh:                                  sinh.                 (line  6)
-* split:                                 Counting_and_extracting_words.
-                                                               (line 35)
-* split <1>:                             Counting_and_extracting_words.
-                                                               (line 35)
-* split <2>:                             Array_functions.      (line  6)
-* sprintf:                               sprintf.              (line  6)
-* sqrt:                                  sqrt.                 (line  6)
-* strftime:                              strftime.             (line  6)
-* strlen:                                strlen.               (line  6)
-* strptime:                              strptime.             (line  6)
-* strstrt:                               strstrt.              (line  6)
-* substr:                                substr.               (line  6)
-* tan:                                   tan.                  (line  6)
-* tanh:                                  tanh.                 (line  6)
-* trim:                                  trim.                 (line  6)
-* trim <1>:                              Counting_and_extracting_words.
-                                                               (line 71)
-* trim <2>:                              Counting_and_extracting_words.
-                                                               (line 71)
-* uigamma:                               uigamma.              (line  6)
-* value:                                 value.                (line  6)
-* voigt:                                 voigt.                (line  6)
-* voxel:                                 voxel.                (line  6)
-* word:                                  word.                 (line  6)
-* word <1>:                              Counting_and_extracting_words.
-                                                               (line  6)
-* words:                                 words.                (line  6)
-* words <1>:                             Counting_and_extracting_words.
-                                                               (line  6)
-* zeta:                                  zeta.                 (line  6)
-
-
-File: gnuplot.info,  Node: Terminal_Index,  Prev: Function_Index,  Up: Top
-
-Terminal Index
-**************
-
-[index]
-* Menu:
-
-* aqua:                                  aqua.                  (line 6)
-* cgm:                                   cgm.                   (line 6)
-* context:                               context.               (line 6)
-* corel:                                 corel.                 (line 6)
-* debug:                                 debug.                 (line 6)
-* dospc:                                 dospc.                 (line 6)
-* dpu414:                                epson_180dpi.          (line 6)
-* dumb:                                  dumb.                  (line 6)
-* dxf:                                   dxf.                   (line 6)
-* dxy800a:                               dxy800a.               (line 6)
-* eepic:                                 eepic.                 (line 6)
-* emf:                                   emf.                   (line 6)
-* emtex:                                 latex.                 (line 6)
-* epscairo:                              epscairo.              (line 6)
-* excl:                                  excl.                  (line 6)
-* ggi:                                   ggi.                   (line 6)
-* gpic:                                  gpic.                  (line 6)
-* graph-menu:                            graph-menu.            (line 6)
-* grass:                                 grass.                 (line 6)
-* hp2623a:                               hp2623a.               (line 6)
-* hp2648:                                hp2648.                (line 6)
-* hp500c:                                hp500c.                (line 6)
-* hpdj:                                  hpljii.                (line 6)
-* hpgl:                                  hpgl.                  (line 6)
-* hpljii:                                hpljii.                (line 6)
-* hppj:                                  hppj.                  (line 6)
-* imagen:                                imagen.                (line 6)
-* kc-tek40xx:                            tek40.                 (line 6)
-* kyo:                                   kyo.                   (line 6)
-* latex:                                 latex.                 (line 6)
-* lua:                                   lua.                   (line 6)
-* mif:                                   mif.                   (line 6)
-* okidata:                               epson_180dpi.          (line 6)
-* pbm:                                   pbm.                   (line 6)
-* pdf:                                   cairo_(pdfcairo.       (line 6)
-* pdf <1>:                               pdf.                   (line 6)
-* png:                                   cairo_(pdfcairo.       (line 6)
-* png <1>:                               gd_(png.               (line 6)
-* png <2>:                               png_.                  (line 6)
-* prescribe:                             kyo.                   (line 6)
-* pstricks:                              pstricks.              (line 6)
-* qms:                                   qms.                   (line 6)
-* regis:                                 regis.                 (line 6)
-* sixeltek:                              tek40.                 (line 6)
-* starc:                                 epson_180dpi.          (line 6)
-* svg:                                   svg.                   (line 6)
-* svga:                                  svga.                  (line 6)
-* tek40:                                 tek40.                 (line 6)
-* tek410x:                               tek410x.               (line 6)
-* texdraw:                               texdraw.               (line 6)
-* text-menu:                             text-menu".            (line 6)
-* tgif:                                  tgif.                  (line 6)
-* tkcanvas:                              tkcanvas.              (line 6)
-* tpic:                                  tpic.                  (line 6)
-* vttek:                                 tek40.                 (line 6)
-* wgnuplot.ini:                          wgnuplot.ini.          (line 6)
-* wgnuplot.mnu:                          wgnuplot.mnu".         (line 6)
-* windows:                               windows.               (line 6)
-* wxt:                                   cairo_(pdfcairo.       (line 6)
-* wxt <1>:                               wxt.                   (line 6)
-* xlib:                                  xlib.                  (line 6)
-* xterm:                                 tek40.                 (line 6)
-
-
-
-Tag Table:
-Node: Top204
-Node: Gnuplot1159
-Node: Copyright2047
-Node: Introduction4132
-Node: Seeking-assistance_/_Bugs8334
-Node: New_features_in_version_69953
-Node: Function_blocks_and_scoped_variables11134
-Node: Special_and_complex-valued_functions13216
-Node: New_plot_styles15597
-Node: Hulls17936
-Node: Named_palettes19437
-Node: New_data_formats20354
-Node: New_built-in_functions_and_array_operations21053
-Node: Program_control_flow22359
-Node: Multiplots23410
-Node: New_terminals_and_terminal_options25356
-Node: Watchpoints26691
-Node: Week-date_time_support27540
-Node: Other_new_features28539
-Node: Brief_summary_of_features_introduced_in_version_531098
-Node: Features_introduced_in_5.431455
-Node: Features_introduced_in_5.232773
-Node: Features_introduced_in_5.033533
-Node: Differences_between_versions_5_and_634309
-Node: Plot_style_details34783
-Node: Deprecated_syntax35592
-Node: Demos_and_Online_Examples37049
-Node: Batch/Interactive_Operation37679
-Node: command_line_options38445
-Node: Examples39402
-Node: Canvas_size40200
-Node: Command-line-editing41527
-Node: Comments43018
-Node: Coordinates43529
-Node: Datastrings45863
-Node: Enhanced_text_mode47874
-Node: escape_sequences52446
-Node: Environment53802
-Node: Expressions56084
-Node: Complex_values58482
-Node: Constants60397
-Node: Functions61885
-Node: abs63508
-Node: acos63922
-Node: acosh64192
-Node: airy64434
-Node: arg64780
-Node: asin64998
-Node: asinh65262
-Node: atan65501
-Node: atan265775
-Node: atanh66118
-Node: besj066365
-Node: besj166607
-Node: besjn66849
-Node: besy067038
-Node: besy167280
-Node: besyn67522
-Node: besi067711
-Node: besi167946
-Node: besin68181
-Node: cbrt68382
-Node: conj68689
-Node: cos68879
-Node: cosh69125
-Node: EllipticK69360
-Node: EllipticE69619
-Node: EllipticPi69885
-Node: erf70149
-Node: erfc70484
-Node: exp70814
-Node: gamma71161
-Node: inverf71509
-Node: imag71751
-Node: invnorm72025
-Node: lambertw72297
-Node: lgamma72620
-Node: lngamma72962
-Node: log73375
-Node: log1073585
-Node: norm73769
-Node: rand74045
-Node: real74263
-Node: sgn74549
-Node: Sign74849
-Node: sin75070
-Node: sinh75320
-Node: sqrt75548
-Node: tan75804
-Node: tanh76057
-Node: voigt76289
-Node: cerf76721
-Node: cdawson76931
-Node: faddeeva77212
-Node: erfi77545
-Node: Voigt_Profile77750
-Node: gprintf78104
-Node: sprintf78477
-Node: strlen78947
-Node: strstrt79505
-Node: substr80017
-Node: split80377
-Node: join81020
-Node: strftime81374
-Node: strptime81657
-Node: system81970
-Node: trim82400
-Node: word82784
-Node: words83011
-Node: exists84485
-Node: hsv2rgb84788
-Node: palette85013
-Node: rgbcolor85268
-Node: voxel85791
-Node: integer_conversion_functions_(int_floor_ceil_round)86236
-Node: elliptic_integrals88359
-Node: Complex_Airy_functions89487
-Node: Complex_Bessel_functions89933
-Node: Expint91410
-Node: Fresnel_integrals_FresnelC(x)_and_FresnelS(x)92131
-Node: Gamma92586
-Node: Igamma92962
-Node: Invigamma94169
-Node: Ibeta94602
-Node: Invibeta95049
-Node: LambertW95477
-Node: lnGamma95989
-Node: Random_number_generator96431
-Node: Special_functions_with_complex_arguments97360
-Node: Synchrotron_function98677
-Node: Time_functions99211
-Node: uigamma104093
-Node: using_specifier_functions104565
-Node: value107110
-Node: Counting_and_extracting_words107746
-Node: zeta110976
-Node: operators111487
-Node: Unary112092
-Node: Binary113108
-Node: Ternary115098
-Node: summation116567
-Node: Gnuplot-defined_variables117559
-Node: User-defined_variables_and_functions119585
-Node: arrays122086
-Node: Array_functions124052
-Node: Array_indexing124929
-Node: Fonts125663
-Node: cairo_(pdfcairo126659
-Node: gd_(png127380
-Node: postscript__(also_encapsulated_postscript_*.eps)129107
-Node: Glossary130922
-Node: inline_data_and_datablocks132259
-Node: iteration133719
-Node: linetypes135506
-Node: colorspec138044
-Node: background_color141332
-Node: linecolor_variable142047
-Node: palette_143251
-Node: rgbcolor_variable144596
-Node: dashtype145661
-Node: linestyles_vs_linetypes147852
-Node: special_linetypes148823
-Node: layers149898
-Node: mouse_input151358
-Node: bind152037
-Node: bind_space155285
-Node: Mouse_variables155715
-Node: Persist157404
-Node: Plotting158569
-Node: Plugins161244
-Node: Scope_of_variables162794
-Node: Start-up_(initialization)164973
-Node: String_constants165701
-Node: substrings167207
-Node: string_operators168096
-Node: string_functions168508
-Node: string_encoding168981
-Node: Substitution_and_Command_line_macros169460
-Node: Substitution_of_system_commands_in_backquotes170053
-Node: Substitution_of_string_variables_as_macros171247
-Node: String_variables173413
-Node: Syntax174951
-Node: quote_marks177107
-Node: Time/Date_data178842
-Node: Watchpoints_182491
-Node: watch_mouse185559
-Node: watch_labels186290
-Node: Plotting_styles186866
-Node: arrows188493
-Node: arrowstyle_variable189677
-Node: Bee_swarm_plots190366
-Node: boxerrorbars191038
-Node: boxes192673
-Node: 2D_boxes193543
-Node: 3D_boxes195056
-Node: boxplot196757
-Node: boxxyerror200822
-Node: candlesticks202032
-Node: circles205138
-Node: contourfill207448
-Node: dots208637
-Node: ellipses209179
-Node: filledcurves211759
-Node: above/below213854
-Node: 3D_waterfall_plots214689
-Node: fill_properties215572
-Node: financebars216282
-Node: fillsteps217268
-Node: fsteps218047
-Node: histeps218800
-Node: heatmaps219771
-Node: histograms222328
-Node: newhistogram229718
-Node: automated_iteration_over_multiple_columns232072
-Node: histogram_color_assignments232659
-Node: hsteps234798
-Node: offset239000
-Node: missing_data239798
-Node: image240445
-Node: transparency244142
-Node: image_pixels244762
-Node: impulses245543
-Node: labels246218
-Node: lines248651
-Node: linespoints249340
-Node: masking250584
-Node: parallelaxes252633
-Node: Polar_plots253930
-Node: points254912
-Node: variable_point_properties256059
-Node: polygons257488
-Node: rgbalpha259858
-Node: rgbimage259996
-Node: sectors260133
-Node: spiderplot262927
-Node: newspiderplot264952
-Node: steps265548
-Node: surface266378
-Node: vectors267300
-Node: xerrorbars268992
-Node: xyerrorbars269986
-Node: xerrorlines271391
-Node: xyerrorlines272205
-Node: yerrorbars273424
-Node: yerrorlines274486
-Node: 3D_plots275351
-Node: surface_plots275919
-Node: 2D_projection_(set_view_map)276744
-Node: PM3D_plots277267
-Node: Fence_plots278039
-Node: isosurface278751
-Node: Zerrorfill279728
-Node: Animation281676
-Node: Commands282582
-Node: Break283794
-Node: cd284200
-Node: call284777
-Node: ARGV[_]286245
-Node: Example287409
-Node: clear288560
-Node: Continue289304
-Node: Do289714
-Node: evaluate290552
-Node: exit291447
-Node: fit292785
-Node: adjustable_parameters301953
-Node: short_introduction303247
-Node: error_estimates307378
-Node: statistical_overview308317
-Node: practical_guidelines312383
-Node: control316365
-Node: error_recovery317305
-Node: multi-branch318237
-Node: starting_values319523
-Node: time_data321192
-Node: tips322732
-Node: function_blocks325906
-Node: help330134
-Node: history330917
-Node: if332210
-Node: for333587
-Node: import334628
-Node: load335816
-Node: local337403
-Node: lower339069
-Node: pause339191
-Node: pause_mouse_close341888
-Node: pseudo-mousing_during_pause342861
-Node: plot343637
-Node: axes345806
-Node: binary346307
-Node: general349213
-Node: array351006
-Node: record351779
-Node: skip352819
-Node: format353430
-Node: blank354515
-Node: endian355298
-Node: filetype356156
-Node: keywords357872
-Node: data363315
-Node: columnheaders368536
-Node: csv_files369192
-Node: every369954
-Node: example_datafile371948
-Node: filters374015
-Node: index382365
-Node: skip_384581
-Node: smooth385129
-Node: special-filenames396419
-Node: piped-data400420
-Node: using401709
-Node: volatile412101
-Node: functions412483
-Node: parametric413229
-Node: ranges414266
-Node: sampling416829
-Node: 1D_sampling_(x_or_t_axis)417032
-Node: 2D_sampling_(u_and_v_axes)419087
-Node: for_loops_in_plot_command420469
-Node: title423418
-Node: with426455
-Node: print433496
-Node: printerr434643
-Node: pwd435041
-Node: quit435396
-Node: raise435569
-Node: refresh436283
-Node: remultiplot437212
-Node: replot437804
-Node: reread439675
-Node: reset440245
-Node: return441743
-Node: save442364
-Node: set-show444436
-Node: angles447045
-Node: arrow448651
-Node: autoscale452869
-Node: noextend455360
-Node: examples456197
-Node: polar_mode457134
-Node: bind_457655
-Node: bmargin457839
-Node: border458057
-Node: boxwidth462524
-Node: boxdepth464157
-Node: chi_shapes464626
-Node: color465379
-Node: colormap466002
-Node: colorsequence467518
-Node: clabel468443
-Node: clip468756
-Node: cntrlabel470899
-Node: cntrparam472437
-Node: Examples_477479
-Node: color_box479127
-Node: colornames481730
-Node: contour482413
-Node: cornerpoles485236
-Node: contourfill_485530
-Node: dashtype_487046
-Node: datafile487853
-Node: set_datafile_columnheaders488586
-Node: set_datafile_fortran489257
-Node: set_datafile_nofpe_trap489793
-Node: set_datafile_missing490319
-Node: set_datafile_separator492308
-Node: set_datafile_commentschars493243
-Node: set_datafile_binary494166
-Node: decimalsign494921
-Node: dgrid3d497335
-Node: dummy502391
-Node: encoding503393
-Node: errorbars505538
-Node: fit_506716
-Node: fontpath511678
-Node: format__512903
-Node: gprintf_514711
-Node: format_specifiers515301
-Node: time/date_specifiers518774
-Node: grid522970
-Node: hidden3d525770
-Node: history_532654
-Node: isosamples533672
-Node: isosurface_535153
-Node: isotropic535945
-Node: jitter536577
-Node: key_538902
-Node: 3D_key542485
-Node: key_examples543343
-Node: extra_key_entries544022
-Node: key_autotitle545667
-Node: key_layout547090
-Node: key_placement550121
-Node: key_offset553449
-Node: key_samples553820
-Node: multiple_keys555284
-Node: label556116
-Node: examples_561390
-Node: hypertext563248
-Node: linetype565044
-Node: link567607
-Node: lmargin568879
-Node: loadpath569098
-Node: locale570178
-Node: logscale570855
-Node: macros571785
-Node: mapping572121
-Node: margin573959
-Node: micro575894
-Node: minussign576617
-Node: monochrome578431
-Node: mouse579604
-Node: doubleclick583140
-Node: format___583519
-Node: mouseformat583910
-Node: scrolling585483
-Node: zoom586403
-Node: mttics587302
-Node: multiplot587534
-Node: mx2tics593892
-Node: mxtics594113
-Node: mxtics_time596635
-Node: my2tics597676
-Node: mytics597901
-Node: mztics598108
-Node: nonlinear598317
-Node: object600672
-Node: rectangle603158
-Node: ellipse604608
-Node: circle606920
-Node: polygon608164
-Node: offsets609430
-Node: origin611064
-Node: output611480
-Node: overflow612842
-Node: float614649
-Node: NaN615132
-Node: undefined615546
-Node: affected_operations615983
-Node: palette__616719
-Node: rgbformulae620063
-Node: defined621279
-Node: functions_624053
-Node: gray624951
-Node: cubehelix625257
-Node: viridis626141
-Node: colormap_626766
-Node: file627137
-Node: gamma_correction628716
-Node: maxcolors629864
-Node: Color_model630811
-Node: postscript631905
-Node: parametric_633084
-Node: paxis635302
-Node: pixmap636349
-Node: pixmap_from_colormap638805
-Node: pm3d639511
-Node: with_pm3d_(pm3d_explicit)641749
-Node: pm3d_implicit643251
-Node: algorithm644608
-Node: lighting647124
-Node: position648989
-Node: scanorder650031
-Node: clipping652060
-Node: color_assignment653192
-Node: corners2color654447
-Node: border_655679
-Node: fillcolor656449
-Node: interpolate657831
-Node: deprecated_options658852
-Node: pointintervalbox659212
-Node: pointsize659913
-Node: polar660506
-Node: polar_grid662687
-Node: print_664805
-Node: psdir665693
-Node: raxis666329
-Node: rgbmax666898
-Node: rlabel667447
-Node: rmargin667720
-Node: rrange667940
-Node: rtics668625
-Node: samples669006
-Node: size670348
-Node: spiderplot_673078
-Node: style673720
-Node: set_style_arrow675255
-Node: boxplot_679276
-Node: set_style_data683117
-Node: set_style_fill683538
-Node: set_style_function687403
-Node: set_style_histogram687814
-Node: set_style_increment688017
-Node: set_style_line688648
-Node: set_style_circle693672
-Node: set_style_rectangle694455
-Node: set_style_ellipse695329
-Node: set_style_parallelaxis697436
-Node: set_style_spiderplot697842
-Node: set_style_textbox698789
-Node: set_style_watchpoint699973
-Node: surface_701046
-Node: table702339
-Node: plot_with_table703916
-Node: terminal705862
-Node: termoption707562
-Node: theta708251
-Node: tics708829
-Node: ticslevel712636
-Node: ticscale712793
-Node: timestamp712993
-Node: timefmt714136
-Node: title_717380
-Node: tmargin718976
-Node: trange719194
-Node: ttics719992
-Node: urange720760
-Node: version721172
-Node: vgrid721765
-Node: view722983
-Node: azimuth724924
-Node: equal_axes725618
-Node: projection726235
-Node: vrange727102
-Node: vxrange727513
-Node: vyrange728043
-Node: vzrange728184
-Node: walls728323
-Node: watchpoints729226
-Node: x2data730691
-Node: x2dtics730927
-Node: x2label731170
-Node: x2mtics731384
-Node: x2range731630
-Node: x2tics731930
-Node: x2zeroaxis732167
-Node: xdata732426
-Node: time_733067
-Node: xdtics734378
-Node: xlabel734992
-Node: xmtics738224
-Node: xrange738855
-Node: examples__743087
-Node: extend743981
-Node: xtics744161
-Node: xtics_series749115
-Node: xtics_list750759
-Node: xtics_timedata752916
-Node: geographic755148
-Node: xtics_logscale756616
-Node: xtics_rangelimited757658
-Node: xyplane758662
-Node: xzeroaxis759710
-Node: y2data759932
-Node: y2dtics760166
-Node: y2label760416
-Node: y2mtics760637
-Node: y2range760890
-Node: y2tics761190
-Node: y2zeroaxis761434
-Node: ydata761700
-Node: ydtics761916
-Node: ylabel762146
-Node: ymtics762334
-Node: yrange762567
-Node: ytics762811
-Node: yzeroaxis763034
-Node: zdata763253
-Node: zdtics763466
-Node: zzeroaxis763699
-Node: cbdata764019
-Node: cbdtics764219
-Node: zero764460
-Node: zeroaxis765136
-Node: zlabel766508
-Node: zmtics766698
-Node: zrange766931
-Node: ztics767227
-Node: cblabel767448
-Node: cbmtics767647
-Node: cbrange767894
-Node: cbtics768573
-Node: shell768792
-Node: show769470
-Node: show_colornames770002
-Node: show_functions770340
-Node: show_palette770931
-Node: show_palette_gradient771489
-Node: show_palette_palette771888
-Node: show_palette_rgbformulae773494
-Node: show_plot773807
-Node: show_variables774339
-Node: splot774895
-Node: data-file777479
-Node: matrix779739
-Node: example_datafile_786879
-Node: grid_data788218
-Node: splot_surfaces789986
-Node: voxel-grid791381
-Node: stats_(Statistical_Summary)792660
-Node: name798537
-Node: test_for_existence_of_a_file799427
-Node: voxelgrid800108
-Node: system_800922
-Node: test801928
-Node: toggle802671
-Node: undefine803377
-Node: unset804287
-Node: linetype_804880
-Node: monochrome_805319
-Node: output_805535
-Node: terminal_805996
-Node: warnings806613
-Node: update807129
-Node: vclear807295
-Node: vfill807564
-Node: warn809804
-Node: While810232
-Node: Terminal_types810604
-Node: complete_list_of_terminals810774
-Node: aifm812212
-Node: aqua812632
-Node: be813852
-Node: command-line_options816011
-Node: monochrome_options817495
-Node: color_resources817839
-Node: grayscale_resources818905
-Node: line_resources819648
-Node: epscairo821366
-Node: canvas821704
-Node: cgm825377
-Node: cgm_font827493
-Node: cgm_fontsize830387
-Node: cgm_linewidth830821
-Node: cgm_rotate831152
-Node: cgm_solid831795
-Node: cgm_size832211
-Node: cgm_width832469
-Node: cgm_nofontlist833321
-Node: context834132
-Node: Requirements839824
-Node: Calling_gnuplot_from_ConTeXt840427
-Node: corel841047
-Node: debug841525
-Node: svga841792
-Node: dumb843080
-Node: dxf846741
-Node: dxy800a847285
-Node: eepic847517
-Node: emf851862
-Node: epson_180dpi853365
-Node: excl854836
-Node: fig855106
-Node: png_857732
-Node: examples____860417
-Node: ggi860959
-Node: gpic862071
-Node: grass863941
-Node: hp2623a864357
-Node: hp2648864577
-Node: hp500c864806
-Node: hpgl865446
-Node: hpljii866526
-Node: hppj867214
-Node: imagen867653
-Node: kyo868367
-Node: latex868716
-Node: lua871926
-Node: mf872901
-Node: METAFONT_Instructions874278
-Node: mp877741
-Node: Metapost_Instructions884537
-Node: mif886945
-Node: pbm888217
-Node: dospc889615
-Node: pdf890941
-Node: pstricks892977
-Node: qms895186
-Node: regis895421
-Node: svg895754
-Node: tek410x897898
-Node: tek40898136
-Node: texdraw899613
-Node: tgif901824
-Node: tkcanvas904720
-Node: tpic910190
-Node: windows912164
-Node: graph-menu916544
-Node: printing919509
-Node: text-menu"920432
-Node: wgnuplot.mnu"921516
-Node: wgnuplot.ini923231
-Node: wxt925796
-Node: x11932174
-Node: x11_fonts937468
-Node: command-line_options_940422
-Node: color_resources_942640
-Node: grayscale_resources_944064
-Node: line_resources_944813
-Node: x11_pm3d_resources946569
-Node: x11_other_resources947903
-Node: xlib948558
-Node: Concept_Index948970
-Node: Command_Index1025750
-Node: Options_Index1028965
-Node: Function_Index1041163
-Node: Terminal_Index1048102
-
-End Tag Table
-
-
-Local Variables:
-coding: utf-8
-End:
diff --git a/elpa/gnuplot-20260322.20/README-elpa b/elpa/gnuplot-20260322.20/README-elpa
new file mode 100644
index 00000000..52caf5c8
--- /dev/null
+++ b/elpa/gnuplot-20260322.20/README-elpa
@@ -0,0 +1,10 @@
+This is a major mode for composing gnuplot scripts and displaying
+their results using gnuplot.  It supports features of recent Gnuplot
+versions (5.0 and up), but should also work fine with older
+versions.
+
+Gnuplot-mode includes context-sensitive support for keyword
+completion and, optionally, eldoc-mode help text.  See the
+commentary in gnuplot-context.el for more information.  If you
+don't find it useful, it can be turned off by customizing
+`gnuplot-context-sensitive-mode'.
diff --git a/elpa/gnuplot-20260322.20/dir b/elpa/gnuplot-20260322.20/dir
new file mode 100644
index 00000000..37ad9fe4
--- /dev/null
+++ b/elpa/gnuplot-20260322.20/dir
@@ -0,0 +1,18 @@
+This is the file .../info/dir, which contains the
+topmost node of the Info hierarchy, called (dir)Top.
+The first time you invoke Info you start off looking at this node.
+
+File: dir,	Node: Top	This is the top of the INFO tree
+
+  This (the Directory node) gives a menu of major topics.
+  Typing "q" exits, "H" lists all Info commands, "d" returns here,
+  "h" gives a primer for first-timers,
+  "mEmacs<Return>" visits the Emacs manual, etc.
+
+  In Emacs, you can click mouse button 2 on a menu item or cross reference
+  to select it.
+
+* Menu:
+
+Math
+* GNUPLOT: (gnuplot).           An Interactive Plotting Program
diff --git a/elpa/gnuplot-20260322.20/gnuplot-autoloads.el b/elpa/gnuplot-20260322.20/gnuplot-autoloads.el
new file mode 100644
index 00000000..58ae3c15
--- /dev/null
+++ b/elpa/gnuplot-20260322.20/gnuplot-autoloads.el
@@ -0,0 +1,94 @@
+;;; gnuplot-autoloads.el --- automatically extracted autoloads (do not edit)   -*- lexical-binding: t -*-
+;; Generated by the `loaddefs-generate' function.
+
+;; This file is part of GNU Emacs.
+
+;;; Code:
+
+(add-to-list 'load-path (or (and load-file-name (directory-file-name (file-name-directory load-file-name))) (car load-path)))
+
+
+
+;;; Generated autoloads from gnuplot.el
+
+(autoload 'gnuplot-mode "gnuplot"
+"Major mode for editing and executing GNUPLOT scripts.
+This was written with version 4.6 of gnuplot in mind, but should
+work with newer and older versions.
+
+Report bugs at https://github.com/emacs-gnuplot/gnuplot/issues
+
+                            ------O------
+
+Gnuplot-mode includes two different systems for keyword completion and
+documentation lookup: a newer one, `gnuplot-context-sensitive-mode' ,
+which is enabled by default, and a older one which extracts keywords
+from gnuplot's Info file.  Both systems allow looking up documentation
+in the Info file.  With the context-sensitive mode active,
+`gnuplot-mode' can also provide Eldoc syntax hints as you type.
+
+                            ------O------
+
+There are several known shortcomings of `gnuplot-mode', version 0.5g
+and up.  Many of the shortcomings involve the graphical interface
+(refered to as the GUI) to setting arguments to plot options.  Here is
+a list:
+
+ 1.  Currently there is no way for `gnuplot-mode' to know if information
+     sent to gnuplot was correctly plotted.
+ 2.  \"plot\", \"splot\", and \"fit\" are handled in the GUI, but are
+     a bit flaky.  Their arguments may not be read correctly from
+     existing text, and continuation lines (common for plot and splot)
+     are not supported.
+ 3.  The GUI does not know how to read from continuation lines.
+ 4.  Comma separated position arguments to plot options are
+     unsupported in the GUI.  Colon separated datafile modifiers (used
+     for plot, splot, and fit) are not supported either.  Arguments
+     not yet supported by the GUI generate messages printed in grey
+     text.
+ 5.  The GUI handling of \"hidden3d\" is flaky and \"cntrparam\" is
+     unsupported.
+
+In addition to any hooks its parent mode `prog-mode' might have run,
+this mode runs the hook `gnuplot-mode-hook', as the final or
+penultimate step during initialization.
+
+\\{gnuplot-mode-map}" t)
+(autoload 'gnuplot-make-buffer "gnuplot"
+"Open a new buffer in `gnuplot-mode'.
+When invoked, it switches to a new, empty buffer visiting no file
+and then starts `gnuplot-mode'.
+
+It is convenient to bind this function to a global key sequence.  For
+example, to make the F10 key open a gnuplot script buffer, put the
+following in your .emacs file:
+     (global-set-key [(f10)] \\='gnuplot-make-buffer)" t)
+(autoload 'run-gnuplot "gnuplot"
+"Run an inferior Gnuplot process." t)
+(add-to-list 'auto-mode-alist '("\\.gp\\'" . gnuplot-mode))
+(add-to-list 'interpreter-mode-alist '("gnuplot" . gnuplot-mode))
+(register-definition-prefixes "gnuplot" '("gnuplot-"))
+
+
+;;; Generated autoloads from gnuplot-context.el
+
+(register-definition-prefixes "gnuplot-context" '("gnuplot-context-"))
+
+
+;;; Generated autoloads from gnuplot-gui.el
+
+(register-definition-prefixes "gnuplot-gui" '("gnuplot-gui-"))
+
+;;; End of scraped data
+
+(provide 'gnuplot-autoloads)
+
+;; Local Variables:
+;; version-control: never
+;; no-byte-compile: t
+;; no-update-autoloads: t
+;; no-native-compile: t
+;; coding: utf-8-emacs-unix
+;; End:
+
+;;; gnuplot-autoloads.el ends here
diff --git a/elpa/gnuplot-20260322.20/gnuplot-context.el b/elpa/gnuplot-20260322.20/gnuplot-context.el
new file mode 100644
index 00000000..46105053
--- /dev/null
+++ b/elpa/gnuplot-20260322.20/gnuplot-context.el
@@ -0,0 +1,2201 @@
+;;; gnuplot-context.el -- context-sensitive help and completion for gnuplot -*- lexical-binding: t -*-
+
+;; Copyright (C) 2012-2013 Jon Oddie <jonxfield@gmail.com>
+
+;; Author: Jon Oddie <jonxfield@gmail.com>
+
+;; This program is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+;;; Commentary:
+
+;;
+;; This file enhances gnuplot-mode with context-sensitive completion,
+;; ElDoc support, and info page lookup for gnuplot script and shell
+;; buffers.
+;;
+;; Usage
+;; =====
+;;
+;; Make sure to byte-compile this file, or things will be noticeably
+;; slow.
+;;
+;; Summary of key bindings:
+;;     C-c C-d            read info page for construction at point
+;;     C-u C-c C-d        prompt for info page to read
+;;     C-c M-h, C-c C-/   pop up multi-line ElDoc string for construction
+;;                          at point
+;;
+;; Gnuplot's context sensitive mode is best controlled using Customize
+;; (M-x customize-group gnuplot): simply enable the
+;; `gnuplot-context-sensitive-mode' setting.  You may also want to set
+;; the Emacs variable `tab-always-indent' to `complete' so that the
+;; TAB key does auto-completion on lines which are already indented.
+;;
+;; If you need to turn context sensitivity on or off from Lisp code
+;; for some reason, call the function
+;; `gnuplot-context-sensitive-mode', which behaves like a minor mode.
+;;
+;; With `eldoc-mode' support, `gnuplot-mode' will show one-line syntax
+;; hints automatically in the echo area.  Whether `eldoc-mode' is
+;; active or not, you can always pop up a longer description of syntax
+;; using `gnuplot-context-help-at-point' (C-c C-/ or C-c M-h).
+;;
+;; Internal details
+;; ================
+;;
+;; Gnuplot's command language has a fair amount of syntactic
+;; complexity, and the only way I could think of to support these
+;; features was to do a complete parse of the command line.  So that's
+;; what this package does.  Instead of building a parse tree, it
+;; matches up until the token at point, and then either makes a list
+;; of possible completions, or sets the variables
+;; `gnuplot-context--eldoc' and `gnuplot-context--info-at-point' based
+;; on where it is in the grammar at that point.
+;;
+;; The parsing/matching process happens in two phases: tokenizing
+;; (`gnuplot-context--tokenize') and matching
+;; (`gnuplot-context--match-pattern').  In order to be able to
+;; construct a full list of possible completions via backtracking, the
+;; matching algorithm simulates a simple stack machine with
+;; continuations.  At byte-compile time, the PEG-like grammar in
+;; S-expression notation (`gnuplot-grammar') is compiled down into a
+;; vector of "machine code" for the parsing machine (see
+;; `gnuplot-context--compile-pattern',
+;; `gnuplot-context--compile-grammar' and
+;; `gnuplot-context--compiled-grammar').  This is complicated, but it
+;; seems to work well enough, and it saves on the Emacs call stack.
+;;
+;; Compiling the grammar does require increasing `max-lisp-eval-depth'
+;; modestly.  This shouldn't cause any problems on modern machines, and
+;; it only needs to be done once, at byte-compilation time.
+;;
+;; The parsing machine and compiler are partially based on the
+;; description in Medeiros and Ierusalimschy 2008, "A Parsing Machine
+;; for PEGs" (https://dl.acm.org/citation.cfm?doid=1408681.1408683).
+;;
+;; The pattern-matching language
+;; =============================
+;;
+;; The gnuplot-mode grammar (see `gnuplot-context--compiled-grammar')
+;; is a list of rules (RULE PATTERN), with each pattern written in
+;; S-expression notation as follows:
+;;
+;;    any
+;;      Match any token
+;;
+;;    name, number, string, separator
+;;      Match a token of the given type.  "Separator" is semicolon, the
+;;      statement separator.
+;;
+;;    Any other symbol
+;;      Match another named rule in the grammar.  May be recursive.
+;;
+;;    "STRING"
+;;      Match literally: a token with exactly the text "STRING".
+;;
+;;   (kw KEYWORD ALIASES ...)
+;;  Match abbreviated Gnuplot keywords.  KEYWORD can be a string or
+;;  a cons (PREFIX . SUFFIX).  In the latter case, this pattern
+;;  will match PREFIX plus any number of characters from the
+;;  beginning of SUFFIX.  Any literal string from ALIASES will
+;;  also match.  The token-id of the matching token is mutated to
+;;  the canonical value of KEYWORD.
+;;  Example:
+;;   (kw ("linew" ."idth") "lw") matches "linew", "linewi",
+;;  ... "linewidth" as well as "lw".  Any of these tokens will
+;;  appear as "linewidth" in subsequent processing.  (This is
+;;  important for the "info-keyword" form, see below).
+;;
+;; The other pattern forms combine simpler patterns, much like regular
+;; expressions or PEGs (parsing expression grammars):
+;;
+;;    (sequence { (:eldoc "eldoc string") }
+;;              { (:info "info page") }
+;;              { (:no-info) }
+;;           PATTERN PATTERN... )
+;;      Match all the PATTERNs in sequence or fail.  Sequences can also
+;;      have optional ElDoc strings and info pages associated with
+;;      them; the innermost ElDoc or info page around point is the one
+;;      shown to the user.  Alternatively, either property may be a
+;;      symbol, which should be a function to be called to get the
+;;      real value.  Finally, if no ElDoc string is specified but the
+;;      variable `gnuplot-eldoc-hash' contains a value for the name of
+;;      the info page at point, that value is used as the ElDoc string
+;;      instead.
+;;
+;;  For better readability, sequence forms can also be written as
+;;  a vector, omitting the `sequence': [PATTERN PATTERN ...]
+;;
+;;    (either PATTERN PATTERN...)
+;;      Match the first PATTERN to succeed, or fail if none
+;;      matches.  Like regexp `|'.
+;;
+;;    (many PATTERN)
+;;  Match PATTERN zero or more times, greedily; like regexp
+;;  `*'.  Unlike a regular expression matcher, the parsing machine
+;;  will not backtrack and try to match fewer times if a later
+;;  part of the pattern fails.  This applies equally to the other
+;;  non-deterministic forms "either" and "maybe".
+;;
+;;    (maybe PATTERN)
+;;      Match PATTERN zero or one times, like regexp `?'.
+;;
+;;    (capture NAME PATTERN)
+;;      Match PATTERN, capturing the tokens in a capture group named
+;;      NAME.  Capture groups are stored in `gnuplot-context--captures'
+;;      and can be retrieved using `gnuplot-context--capture-group'.  This is
+;;      used to store the plotting style, which we need in order to
+;;      give the correct ElDoc string for "using" clauses, and for
+;;      info keywords (see below)
+;;
+;;    (info-keyword PATTERN)
+;;      Match PATTERN, and use whatever the value of the first token
+;;      it matches is to look up info pages for this pattern.  Most
+;;      Gnuplot info pages have the same name as the keyword they
+;;      document, so by using this we only have to put :info
+;;      properties on the few that don't, such as "set".
+;;
+;;    For convenience, "many", "maybe", "capture" and "info-keyword"
+;;    wrap the rest of their arguments in an implicit "sequence" form,
+;;    so we can write (maybe "," expression) instead of
+;;    (maybe (sequence "," expression))
+;;
+;;    (delimited-list PATTERN SEPARATOR)
+;;      Match a list of PATTERNs separated by SEPARATOR.  Sugar for:
+;;      (sequence PATTERN (many (sequence SEPARATOR PATTERN)))
+;;
+;;   (assert LISP-FORM)
+;;  Evaluate LISP-FORM and fail if it returns NIL.  We need this in
+;;  the patterns for "plot" and "splot" to check whether the
+;;  command at point should be parsed in parametric mode or
+;;  not.  See `gnuplot-context--guess-parametric-p'.
+;;
+;;
+;; Bugs, TODOs, etc.
+;; =======================
+;;
+;; It would be useful to complete on user-defined functions and
+;; variables as well as built-ins.
+;;
+;; Completion probably will not work in continuation lines entered
+;; into the gnuplot interaction buffer.
+;;
+;; It would be better to pop up longer syntax descriptions in a
+;; temporary window, rather than making the echo area grow to fit
+;; many lines.
+;;
+;; In ElDoc mode, we parse the whole line every time the user stops
+;; typing.  This is wasteful; should cache things in text properties
+;; instead.
+;;
+;; The pattern matching engine uses backtracking, which can take
+;; exponential time.  So far it seems "fast enough" in actual use.
+;;
+;; The patterns don't really distinguish between "plot" and "splot"
+;; for things like plot styles, binary arguments, etc.
+;;
+;; Some other the patterns are probably not quite right, especially for
+;; things like abbreviated keywords, and features that I don't use
+;; myself like "fit".  Hopefully anyone bothered by this will submit
+;; patches ;-)
+;;
+;; It would be possible to provide more helpful ElDoc strings for
+;; sub-parts of complicated options like "cntrparam".  This is a time
+;; and maintenance issue rather than a technical one.
+
+;;; Code:
+
+(require 'gnuplot)
+(require 'gnuplot-eldoc)
+
+
+;;;; The tokenizer.
+
+(cl-defstruct (gnuplot-context--token
+               (:constructor gnuplot-context--token-make)
+               (:copier nil))
+  start     ; Buffer start position
+  end       ; Buffer end position
+  id        ; Text
+  type)     ; a symbol: name, number, string, operator, separator
+
+(defvar gnuplot-context--operator-regexp
+  (eval-when-compile
+    (regexp-opt
+     '("(" ")" "(" ")" "{" "," "}" "[" ":" "]" "!" "**" "-" "+" "~" "!" "*" "/"
+       "%" "+" "-" "." "<" "<=" ">" ">=" "==" "!=" "eq" "ne" "&" "^" "|" "&&" "||"
+       "?" ":" "=" "$")))
+  "Regexp to match Gnuplot operators for tokenizing.")
+
+(eval-when-compile
+  (defmacro gnuplot-context--tokenize-by-regexps (&rest rules)
+    `(cond ,@(mapcar
+              (lambda (rule)
+                (let ((regexp (car rule))
+                      (token-type (cadr rule)))
+                  `((looking-at ,regexp)
+                    (let ((str (match-string-no-properties 0)))
+                      (forward-char (length str))
+                      (gnuplot-context--token-make :id str
+                                                   :type ',token-type
+                                                   :start (match-beginning 0)
+                                                   :end (match-end 0))))))
+              rules))))
+
+(defun gnuplot-context--tokenize (&optional completing-p)
+  "Tokenize the Gnuplot command at point.
+Return a list of `gnuplot-context--token' objects.
+
+If COMPLETING-P is non-nil, omits the token at point if it is a
+name; otherwise continues tokenizing up to the token at point.  FIXME."
+  (let ((tokens '())
+        (stop-point (min (point)
+                         (gnuplot--point-at-end-of-command))))
+    (save-excursion
+      (if (save-excursion               ; HACK FIXME
+            (gnuplot--beginning-of-continuation)
+            (looking-at "\\s-*if\\s-*("))
+          (gnuplot--beginning-of-continuation)
+        (gnuplot--beginning-of-command))
+      (while
+          ;; Skip whitespace and continuation lines
+          (progn
+            (skip-syntax-forward "-" stop-point)
+            (while (looking-at "\\\\\n")
+              (forward-line)
+              (skip-syntax-forward "-" stop-point))
+            ;; Don't tokenize anything starting after point
+            (and (not (looking-at "#"))
+                 (< (point) stop-point)))
+        (let* ((from (point))
+               (token
+                (cond
+                 ((gnuplot-context--tokenize-by-regexps
+                   ("[[:alpha:]_][[:alpha:]0-9_]*" name)
+                   ("[0-9]+\\(\\.[0-9]*\\)?\\([eE][+-]?[0-9]+\\)?\\|\\.[0-9]+\\([eE][+-]?[0-9]+\\)?" number)
+                   (gnuplot-context--operator-regexp operator)
+                   (";" separator)))
+
+                 ((looking-at "['\"]")
+                  (let* ((bounds (bounds-of-thing-at-point 'sexp))
+                         (to (or (cdr bounds) stop-point)))
+                    (goto-char to)
+                    (gnuplot-context--token-make
+                     :id (buffer-substring-no-properties from to)
+                     :type 'string
+                     :start from :end to)))
+
+                 (t (error
+                     "gnuplot-context--tokenize: bad token beginning %s"
+                     (buffer-substring-no-properties (point) stop-point))))))
+
+          (push token tokens))))
+
+    ;; If we are looking for completions, AND if the last token
+    ;; read is a name, AND if point is within the bounds of the
+    ;; last token, then discard it. The matching function
+    ;; generates a list of all possible tokens that could appear
+    ;; in that position for completion.
+    (if (and completing-p
+             tokens
+             (eq (gnuplot-context--token-type (car tokens)) 'name)
+             (<= (point) (gnuplot-context--token-end (car tokens))))
+        (pop tokens))
+
+    (nreverse tokens)))
+
+
+;;;; The pattern and grammar compiler
+;;
+;; These functions compile the source S-expression grammar into a
+;; vector of instructions for the parsing machine,
+;; `gnuplot-context--match-pattern'. Its state consists of a program counter
+;; (PC), a position in the list of tokens, a call stack, and a second
+;; stack of backtracking entries (continuations). Its "machine
+;; instructions" are the following:
+;;
+;;    (any)
+;;      Match any token (fails only at end of command).
+;;
+;;    (literal LITERAL NO-COMPLETE)
+;;      Match token with `gnuplot-context--token-id' LITERAL or fail. If we
+;;      have reached the token before point, include LITERAL in the
+;;      completion list unless NO-COMPLETE is non-`nil'.
+;;
+;;    (token-type TYPE)
+;;      Match a token with `gnuplot-context--token-type' TYPE, or fail.
+;;
+;;    (keyword REGEXP NAME)
+;;      Match any token whose `gnuplot-context--token-id' matches REGEXP. Use
+;;      NAME for the completion list.
+;;
+;;    (jump OFFSET FIXED)
+;;      Jump to (set PC to) OFFSET if FIXED is non-nil, otherwise to
+;;      PC + OFFSET
+;;
+;;    (call OFFSET FIXED)
+;;      Like "jump", but push a return address onto the stack for
+;;      (return). (The compiler adds the name of the rule being called
+;;      as a fourth element on the end of the list, but this is just a
+;;      comment for debugging purposes).
+;;
+;;    (return)
+;;      Return to the PC address on top of the stack, or finish
+;;      matching if stack is empty. (Usually this doesn't happen,
+;;      because the machine stops as soon as it gets to the token at
+;;      point).
+;;
+;;    (choice OFFSET)
+;;      Push a backtracking entry for location PC + OFFSET onto the
+;;      backtracking stack. Backtracking entries save the contents of
+;;      the call stack, position in the token list, the values of
+;;      capture groups, and the record of loop progress (see below).
+;;
+;;    (check-progress)
+;;      Break out of infinite loops, like (many (many ...)).  Checks
+;;      an alist of conses (pc . tokens) for the position in the token
+;;      stream the last time this instruction was reached, and breaks
+;;      out of the loop if stuck in the same place; otherwise pushes a
+;;      new entry onto the list.
+;;
+;;    (fail)
+;;      Pop the most recent backtracking entry and continue from
+;;      there, or fail the whole match if out of backtrack
+;;      points. Failing to match returns the remainder of the token
+;;      list, although we don't currently use this for anything.
+;;
+;;    (commit OFFSET)
+;;      Discard one backtracking point and jump to PC + OFFSET. This
+;;      is used to make the (either) form non-deterministic.
+;;
+;;    (push TYPE VALUE)
+;;      Push an entry for an eldoc or info string (specified by TYPE)
+;;      onto the stack.
+;;
+;;    (pop TYPE)
+;;      Pop something off the stack; checks that it has the expected
+;;      TYPE, for safety.
+;;
+;;    (save-start NAME)
+;;      Open a capture group named NAME. Pushes an entry onto
+;;      `gnuplot-context--captures' with current position in token list as the
+;;      start of the group.
+;;
+;;    (save-end NAME)
+;;      Close the capture group named NAME. Finds the topmost entry in
+;;      `gnuplot-context--captures' with this name and sets its endpoint to the
+;;      current position in token list. Error if no group with that
+;;      name is found.
+;;
+;;    (label NAME)
+;;      This should never be reached and will cause an error. The
+;;      compiler inserts it at the beginning of compiled rules only
+;;      for debugging purposes.
+;;
+
+(eval-and-compile
+  ;; Compile a single pattern into a list of instructions. Leaves
+  ;; calls to other rules as symbolic instructions (call SYMBOL) and
+  ;; jumps, commits etc. as relative offsets; these are resolved into
+  ;; absolute locations by `gnuplot-context--compile-grammar', below.
+  (defun gnuplot-context--compile-pattern (pat)
+    (cond
+     ;; Strings match a single token literally
+     ((stringp pat)
+      ;; Don't add non-words to completion lists
+      (let ((wordp (string-match-p "^\\sw\\(\\sw\\|\\s_\\)*$" pat)))
+        `((literal ,pat ,(not wordp)))))
+
+     ;; Symbols match token types or calls to other patterns
+     ((symbolp pat)
+      (cl-case pat
+        ((any) `((any)))
+        ((name number string separator) `((token-type ,pat)))
+        (t `((call ,pat)))))
+
+     ;; Syntactic sugar: write sequences (sequence ...) as vectors [...]
+     ((vectorp pat)
+      (gnuplot-context--compile-pattern
+       (append '(sequence) pat '())))
+
+     ;; Other forms combine simpler patterns
+     (t
+      (let ((type (car pat)))
+        (cl-case type
+          ;; (sequence...): concatenate patterns, with optional eldoc
+          ;; and info strings
+          ((sequence)
+           (cl-destructuring-bind
+               (subpats eldoc info)
+               (gnuplot-context--filter-arg-list (cdr pat))
+             (let ((eldoc-push '()) (eldoc-pop '())
+                   (info-push '()) (info-pop '())
+                   (compiled
+                    (mapcar 'gnuplot-context--compile-pattern subpats)))
+               (if eldoc
+                   (setq eldoc-push `((push eldoc ,eldoc))
+                         eldoc-pop `((pop eldoc))))
+               (if info
+                   (if (eq info :no-info)
+                       (setq info-push '((push no-scan t))
+                             info-pop '((pop no-scan)))
+                     (setq info-push `((push info ,info))
+                           info-pop `((pop info)))))
+               (apply 'append
+                      `(,info-push
+                        ,eldoc-push
+                        ,@compiled
+                        ,eldoc-pop
+                        ,info-pop)))))
+
+          ;; (either...): choose between patterns
+          ((either)
+           (cond
+            ((= (length pat) 2)         ; trivial case
+             (gnuplot-context--compile-pattern (cadr pat)))
+
+            ((> (length pat) 3)         ; could be more efficient...
+             (gnuplot-context--compile-pattern (gnuplot-context--either-helper pat)))
+
+            (t              ; two patterns
+             (let* ((pat1 (cadr pat))
+                    (pat2 (caddr pat))
+                    (pat1-c (gnuplot-context--compile-pattern pat1))
+                    (pat2-c (gnuplot-context--compile-pattern pat2))
+                    (pat1-l (length pat1-c))
+                    (pat2-l (length pat2-c)))
+               `((choice ,(+ pat1-l 2))
+                 ,@pat1-c
+                 (commit ,(+ pat2-l 1))
+                 ,@pat2-c)))))
+
+          ;; Repetition (*)
+          ((many)
+           (let* ((pat1 (cons 'sequence (cdr pat)))
+                  (pat1-c (gnuplot-context--compile-pattern pat1))
+                  (pat1-l (length pat1-c)))
+             `((choice ,(+ pat1-l 3))
+               (check-progress)         ; bail out of infinite loops
+               ,@pat1-c
+               (commit ,(- (+ pat1-l 2))))))
+
+          ;; Repetition (+)
+          ((many1)
+           (let* ((pat1 (cdr pat)))
+             (gnuplot-context--compile-pattern
+              `(sequence ,@pat1 (many ,@pat1)))))
+
+          ;; Optional (?)
+          ((maybe)
+           (let* ((pat1 (cons 'sequence (cdr pat)))
+                  (pat1-c (gnuplot-context--compile-pattern pat1))
+                  (pat1-l (length pat1-c)))
+             `((choice ,(+ pat1-l 1))
+               ,@pat1-c)))
+
+          ;; Syntactic sugar for delimited lists
+          ((delimited-list)
+           (let* ((item (cadr pat))
+                  (sep (caddr pat)))
+             (gnuplot-context--compile-pattern
+              `(sequence ,item (many (sequence ,sep ,item))))))
+
+          ;; keywords
+          ((kw)
+           (cl-destructuring-bind (regex name)
+               (gnuplot-context--keyword-helper (cdr pat))
+             `((keyword ,regex ,name))))
+
+          ;; Capturing groups
+          ((capture)
+           (let* ((name (cadr pat))
+                  (pat1 (cons 'sequence (cddr pat)))
+                  (pat1-c (gnuplot-context--compile-pattern pat1)))
+             `((save-start ,name)
+               ,@pat1-c
+               (save-end ,name))))
+
+          ;; Use the first token as an info keyword
+          ((info-keyword)
+           (let* ((pat1 (cons 'sequence (cdr pat)))
+                  (pat1-c (gnuplot-context--compile-pattern pat1)))
+             `((push info first-token)
+               ,@pat1-c
+               (pop info))))
+
+          ;; Assertions
+          ((assert)
+           (let* ((form (cadr pat)))
+             `((assert ,form))))
+
+          (t
+           (error "gnuplot-context--compile-pattern: bad pattern form %s" pat)))))))
+
+  ;; Helper function for destructuring (sequence ...) forms in patterns
+  ;; Takes the cdr of the sequence form, returns a list (PATTERNS ELDOC
+  ;; INFO).
+  (defun gnuplot-context--filter-arg-list (args)
+    (let ((accum '())
+          (eldoc nil) (info nil))
+      (dolist (item args)
+        (let ((type (car-safe item)))
+          (cl-case type
+            ((:eldoc) (setq eldoc (cadr item)))
+            ((:no-info) (setq info :no-info)) ; inhibit stack scanning
+            ((:info) (setq info (cadr item)))
+            (t (push item accum)))))
+      (list (reverse accum) eldoc info)))
+
+  ;; Helper function for compiling (kw...) patterns
+  ;; Takes the cdr of the kw form, returns a list (REGEXP KEYWORD)
+  (defun gnuplot-context--keyword-helper (args)
+    (let ((keyword (car args)) (aliases (cdr args)))
+      (when (consp keyword)
+        (let ((pre (car keyword)) (suf (cdr keyword)))
+          (setq keyword (concat pre suf))
+          (while (progn
+                   (push pre aliases)
+                   (not (zerop (length suf))))
+            (setq pre (concat pre (substring suf 0 1))
+                  suf (substring suf 1)))))
+      (let ((regex
+             (concat "^"
+                     (regexp-opt (cons keyword aliases))
+                     "$")))
+        (list regex keyword))))
+
+  ;; Helper function for compiling (either ...) patterns. Rewrites
+  ;; alternates (either A B C) into (either A (either B (either C D)))
+  (defun gnuplot-context--either-helper (pat)
+    (if (= (length pat) 3)
+        pat
+      `(either ,(cadr pat)
+               ,(gnuplot-context--either-helper
+                 (cons 'either (cddr pat))))))
+
+  ;; Compile the grammar (a list of rule-pattern pairs (RULE PATTERN))
+  ;; into a single vector of matching-machine instructions. Compiles
+  ;; each pattern individually, then "links" them into one vector,
+  ;; converting symbolic (call ...) instructions into numeric offsets
+  (defun gnuplot-context--compile-grammar (grammar start-symbol)
+    (let ((compiled-pats '())         ; Alist of (name . instructions)
+          ;; Reserve space for a jump to the start symbol
+          (code-length 1))
+
+      ;; Compile each rule and find the total number of instructions
+      (dolist (item grammar)
+        (let* ((name (car item))
+               (pat (cadr item))
+               (code (gnuplot-context--compile-pattern pat)))
+          (push (cons name code) compiled-pats)
+          ;; Reserve space for a label at the beginning and (return) at
+          ;; the end
+          (setq code-length (+ code-length 2 (length code)))))
+
+      ;; Copy instructions into a single vector
+      (let ((object-code (make-vector code-length nil))
+            (name->offset (make-hash-table))
+            (i 1))
+        (setf (aref object-code 0) `(jump ,start-symbol))
+        (dolist (chunk compiled-pats)
+          (let ((name (car chunk))
+                (code (cdr chunk)))
+            (setf (aref object-code i) `(label ,name))
+            (cl-incf i)
+            (puthash name i name->offset)
+            (while code
+              (setf (aref object-code i) (car code)
+                    code (cdr code)
+                    i (1+ i)))
+            (setf (aref object-code i) '(return)
+                  i (1+ i))))
+
+        ;; Resolve symbolic and relative jumps
+        (let ((pattern-name nil))
+          (dotimes (i (length object-code))
+            (let ((inst (aref object-code i)))
+              (cl-case (car inst)
+                ((label)
+                 (setq pattern-name (cadr inst)))
+
+                ((jump call choice commit)
+                 (cond
+                  ((symbolp (cadr inst))
+                   (let* ((name (cadr inst))
+                          (location (gethash name name->offset)))
+                     (if (not location)
+                         (error
+                          (concat "gnuplot-context--compile-grammar: "
+                                  "No rule found for symbol `%s' in pattern `%s'")
+                          name pattern-name))
+                     (setcdr inst `(,location ,name))))
+
+                  ((numberp (cadr inst))
+                   (let* ((offset (cadr inst))
+                          (location (+ offset i)))
+                     (setcdr inst `(,location))))
+
+                  (t
+                   (error "gnuplot-context--compile-grammar: bad instruction %s" inst))))))))
+        object-code))))
+
+;;; The grammar.
+(defvar gnuplot-context--compiled-grammar
+  (eval-when-compile
+    (let ((max-lisp-eval-depth 600))
+      (gnuplot-context--compile-grammar
+       '((expression
+          [infix-expression (maybe "?" expression ":" expression)])
+
+         (prefix-operator
+          (either "!" "~" "-" "+"))
+
+         (infix-operator
+          (either "**" "*" "/" "%" "+" "-" "." "<" "<=" ">" ">=" "==" "!=" "eq" "ne"
+                  "&" "^" "|" "&&" "||"))
+
+         (infix-expression
+          [(many prefix-operator)
+           primary-expression
+           (many infix-operator expression)])
+
+         (primary-expression
+          [(either number string parenthesized-expression
+                   column-ref complex-number function-call name)
+           (many "!")
+           (maybe "**" infix-expression)
+           (maybe substring-range)])
+
+         (function-call
+          (either
+           (info-keyword
+            [(either "abs" "acos" "acosh" "arg" "asin" "asinh" "atan" "atan2" "atanh"
+                     "besj0" "besj1" "besy0" "besy1" "ceil" "column" "columnhead"
+                     "cos" "cosh" "defined" "erf" "erfc" "exists" "exp" "floor"
+                     "gamma" "gprintf" "ibeta" "igamma" "imag" "int" "inverf"
+                     "invnorm" "lambertw" "lgamma" "log" "log10" "norm" "real"
+                     "sgn" "sin" "sinh" "sprintf" "sqrt" "strftime" "stringcolumn"
+                     "strlen" "strptime" "strstrt" "substr" "tan" "tanh" "timecolumn"
+                     "tm_hour" "tm_mday" "tm_min" "tm_mon" "tm_sec" "tm_wday"
+                     "tm_yday" "tm_year" "valid" "value" "word" "words" "rand")
+             parenthesized-expression])
+           [(:info "elliptic_integrals")
+            (either "EllipticK" "EllipticE" "EllipticPi")
+            parenthesized-expression]
+           [name
+            parenthesized-expression]))
+
+         (parenthesized-expression
+          ["(" comma-list ")"])
+
+         (complex-number
+          ["{" (maybe "-") number "," (maybe "-") number "}"])
+
+         (column-ref
+          ["$" number])
+
+         (substring-range-component
+          (maybe (either "*" expression)))
+
+         (substring-range
+          ["[" (delimited-list substring-range-component ":" 2 2) "]"])
+
+;;; Assignments
+         (lhs
+          [name (maybe "(" (delimited-list name "," 1) ")")])
+
+         (assignment
+          [lhs "=" (either assignment expression)])
+
+;;; Lists of expressions
+         (comma-list
+          (delimited-list (either assignment expression) ","))
+
+         (colon-list
+          (delimited-list expression ":"))
+
+         (tuple
+          ["(" (delimited-list expression "," 2 3) ")"])
+
+;;; Commands
+         (command
+          (info-keyword
+           (either plot-command splot-command replot-command fit-command print-command
+                   set-command cd-command call-command simple-command
+                   eval-command load-command lower-raise-command pause-command
+                   save-command system-command test-command undefine-command
+                   update-command assignment if-command new-if-command do-command)))
+
+         (command-list
+          (delimited-list command separator))
+
+         (block ["{" command-list (maybe separator) "}"])
+
+;;; old-style one-line if(..) command
+         (if-command
+          (info-keyword
+           "if" parenthesized-expression command-list
+           (maybe separator "else" command-list)))
+
+;;; new-style block-structured if
+         (new-if-command
+          (info-keyword
+           "if" parenthesized-expression block
+           (maybe "else" block)))
+
+;;; block-structured "do"
+         (do-command
+          (info-keyword "do" iteration-spec block))
+
+;;; PLOT, SPLOT commands
+         (plot-command
+          [(kw ("pl" . "ot"))
+
+           (either
+            ;; Parametric ranges
+            [(assert (gnuplot-context--guess-parametric-p))
+             (maybe t-axis-range) (maybe x-axis-range) (maybe y-axis-range)]
+
+            ;; Non-parametric ranges
+            [(maybe x-axis-range) (maybe y-axis-range)])
+
+           plot-body])
+
+         (splot-command
+          [ ;; This capturing group lets `gnuplot-context--find-using-eldoc' know
+           ;; that this is an splot command
+           (capture :splot-command (kw ("spl" . "ot")))
+
+           (either
+            ;; Parametric ranges
+            [(assert (gnuplot-context--guess-parametric-p))
+             (maybe u-axis-range) (maybe v-axis-range)
+             (maybe x-axis-range) (maybe y-axis-range) (maybe z-axis-range)]
+
+            ;; Non-parametric ranges
+            [(maybe x-axis-range) (maybe y-axis-range) (maybe z-axis-range)])
+
+           plot-body])
+
+         (replot-command [(kw "replot") plot-body])
+
+         ;; Axis ranges
+         (axis-range-component
+          (maybe (either "*" expression)))
+
+         (axis-range-body
+          (delimited-list axis-range-component ":" 2 3))
+
+         (axis-range
+          [(:info "ranges")
+           "[" (maybe (maybe name "=") axis-range-body) "]"])
+
+         (x-axis-range [(:eldoc "X RANGE: [{<dummy>=}<min>:<max>]") axis-range])
+         (y-axis-range [(:eldoc "Y RANGE: [{<dummy>=}<min>:<max>]") axis-range])
+         (z-axis-range [(:eldoc "Z RANGE: [{<dummy>=}<min>:<max>]") axis-range])
+         (t-axis-range [(:eldoc "T RANGE: [{<dummy>=}<min>:<max>]") axis-range])
+         (u-axis-range [(:eldoc "U RANGE: [{<dummy>=}<min>:<max>]") axis-range])
+         (v-axis-range [(:eldoc "V RANGE: [{<dummy>=}<min>:<max>]") axis-range])
+
+         ;; Body of a plot/splot command. Should really be different for
+         ;; parametric vs non-parametric, but that's too hard.
+         (plot-body
+          (delimited-list
+           [(maybe iteration-spec) plot-expression plot-modifiers]
+           ","))
+
+         ;; Iteration: for [... ]
+         (iteration-spec
+          [(:info "iteration")
+           (many1
+            "for" "[" name
+            (either ["=" (delimited-list expression ":")]
+                    ["in" expression])
+            "]")])
+
+         ;; Expressions to plot can be preceded by any number of
+         ;; assignments, with or without commas
+         (plot-expression
+          [(many [(:no-info) assignment (maybe ",")])
+           expression])
+
+;;; Plot/splot modifiers
+         ;; These should probably be more different for plot and splot ...
+         (plot-modifiers (many (either plot-modifier datafile-modifier)))
+
+         (plot-modifier
+          (info-keyword
+           (either
+            ;; simple one-word modifiers
+            (kw "nohidden3d") (kw "nocontours") (kw "nosurface")
+
+            ;; word followed by expression
+            [(either
+              (kw ("lines" . "tyle") "ls")
+              (kw ("linet" . "ype") "lt")
+              (kw ("linew" . "idth") "lw")
+              (kw ("pointt" . "ype") "pt")
+              (kw ("points" . "ize") "ps")
+              (kw ("pointi" . "nterval") "pi"))
+             expression]
+
+            ;; others defined below
+            title-modifier notitle-modifier axes-modifier with-modifier
+            linecolor-modifier fillstyle-modifier)))
+
+         (title-modifier
+          [(kw ("t" . "itle")) expression])
+
+         (notitle-modifier
+          [(:info "title")
+           (kw ("not" . "itle"))
+           (maybe string)])
+
+         (axes-modifier
+          [(kw ("ax" . "es")) (either "x1y1" "x1y2" "x2y1" "x2y2")])
+
+         (linecolor-modifier
+          [(kw ("linec" . "olor") "lc") color-spec])
+
+         (fillstyle-modifier
+          [(kw "fillstyle" "fs")
+           ;; fill-style also used by "set style fill"
+           fill-style])
+
+         (fill-style
+          [(either
+            "empty"
+            [(maybe "transparent")
+             (either "pattern" "solid")
+             (maybe (either fill-style-border-clause expression))])
+           (maybe fill-style-border-clause)])
+
+         (fill-style-border-clause
+          (either "noborder" [(kw ("bo" . "rder")) expression]))
+
+         (color-spec
+          [(:info "colorspec")
+           (either
+            (kw ("var" . "iable"))
+
+            [(kw ("pal" . "ette"))
+             (either "z"
+                     [(either "frac" "cb") expression])]
+
+            [(kw ("rgb" . "color"))
+             (either (kw ("var" . "iable")) string)])])
+
+         (with-modifier
+          [(:info "plotting_styles")
+           (kw ("w" . "ith"))
+
+           ;; plotting-style also used for "set style data"
+           (capture :with-style plotting-style)])
+
+         (plotting-style
+          (info-keyword
+           (either
+            ;; Simple styles that take no arguments
+            (kw ("l" . "ines")) (kw ("i" . "mpulses")) (kw ("p" . "oints"))
+            (kw ("linesp" . "oints") "lp") (kw ("d" . "ots")) (kw ("yerrorl" . "ines"))
+            (kw ("errorl" . "ines")) (kw ("xerrorl" . "ines")) (kw ("xyerrorl" . "ines"))
+            (kw ("ye" . "rrorbars")) (kw ("e" . "rrorbars")) (kw ("xe" . "rrorbars"))
+            (kw ("xye" . "rrorbars")) (kw "boxes") (kw ("hist" . "ograms"))
+            (kw ("boxer" . "rorbars")) (kw ("boxx" . "yerrorbars")) (kw ("st" . "eps"))
+            (kw ("fs" . "teps")) (kw ("his" . "teps")) (kw ("fin" . "ancebars"))
+            (kw ("can" . "dlesticks")) (kw ("pm" . "3d"))
+            (kw ("cir" . "cles"))
+
+            ;; Image styles all use the same info page
+            [(:info "image")
+             (either (kw ("ima" . "ge"))
+                     (kw ("rgbima" . "ge"))
+                     (kw ("rgba" . "lpha")))]
+
+            ;; More complicated styles defined below
+            labels-style-clause
+            filledcurves-style-clause
+            vectors-style-clause)))
+
+         (labels-style-clause
+          [(kw "labels")
+           (maybe textcolor-spec)])
+
+         (filledcurves-style-clause
+          [(kw ("filledc" . "urves"))
+           (maybe
+            (either
+             "closed"
+
+             ["xy" "=" expression "," expression]
+
+             [(maybe (either "above" "below"))
+              (maybe [(either "x1" "x2" "y1" "y2")
+                      (maybe "=" expression)])]))])
+
+         (vectors-style-clause
+          [(kw ("vec" . "tors"))
+           (many
+            (either
+             "nohead" "head" "heads" "filled" "empty" "nofilled" "front" "back"
+             [(kw "arrowstyle" "as") expression]
+             ["size" (delimited-list expression ",")]
+             linestyle-spec))])
+
+;;; Various style specifiers, used in different places
+         (linestyle-spec
+          (many1
+           (either
+            [(kw ("lines" . "tyle") "ls") expression]
+            [(kw ("linet" . "ype") "lt") expression]
+            [(kw ("linew" . "idth") "lw") expression])))
+
+         (textcolor-spec
+          [(kw "textcolor" "tc")
+           (either "default"
+                   ["lt" expression]
+                   color-spec)])
+
+         (pointsize-spec [(kw "pointsize" "ps") expression])
+
+;;; Datafile modifiers
+         (datafile-modifier
+          (info-keyword
+           (either binary-modifier
+                   [(maybe "nonuniform") (kw ("mat" . "rix"))]
+                   index-modifier every-modifier
+                   thru-modifier using-modifier
+                   smooth-modifier
+                   "volatile" "noautoscale")))
+
+         (index-modifier
+          [(kw ("i" . "ndex"))
+           (either string (delimited-list expression ":" 0 2))])
+
+         (every-modifier
+          [(kw ("ev" . "ery")) (delimited-list (maybe expression) ":")])
+
+         (thru-modifier
+          [(kw "thru") expression])
+
+         (using-modifier
+          [(:eldoc gnuplot-context--find-using-eldoc)
+           (kw ("u" . "sing"))
+           (either
+            string
+            [colon-list (maybe string)])])
+
+         (smooth-modifier
+          [(kw ("s" . "mooth"))
+           (either (kw ("a" . "csplines")) (kw ("b" . "ezier")) (kw ("c" . "splines"))
+                   (kw ("s" . "bezier")) (kw ("u" . "nique")) (kw ("f" . "requency"))
+                   (kw ("cum" . "ulative")) (kw ("k" . "density")))])
+
+;;; Binary datafile modifiers
+         (binary-modifier
+          ["binary" (many binary-keyword)])
+
+         (binary-keyword
+          (either
+           ;; All of these binary keywords are described on the same
+           ;; info page
+           [(:info "keywords")
+            (either
+             "transpose" "flipx" "flipy" "flipz"
+             ["flip" "=" (either "x" "y" "z")]
+             ["scan" "=" name]
+             [(either "dx" "dy" "dz") "=" number]
+             [(either "origin" "center" "perpendicular") "="
+              (delimited-list tuple ":")]
+             [(kw ("rot" . "ate") "rotation") "="
+              (sequence expression (maybe (kw ("d" . "eg")) (kw ("p" . "i"))))])]
+
+           ;; remaining binary keywords have their own info pages
+           (info-keyword
+            (either
+             [(either "array" "record")
+              "="
+              (delimited-list expression ":")]
+
+             [(either "skip")
+              "="
+              (delimited-list expression ":")]
+
+             [(either "format" "endian" "filetype")
+              "="
+              expression]))))
+
+;;; "fit" command
+         (fit-command
+          [(:info "fit")
+           (kw "fit")
+           (many axis-range)
+           expression
+           string
+           (many plot-modifier)
+           (kw "via")
+           (either string (delimited-list name ","))])
+
+;;; print command
+         (print-command
+          [(kw ("pr" . "int")) (delimited-list expression ",")])
+
+;;; set commands
+         (set-command
+          [(:eldoc "set ...")
+           (:info "set-show")
+           (either (kw "set") (kw "unset") (kw "show"))
+           (maybe iteration-spec)
+           (info-keyword
+            (either set-angles-clause set-arrow-clause
+                    set-autoscale-clause set-bars-clause
+                    set-border-clause set-boxwidth-clause
+                    set-clabel-clause set-clip-clause
+                    set-cntrparam-clause set-colorbox-clause
+                    set-contour-clause set-datafile-clause
+                    set-decimalsign-clause set-dgrid3d-clause
+                    set-dummy-clause set-encoding-clause
+                    set-fit-clause set-fontpath-clause
+                    set-format-clause set-grid-clause
+                    set-hidden3d-clause set-historysize-clause
+                    set-isosamples-clause set-key-clause
+                    set-label-clause set-loadpath-clause
+                    set-locale-clause set-logscale-clause
+                    set-mapping-clause set-margin-clause
+                    set-multiplot-clause set-mxtics-clause
+                    set-object-clause set-offsets-clause
+                    set-origin-clause set-output-clause
+                    set-parametric-clause set-pm3d-clause
+                    set-palette-clause set-pointsize-clause
+                    set-polar-clause set-print-clause
+                    set-samples-clause set-size-clause
+                    set-style-clause
+                    set-surface-clause set-table-clause
+                    set-terminal-clause set-termoption-clause
+                    set-tics-clause set-tics-clause-2
+                    set-xtics-clause
+                    set-timestamp-clause set-timefmt-clause
+                    set-title-clause set-view-clause
+                    set-data-clause set-dtics-clause
+                    set-xlabel-clause
+                    set-mtics-clause set-range-clause
+                    set-xyplane-clause set-zero-clause
+                    set-zeroaxis-clause))])
+
+;;; positions and coordinate systems for set options
+         (position-system
+          (either "first" "second" "graph" "screen" "character"))
+
+         (dimension [(maybe position-system) expression])
+
+         (position
+          [dimension "," dimension (maybe "," dimension)])
+
+         (to (either "to" "rto"))
+
+;;; all the different "set ... " options
+         (set-angles-clause
+          ["angles" (either "degrees" "radians")])
+
+         (set-arrow-clause
+          ["arrow" (maybe number)
+           (many
+            (either ["from" position] [to position]
+                    [(kw "arrowstyle" "as") expression]
+                    "nohead" "head" "backhead" "heads"
+                    ["size" dimension "," expression (maybe "," expression)]
+                    "filled" "empty" "nofilled" "front" "back"
+                    linecolor-modifier linestyle-spec))])
+
+         (set-autoscale-clause
+          ["autoscale"
+           (either "fix"
+                   "keepfix"
+                   "x" "y" "z" "cb" "x2" "y2" "xy"
+                   "xmin" "ymin" "zmin" "cbmin" "x2min" "y2min"
+                   "xmax" "ymax" "zmax" "cbmax" "x2max" "y2max"
+                   "xfix" "yfix" "zfix" "cbfix" "x2fix" "y2fix"
+                   "xfixmax" "yfixmax" "zfixmax" "cbfixmax" "x2fixmax" "y2fixmax"
+                   "xfixmin" "yfixmin" "zfixmin" "cbfixmin" "x2fixmin" "y2fixmin")])
+
+         (set-bars-clause
+          ["bars"
+           (either expression "small" "large" "fullwidth")
+           (either "front" "back")])
+
+         (set-border-clause
+          ["border"
+           (maybe number)
+           (maybe (either "front" "back"))
+           (maybe (kw "linewidth" "lw") expression)
+           (maybe
+            (either (kw "linestyle" "ls") (kw "linetype" "lt"))
+            expression)])
+
+         (set-boxwidth-clause
+          ["boxwidth"
+           (maybe expression)
+           (maybe (either (kw ("abs" . "olute")) "relative"))])
+
+         (set-clabel-clause
+          ["clabel" (maybe string)])
+
+         (set-clip-clause
+          ["clip" (maybe (either "points" "one" "two"))])
+
+         (set-cntrparam-clause
+          [(kw "cntrparam")
+           (either
+            "linear" "cubicspline" "bspline"
+
+            [(either "points" "order") number]
+
+            [(kw "levels")
+             (either
+              number
+              (sequence (kw "auto") (maybe number))
+              (sequence
+               (kw "discrete") comma-list)
+              (sequence
+               (kw "incremental") (delimited-list expression "," 2 3)))])])
+
+         (set-colorbox-clause
+          [(:info "color_box")
+           (kw ("colorb" . "ox"))
+           (many
+            (either
+             (kw ("vert" . "ical")) (kw ("horiz" . "ontal"))
+             "default" "user"
+             ["origin" expression "," expression]
+             ["size" expression "," expression]
+             "front" "back"
+             "noborder" "bdefault"
+             ["border" expression]))])
+
+         (set-contour-clause
+          ["contour" (either "base" "surface" "both")])
+
+         (set-datafile-clause
+          ["datafile"
+           (either [(:info "set_datafile_fortran")
+                    "fortran"]
+                   [(:info "set_datafile_nofpe_trap")
+                    "nofpe_trap"]
+                   [(:info "set_datafile_missing")
+                    "missing" (maybe string)]
+                   [(:info "set_datafile_separator")
+                    "separator" (either "whitespace" string)]
+                   [(:info "set_datafile_commentschars")
+                    "commentschars" (maybe string)]
+                   [(:info "set_datafile_binary")
+                    "binary" (many binary-keyword)])])
+
+         (set-decimalsign-clause
+          ["decimalsign"
+           (either string ["locale" (maybe string)])])
+
+         (set-dgrid3d-clause
+          ["dgrid3d"
+           (maybe expression)       ; fixme
+           (maybe "," expression)
+           (either
+            "splines"
+            ["qnorm" expression]
+            [(either "gauss" "cauchy" "exp" "box" "hann")
+             (maybe expression)
+             (maybe "," expression)])])
+
+         (set-dummy-clause
+          ["dummy"
+           name (maybe "," name)])
+
+         (set-encoding-clause
+          ["encoding"
+           (either "default" "iso_8859_1" "iso_8859_15" "iso_8859_2" "iso_8859_9"
+                   "koi8r" "koi8u" "cp437" "cp850" "cp852" "cp1250" "cp1251" "cp1254"
+                   "utf8" "locale")])
+
+         (set-fit-clause
+          [(:info "fit_")
+           "fit"
+           (either
+            ["logfile" string]
+            "errorvariables" "noerrorvariables")])
+
+         (set-fontpath-clause
+          ["fontpath" (many string)])
+
+         (set-format-clause
+          [(:info "format_")
+           "format"
+           (maybe (either "x" "y" "xy" "x2" "y2" "z" "cb"))
+           string])
+
+         (set-grid-clause
+          ["grid"
+           (either "nomxtics" "mxtics" "noxtics" "xtics" "nomytics" "mytics"
+                   "noytics" "ytics" "nomztics" "mztics" "noztics" "ztics"
+                   "nomx2tics" "mx2tics" "nox2tics" "x2tics" "nomy2tics"
+                   "my2tics" "noy2tics" "y2tics" "nomcbtics" "mcbtics"
+                   "nocbtics" "cbtics" "layerdefault" "front" "back"
+                   [linestyle-spec (maybe "," linestyle-spec)])])
+
+         (set-hidden3d-clause
+          [(kw ("hidden" . "3d"))
+           (many
+            (either
+             "defaults" "front" "back"
+             ["offset" expression] "nooffset"
+             ["trianglepattern"
+              (either "0" "1" "2" "3" "4" "5" "6" "7")]
+             ["undefined" (either "1" "2" "3")]
+             ["noundefined"]
+             "altdiagonal" "noaltdiagonal"
+             "bentover" "nobentover"))])
+
+         (set-historysize-clause
+          ["historysize" number])
+
+         (set-isosamples-clause
+          [(kw ("isosam" . "ples")) number (maybe "," number)])
+
+         (set-key-clause
+          ["key"
+           (many
+            (either "on" "off" "default"
+                    [(either "inside" "outside")
+                     (either "lmargin" "rmargin" "tmargin" "bmargin")]
+                    ["at" expression "," expression]
+                    "left" "right" "center" "top" "bottom" "vertical"
+                    "horizontal" "Left" "Right" "reverse" "noreverse" "invert"
+                    "noinvert" "above" "over" "below" "under"
+                    ["samplen" number]
+                    ["spacing" number]
+                    ["width" number]
+                    [(either "autotitle" "noautotitle") (maybe "columnheader")]
+                    ["title" expression] "enhanced" "noenhanced" ["font" string]
+                    textcolor-spec
+                    [(either "box" "nobox") linestyle-spec]
+                    ["maxcols" (either expression "auto")]
+                    ["maxrows" (either expression "auto")]))])
+
+         (set-label-clause
+          ["label"
+           (maybe expression)
+           (either label-clause-component expression)
+           (many label-clause-component)])
+
+         (label-clause-component
+          (either
+           ["at" position]
+           "left" "center" "right"
+           (either "norotate" ["rotate" "by" expression])
+           ["font" string]
+           "noenhanced"
+           "front" "back"
+           textcolor-spec
+           "nopoint" ["point" (many (either pointsize-spec linestyle-spec))]
+           ["offset" position]))
+
+         (set-loadpath-clause
+          ["loadpath" (many string)])
+
+         (set-locale-clause
+          ["locale" (maybe string)])
+
+         (set-logscale-clause
+          ["logscale"
+           (either "x" "y" "xy" "x2" "y2" "z" "cb" name)])
+
+         (set-mapping-clause
+          ["mapping" (either "cartesian" "spherical" "cylindrical")])
+
+         (set-margin-clause
+          [(either "bmargin" "lmargin" "rmargin" "tmargin")
+           (maybe "at" "screen") expression])
+
+         ;; TODO: set-mouse-clause
+
+         (set-multiplot-clause
+          ["multiplot"
+           (maybe
+            ["layout" number "," number
+             (maybe (either "rowsfirst" "columnsfirst"))
+             (maybe (either "downwards" "upwards"))
+             (maybe "title" string)
+             (maybe "scale" number (maybe "," number))
+             (maybe "offset" number (maybe "," number))])])
+
+         (set-mxtics-clause
+          [(:info "mxtics")
+           (either "mxtics" "mytics" "mztics" "mx2tics" "my2tics" "mcbtics")
+           (either "default" number)])
+
+         ;; "set object", objects, dimensions, positions
+         (set-object-clause
+          ["object"
+           (maybe number)
+           (info-keyword
+            (either rectangle-object ellipse-object circle-object polygon-object))
+           (maybe (either "front" "back" "behind"))
+           (maybe (kw "fillcolor" "fc") color-spec)
+           (maybe "fs" expression)
+           (maybe "default")
+           (maybe (kw "linewidth" "lw") expression)])
+
+         (rectangle-object
+          [(kw ("rect" . "angle"))
+           (maybe
+            (either
+             ["from" position (either "to" "rto") position]
+             ["center" position "size" dimension "," dimension]
+             ["at" position "size" dimension "," dimension]))])
+
+         (ellipse-object
+          ["ellipse"
+           (either "at" "center") position
+           "size" dimension "," dimension
+           (maybe "angle" number)])
+
+         (circle-object
+          ["circle"
+           (either "at" "center") position
+           "size" dimension
+           (maybe "arc" "[" number ":" number "]")])
+
+         (polygon-object
+          ["polygon"
+           "from" position (many (either "to" "rto") position)])
+
+         ;; "set offsets"
+         (set-offsets-clause
+          ["offsets"
+           (delimited-list [(maybe "graph") expression] "," 4 4)])
+
+         (set-origin-clause
+          ["origin" expression "," expression])
+
+         (set-output-clause
+          ["output" (maybe string)])
+
+         (set-parametric-clause
+          [(:info "parametric_")
+           (kw ("param" . "etric"))])
+
+         (set-pm3d-clause
+          ["pm3d"
+           (many
+            (either
+             ["at" name]
+             ["interpolate" number "," number]
+             (either "scansautomatic" "scansforward" "scansbackward" "depthorder")
+             ["flush" (either "begin" "center" "end")]
+             (either "ftriangles" "noftriangles")
+             (either "clip1in" "clip4in")
+             ["corners2color"
+              (either "mean" "geomean" "median" "min" "max" "c1" "c2" "c3" "c4")]
+             ["hidden3d" number]
+             "nohidden3d"
+             "implicit" "explicit" "map"))])
+
+         (set-palette-clause
+          ["palette"
+           (many
+            (either
+             "gray" "color"
+             ["gamma" number]
+             ["rgbformulae" number "," number "," number]
+             "defined"          ; not complete
+             ["functions" expression "," expression "," expression]
+             ["file" string (many datafile-modifier)]
+             "RGB" "HSV" "CMY" "YIQ" "XYZ"
+             "positive" "negative"
+             "nops_allcF" "ps_allcF"
+             ["maxcolors" number]))])
+
+         (set-pointsize-clause pointsize-spec)
+
+         (set-polar-clause "polar")
+
+         (set-print-clause
+          [(:info "print_")
+           "print"
+           (maybe string)])
+
+         (set-samples-clause
+          ["samples" expression (maybe "," expression)])
+
+         (set-size-clause
+          ["size"
+           (either
+            "square" "nosquare"
+            ["ratio" expression]
+            "noratio"
+            [expression "," expression])])
+
+         (set-style-clause
+          ["style"
+           (either style-arrow-clause style-data-clause style-fill-clause
+                   style-function-clause style-increment-clause
+                   style-line-clause style-circle-clause style-rectangle-clause)])
+
+         ;; begin subclauses of "set style ..."
+         (style-arrow-clause
+          [(:info "set_style_arrow")
+           "arrow"
+           number
+           (either
+            "default"
+            (many
+             (either "nohead" "head" "heads"
+                     "filled" "empty" "nofilled"
+                     "front" "back"
+                     ["size" dimension "," number (maybe "," number)]
+                     linestyle-spec)))])
+
+         (style-data-clause
+          [(:info "set_style_data")
+           "data" plotting-style])
+
+         (style-fill-clause
+          [(:info "set_style_fill")
+           "fill" fill-style])
+
+         (style-function-clause
+          [(:info "set_style_function")
+           "function" plotting-style])
+
+         (style-increment-clause
+          [(:info "set_style_increment")
+           "increment"
+           (either (kw ("d" . "efault")) (kw ("u" . "serstyles")))])
+
+         (style-line-clause
+          [(:info "set_style_line")
+           "line"
+           expression
+           (either
+            "default"
+            (many
+             (either
+              "palette"
+              [(kw ("linet" . "ype") "lt")
+               (either expression color-spec)]
+              [(kw ("linec" . "olor") "lc") color-spec]
+              [(either (kw ("linew" . "idth") "lw")
+                       (kw ("pointt" . "ype") "pt")
+                       (kw ("points" . "ize") "ps")
+                       (kw ("pointi" . "nterval") "pi"))
+               expression])))])
+
+         (style-circle-clause
+          [(:info "set_style_circle")
+           "circle" "radius" dimension])
+
+         (style-rectangle-clause
+          [(:info "set_style_rectangle")
+           "rectangle"
+           (many
+            (either
+             "front" "back"
+             [(kw ("linew" . "idth") "lw") expression]
+             [(kw "fillcolor" "fc") color-spec]
+             ["fs" expression]))])
+         ;; end of "set style ..." clauses
+
+         (set-surface-clause "surface")
+
+         (set-table-clause ["table" (maybe string)])
+
+         (set-terminal-clause       ; not sure how to do this...
+          ["terminal" (maybe (either "push" "pop"))])
+
+         (set-termoption-clause
+          ["termoption"
+           (either
+            "enhanced" "noenhanced"
+            ["font" string]
+            "solid" "dashed"
+            [(kw "linewidth" "lw") expression])])
+
+         (set-tics-clause
+          ["tics"
+           (many
+            (either
+             "axis" "border" "mirror" "nomirror" "in" "out"
+             ["scale" (either "default" [expression (maybe "," expression)])]
+             [(either "rotate" "norotate") (maybe "by" expression)]
+             ["offset" expression] "nooffset"
+             ["format" string]
+             ["font" string]
+             textcolor-spec))])
+
+         (set-tics-clause-2
+          ["tics" (either "front" "back")])
+
+         (set-xtics-clause
+          [(:info "xtics")
+           (either "xtics" "ytics" "ztics" "x2tics" "y2tics" "cbtics")
+           (many
+            (either
+             "axis" "border" "mirror" "nomirror" "in" "out"
+             ["scale" (either "default" [expression (maybe "," expression)])]
+             [(either "rotate" "norotate") (maybe "by" expression)]
+             ["offset" position] "nooffset"
+             "add" "autofreq"
+             ["(" (delimited-list [(maybe string) expression (maybe number)] ",") ")"]
+             ["format" string]
+             ["font" string]
+             "rangelimited"
+             textcolor-spec
+             (delimited-list expression ",")))])
+
+         (set-timestamp-clause
+          ["timestamp"
+           (maybe string)
+           (maybe (either "top" "bottom"))
+           (maybe (either "rotate" "norotate"))
+           (maybe "offset" position)
+           (maybe "font" string)])
+
+         (set-timefmt-clause
+          ["timefmt" string])
+
+         (set-title-clause
+          [(:info "title_")
+           "title"
+           (maybe expression)
+           (many
+            (either
+             ["offset" position]
+             ["font" string]
+             textcolor-spec
+             "enhanced" "noenhanced"))])
+
+         (set-view-clause
+          ["view"
+           (either
+            "map"
+            [(either "equal" "noequal") (maybe (either "xy" "xyz"))]
+            (delimited-list (maybe expression) ","))])
+
+         (set-data-clause
+          [(:info "xdata")
+           (either "xdata" "ydata" "zdata" "x2data" "y2data" "cbdata")
+           (maybe (either "time" "geographic"))])
+
+         (set-dtics-clause
+          [(:info "xdtics")
+           (either "xdtics" "ydtics" "zdtics" "x2dtics" "y2dtics" "cbdtics")])
+
+         (set-xlabel-clause
+          [(:info "xlabel")
+           (either (kw ("xlab" . "el")) (kw ("ylab" . "el"))
+                   (kw ("zlab" . "el")) (kw ("x2lab" . "el"))
+                   (kw ("y2lab" . "el")) (kw ("cblab" . "el")))
+           (maybe expression)
+           (many
+            (either
+             ["offset" position]
+             ["font" string]
+             textcolor-spec
+             "enhanced" "noenhanced"))])
+
+         (set-mtics-clause
+          [(:info "xmtics")
+           (either "xmtics" "ymtics" "zmtics" "x2mtics" "y2mtics" "cbmtics")])
+
+         (set-range-clause
+          [(:info "xrange")
+           (either (kw ("xr" . "ange")) (kw ("yr" . "ange"))
+                   (kw ("x2r" . "ange")) (kw ("y2r" . "ange"))
+                   (kw ("zr" . "ange")) (kw ("tr" . "ange"))
+                   (kw ("ur" . "ange")) (kw ("vr" . "ange"))
+                   (kw ("rr" . "ange")) (kw ("cbr" . "ange")))
+           (either
+            "restore"
+            ["[" (maybe
+                  [(maybe axis-range-component) ":"
+                   (maybe axis-range-component)])
+             "]"
+             (many (either "reverse" "noreverse" "writeback" "nowriteback"))])])
+
+         (set-xyplane-clause
+          ["xyplane" (either "at" "relative") expression])
+
+         (set-zero-clause
+          ["zero" expression])
+
+         (set-zeroaxis-clause
+          [(:info "zeroaxis")
+           (either "zeroaxis" "xzeroaxis" "x2zeroaxis" "yzeroaxis" "y2zeroaxis"
+                   "zzeroaxis")
+           (maybe linestyle-spec)])
+
+;;; Other commands
+         (cd-command
+          ["cd" string])
+
+         (call-command
+          ["call" string (many expression)])
+
+         (simple-command
+          (either "clear" "exit" "quit" "pwd" "refresh" "reread" "reset"
+                  "shell"))
+
+         (eval-command
+          ["eval" expression])
+
+         (load-command
+          ["load" string])
+
+         (lower-raise-command [(either "lower" "raise") number])
+
+         (pause-command
+          ["pause"
+           (either
+            expression
+            ["mouse" (maybe endcondition (maybe "," endcondition))])
+           string])
+
+         (endcondition (either "keypress" "button1" "button2" "button3" "close" "any"))
+
+         (save-command
+          ["save"
+           (either "functions" "variables" "terminal" "set")
+           string])
+
+         (system-command
+          ["system" string])
+
+         (test-command
+          ["test"
+           (either
+            "terminal"
+            ["palette"
+             (maybe
+              (either "rgb" "rbg" "grb" "gbr" "brg" "bgr"))])])
+
+         (undefine-command
+          ["undefine" (many name)])
+
+         (update-command
+          ["update" string (maybe string)]))
+
+       ;; This is the start symbol
+       'command))))
+
+
+;; The following macros are used for debugging; load
+;; gnuplot-debug-context.el and then re-load this file to enable
+;; them. For normal use, they compile to no-ops.
+(eval-when-compile
+  (when (not (featurep 'gnuplot-debug-context))
+    (defmacro gnuplot-context--with-trace-buffer (&rest _) "No-op." '(progn nil))
+    (defmacro gnuplot-context--trace (&rest _) "No-op." '(progn nil))
+    (defmacro gnuplot-context--debug (&rest _) "No-op." '(progn nil))))
+
+
+;;;; Variables to be set via pattern matching
+(defvar gnuplot-context--completions nil
+  "List of possible `gnuplot-mode' completions at point.
+This is filled in by `gnuplot-context--match-pattern' when it reaches the
+token before point.")
+
+(defvar gnuplot-context--info-at-point nil
+  "Relevant page of the Gnuplot info manual for the construction at point.
+
+Set by `gnuplot-context--match-pattern' using information from
+`gnuplot-context--compiled-grammar'.  `gnuplot-context--match-pattern'
+pushes ElDoc and info strings onto the stack as it runs, and scans the
+stack for the topmost entry when it reaches the token at point.")
+
+(defvar gnuplot-context--captures nil
+  "Alist of named capture groups for `gnuplot-mode' completion code.
+
+Each entry is of the form (NAME BEGIN END), where NAME is the
+name specified in the (capture NAME PATTERN) form in the
+`gnuplot-context--compiled-grammar' source, BEGIN is the tail of the token
+list beginning the capture group, and END is the tail of the
+token list just after the end of the capture group.")
+
+(defvar gnuplot-context--eldoc nil
+  "ElDoc documentation string for the Gnuplot construction at point.
+
+Set by `gnuplot-context--match-pattern'.  See also
+`gnuplot-context-info-at-point'.")
+
+
+;;;; The pattern matching machine
+(defun gnuplot-context--match-pattern (instructions tokens completing-p
+                                                    &optional start-symbol)
+  "Parse TOKENS, setting completions, info and ElDoc information.
+
+This function parses TOKENS by simulating a stack machine with
+unlimited backtracking.  If COMPLETING-P is non-nil, it stops
+before the token at point and collects a list of the next tokens
+that it would accept in `gnuplot-context--completions'.  If COMPLETING-P is
+nil, it parses up to the token at point and sets `gnuplot-context--eldoc'
+and `gnuplot-context--info-at-point' based on the contents of the stack
+there."
+  (catch 'return
+    (let ((pc 0)            ; Program counter
+          ;; Stack of return addresses (return PC), eldoc strings
+          ;; (eldoc STRING) and info pages (info STRING)
+          (stack '())
+          ;; Stack of backtracking records:
+          ;; ((STACK TOKENS RESUME-PC CAPTURES PROGRESS) ...)
+          (backtrack '())
+          ;; Match failure flag, set to `t' to cause backtracking
+          (fail nil)
+          ;; Flag set by JUMP and CALL instructions to stop PC advance
+          (jump nil)
+          ;; Record of progress made within (many ...) loops, an alist
+          ;; of conses (pc . tokens)
+          (progress '()))
+
+      (gnuplot-context--with-trace-buffer (erase-buffer))
+
+      (when start-symbol        ; HACK FIXME
+        (let ((look-for `(label ,start-symbol)))
+          (while (not (equal (aref instructions pc) look-for))
+            (cl-incf pc))
+          (cl-incf pc)))
+
+      (setq gnuplot-context--completions nil
+            gnuplot-context--eldoc nil
+            gnuplot-context--info-at-point nil
+            gnuplot-context--captures nil)
+
+      (cl-flet ((advance
+                  ()
+                  (pop tokens)
+                  (if (and (null tokens) (not completing-p))
+                      (gnuplot-context--scan-stack stack tokens)))
+                (fail () (setq fail t)))
+
+        ;; Main loop
+        (while t
+          (let* ((inst (aref instructions pc))
+                 (opcode (car inst))
+                 (token (car tokens))
+                 (end-of-tokens (null tokens)))
+            (gnuplot-context--trace "%s\t%s\t%s\n" pc inst (and token (gnuplot-context--token-id token)))
+
+            (cl-case opcode
+              ;; (literal LITERAL NO-COMPLETE)
+              ((literal)
+               (let ((expect (cadr inst))
+                     (no-complete (caddr inst)))
+                 (cond (end-of-tokens
+                        (unless no-complete
+                          (gnuplot-context--trace "\tpushing \"%s\" to completions\n" expect)
+                          (push expect gnuplot-context--completions))
+                        (fail))
+
+                       ((not (equal (gnuplot-context--token-id token) expect))
+                        (fail))
+
+                       ;; otherwise succeed
+                       (t (advance)))))
+
+              ;; (token-type TYPE)
+              ((token-type)
+               (let ((expect (cadr inst)))
+                 (if (or end-of-tokens
+                         (not (eq (gnuplot-context--token-type token) expect)))
+                     (fail)
+                   (advance))))
+
+              ;; (keyword REGEXP NAME): match any token whose ID
+              ;; regexp-matches REGEXP, use NAME for completions
+              ((keyword)
+               (let ((regexp (cadr inst))
+                     (name (caddr inst)))
+                 (cond (end-of-tokens
+                        (gnuplot-context--trace "\tpushing \"%s\" to completions\n" name)
+                        (push name gnuplot-context--completions)
+                        (fail))
+
+                       ((not (string-match-p regexp (gnuplot-context--token-id token)))
+                        (fail))
+
+                       ;; otherwise succeed
+                       (t
+                        (setf (gnuplot-context--token-id token) name)
+                        (advance)))))
+
+              ;; (any): match any token
+              ((any)
+               (if end-of-tokens
+                   (fail)
+                 (advance)))
+
+              ;; (jump LOCATION): jump to instruction at LOCATION
+              ((jump)
+               (let ((location (cadr inst)))
+                 (setq jump location)))
+
+              ;; (call LOCATION): push the next instruction as a
+              ;; return location and jump
+              ((call)
+               (let ((location (cadr inst)))
+                 (push `(return ,(+ pc 1)) stack)
+                 (setq jump location)))
+
+              ;; (return): return to address at topmost RETURN record on
+              ;; stack, or stop matching and return if stack is empty
+              ((return)
+               (while (and stack
+                           (not (eq (caar stack) 'return)))
+                 (pop stack))
+               (if (not stack)
+                   ;; Successful match
+                   (throw 'return (list tokens))
+                 ;; Otherwise, return to caller
+                 (let* ((r (pop stack))
+                        (r-pc (cadr r)))
+                   (setq jump r-pc))))
+
+              ;; (choice LOCATION): push LOCATION onto the stack of
+              ;; backtracking points and continue at next instruction
+              ((choice)
+               (let ((location (cadr inst)))
+                 (push `(,stack ,tokens ,location ,gnuplot-context--captures
+                                ,progress)
+                       backtrack)))
+
+              ;; (commit LOCATION): discard most recent backtrack point
+              ;; and jump to LOCATION
+              ((commit)
+               (let ((location (cadr inst)))
+                 (if (not backtrack)
+                     (error "No more backtrack points in commit"))
+                 (pop backtrack)
+                 (setq jump location)))
+
+              ;; (fail): force this match to fail, going back to most
+              ;; recent backtrack point
+              ((fail)
+               (fail))
+
+              ;; (assert): run Lisp code and fail if it returns NIL
+              ((assert)
+               (let ((form (cadr inst)))
+                 (if (not (eval form)) (fail))))
+
+              ;; (push TYPE VALUE): push an info page or eldoc string
+              ;; onto the stack
+              ((push)
+               (let* ((type (cadr inst))
+                      (value (caddr inst)))
+                 (push `(,type ,value ,tokens) stack)))
+
+              ;; (pop TYPE): pop something off the stack
+              ((pop)
+               (let ((type (cadr inst)))
+                 (if (not (and stack
+                               (eq (caar stack) type)))
+                     (error "Expected a %s on the stack but found %s" type stack))
+                 (pop stack)))
+
+              ;; (save-start NAME): save current token pointer as
+              ;; beginning of capture group NAME
+              ((save-start)
+               (let ((name (cadr inst)))
+                 (push `(,name ,tokens nil) gnuplot-context--captures)))
+
+              ;; (save-end NAME): save current token pointer as end of
+              ;; capture group NAME
+              ((save-end)
+               (let* ((name (cadr inst))
+                      (record (assoc name gnuplot-context--captures)))
+                 (if (not record)
+                     (error "Gnuplot-match-tokens: no open capture group named %s" name)
+                   (setf (caddr record) tokens)
+                   (gnuplot-context--debug (gnuplot-dump-captures)))))
+
+              ;; (check-progress): make sure not stuck in an infinite loop
+              ((check-progress)
+               (let ((prev-progress (cdr (assoc pc progress))))
+                 (if (and prev-progress (eq prev-progress tokens))
+                     (fail)
+                   (push (cons pc tokens) progress))))
+
+              (t
+               (error "Bad instruction: %s" inst)))
+
+            ;; Increment PC or jump
+            (setq pc (or jump (1+ pc))
+                  jump nil)
+
+            ;; Backtrack on failure
+            (when fail
+              (if (not backtrack)   ; Out of backtracking stack: failed match
+                  (throw 'return nil)
+                (gnuplot-context--trace "\t*fail*\t%s\n" (length backtrack))
+                (gnuplot-context--debug (gnuplot-dump-backtrack backtrack))
+                ;; If we got as far as token-at-point before failing,
+                ;; scan the stack for eldoc and info strings
+                (when (and end-of-tokens (not completing-p))
+                  (gnuplot-context--scan-stack stack tokens))
+
+                (cl-destructuring-bind
+                    (bt-stack bt-tokens bt-pc bt-captures bt-progress)
+                    (pop backtrack)
+                  (setq stack bt-stack
+                        tokens bt-tokens
+                        pc bt-pc
+                        gnuplot-context--captures bt-captures
+                        progress bt-progress
+                        fail nil)
+                  (gnuplot-context--debug (gnuplot-dump-progress progress)))))))))))
+
+(defun gnuplot-context--scan-stack (stack tokens)
+  "Scan STACK for the most recently pushed eldoc and info strings."
+  (gnuplot-context--trace "\t* scanning stack *\n")
+  (gnuplot-context--debug (gnuplot-backtrace stack))
+  (gnuplot-context--debug (gnuplot-dump-captures))
+
+  (catch 'no-scan
+    (while (and stack
+                (not (and gnuplot-context--info-at-point gnuplot-context--eldoc)))
+      (let* ((item (car stack))
+             (type (car item))
+             (position (caddr item))) ; must progress by at least one token
+        (if (and (memq type '(info eldoc no-scan))
+                 (not (eq position tokens)))
+            (cl-case type
+              ((no-scan)
+               (throw 'no-scan nil))
+
+              ((info)
+               (when (not gnuplot-context--info-at-point)
+                 (let ((info (cadr item)))
+                   (setq gnuplot-context--info-at-point
+                         (cond
+                          ((eq info 'first-token)
+                           (gnuplot-context--token-id (car position)))
+                          ((functionp info) (funcall info))
+                          (t info)))
+                   (when gnuplot-context--info-at-point
+                     (gnuplot-context--trace "\tset info to \"%s\"\n" gnuplot-context--info-at-point)
+                     (unless gnuplot-context--eldoc
+                       (let ((eldoc
+                              (car (gethash gnuplot-context--info-at-point gnuplot-eldoc-hash))))
+                         (when eldoc
+                           (setq gnuplot-context--eldoc eldoc)
+                           (gnuplot-context--trace "\tand set eldoc to \"%s\"\n" eldoc))))))))
+
+              ((eldoc)
+               (when (not gnuplot-context--eldoc)
+                 (let ((eldoc (cadr item)))
+                   (setq gnuplot-context--eldoc
+                         (if (functionp eldoc) (funcall eldoc) eldoc))
+                   (gnuplot-context--trace "\tset eldoc to \"%s\"\n" gnuplot-context--eldoc)))))))
+      (pop stack))))
+
+(defun gnuplot-context--capture-group (name)
+  "Return capture group NAME from the most recent parse, as a list of tokens."
+  (let ((record (assoc name gnuplot-context--captures)))
+    (if (not record) nil
+      (let ((begin (cadr record))
+            (end (caddr record))
+            (accum '()))
+        (while (and begin (not (eq begin end)))
+          (push (pop begin) accum))
+        (nreverse accum)))))
+
+
+;;; Interface to the matching machine
+(defun gnuplot-context--parse-at-point (completing-p)
+  (let ((tokens (gnuplot-context--tokenize completing-p)))
+    (gnuplot-context--match-pattern gnuplot-context--compiled-grammar tokens completing-p)))
+
+;; Completions
+(defun gnuplot-context--completions ()
+  (gnuplot-context--parse-at-point t)
+  gnuplot-context--completions)
+
+(defun gnuplot-context-completion-at-point ()
+  "Return completions of keyword preceding point, using context."
+  (list (save-excursion
+          (skip-syntax-backward "w_" (gnuplot--point-at-beginning-of-command))
+          (point))
+        (point)
+        (gnuplot-context--completions)))
+
+;; Eldoc help
+(defun gnuplot-context-eldoc-function (&rest _)
+  "Return the ElDoc string for the Gnuplot construction at point."
+  (gnuplot-context--parse-at-point nil)
+  gnuplot-context--eldoc)
+
+(defun gnuplot-context-help-at-point ()
+  "Pop up the extended documentation for the construction at point."
+  (interactive nil gnuplot-mode gnuplot-comint-mode)
+  (gnuplot-context--parse-at-point nil)
+  (if gnuplot-context--info-at-point
+      (let ((eldoc
+             (cadr (gethash gnuplot-context--info-at-point gnuplot-eldoc-hash))))
+        (if eldoc (message eldoc)))))
+
+;; Info lookup
+(defun gnuplot-context-info-at-point (&optional query)
+  "Open the relevant gnuplot info page for the construction at point."
+  (interactive "P" gnuplot-mode gnuplot-comint-mode)
+  (setq gnuplot-context--info-at-point nil)
+  (unless query
+    (gnuplot-context--parse-at-point nil))
+  (if (or query (not gnuplot-context--info-at-point))
+      (let ((info
+             (info-lookup-interactive-arguments 'symbol)))
+        (setq gnuplot-context--info-at-point (car info))))
+  (when gnuplot-context--info-at-point
+    (gnuplot-context--find-info-node gnuplot-context--info-at-point)))
+
+(defun gnuplot-context--find-info-node (node)
+  (save-window-excursion
+    (info (format "(gnuplot)%s" node)))
+  (gnuplot--adjust-info-display))
+
+
+;;; Some context-sensitive hacks
+
+;; ElDoc strings for "using" specs, which depend on other information
+;; from the parsed command
+
+(defvar gnuplot-context--using-eldoc
+  '(("boxerrorbars" . "x:y:ydelta{:xdelta} | x:y:ylow:yhigh{:xdelta}")
+    ("boxes" . "x:y{:x_width}")
+    ("boxxyerrorbars" . "x:y:xdelta:ydelta | x:y:xlow:xhigh:ylow:yhigh")
+    ("candlesticks" . "x:box_min:whisker_min:whisker_high:box_high | date:open:low:high:close")
+    ("circles" . "x:y:radius")
+    ("dots" . "x{:y{:z}}")
+    ("filledcurves" . "x:y | x:y1:y2")
+    ("financebars" . "date:open:low:high:close")
+    ("fsteps" . "y | x:y")
+    ("histeps" . "y | x:y")
+    ("histograms" . "y:yerr | y:ymin:ymax")
+    ("image" . "x:y:value")
+    ("rgbimage" . "x:y:r:g:b")
+    ("rgbalpha" . "x:y:r:g:b:a")
+    ("impulses" . "x{:y{:z}}")
+    ("labels" . "x:y:string")
+    ("lines" . "y | x:y")
+    ("steps" . "y | x:y")
+    ("vectors" . "x:y:xdelta:ydelta")
+    ("xerrorbars" . "x:y:xdelta | x:y:xlow:xhigh")
+    ("xyerrorbars" . "x:y:xdelta:ydelta | x:y:xlow:xhigh:ylow:yhigh")
+    ("yerrorbars" . "x:y:ydelta | x:y:ylow:yhigh")
+    ("yerrorlines" . "x:y:ydelta | x:y:ylow:yhigh")
+    ("xerrorlines" "x:y:xdelta | x:y:xlow:xhigh")
+    ("xyerrorlines" . "x:y:xdelta:ydelta | x:y:xlow:xhigh:ylow:yhigh"))
+  "Alist of ElDoc strings for Gnuplot \"using\" clauses in \"plot\" commands.")
+
+(defvar gnuplot-context--using-3d-eldoc
+  (append
+   '(("fsteps" . "z | x:y:z")
+     ("histeps" . "z | x:y:z")
+     ("histograms" . "y:yerr | y:ymin:ymax")
+     ("image" . "x:y:z:value")
+     ("rgbimage" . "x:y:z:r:g:b")
+     ("rgbalpha" . "x:y:z:r:g:b:a")
+     ("labels" . "x:y:z:string")
+     ("lines" . "z | x:y:z")
+     ("steps" . "z | x:y:z")
+     ("vectors" . "x:y:z:xdelta:ydelta:zdelta"))
+   gnuplot-context--using-eldoc)
+  "Alist of ElDoc strings for Gnuplot \"using\" clauses in \"splot\" commands.")
+
+(defun gnuplot-context--find-using-eldoc ()
+  "Return ElDoc string for a Gnuplot \"using\" clause, based on plotting style.
+
+This will fail if the \"using\" clause comes before the \"with\"
+clause."
+  (let ((with-style (gnuplot-context--capture-group :with-style))
+        (3d-p (gnuplot-context--capture-group :splot-command))
+        (column-description nil))
+    (if with-style
+        (let ((with-style-string (gnuplot-context--token-id (car with-style))))
+          (setq column-description
+                (or (and 3d-p
+                         (cdr (assoc with-style-string gnuplot-context--using-3d-eldoc)))
+                    (cdr (assoc with-style-string gnuplot-context--using-eldoc))
+                    "<columns>"))))
+    (format "using %s {'format'}" column-description)))
+
+;;; Needed for correctly parsing plot commands
+(defun gnuplot-context--guess-parametric-p (&optional start)
+  "Guess whether the command beginning at START is in parametric mode.
+
+Searches backward in current buffer for an \"(un)set parametric\"
+command."
+  (save-excursion
+    (and start (goto-char start))
+    (catch 'result
+      (while
+          (search-backward-regexp "reset\\|set\\s-+parametric" (point-min) t)
+        (gnuplot--beginning-of-command)
+        (cond ((looking-at "reset\\|unset\\s-+parametric") (throw 'result nil))
+              ((looking-at "set\\s-+parametric") (throw 'result t))))
+      nil)))
+
+(define-minor-mode gnuplot-context-sensitive-mode
+  "Use context-sensitive completion and help in `gnuplot-mode'.
+
+When context-sensitive mode is enabled, `gnuplot-mode' tries to
+provide more useful completions and help suggestions for built-in
+keywords and functions by parsing each command as you type.  It
+attempts to take into account Gnuplot's many abbreviated
+keywords.  For example, with point at the end of a line reading
+\"plot \\='datafile\\=' w \", typing \\[completion-at-point] will pop
+up a list of plotting styles.
+
+Key bindings:
+
+\\[completion-at-point] will complete the keyword at point based
+on its context in the command. To make keyword completion work on
+pressing TAB, set `tab-always-indent' to `complete'.
+
+\\[gnuplot-context-info-at-point] will try to find the most relevant
+Gnuplot info node for the construction at point, prompting for a
+node name if nothing is found.
+
+\\[gnuplot-context-help-at-point] will pop up a brief summary of the
+syntax at point in the minibuffer. To have one-line syntax
+summaries appear in the echo area as you type, toggle
+`eldoc-mode'.
+
+To choose whether to use this mode by default in Gnuplot buffers,
+customize the variable
+`gnuplot-use-context-sensitive-completion'."
+  :interactive (gnuplot-mode gnuplot-comint-mode)
+  :keymap
+  `((,(kbd "C-c C-/") . gnuplot-context-help-at-point)
+    (,(kbd "C-c C-d") . gnuplot-context-info-at-point))
+  (unless (derived-mode-p 'gnuplot-mode 'gnuplot-comint-mode)
+    (message "Gnuplot context-sensitive mode works only in Gnuplot-mode buffers")
+    (setq gnuplot-context-sensitive-mode nil))
+  (if gnuplot-context-sensitive-mode
+      (progn
+        (remove-hook 'completion-at-point-functions #'gnuplot-completion-at-point-info-look t)
+        (add-hook 'completion-at-point-functions #'gnuplot-context-completion-at-point nil t)
+        (add-hook 'eldoc-documentation-functions #'gnuplot-context-eldoc-function nil 'local))
+    (add-hook 'completion-at-point-functions #'gnuplot-completion-at-point-info-look nil t)
+    (remove-hook 'completion-at-point-functions #'gnuplot-context-completion-at-point t)
+    (remove-hook 'eldoc-documentation-functions #'gnuplot-context-eldoc-function t)))
+
+(provide 'gnuplot-context)
+;;; gnuplot-context.el ends here
diff --git a/elpa/gnuplot-20260322.20/gnuplot-eldoc.el b/elpa/gnuplot-20260322.20/gnuplot-eldoc.el
new file mode 100644
index 00000000..0425ffe9
--- /dev/null
+++ b/elpa/gnuplot-20260322.20/gnuplot-eldoc.el
@@ -0,0 +1,631 @@
+;;; gnuplot-eldoc.el -- Eldoc documentation strings for gnuplot-mode -*- lexical-binding: t -*-
+;;; Automatically generated by doc2texi.el on Sun, 01 June 2025
+
+;;;; This file is generated automatically from the Gnuplot
+;;;; documentation by `doc2texi.el', part of the Gnuplot distribution.
+;;;; It is not intended to be edited manually.  See docs/gnuplot.doc
+;;;; in the gnuplot source tree (available from
+;;;; gnuplot.sourcefourge.net) for the original.
+
+;; This file is covered by the Gnuplot licensing terms:
+
+;; Copyright 1986 - 1993, 1998, 2004   Thomas Williams, Colin Kelley
+;;
+;; Permission to use, copy, and distribute this software and its
+;; documentation for any purpose with or without fee is hereby granted,
+;; provided that the above copyright notice appear in all copies and
+;; that both that copyright notice and this permission notice appear
+;; in supporting documentation.
+;;
+;; Permission to modify the software is granted, but not the right to
+;; distribute the complete modified source code.  Modifications are to
+;; be distributed as patches to the released version.  Permission to
+;; distribute binaries produced by compiling modified sources is granted,
+;; provided you
+;;   1. distribute the corresponding source modifications from the
+;;    released version in the form of a patch file along with the binaries,
+;;   2. add special version identification to distinguish your version
+;;    in addition to the base release version number,
+;;   3. provide your name and address as the primary contact for the
+;;    support of your modified version, and
+;;   4. retain our contact information in regard to use of the base
+;;    software.
+;; Permission to distribute the released version of the source code along
+;; with corresponding source modifications in the form of a patch file is
+;; granted with same provisions 2 through 4 for binary distributions.
+;;
+;; This software is provided "as is" without express or implied warranty
+;; to the extent permitted by applicable law.
+
+(eval-when-compile (defvar gnuplot-eldoc-hash nil))
+(setq gnuplot-eldoc-hash (let ((tbl (make-hash-table :test 'equal)) (alist '(("x11" "set terminal x11 {<n> | window \"<string>\"} [more ...]" "set terminal x11 {<n> | window \"<string>\"}
+                 {title \"<string>\"}
+                 {{no}enhanced} {font <fontspec>}
+                 {linewidth LW}
+                 {{no}persist} {{no}raise} {{no}ctrlq}
+                 {{no}replotonresize}
+                 {close}
+                 {size XX,YY} {position XX,YY}
+set terminal x11 {reset}") ("wxt" "set term wxt {<n>} [more ...]" "set term wxt {<n>}
+             {size <width>,<height>} {position <x>,<y>}
+             {background <rgb_color> | nobackground}
+             {{no}enhanced}
+             {font <font>} {fontscale <scale>}
+             {title \"title\"}
+             {linewidth <lw>} {butt|rounded|square}
+             {dashlength <dl>}
+             {{no}persist}
+             {{no}raise}
+             {{no}ctrl}
+             {close}") ("windows" "set terminal windows {<n>} [more ...]" "set terminal windows {<n>}
+                     {color | monochrome}
+                     {solid | dashed}
+                     {rounded | butt}
+                     {enhanced | noenhanced}
+                     {font <fontspec>}
+                     {fontscale <scale>}
+                     {linewidth <scale>}
+                     {pointscale <scale>}
+                     {background <rgb color>}
+                     {title \"Plot Window Title\"}
+                     {{size | wsize} <width>,<height>}
+                     {position <x>,<y>}
+                     {docked {layout <rows>,<cols>} | standalone}
+                     {close}") ("tpic" "set terminal tpic <pointsize> <linewidth> <interval>") ("tkcanvas" "set terminal tkcanvas {tcl | perl | perltkx | python | ruby | rexx} [more ...]" "set terminal tkcanvas {tcl | perl | perltkx | python | ruby | rexx}
+                      {standalone | input}
+                      {interactive}
+                      {rounded | butt}
+                      {nobackground | background <rgb color>}
+                      {{no}rottext}
+                      {size <width>,<height>}
+                      {{no}enhanced}
+                      {externalimages | pixels}") ("tgif" "set terminal tgif {portrait | landscape | default} {<[x,y]>} [more ...]" "set terminal tgif {portrait | landscape | default} {<[x,y]>}
+                  {monochrome | color}
+                  {{linewidth | lw} <LW>}
+                  {solid | dashed}
+                  {font \"<fontname>{,<fontsize>}\"}") ("tek40" "set terminal sixeltek {<fontsize>} {mono|color|colors <n>} {size <x>,<y>} [more ...]" "set terminal sixeltek {<fontsize>} {mono|color|colors <n>} {size <x>,<y>}
+                      {animate}") ("svg" "set terminal svg {size <x>,<y> {|fixed|dynamic}} [more ...]" "set terminal svg {size <x>,<y> {|fixed|dynamic}}
+                 {mouse} {standalone | jsdir <dirname>}
+                 {name <plotname>}
+                 {font \"<fontname>{,<fontsize>}\"} {{no}enhanced}
+                 {fontscale <multiplier>}
+                 {rounded|butt|square} {solid|dashed} {linewidth <lw>}
+                 {background <rgb_color>}") ("regis" "set terminal regis {4 | 16}\"") ("pstricks" "set terminal pstricks [more ...]" "set terminal pstricks
+               {unit | size <XX>{unit},<YY>{unit}}
+               {standalone | input}
+               {blacktext | colortext | colourtext}
+               {linewidth <lw>} {rounded | butt}
+               {pointscale <ps>}
+               {psarrows | gparrows}
+               {background <rgbcolor>}
+               {pstricks | pdftricks2}") ("pdf" "set terminal pdf {monochrome|color|colour} [more ...]" "set terminal pdf {monochrome|color|colour}
+                 {{no}enhanced}
+                 {fname \"<font>\"} {fsize <fontsize>}
+                 {font \"<fontname>{,<fontsize>}\"} {fontscale <scale>}
+                 {linewidth <lw>} {rounded|butt}
+                 {dl <dashlength>}}
+                 {size <XX>{unit},<YY>{unit}}") ("dospc" "set terminal dospc [more ...]" "set terminal dospc
+    {{no}{enhanced}}
+    {fontscale <scale>} {pointsize <scale>} {linewidth <scale}
+    {background <rgbcolor>}") ("pbm" "set terminal pbm {<fontsize>} {<mode>} {size <x>,<y>}") ("mif" "set terminal mif {color | colour | monochrome} {polyline | vectors} [more ...]" "set terminal mif {color | colour | monochrome} {polyline | vectors}
+                 {help | ?}") ("mp" "set term mp {color | colour | monochrome} [more ...]" "set term mp {color | colour | monochrome}
+            {solid | dashed}
+            {notex | tex | latex}
+            {magnification <magsize>}
+            {psnfss | psnfss-version7 | nopsnfss}
+            {prologues <value>}
+            {a4paper}
+            {amstex}
+            {\"<fontname> {,<fontsize>}\"} ") ("lua" "set terminal lua <target name> | \"<file name>\" [more ...]" "set terminal lua <target name> | \"<file name>\"
+                    {<script_args> ...}
+                    {help}") ("latex" "set terminal {latex | emtex} {default | {courier|roman} {<fontsize>}} [more ...]" "set terminal {latex | emtex} {default | {courier|roman} {<fontsize>}}
+             {size <XX>{unit}, <YY>{unit}} {rotate | norotate}
+             {color | monochrome}") ("imagen" "set terminal imagen {<fontsize>} {portrait | landscape} [more ...]" "set terminal imagen {<fontsize>} {portrait | landscape}
+                    {[<horiz>,<vert>]}") ("hppj" "set terminal hppj {FNT5X9 | FNT9X17 | FNT13X25}") ("hpljii" "set terminal hpljii | hpdj {<res>}") ("hpgl" "set terminal hpgl {<number_of_pens>} {eject} {fontscale <scale>}") ("hp500c" "set terminal hp500c {<res>} {<comp>}") ("gpic" "set terminal gpic {<x> <y>}") ("ggi" "set terminal ggi [acceleration <integer>] [[mode] {mode}]") ("png_" "set terminal png  [more ...]" "set terminal png 
+       {{no}enhanced}
+       {{no}transparent} {{no}interlace}
+       {{no}truecolor} {rounded|butt}
+       {linewidth <lw>} {dashlength <dl>}
+       {tiny | small | medium | large | giant}
+       {font \"<face> {,<pointsize>}\"} {fontscale <scale>}
+       {size <x>,<y>} {{no}crop}
+       {background <rgb_color>}") ("fig" "set terminal fig {monochrome | color} [more ...]" "set terminal fig {monochrome | color}
+                 {small | big | size <xsize>{in|cm},<ysize>{in|cm}}
+                 {landscape | portrait}
+                 {pointsmax <max_points>}
+                 {font \"<fontname>{,<fontsize>}\"} {fontsize <size>}
+                 {textnormal | {textspecial texthidden textrigid}}
+                 {{linewidth|lw} <multiplier>}") ("epson_180dpi" "set terminal dpu414 {small | medium | large} {normal | draft}") ("epson_180dpi" "set terminal nec_cp6 {monochrome | colour | draft}") ("emf" "set terminal emf {color | monochrome} [more ...]" "set terminal emf {color | monochrome}
+                 {enhanced {noproportional}}
+                 {rounded | butt}
+                 {linewidth <LW>} {dashlength <DL>}
+                 {size XX,YY} {background <rgb_color>}
+                 {font \"<fontname>{,<fontsize>}\"}
+                 {fontscale <scale>}") ("eepic" "set terminal eepic {default} {color|monochrome|dashed} [more ...]" "set terminal eepic {default} {color|monochrome|dashed}
+                   {rotate} {size XX,YY}
+                   {small|tiny|<fontsize>}") ("dumb" "set terminal dumb {size <xchars>,<ychars>} {[no]feed} [more ...]" "set terminal dumb {size <xchars>,<ychars>} {[no]feed}
+                  {aspect <htic>{,<vtic>}}
+                  {[no]enhanced}
+                  {fillchar {solid|\"<char>\"}}
+                  {[no]attributes}
+                  {mono|ansi|ansi256|ansirgb}") ("svga" "set terminal svga {font \"<fontname>\"} [more ...]" "set terminal svga {font \"<fontname>\"}
+                  {{no}enhanced}
+                  {background <rgb color>}
+                  {linewidth|lw <lw>}
+                  {pointscale|ps <scale>}
+                  {fontscale|fs <scale>}") ("corel" "set terminal corel {monochrome | color} {\"<font>\" {<fontsize>}} [more ...]" "set terminal corel {monochrome | color} {\"<font>\" {<fontsize>}}
+                   {<xsize> <ysize> {<linewidth> }}") ("context" "set term context {default} [more ...]" "set term context {default}
+        {defaultsize | size <scale> | size <xsize>{in|cm}, <ysize>{in|cm}}
+        {input | standalone}
+        {timestamp | notimestamp}
+        {noheader | header \"<header>\"}
+        {color | colour | monochrome}
+        {rounded | mitered | beveled} {round | butt | squared}
+        {dashed | solid} {dashlength | dl <dl>}
+        {linewidth | lw <lw>}
+        {fontscale <fontscale>}
+        {mppoints | texpoints}
+        {inlineimages | externalimages}
+        {defaultfont | font \"{<fontname>}{,<fontsize>}\"}") ("cgm" "set terminal cgm {color | monochrome} {solid | dashed} {{no}rotate} [more ...]" "set terminal cgm {color | monochrome} {solid | dashed} {{no}rotate}
+                 {<mode>} {width <plot_width>} {linewidth <line_width>}
+                 {font \"<fontname>,<fontsize>\"}
+                 {background <rgb_color>}") ("canvas" "set terminal canvas {size <xsize>, <ysize>} {background <rgb_color>} [more ...]" "set terminal canvas {size <xsize>, <ysize>} {background <rgb_color>}
+                    {font {<fontname>}{,<fontsize>}} | {fsize <fontsize>}
+                    {{no}enhanced} {linewidth <lw>}
+                    {rounded | butt | square}
+                    {dashlength <dl>}
+                    {standalone {mousing} | name '<funcname>'}
+                    {jsdir 'URL/for/javascripts'}
+                    {title '<some string>'}") ("be" "set terminal be {reset} {<n>}") ("aqua" "set terminal aqua {<n>} {title \"<wintitle>\"} {size <x> <y>} [more ...]" "set terminal aqua {<n>} {title \"<wintitle>\"} {size <x> <y>}
+                  {font \"<fontname>{,<fontsize>}\"}
+                  {linewidth <lw>}\"}
+                  {{no}enhanced} {solid|dashed} {dl <dashlength>}}") ("aifm" "set terminal aifm {color|monochrome} {\"<fontname>\"} {<fontsize>}") ("While" "while (<expr>) { [more ...]" "while (<expr>) {
+    <commands>
+}") ("warn" "warn \"message\"") ("vfill" "vfill  FILE using x:y:z:radius:(<expression>) [more ...]" "vfill  FILE using x:y:z:radius:(<expression>)
+vgfill FILE using x:y:z:radius:(<expression>)") ("vclear" "vclear {$gridname}") ("linetype_" "unset linetype N") ("toggle" "toggle {<plotno> | \"plottitle\" | all}") ("test" "test {terminal | palette}") ("system_" "system \"command string\" [more ...]" "system \"command string\"
+! command string
+output = system(\"command string\")
+show variable GPVAL_SYSTEM") ("stats_(Statistical_Summary)" "stats {<ranges>} 'filename' {matrix | using N{:M}} {name 'prefix'} {{no}output} [more ...]" "stats {<ranges>} 'filename' {matrix | using N{:M}} {name 'prefix'} {{no}output}
+stats $voxelgridname {name 'prefix'}") ("voxel-grid" "splot $voxelgridname with {dots|points} {above <threshold>} ... [more ...]" "splot $voxelgridname with {dots|points} {above <threshold>} ...
+splot $voxelgridname with isosurface {level <threshold>} ...") ("matrix" "plot 'file' matrix every {<column_incr>} [more ...]" "plot 'file' matrix every {<column_incr>}
+                         {:{<row_incr>}
+                           {:{<start_column>}
+                             {:{<start_row>}
+                               {:{<end_column>}
+                                 {:<end_row>}}}}}") ("matrix" "sparse matrix=(cols,rows) origin=(x0,y0) dx=<delx> dy=<dely>") ("data-file" "splot '<file_name>' {binary <binary list>} [more ...]" "splot '<file_name>' {binary <binary list>}
+                    {{nonuniform|sparse} matrix}
+                    {index <index list>}
+                    {every <every list>}
+                    {using <using list>}") ("splot" "splot {<ranges>} [more ...]" "splot {<ranges>}
+      {<iteration>}
+      <function> | {{<file name> | <datablock name>} {datafile-modifiers}}
+                 | <voxelgridname>
+                 | keyentry
+      {<title-spec>} {with <style>}
+      {, {definitions{,}} <function> ...}") ("show_variables" "show variables      # show variables that do not begin with GPVAL_ [more ...]" "show variables      # show variables that do not begin with GPVAL_
+show variables all  # show all variables including those beginning GPVAL_
+show variables NAME # show only variables beginning with NAME") ("show_palette" "show palette [more ...]" "show palette
+show palette palette {<ncolors>} {{float | int | hex}}
+show palette gradient
+show palette rgbformulae
+test palette") ("show_functions" "show functions") ("zeroaxis" "set {x|x2|y|y2|z}zeroaxis { {linestyle | ls <line_style>} [more ...]" "set {x|x2|y|y2|z}zeroaxis { {linestyle | ls <line_style>}
+                           | {linetype | lt <line_type>}
+                             {linewidth | lw <line_width>}
+                             {linecolor | lc <colorspec>}
+                             {dashtype | dt <dashtype>} }
+unset {x|x2|y|y2|z}zeroaxis
+show {x|y|z}zeroaxis") ("zero" "set zero <expression> [more ...]" "set zero <expression>
+show zero") ("xyplane" "set xyplane at <zvalue> [more ...]" "set xyplane at <zvalue>
+set xyplane relative <frac>
+set ticslevel <frac>        # equivalent to set xyplane relative
+show xyplane") ("xtics_list" "set xtics {add} (\"label1\" <pos1> <level1>, \"label2\" <pos2> <level2>, ...)") ("xtics_series" "set xtics <incr> [more ...]" "set xtics <incr>
+set xtics <start>, <incr>, <end>") ("xtics" "set xtics {axis | border} {{no}mirror} [more ...]" "set xtics {axis | border} {{no}mirror}
+          {in | out} {scale {default | <major> {,<minor>}}}
+          {{no}rotate {by <ang>}} {offset <offset> | nooffset}
+          {left | right | center | autojustify}
+          {add}
+          {  autofreq
+           | <incr>
+           | <start>, <incr> {,<end>}
+           | ({\"<label>\"} <pos> {<level>} {,{\"<label>\"}...) }
+          {format \"formatstring\"} {font \"name{,<size>}\"} {{no}enhanced}
+          { numeric | timedate | geographic }
+          {{no}logscale}
+          { rangelimited }
+          { textcolor <colorspec> }
+unset xtics
+show xtics") ("xrange" "set xrange [{{<min>}:{<max>}}] {{no}reverse} {{no}writeback} {{no}extend} [more ...]" "set xrange [{{<min>}:{<max>}}] {{no}reverse} {{no}writeback} {{no}extend}
+           | restore
+show xrange") ("xmtics" "set xmtics [more ...]" "set xmtics
+unset xmtics
+show xmtics") ("xlabel" "set xlabel {\"<label>\"} {offset <offset>} {font \"<font>{,<size>}\"} [more ...]" "set xlabel {\"<label>\"} {offset <offset>} {font \"<font>{,<size>}\"}
+           {textcolor <colorspec>} {{no}enhanced}
+           {rotate by <degrees> | rotate parallel | norotate}
+show xlabel") ("xdtics" "set xdtics [more ...]" "set xdtics
+unset xdtics
+show xdtics") ("xdata" "set xdata {time} [more ...]" "set xdata {time}
+show xdata") ("walls" "set walls [more ...]" "set walls
+set wall {x0|y0|z0|x1|y1} {<fillstyle>} {fc <fillcolor>}") ("vxrange" "Establishes the range of x coordinates spanned by the active voxel grid. [more ...]" "Establishes the range of x coordinates spanned by the active voxel grid.
+Analogous commands `set vyrange` and `set vzrange` exist for the other two
+dimensions of the voxel grid.  If no explicit ranges have been set prior to
+the first `vclear`, `vfill`, or `voxel(x,y,z) = ` command, vmin and vmax
+will be copied from the current values of `xrange`.") ("vrange" "The range of the parametric variables u and v is useful in two contexts. [more ...]" "The range of the parametric variables u and v is useful in two contexts.
+1) `splot` in parametric mode. See `set parametric`, `set isosamples`.
+2) generating 2-dimension sampled data for either `plot` or `splot` using the
+pseudofile \"++\". See `sampling 2D`.") ("projection" "set view projection {xy|xz|yz}") ("view" "set view <rot_x>{,{<rot_z>}{,{<scale>}{,<scale_z>}}} [more ...]" "set view <rot_x>{,{<rot_z>}{,{<scale>}{,<scale_z>}}}
+set view map {scale <scale>}
+set view projection {xy|xz|yz}
+set view {no}equal {xy|xyz}
+set view azimuth <angle>
+show view") ("vgrid" "set vgrid $gridname {size N} [more ...]" "set vgrid $gridname {size N}
+unset vgrid $gridname
+show vgrid") ("version" "show version {long}") ("urange" "The range of the parametric variables u and v is useful in two contexts. [more ...]" "The range of the parametric variables u and v is useful in two contexts.
+1) `splot` in parametric mode. See `set parametric`, `set isosamples`.
+2) generating 2-dimension sampled data for either `plot` or `splot` using the
+pseudofile \"++\". See `sampling 2D`.") ("trange" "The range of the parametric variable t is useful in three contexts.") ("title_" "set title {\"<title-text>\"} {offset <offset>} {font \"<font>{,<size>}\"} [more ...]" "set title {\"<title-text>\"} {offset <offset>} {font \"<font>{,<size>}\"}
+          {{textcolor | tc} {<colorspec> | default}} {{no}enhanced}
+show title") ("timefmt" "set timefmt \"<format string>\" [more ...]" "set timefmt \"<format string>\"
+show timefmt") ("timestamp" "set timestamp {\"<format>\"} {top|bottom} {{no}rotate} [more ...]" "set timestamp {\"<format>\"} {top|bottom} {{no}rotate}
+              {offset <xoff>{,<yoff>}} {font \"<fontspec>\"}
+              {textcolor <colorspec>}
+unset timestamp
+show timestamp") ("tics" "set tics {axis | border} {{no}mirror} [more ...]" "set tics {axis | border} {{no}mirror}
+         {in | out} {front | back}
+         {{no}rotate {by <ang>}} {offset <offset> | nooffset}
+         {left | right | center | autojustify}
+         {format \"formatstring\"} {font \"name{,<size>}\"} {{no}enhanced}
+         { textcolor <colorspec> }
+set tics scale {default | <major> {,<minor>}}
+unset tics
+show tics") ("terminal" "set terminal {<terminal-type> | push | pop} [more ...]" "set terminal {<terminal-type> | push | pop}
+show terminal") ("table" "set table {\"outfile\" | $datablock} {append} [more ...]" "set table {\"outfile\" | $datablock} {append}
+          {separator {whitespace|tab|comma|\"<char>\"}}
+plot <whatever>
+unset table") ("surface_" "set surface {implicit|explicit} [more ...]" "set surface {implicit|explicit}
+unset surface
+show surface") ("set_style_watchpoint" "set style watchpoint nolabels [more ...]" "set style watchpoint nolabels
+set style watchpoint labels {label-options}") ("set_style_textbox" "set style textbox {<boxstyle-index>} [more ...]" "set style textbox {<boxstyle-index>}
+          {opaque|transparent} {fillcolor <color>}
+          {{no}border {linecolor <colorspec>}}{linewidth <lw>}
+          {margins <xmargin>,<ymargin>}") ("set_style_spiderplot" "set style spiderplot [more ...]" "set style spiderplot
+          {fillstyle <fillstyle-properties>}
+          {<line-properties> | <point-properties>}") ("set_style_parallelaxis" "set style parallelaxis {front|back} {line-properties}") ("set_style_ellipse" "set style ellipse {units xx|xy|yy} [more ...]" "set style ellipse {units xx|xy|yy}
+                  {size {graph|screen} <a>, {{graph|screen} <b>}}
+                  {angle <angle>}
+                  {clip|noclip}") ("set_style_rectangle" "set style rectangle {front|back} {lw|linewidth <lw>} [more ...]" "set style rectangle {front|back} {lw|linewidth <lw>}
+                    {fillcolor <colorspec>} {fs <fillstyle>}") ("set_style_circle" "set style circle {radius {graph|screen} <R>} [more ...]" "set style circle {radius {graph|screen} <R>}
+                 {{no}wedge}
+                 {clip|noclip}") ("set_style_line" "set style line <index> default [more ...]" "set style line <index> default
+set style line <index> {{linetype  | lt} <line_type> | <colorspec>}
+                       {{linecolor | lc} <colorspec>}
+                       {{linewidth | lw} <line_width>}
+                       {{pointtype | pt} <point_type>}
+                       {{pointsize | ps} <point_size>}
+                       {{pointinterval | pi} <interval>}
+                       {{pointnumber | pn} <max_symbols>}
+                       {{dashtype | dt} <dashtype>}
+                       {palette}
+unset style line
+show style line") ("set_style_function" "set style function <plotting-style> [more ...]" "set style function <plotting-style>
+show style function") ("set_style_fill" "set style fill {empty [more ...]" "set style fill {empty
+                | {transparent} solid {<density>}
+                | {transparent} pattern {<n>}}
+               {border {lt} {lc <colorspec>} | noborder}") ("set_style_data" "set style data <plotting-style> [more ...]" "set style data <plotting-style>
+show style data") ("boxplot_" "set style boxplot {range <r> | fraction <f>} [more ...]" "set style boxplot {range <r> | fraction <f>}
+                  {{no}outliers} {pointtype <p>}
+                  {candlesticks | financebars}
+                  {medianlinewidth <width>}
+                  {separation <x>}
+                  {labels off | auto | x | x2}
+                  {sorted | unsorted}") ("set_style_arrow" "set style arrow <index> default [more ...]" "set style arrow <index> default
+set style arrow <index> {nohead | head | backhead | heads}
+                        {size <length>,<angle>{,<backangle>} {fixed}}
+                        {filled | empty | nofilled | noborder}
+                        {front | back}
+                        { {linestyle | ls <line_style>}
+                          | {linetype | lt <line_type>}
+                            {linewidth | lw <line_width}
+                            {linecolor | lc <colorspec>}
+                            {dashtype | dt <dashtype>} }
+unset style arrow
+show style arrow") ("style" "set style arrow <n> <arrowstyle> [more ...]" "set style arrow <n> <arrowstyle>
+set style boxplot <boxplot style options>
+set style circle radius <size> {clip|noclip}
+set style ellipse size <size> units {xy|xx|yy} {clip|noclip}
+set style fill <fillstyle>
+set style histogram <histogram style options>
+set style line <n> <linestyle>
+set style rectangle <object options> <linestyle> <fillstyle>
+set style textbox {<n>} {opaque|transparent} {{no}border} {fillcolor}
+set style watchpoint labels <label options>") ("style" "set style function <style> [more ...]" "set style function <style>
+set style data <style>
+show style function
+show style data") ("size" "set size {{no}square | ratio <r> | noratio} {<xscale>,<yscale>} [more ...]" "set size {{no}square | ratio <r> | noratio} {<xscale>,<yscale>}
+show size") ("samples" "set samples <samples_1> {,<samples_2>} [more ...]" "set samples <samples_1> {,<samples_2>}
+show samples") ("rgbmax" "set rgbmax {1.0 | 255} [more ...]" "set rgbmax {1.0 | 255}
+unset rgbmax") ("print_" "set print [more ...]" "set print
+set print \"-\"
+set print \"<filename>\" [append]
+set print \"|<shell_command>\"
+set print $datablock [append]") ("polar_grid" "set polar grid {<theta_segments>, <radial_segments>} [more ...]" "set polar grid {<theta_segments>, <radial_segments>}
+               { qnorm {<power>} | gauss | cauchy | exp | box | hann }
+               { kdensity } { scale <scale> }
+               {theta [min:max]} {r [min:max]}") ("polar" "set polar [more ...]" "set polar
+set polar grid <grid options>
+unset polar
+show polar") ("pointsize" "set pointsize <multiplier> [more ...]" "set pointsize <multiplier>
+show pointsize") ("clipping" "set pm3d {clip | clip1in | clip4in} [more ...]" "set pm3d {clip | clip1in | clip4in}
+set pm3d {no}clipcb") ("lighting" "set pm3d lighting {primary <frac>} {specular <frac>} {spec2 <frac>} [more ...]" "set pm3d lighting {primary <frac>} {specular <frac>} {spec2 <frac>}
+set pm3d spotlight {rgb <color>} {rot_x <angle>} {rot_z <angle>}
+                   {Phong <value>} {default}") ("pixmap_from_colormap" "set pixmap <index> colormap <name>") ("pixmap" "set pixmap <index> {\"filename\" | colormap <name>} [more ...]" "set pixmap <index> {\"filename\" | colormap <name>}
+           at <position>
+           {width <w> | height <h> | size <w>,<h>}
+           {front|back|behind} {center}
+show pixmaps
+unset pixmaps
+unset pixmap <index>") ("paxis" "set paxis <axisno> {range <range-options> | tics <tic-options>} [more ...]" "set paxis <axisno> {range <range-options> | tics <tic-options>}
+set paxis <axisno> label <label-options> { offset <radial-offset> }
+show paxis <axisno> {range | tics}") ("parametric_" "set parametric [more ...]" "set parametric
+unset parametric
+show parametric") ("defined" "set palette  defined { ( <gray1> <color1> {, <grayN> <colorN>}... ) }") ("palette__" "set palette [more ...]" "set palette
+set palette {
+           { gray | color }
+           { gamma <gamma> }
+           {   rgbformulae <r>,<g>,<b>
+             | defined { ( <gray1> <color1> {, <grayN> <colorN>}... ) }
+             | file '<filename>' {datafile-modifiers}
+             | colormap <colormap-name> 
+             | functions <R>,<G>,<B>
+           }
+           { cubehelix {start <val>} {cycles <val>} {saturation <val>} }
+           { viridis }
+           { model { RGB | CMY | HSV {start <radians>} } }
+           { positive | negative }
+           { nops_allcF | ps_allcF }
+           { maxcolors <maxcolors> }
+         }") ("overflow" "set overflow {float | NaN | undefined} [more ...]" "set overflow {float | NaN | undefined}
+unset overflow") ("output" "set output {\"<filename>\"} [more ...]" "set output {\"<filename>\"}
+unset output
+show output") ("origin" "set origin <x-origin>,<y-origin>") ("offsets" "set offsets <left>, <right>, <top>, <bottom> [more ...]" "set offsets <left>, <right>, <top>, <bottom>
+unset offsets
+show offsets") ("polygon" "set object <index> polygon [more ...]" "set object <index> polygon
+    from <position> to <position> ... {to <position>}") ("circle" "set object <index> circle {at|center} <position> size <radius> [more ...]" "set object <index> circle {at|center} <position> size <radius>
+    {arc [<begin>:<end>]} {no{wedge}}
+    {<other-object-properties>}") ("ellipse" "set object <index> ellipse {at|center} <position> size <w>,<h> [more ...]" "set object <index> ellipse {at|center} <position> size <w>,<h>
+    {angle <orientation>} {units xy|xx|yy}
+    {<other-object-properties>}") ("rectangle" "set object <index> rectangle [more ...]" "set object <index> rectangle
+    {from <position> {to|rto} <position> |
+     center <position> size <w>,<h> |
+     at <position> size <w>,<h>}") ("object" "set object <index> [more ...]" "set object <index>
+    <object-type> <object-properties>
+    {front|back|behind|depthorder}
+    {clip|noclip}
+    {fc|fillcolor <colorspec>} {fs <fillstyle>}
+    {default} {lw|linewidth <width>} {dt|dashtype <dashtype>}
+unset object <index>") ("nonlinear" "set nonlinear <axis> via f(axis) inverse g(axis) [more ...]" "set nonlinear <axis> via f(axis) inverse g(axis)
+unset nonlinear <axis>") ("mxtics_time" "set mxtics time <N> {seconds|minutes|hours|days|weeks|months|years}") ("mxtics" "set mxtics <freq> [more ...]" "set mxtics <freq>
+set mxtics default
+set mxtics time <N> <units>
+unset mxtics
+show mxtics") ("multiplot" "set multiplot [more ...]" "set multiplot
+    { title <page title> {font <fontspec>} {enhanced|noenhanced} }
+    { layout <rows>,<cols>
+      {rowsfirst|columnsfirst} {downwards|upwards}
+      {scale <xscale>{,<yscale>}} {offset <xoff>{,<yoff>}}
+      {margins <left>,<right>,<bottom>,<top>}
+      {spacing <xspacing>{,<yspacing>}}
+    }
+set multiplot {next|previous}
+unset multiplot") ("mouseformat" "set mouse mouseformat i [more ...]" "set mouse mouseformat i
+set mouse mouseformat \"custom format\"
+set mouse mouseformat function string_valued_function(x, y)") ("mouse" "set mouse {doubleclick <ms>} {nodoubleclick} [more ...]" "set mouse {doubleclick <ms>} {nodoubleclick}
+          {{no}zoomcoordinates}
+          {zoomfactors <xmultiplier>, <ymultiplier>}
+          {noruler | ruler {at x,y}}
+          {polardistance{deg|tan} | nopolardistance}
+          {format <string>}
+          {mouseformat <int> | <string> | function <f(x,y)>}
+          {{no}labels {\"labeloptions\"}}
+          {{no}zoomjump} {{no}verbose}
+unset mouse") ("monochrome" "set monochrome {linetype N <linetype properties>}") ("margin" "set lmargin {{at screen} <margin>} [more ...]" "set lmargin {{at screen} <margin>}
+set rmargin {{at screen} <margin>}
+set tmargin {{at screen} <margin>}
+set bmargin {{at screen} <margin>}
+set margins <left>, <right>, <bottom>, <top>
+show margin") ("mapping" "set mapping {cartesian | spherical | cylindrical}") ("logscale" "set logscale <axes> {<base>} [more ...]" "set logscale <axes> {<base>}
+unset logscale <axes>
+show logscale") ("locale" "set locale {\"<locale>\"}") ("loadpath" "set loadpath {\"pathlist1\" {\"pathlist2\"...}} [more ...]" "set loadpath {\"pathlist1\" {\"pathlist2\"...}}
+show loadpath") ("link" "set link {x2 | y2} {via <expression1> inverse <expression2>} [more ...]" "set link {x2 | y2} {via <expression1> inverse <expression2>}
+unset link") ("label" "set label {<tag>} {\"<label text>\"} {at <position>} [more ...]" "set label {<tag>} {\"<label text>\"} {at <position>}
+          {left | center | right}
+          {norotate | rotate {by <degrees>}}
+          {font \"<name>{,<size>}\"}
+          {noenhanced}
+          {front | back}
+          {textcolor <colorspec>}
+          {point <pointstyle> | nopoint}
+          {offset <offset>}
+          {nobox} {boxed {bs <boxstyle>}}
+          {hypertext}
+unset label {<tag>}
+show label") ("jitter" "set jitter {overlap <yposition>} {spread <factor>} {wrap <limit>} [more ...]" "set jitter {overlap <yposition>} {spread <factor>} {wrap <limit>}
+           {swarm|square|vertical}") ("isotropic" "set isotropic [more ...]" "set isotropic
+unset isotropic") ("isosurface_" "set isosurface {mixed|triangles} [more ...]" "set isosurface {mixed|triangles}
+set isosurface {no}insidecolor <n>") ("isosamples" "set isosamples <iso_1> {,<iso_2>} [more ...]" "set isosamples <iso_1> {,<iso_2>}
+show isosamples") ("history_" "set history {size <N>} {quiet|numbers} {full|trim} {default}") ("hidden3d" "set hidden3d {defaults} | [more ...]" "set hidden3d {defaults} |
+             { {front|back}
+               {{offset <offset>} | {nooffset}}
+               {trianglepattern <bitpattern>}
+               {{undefined <level>} | {noundefined}}
+               {{no}altdiagonal}
+               {{no}bentover} }
+unset hidden3d
+show hidden3d") ("grid" "set grid {{no}{m}xtics} {{no}{m}ytics} {{no}{m}ztics} [more ...]" "set grid {{no}{m}xtics} {{no}{m}ytics} {{no}{m}ztics}
+         {{no}{m}x2tics} {{no}{m}y2tics} {{no}{m}rtics}
+         {{no}{m}cbtics}
+         {polar {<angle>}}
+         {layerdefault | front | back}
+         {{no}vertical}
+         {<line-properties-major> {, <line-properties-minor>}}
+unset grid
+show grid") ("format__" "set format {<axes>} {\"<format-string>\"} {numeric|timedate|geographic} [more ...]" "set format {<axes>} {\"<format-string>\"} {numeric|timedate|geographic}
+show format") ("fontpath" "set fontpath \"/directory/where/my/fonts/live\" [more ...]" "set fontpath \"/directory/where/my/fonts/live\"
+set term postscript fontfile <filename>") ("fit_" "set fit {nolog | logfile {\"<filename>\"|default}} [more ...]" "set fit {nolog | logfile {\"<filename>\"|default}}
+        {{no}quiet|results|brief|verbose}
+        {{no}errorvariables}
+        {{no}covariancevariables}
+        {{no}errorscaling}
+        {{no}prescale}
+        {maxiter <value>|default}
+        {limit <epsilon>|default}
+        {limit_abs <epsilon_abs>}
+        {start-lambda <value>|default}
+        {lambda-factor <value>|default}
+        {script {\"<command>\"|default}}
+        {v4 | v5}
+unset fit
+show fit") ("errorbars" "set errorbars {small | large | fullwidth | <size>} {front | back} [more ...]" "set errorbars {small | large | fullwidth | <size>} {front | back}
+              {line-properties}
+unset errorbars
+show errorbars") ("encoding" "set encoding {<value>} [more ...]" "set encoding {<value>}
+set encoding locale
+show encoding") ("dummy" "set dummy {<dummy-var>} {,<dummy-var>} [more ...]" "set dummy {<dummy-var>} {,<dummy-var>}
+show dummy") ("dgrid3d" "set dgrid3d {<rows>} {,{<cols>}} splines [more ...]" "set dgrid3d {<rows>} {,{<cols>}} splines
+set dgrid3d {<rows>} {,{<cols>}} qnorm {<norm>}
+set dgrid3d {<rows>} {,{<cols>}} {gauss | cauchy | exp | box | hann}
+                {kdensity} {<dx>} {,<dy>}
+unset dgrid3d
+show dgrid3d") ("decimalsign" "set decimalsign {<value> | locale {\"<locale>\"}} [more ...]" "set decimalsign {<value> | locale {\"<locale>\"}}
+unset decimalsign
+show decimalsign") ("set_datafile_binary" "set datafile binary <binary list> [more ...]" "set datafile binary <binary list>
+show datafile binary
+show datafile
+unset datafile") ("set_datafile_commentschars" "set datafile commentschars {\"<string>\"} [more ...]" "set datafile commentschars {\"<string>\"}
+show datafile commentschars
+unset commentschars") ("set_datafile_separator" "set datafile separator {whitespace | tab | comma | \"<chars>\"}") ("set_datafile_missing" "set datafile missing \"<string>\" [more ...]" "set datafile missing \"<string>\"
+set datafile missing NaN
+show datafile missing
+unset datafile") ("contourfill_" "set contourfill auto N          # split zrange evenly into N slices [more ...]" "set contourfill auto N          # split zrange evenly into N slices
+set contourfill ztics           # slice at each z axis major tick
+set contourfill cbtics          # slice at each cb axis major tick
+set contourfill {palette | firstlinetype N}") ("contour" "set contour {base | surface | both} [more ...]" "set contour {base | surface | both}
+unset contour
+show contour") ("cntrparam" "set cntrparam { { linear [more ...]" "set cntrparam { { linear
+                | cubicspline
+                | bspline
+                | points <n>
+                | order <n>
+                | levels { <n>
+                           | auto {<n>}
+                           | discrete <z1> {,<z2>{,<z3>...}}
+                           | incremental <start>, <incr> {,<end>}
+                         }
+                  {{un}sorted}
+                  {firstlinetype N}
+                }
+              }
+show contour") ("cntrlabel" "set cntrlabel {format \"format\"} {font \"font\"} [more ...]" "set cntrlabel {format \"format\"} {font \"font\"}
+set cntrlabel {start <int>} {interval <int>}
+set cntrlabel onecolor") ("clip" "set clip {points|one|two|radial} [more ...]" "set clip {points|one|two|radial}
+unset clip {points|one|two|radial}
+show clip") ("colorsequence" "set colorsequence {default|classic|podo}") ("colormap" "set colormap new <colormap-name> [more ...]" "set colormap new <colormap-name>
+set colormap <colormap-name> range [<min>:<max>]
+show colormaps") ("boxwidth" "set boxwidth {<width>} {absolute|relative} [more ...]" "set boxwidth {<width>} {absolute|relative}
+show boxwidth") ("border" "set border {<integer>} [more ...]" "set border {<integer>}
+           {front | back | behind}
+           {linestyle | ls <line_style>}
+           {linetype | lt <line_type>} {linewidth | lw <line_width>}
+           {linecolor | lc <colorspec>} {dashtype | dt <dashtype>}
+           {polar}
+unset border
+show border") ("autoscale" "set autoscale {<axis>{|min|max|fixmin|fixmax|fix} | fix | keepfix} [more ...]" "set autoscale {<axis>{|min|max|fixmin|fixmax|fix} | fix | keepfix}
+set autoscale noextend
+unset autoscale {<axis>}
+show autoscale") ("arrow" "set arrow {<tag>} from <position> to <position> [more ...]" "set arrow {<tag>} from <position> to <position>
+set arrow {<tag>} from <position> rto <position>
+set arrow {<tag>} from <position> length <coord> angle <ang>
+set arrow <tag> arrowstyle | as <arrow_style>
+set arrow <tag> {nohead | head | backhead | heads}
+                {size <headlength>,<headangle>{,<backangle>}} {fixed}
+                {filled | empty | nofilled | noborder}
+                {front | back}
+                {linestyle | ls <line_style>}
+                {linetype | lt <line_type>}
+                {linewidth | lw <line_width>}
+                {linecolor | lc <colorspec>}
+                {dashtype | dt <dashtype>}") ("angles" "set angles {degrees | radians} [more ...]" "set angles {degrees | radians}
+show angles") ("save" "save  {functions | variables | terminal | set | fit | datablocks} [more ...]" "save  {functions | variables | terminal | set | fit | datablocks}
+      '<filename>' {append}") ("return" "return <expression>") ("raise" "raise {plot_window_id} [more ...]" "raise {plot_window_id}
+lower {plot_window_id}") ("print" "print <expression> {, <expression>, ...}") ("with" "with <style> { {linestyle | ls <line_style>} [more ...]" "with <style> { {linestyle | ls <line_style>}
+               | {{linetype  | lt <line_type>}
+                  {linewidth | lw <line_width>}
+                  {linecolor | lc <colorspec>}
+                  {pointtype | pt <point_type>}
+                  {pointsize | ps <point_size>}
+                  {arrowstyle | as <arrowstyle_index>}
+                  {fill | fs <fillstyle>} {fillcolor | fc <colorspec>}
+                  {nohidden3d} {nocontours} {nosurface}
+                  {palette}}
+             }") ("title" "title <text> | notitle [<ignored text>] [more ...]" "title <text> | notitle [<ignored text>]
+title columnheader | title columnheader(N)
+      {at {beginning|end}} {{no}enhanced}") ("for_loops_in_plot_command" "plot for [<variable> = <start> : <end> {:<increment>}] [more ...]" "plot for [<variable> = <start> : <end> {:<increment>}]
+plot for [<variable> in \"string of words\"]") ("ranges" "[{<dummy-var>=}{{<min>}:{<max>}}] [more ...]" "[{<dummy-var>=}{{<min>}:{<max>}}]
+[{{<min>}:{<max>}}]") ("using" "plot 'file' using <entry> {:<entry> {:<entry> ...}} {'format'}") ("smooth" "smooth {unique | frequency | fnormal | cumulative | cnormal [more ...]" "smooth {unique | frequency | fnormal | cumulative | cnormal
+       | csplines | acsplines | mcsplines  bezier | sbezier
+       | path
+       | kdensity {bandwidth} {period}
+       | unwrap}") ("index" "plot 'file' index { <m>{:<n>{:<p>}} | \"<name>\" }") ("filters" "plot 'DATA' using <XCOL> {:<YCOL>} bins{=<NBINS>} [more ...]" "plot 'DATA' using <XCOL> {:<YCOL>} bins{=<NBINS>}
+     {binrange [<LOW>:<HIGH>]} {binwidth=<width>}
+     {binvalue={sum|avg}}") ("every" "plot 'file' every {<point_incr>} [more ...]" "plot 'file' every {<point_incr>}
+                    {:{<block_incr>}
+                      {:{<start_point>}
+                        {:{<start_block>}
+                          {:{<end_point>}
+                            {:<end_block>}}}}}") ("csv_files" "set datafile separator {whitespace | tab | comma | \"chars\"}") ("data" "plot '<file_name>' {binary <binary list>} [more ...]" "plot '<file_name>' {binary <binary list>}
+                   {{nonuniform|sparse} matrix}
+                   {index <index list> | index \"<name>\"}
+                   {every <every list>}
+                   {skip <number-of-lines>}
+                   {using <using list>}
+                   {convexhull} {concavehull}
+                   {smooth <option>}
+                   {bins <options>}
+                   {mask}
+                   {volatile} {zsort} {noautoscale}") ("general" "plot '<file_name>' {binary <binary list>} ... [more ...]" "plot '<file_name>' {binary <binary list>} ...
+splot '<file_name>' {binary <binary list>} ...") ("plot" "plot {<ranges>} <plot-element> {, <plot-element>, <plot-element>}") ("pause" "pause <time> {\"<string>\"} [more ...]" "pause <time> {\"<string>\"}
+pause mouse {<endcondition>}{, <endcondition>} {\"<string>\"}
+pause mouse close") ("local" "local foo = <expression> [more ...]" "local foo = <expression>
+local array foo[size]") ("load" "load \"<input-file>\" [more ...]" "load \"<input-file>\"
+load $datablock") ("import" "import func(x[,y,z,...]) from \"sharedobj[:symbol]\"") ("if" "if (<condition>) { <commands>; [more ...]" "if (<condition>) { <commands>;
+       <commands>
+       <commands>
+} else if (<condition>) {
+       <commands>
+} else {
+       <commands>
+}") ("fit" "fit {<ranges>} <expression> [more ...]" "fit {<ranges>} <expression>
+    '<datafile>' {datafile-modifiers}
+    {{unitweights} | {y|xy|z}error | errors <var1>{,<var2>,...}}
+    via '<parameter file>' | <var1>{,<var2>,...}") ("Do" "do for <iteration-spec> { [more ...]" "do for <iteration-spec> {
+     <commands>
+     <commands>
+}") ("cd" "cd '<directory-name>'") ("Zerrorfill" "splot DATA using 1:2:3:4[:5] with zerrorfill {fc|fillcolor <colorspec>} [more ...]" "splot DATA using 1:2:3:4[:5] with zerrorfill {fc|fillcolor <colorspec>}
+           {lt|linetype <n>} {<line properties>}") ("sectors" "plot DATA {using specifier} {units xy | units xx | units yy}") ("parallelaxes" "set style data parallelaxes [more ...]" "set style data parallelaxes
+plot $DATA using col1{:varcol1} {at <xpos>} {<line properties}, \\
+     $DATA using col2, ...") ("hsteps" "plot <data> with hsteps [more ...]" "plot <data> with hsteps
+                    {forward|backward}
+                    {baseline|pillars|link|nolink}
+                    {{above|below} y=<baseline>}
+                    {offset <y-offset>}") ("newhistogram" "newhistogram {\"<title>\" {font \"name,size\"} {tc <colorspec>}} [more ...]" "newhistogram {\"<title>\" {font \"name,size\"} {tc <colorspec>}}
+             {lt <linetype>} {fs <fillstyle>} {at <x-coord>}") ("ellipses" "plot <data> with ellipses {units [xx|xy|yy]}") ("contourfill" "splot f(x,y) with contourfill {at base} {fillstyle <style>}") ("Watchpoints_" "plot FOO watch {x|y|z|F(x,y)} = <value> [more ...]" "plot FOO watch {x|y|z|F(x,y)} = <value>
+plot FOO watch mouse") ("bind" "bind {allwindows} [<key-sequence>] [\"<gnuplot commands>\"] [more ...]" "bind {allwindows} [<key-sequence>] [\"<gnuplot commands>\"]
+bind <key-sequence> \"\"
+reset bind") ("dashtype" "dashtype N          # predefined dashtype invoked by number [more ...]" "dashtype N          # predefined dashtype invoked by number
+dashtype \"pattern\"  # string containing a combination of the characters
+                    # dot (.) hyphen (-) underscore(_) and space.
+dashtype (s1,e1,s2,e2,s3,e3,s4,e4)  # dash pattern specified by 1 to 4
+                    # numerical pairs <solid length>, <emptyspace length>") ("colorspec" "... {linecolor | lc} {\"colorname\" | <colorspec> | <n>} [more ...]" "... {linecolor | lc} {\"colorname\" | <colorspec> | <n>}
+... {textcolor | tc} {<colorspec> | {linetype | lt} <n>}
+... {fillcolor | fc} {<colorspec> | linetype <n> | linestyle <n>}") ("Time_functions" "time = weekdate_cdc( year, week [, day] )") ("Time_functions" "time = weekdate_iso( year, week [, day] )")))) (while alist (puthash (caar alist) (cdar alist) tbl) (setq alist (cdr alist))) tbl))
+(provide 'gnuplot-eldoc)
+;;; gnuplot-eldoc.el ends here
diff --git a/elpa/gnuplot-20260322.20/gnuplot-gui.el b/elpa/gnuplot-20260322.20/gnuplot-gui.el
new file mode 100644
index 00000000..86a9ac76
--- /dev/null
+++ b/elpa/gnuplot-20260322.20/gnuplot-gui.el
@@ -0,0 +1,1621 @@
+;;;; gnuplot-gui.el -- GUI interface to setting options in gnuplot-mode -*- lexical-binding: t -*-
+
+;; Copyright (C) 1998-2000 Bruce Ravel
+
+;; Author: Bruce Ravel <ravel@phys.washington.edu>
+
+;; This program is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+;;; Commentary:
+
+;; This file provides a graphical user interface to setting arguments
+;; to gnuplot commands.  Positioning point near a command and invoking
+;; `gnuplot-gui-set-options-and-insert' (C-c C-c or shift-mouse-2)
+;; will pop open a frame with widgets for setting the various
+;; arguments appropriate the the item that was near point.  The goal
+;; is to provide point-and-click functionality to gnuplot-mode.
+
+;;; To do:
+
+;; Widgets I need:
+;; -- 'position: two or three comma separated numbers used to denote a
+;;               position or a tic start/end/increment (see arrow,
+;;               need a prefix)
+;; -- 'modifier: colon separated fields used for datafile modifiers
+;;
+;; command types which are currently unsupported or contain mistakes
+;; -- unsupported: cntrparam
+;; -- plot, splot, fit: rather lame
+;; -- label: position information missing
+;; -- label: font string handled in overly simple manner
+;; -- hidden3d: not really suited to 'list, but all options are exclusive...
+;; -- pointstyle argument to "set label"
+;;
+;; overall:
+;; -- continuation lines (ugh!)
+;; -- multiple frames end up displaying same window after setting options
+
+;;; Code:
+
+(require 'gnuplot)
+(require 'wid-edit)
+
+
+;;; customizable variables
+
+(defgroup gnuplot-gui nil
+  "Graphical interface to setting arguments in gnuplot scrips."
+  :prefix "gnuplot-gui-"
+  :group 'gnuplot)
+
+(defcustom gnuplot-gui-popup-flag nil
+  "Non-nil means to open arguments pop-ups automatically.
+This would be done after menu insertion of Gnuplot commands."
+  :type 'boolean)
+
+(defvar gnuplot-gui-frame nil
+  "Frame used to hold the buffer for setting options.")
+
+(defcustom gnuplot-gui-frame-parameters
+  '((height . 18)
+    (width . 65)
+    (user-position . t)
+    (top . 150)
+    (left . 150)
+    (border-width . 0)
+    (menu-bar-lines . 0)
+    (unsplittable . t))
+  "Frame parameters for the input run-time display frame in Emacs."
+  :type '(repeat (sexp :tag "Parameter:")))
+
+(defcustom gnuplot-gui-fontname-list
+  '(" " "\"Helvetica\"" "\"Times-Roman\"")
+  "List of known font names.
+These *must* be quoted, like so \"\\\"Helvetica\\\"\".  This allows
+for fonts with names like \"\\\"Arial Bold Italic\\\"\" to be treated
+as single entries in the menu-buttons.  And it is really important that
+the first entry in the list be a blank string."
+  :type '(repeat (string :tag "Font name:")))
+
+;; some global variables
+(defvar gnuplot-gui-current-frame nil)
+(defvar gnuplot-gui-current-buffer nil)
+(defvar gnuplot-gui-current-buffer-point nil)
+(defvar gnuplot-gui-alist nil)
+(defvar gnuplot-gui-current-string nil)
+
+
+;;; various tools for handling data structures and text in the buffer
+
+;; tools for accessing the elements of the lists in `gnuplot-gui-all-types'
+(defsubst gnuplot-gui-type-tag     (obj) (elt obj 0))
+(defsubst gnuplot-gui-type-symbol  (obj) (elt obj 1))
+(defsubst gnuplot-gui-type-default (obj) (elt obj 2))
+(defsubst gnuplot-gui-type-prefix  (obj) (elt obj 3)) ; also 'range seperator
+(defsubst gnuplot-gui-type-fourth  (obj) (elt obj 4))
+(defsubst gnuplot-gui-type-list    (obj) (cddr obj))
+
+(defun gnuplot-gui-this-word ()
+  "Return the word under point."
+  (let ((begin (save-excursion (beginning-of-line) (point-marker)))
+        (end   (save-excursion (end-of-line)       (point-marker))))
+    (save-excursion
+      (or (looking-at "\\<") (= (current-column) 0) (forward-word -1))
+      (if (> (point) begin) (setq begin (point-marker)))
+      (forward-word 1)
+      (if (> (point) end) (goto-char end))
+      (buffer-substring-no-properties begin (point)))))
+
+
+;;; data structures containing regarding options in Gnuplot 3.7
+
+;; various constants used for options that take the same sorts of arguments
+(defconst gnuplot-gui-mtics-list
+  '(("FREQUENCY"   'number " ")
+    ("DEFAULT"     'list " " "default")))
+(defconst gnuplot-gui-data-list
+  '(("DATA TYPE"   'list " " "time")))
+(defconst gnuplot-gui-label-list
+  '(("LABEL"       'string " ")
+    ("POSITION"    'position " " "" 2)
+    ("FONTNAME"    'list " " gnuplot-gui-fontname-list)
+    ("FONTSIZE"    'fontsize " ")))
+(defconst gnuplot-gui-range-list
+  '(("RANGE"       'range (" " . " ") ":")
+    ("REVERSE"     'list " " "reverse" "noreverse")
+    ("WRITEBACK"   'list " " "writeback" "nowriteback")))
+(defconst gnuplot-gui-tics-list
+  '(("WHERE"       'list " " "axis" "border")
+    ("MIRROR"      'list " " "mirror" "nomirror")
+    ("ROTATE"      'list " " "rotate" "norotate")
+    ("SERIES"      'position " " "" 3)
+    ("LABEL ARRAY" 'labels () )))
+(defconst gnuplot-gui-zeroaxis-list
+  '(("LINETYPE"    'number " ")))
+
+(defvar gnuplot-gui-terminal-types nil
+  "Associated list of terminal descriptions.
+See the doc-string for `gnuplot-gui-all-types'.")
+(setq gnuplot-gui-terminal-types
+      (list (cons "aifm"
+                  '(("COLOR"     'list " " "monochrome" "gray" "color")
+                    ("FONTNAME"  'list " " gnuplot-gui-fontname-list)
+                    ("FONTSIZE"  'fontsize " ")))
+            (cons "cgm"
+                  '(("MODE"      'list   " " "landscape" "portrait" "default")
+                    ("COLOR"     'list   " " "color" "monochrome")
+                    ("ROTATION"  'list   " " "rotate" "norotate")
+                    ("WIDTH"     'number " " "width")
+                    ("LINEWIDTH" 'number " " "linewidth")
+                    ("FONTNAME"  'list   " " "\"Arial\"" "\"Arial Italic\""
+                     "\"Arial Bold\"" "\"Arial Bold Italic\""
+                     "\"Times Roman\"" "\"Times Roman Italic\""
+                     "\"Times Roman Bold\"" "\"Times Roman Bold Italic\""
+                     "\"Helvetica\"" "\"Roman\"")
+                    ("FONTSIZE"  'fontsize " ")))
+            (cons "corel"
+                  '(("COLOR"            'list " " "default" "color" "monochrome")
+                    ("FONTNAME"         'list " " "\"SwitzerlandLight\""
+                     "\"Helvetica\"" "\"Times-Roman\"")
+                    ("FONTSIZE "        'number " ")
+                    ("X-SIZE   "        'number " ")
+                    ("Y-SIZE   "        'number " ")
+                    ("LINEWIDTH"        'number " ")))
+            (cons "dumb"
+                  '(("LINEFEED"         'list   " " "feed" "nofeed")
+                    ("X-SIZE"           'number " ")
+                    ("Y-SIZE"           'number " ")))
+            (cons "emf"
+                  '(("COLOR"            'list " " "color" "monochrome")
+                    ("LINE"             'list " " "solid" "dashed")
+                    ("FONTNAME"         'string " ")
+                    ("FONTSIZE"         'number " ")))
+            (cons "emtex"
+                  '(("FONTNAME"         'list     " " "courier" "roman")
+                    ("FONTSIZE"         'fontsize " ")))
+            (cons "fig"
+                  '(("COLOR"            'list   " " "color" "monochrome")
+                    ("FRAMESIZE"        'list   " " "small" "big")
+                    ("POINTSMAX"        'number " " "pointsmax")
+                    ("ORIENTATION"      'list   " " "landscape" "portrait")
+                    ("UNITS"            'list   " " "metric" "inches")
+                    ("FONT SIZE"        'number " " "fontsize")
+                    ("SIZE"             'pair   (" " . " ") "size")
+                    ("LINE THICKNESS"   'number " " "thickness")
+                    ("LAYER DEPTH"      'number " " "depth")))
+            (cons "hp500c"
+                  '(("RESOLUTION"       'list " " "75" "100" "150" "300")
+                    ("COMPRESSION"      'list " " "rle" "tiff")))
+            (cons "hpgl"
+                  '(("PENS"             'number " ")
+                    ("EJECT"            'list   " " "eject")))
+            (cons "hpdj"
+                  '(("RESOLUTION"       'list " " "75" "100" "150" "300")))
+            (cons "hpljii"
+                  '(("RESOLUTION"       'list " " "75" "100" "150" "300")))
+            (cons "hppj"
+                  '(("FONT"             'list " " "FNT9X17" "FNT5X9" "FNT13X25")))
+            (cons "imagen"
+                  '(("FONT SIZE"        'number " ")
+                    ("LAYOUT"           'list   " " "portrait" "landscape")
+                    ("NUMBER OF GRAPHS" 'range (" " . " ") ",")))
+            (cons "gpic"
+                  '(("X ORIGIN"         'number " ")
+                    ("Y ORIGIN"         'number " " ",")))
+            (cons "latex"
+                  '(("FONTNAME"         'list " " "courier" "roman")
+                    ("FONTSIZE"         'fontsize " ")))
+            (cons "mif"
+                  '(("COLOUR"           'list " " "colour" "monochrome")
+                    ("LINETYPE"         'list " " "polyline" "vectors")))
+            (cons "nec-cp6"
+                  '(("MODE"             'list " " "monochrome" "colour" "draft")))
+            (cons "pbm"
+                  '(("SIZE"      'list " " "small" "medium" "large")
+                    ("COLOR"     'list " " "monochrome" "gray" "color")))
+            (cons "pcl5L"
+                  '(("MODE"      'list " " "landscape" "portrait")
+                    ("FONTNAME"  'list " " "stick" "univers" "cg_times")
+                    ("FONTSIZE"  'fontsize " ")))
+            (cons "png"
+                  '(("SIZE"      'list " " "small" "medium" "large")
+                    ("COLOR"     'list " " "monochrome" "gray" "color")))
+            (cons "postscript"
+                  '(("MODE"      'list " " "landscape" "portrait" "eps" "default")
+                    ("ENHANCED"  'list " " "enhanced" "noenhanced")
+                    ("COLOR"     'list " " "color" "monochrome")
+                    ("SOLID"     'list " " "solid" "dashed")
+                    ("DUPLEXING" 'list " " "defaultplex" "simplex" "duplex")
+                    ("FONTNAME"  'list " " gnuplot-gui-fontname-list)
+                    ("FONTSIZE"  'fontsize " ")))
+            (cons "pslatex"
+                  '(("COLOR"     'list " " "monochrome" "color")
+                    ("DASHED"    'list " " "dashed")
+                    ("ROTATION"  'list " " "rotate" "norotate")
+                    ("AUXFILE"   'list " " "auxfile")))
+            (cons "pstex"
+                  '(("COLOR"     'list " " "monochrome" "color")
+                    ("DASHED"    'list " " "dashed")
+                    ("ROTATION"  'list " " "rotate" "norotate")
+                    ("AUXFILE"   'list " " "auxfile")))
+            (cons "pstricks"
+                  '(("HACK TEXT"        'list " " "hacktext" "nohacktext")
+                    ("PLOT SCALING"     'list " " "nounit" "unit")))
+            (cons "regis"
+                  '(("COLOR DEPTH"      'list "4" "16")))
+            (cons "tgif"
+                  '(("LAYOUT"           'list   " " "portrait" "landscape")
+                    ("NUMBER OF GRAPHS" 'range (" " . " ") ",")
+                    ("LINE TYPE"        'list " " "solid" "dashed")
+                    ("FONTNAME"         'list " " gnuplot-gui-fontname-list)
+                    ("FONTSIZE"         'fontsize " ")))
+            (cons "tpic"
+                  '(("POINTSIZE"        'number " ")
+                    ("LINEWIDTH"        'number " ")
+                    ("INTERVAL "        'number " ")))
+            (cons "vgagl"       ; for pm3d patch (also persist, raise in x11)
+                  '(("BACKGROUND"       'position  " " "background" 3)
+                    ("INTERPOLATION"    'list " " "uniform" "interpolate")
+                    ("DUMP"             'file " ")
+                    ("MODE"             'string  " " "")))
+            (cons "x11"
+                  '(("RESET"            'list " " "reset")
+                    ("TERMINAL NUMBER"  'number " ")
+                    ("PERSIST"          'list " " "persist" "nopersist")
+                    ("RAISE"            'list " " "raise" "noraise"))) ))
+
+(defvar gnuplot-gui-terminal-list nil)
+(setq gnuplot-gui-terminal-list
+      (append (list " ") (mapcar 'car gnuplot-gui-terminal-types)))
+
+(defvar gnuplot-gui-set-types nil
+  "Associated list of set option descriptions.
+See the doc-string for `gnuplot-gui-all-types'.")
+(setq gnuplot-gui-set-types
+      (list (cons "angles"
+                  '(("UNITS" 'list " " "degrees" "radians")))
+            (cons "arrow"
+                  '(("TAG"       'tag " ")
+                    ("FROM"      'position " " "from" 3)
+                    ("TO"        'position " " "to" 3)
+                    ("HEAD"      'list " " "head" "nohead")
+                    ("LINESTYLE" 'number " " "ls")
+                    ("LINETYPE " 'number " " "lt")
+                    ("LINEWIDTH" 'number " " "lw")))
+            (cons "noarrow"
+                  '(("TAG" 'tag " ")))
+            (cons "autoscale"
+                  '(("AXIS" 'list " " "x" "y" "z" "x2" "y2" "xy"
+                     "xmin" "ymin" "zmin" "x2min" "y2min" "xymin"
+                     "xmax" "ymax" "zmax" "x2max" "y2max" "xymax")))
+            (cons "noautoscale"
+                  '(("AXIS" 'list " " "x" "y" "z" "x2" "y2" "xy"
+                     "xmin" "ymin" "zmin" "x2min" "y2min" "xymin"
+                     "xmax" "ymax" "zmax" "x2max" "y2max" "xymax")))
+            (cons "bar"
+                  '(("SIZE" 'list " " "small" "large")))
+            (cons "border"
+                  '(("BORDER CODE" 'number " ")
+                    ("LINE STYLE"  'list   " " "lines"
+                     "dots" "points" "linespoints")
+                    ("LINESTYLE"   'number " " "ls")
+                    ("LINETYPE"    'number " " "lt")
+                    ("LINEWIDTH"   'number " " "lw")))
+            (cons "boxwidth"
+                  '(("WIDTH" 'number " ")))
+            (cons "clabel"
+                  '(("FORMAT" 'format " ")))
+            (cons "clip"
+                  '(("CLIP TYPE" 'list " " "points" "one" "two")))
+            (cons "noclip"
+                  '(("CLIP TYPE" 'list " " "points" "one" "two")))
+            ;;(cons "cntrparam"
+            ;;  '(("INTERPOLATION" 'list " " "linear" "cubicspline" "bspline")
+            ;;    ("POINTS" 'number " " "points")
+            ;;    ("ORDER"  'number " " "order")))
+            (cons "contour"
+                  '(("WHERE"     'list " " "base" "surface" "both")))
+            (cons "dgrid3d"
+                  '(("ROW,COLUMN,NORM" 'position " " "" 3)))
+            (cons "encoding"
+                  '(("ENCODING" 'list " " "default" "iso_8859_1"
+                     "cp850" "cp437")))
+            (cons "format"
+                  '(("AXIS"   'list " " "x" "y" "z" "xy" "x2" "y2")
+                    ("FORMAT" 'format  " ")))
+            (cons "dummy"
+                  '(("VAR 1" 'string " " "")
+                    ("VAR 2" 'string " " ",")))
+            (cons "grid"
+                  '(("XTICS"  'list " " "xtics" "mxtics" "noxtics" "nomxtics")
+                    ("YTICS"  'list " " "ytics" "mytics" "noytics" "nomytics")
+                    ("ZTICS"  'list " " "ztics" "mztics" "noztics" "nomztics")
+                    ("X2TICS" 'list " " "x2tics" "mx2tics" "nox2tics" "nomx2tics")
+                    ("Y2TICS" 'list " " "y2tics" "my2tics" "noy2tics" "nomy2tics")
+                    ("POLAR"  'number " " "polar")
+                    ("MAJOR LINETYPE" 'number " ")
+                    ("MINOR LINETYPE" 'number " ")))
+            (cons "hidden3d"
+                  '(("ALGORITHM" 'list " " "defaults"
+                     "offset"
+                     "nooffset"
+                     ;;"trianglepattern  # bitpattern between 0 and 7"
+                     "trianglepattern 0" "trianglepattern 1"
+                     "trianglepattern 2" "trianglepattern 3"
+                     "trianglepattern 4" "trianglepattern 5"
+                     "trianglepattern 6" "trianglepattern 7"
+                     ;;"undefined        # level between 0 and 3"
+                     "undefined 0" "undefined 1" "undefined 2" "undefined 3"
+                     "noundefined" "altdiagonal" "noaltdiagonal"
+                     "bentover" "nobentover")))
+            (cons "historysize"
+                  '(("SIZE" 'number " ")))
+            (cons "isosamples"
+                  '(("ISO_U LINES" 'number " ")
+                    ("ISO_V LINES" 'number " " ",")))
+            (cons "key"
+                  '(("LOCATION"      'list " " "left" "right" "top" "bottom"
+                     "outside" "below")
+                    ("POSITION"      'position  " " "" 3)
+                    ("JUSTIFICATION" 'list " " "Left" "Right")
+                    ("REVERSE"       'list " " "reverse" "noreverse")
+                    ("SAMPLE LENGTH" 'number " " "samplen")
+                    ("SPACING"       'number " " "spacing")
+                    ("WIDTH"         'number " " "width")
+                    ("TITLE"         'string " " "title ")
+                    ("BOX LINETYPE"  'number " " "box") ;; linetype data
+                    ("NOBOX"         'list   " " "nobox")))
+            (cons "label"
+                  '(("TAG" 'tag " ")
+                    ("LABEL TEXT" 'string " ")
+                    ("POSITION"   'position " " "at" 3)
+                    ;; first, second, graph, screen
+                    ("JUSTIFICATION" 'list " " "left" "right" "center")
+                    ("ROTATE"        'list " " "rotate" "norotate")
+                    ("FONT"          'string " " "font"))) ;; font "name,size"
+            (cons "nolabel"
+                  '(("TAG"        'tag " ")))
+            (cons "linestyle"
+                  '(("TAG      "  'tag " ")
+                    ("LINE STYLE" 'list " " "boxerrorbars" "boxes"
+                     "boxxyerrorbars" "candlesticks" "dots"
+                     "financebars" "fsteps" "histeps" "impulses"
+                     "lines" "linespoints" "points" "steps" "vector"
+                     "xerrorbars" "xyerrorbars" "yerrorbars")
+                    ("LINETYPE " 'number " " "lt")
+                    ("LINEWIDTH" 'number " " "lw")
+                    ("POINTTYPE" 'number " " "pt")
+                    ("POINTSIZE" 'number " " "ps")))
+            (cons "locale"
+                  '(("LOCALE" 'string " ")))
+            (cons "logscale"
+                  '(("AXIS" 'list " " "x" "y" "z" "xy" "xz" "yz" "xyz"
+                     "x2" "y2")
+                    ("BASE" 'number " ")))
+            (cons "nologscale"
+                  '(("AXIS" 'list " " "x" "y" "z" "xy" "xz" "yz" "xyz"
+                     "x2" "y2")))
+            (cons "mapping"
+                  '(("COORDINATE SYSTEM" 'list " " "cartesian" "spherical"
+                     "cylindrical")))
+                                        ; _margin
+            (cons "bmargin"
+                  '(("BOTTOM MARGIN" 'number " ")))
+            (cons "lmargin"
+                  '(("LEFT MARGIN"   'number " ")))
+            (cons "rmargin"
+                  '(("RIGHT MARGIN"  'number " ")))
+            (cons "tmargin"
+                  '(("TOP MARGIN"    'number " ")))
+
+            (cons "missing"
+                  '(("CHARACTER" 'string " " 1)))
+                                        ; m_tics
+            (cons "mxtics"  gnuplot-gui-mtics-list)
+            (cons "mytics"  gnuplot-gui-mtics-list)
+            (cons "mztics"  gnuplot-gui-mtics-list)
+            (cons "mx2tics" gnuplot-gui-mtics-list)
+            (cons "my2tics" gnuplot-gui-mtics-list)
+
+                                        ; pm3d additions
+            (cons "mouse"
+                  '(("DOUBLECLICK"     'number " " "doubleclick")
+                    ("ZOOM"            'list   " " "zoomcoordinates" "nozoomcoordinates")
+                    ("POLAR"           'list   " " "polarcoordinates" "nopolarcoordinates")
+                    ("FORMAT"          'string " " "format")
+                    ("CLIPBOARDFORMAT" 'string " " "clipboardformat")
+                    ("MOUSEFORMAT"     'string " " "mouseformat")
+                    ("LABELS"          'list   " " "labels" "nolabels")
+                    ("LABELOPTIONS"    'string " " "labeloptions")
+                    ("ZOOMJUMP"        'list   " " "zoomjump" "nozoomjump")
+                    ("VERBOSE"         'list   " " "verbose" "noverbose")))
+            (cons "palette"
+                  '(("COLOR"       'list     " " "gray" "color")
+                    ("RGBFORMULAE" 'position " " "rgbformulae" 3)
+                    ("PARITY"      'list     " " "positive" "negative")
+                    ("FORMULAE"    'list     " " "nops_allcF" "ps_allcF")
+                    ("MAXCOLORS"   'number   " ")
+                    ("COLOR_BOX"   'list     " " "nocb" "cbdefault" "cbuser")
+                    ("ORIENTATION" 'list     " " "cbvertical" "cbhorizontal")
+                    ("ORIGIN"      'position " " "origin" 2)
+                    ("SIZE"        'position " " "size" 2)
+                    ("BORDER"      'number   " ")
+                    ("NOBORDER"    'list     " " "bdefault" "noborder")))
+            (cons "pm3d"
+                  '(("AT"         'list*  " " "b" "s" "t" "bs" "bt" "st" "bst")
+                    ("SCANS"      'list   " " "scansautomatic" "scansforward" "scansbackward")
+                    ("FLUSH"      'list*  " " "begin" "center" "end")
+                    ("CLIP"       'list   " " "clip1in" "clip4in")
+                    ("ZRANGE"     'range (" " . " ") ":")
+                    ("HIDDEN3D"   'number " ")
+                    ("NOHIDDEN3D" 'list   " " "nohidden3d")
+                    ("FILLING"    'list   " " "transparent" "solid")
+                    ("MAP"        'list   " " "map")))
+
+            (cons "offsets"
+                  '(("LEFT  " 'number " ")
+                    ("RIGHT " 'number " " ",")
+                    ("TOP   " 'number " " ",")
+                    ("BOTTOM" 'number " " ",")))
+            (cons "origin"
+                  '(("X ORIGIN"   'number " ")
+                    ("Y ORIGIN"   'number " " ",")))
+            (cons "output"
+                  '(("FILENAME"   'file " ")))
+            (cons "pointsize"
+                  '(("MULTIPLIER" 'number " ")))
+            (cons "samples"
+                  '(("2D PLOT"    'number " ")
+                    ("3D PLOT"    'number " " ",")))
+            (cons "size"
+                  '(("ASPECT"           'list " " "square" "nosquare"
+                     "ratio" "noratio")
+                    ("X-SCALE OR RATIO" 'number " ")
+                    ("Y-SCALE"          'number " " ",")))
+            (cons "style"
+                  '(("DATA TYPE"  'list " " "data" "function")
+                    ("PLOT STYLE" 'list " " "boxerrorbars" "boxes"
+                     "boxxyerrorbars" "candlesticks" "dots"
+                     "financebars" "fsteps" "histeps" "impulses"
+                     "lines" "linespoints" "points" "steps" "vector"
+                     "xerrorbars" "xyerrorbars" "yerrorbars")))
+            (cons "terminal"
+                  '(("TERMINAL TYPE" 'list " " gnuplot-gui-terminal-list)))
+            (cons "tics"
+                  '(("DIRECTION"  'list " " "in" "out")))
+            (cons "ticslevel"
+                  '(("RELATIVE HEIGHT" 'number " ")))
+            (cons "ticscale"
+                  '(("MAJOR" 'number " ")
+                    ("MINOR" 'number " ")))
+            (cons "timestamp"
+                  '(("FORMAT STRING" 'format " ")
+                    ("WHERE"         'list " " "top" "bottom")
+                    ("ROTATE"        'list " " "rotate" "norotate")
+                    ("X-OFFSET"      'number " ")
+                    ("Y-OFFSET"      'number " " ",")
+                    ("FONTNAME"      'list " " gnuplot-gui-fontname-list)))
+            (cons "timefmt"
+                  '(("FORMAT STRING" 'string " ")))
+            (cons "title"
+                  '(("TITLE" 'string " ")))
+            (cons "view"
+                  '(("X-ROTATION" 'number " ")
+                    ("Z-ROTATION" 'number " " ",")
+                    ("SCALE"      'number " " ",")
+                    ("Z-SCALE"    'number " " ",")))
+            ;; ("SCALE" 'position " " "," 4)
+                                        ; _data
+            (cons "xdata"      gnuplot-gui-data-list)
+            (cons "ydata"      gnuplot-gui-data-list)
+            (cons "zdata"      gnuplot-gui-data-list)
+            (cons "x2data"     gnuplot-gui-data-list)
+            (cons "y2data"     gnuplot-gui-data-list)
+                                        ; _label
+            (cons "xlabel"     gnuplot-gui-label-list)
+            (cons "ylabel"     gnuplot-gui-label-list)
+            (cons "zlabel"     gnuplot-gui-label-list)
+            (cons "x2label"    gnuplot-gui-label-list)
+            (cons "y2label"    gnuplot-gui-label-list)
+                                        ; _range, note that the [] syntax for
+                                        ;         the writeback argument is
+                                        ;         not properly supported
+            (cons "xrange"     gnuplot-gui-range-list)
+            (cons "yrange"     gnuplot-gui-range-list)
+            (cons "zrange"     gnuplot-gui-range-list)
+            (cons "x2range"    gnuplot-gui-range-list)
+            (cons "y2range"    gnuplot-gui-range-list)
+            (cons "trange"     gnuplot-gui-range-list)
+            (cons "rrange"     gnuplot-gui-range-list)
+            (cons "urange"     gnuplot-gui-range-list)
+            (cons "vrange"     gnuplot-gui-range-list)
+                                        ; _tics
+            (cons "xtics"      gnuplot-gui-tics-list)
+            (cons "ytics"      gnuplot-gui-tics-list)
+            (cons "ztics"      gnuplot-gui-tics-list)
+            (cons "x2tics"     gnuplot-gui-tics-list)
+            (cons "y2tics"     gnuplot-gui-tics-list)
+                                        ; zeroaxis
+            (cons "zeroaxis"   gnuplot-gui-zeroaxis-list)
+            (cons "xzeroaxis"  gnuplot-gui-zeroaxis-list)
+            (cons "yzeroaxis"  gnuplot-gui-zeroaxis-list)
+            (cons "y2zeroaxis" gnuplot-gui-zeroaxis-list)
+            (cons "x2zeroaxis" gnuplot-gui-zeroaxis-list)
+
+            (cons "zero"
+                  '(("THRESHOLD" 'number " ")))))
+
+(defvar gnuplot-gui-command-types nil
+  "Associated list of command descriptions.
+See the doc-string for `gnuplot-gui-all-types'.")
+(setq gnuplot-gui-command-types
+      (list (cons "cd"
+                  '(("FILENAME"       'file   " ")))
+            (cons "call"
+                  '(("INPUT FILE"     'file   " ")
+                    ("PARAMETER LIST" 'string " ")))
+            (cons "load"
+                  '(("INPUT FILE"     'file   " ")))
+            (cons "pause"
+                  '(("TIME"           'number " ")
+                    ("MESSAGE"        'string " ")))
+            (cons "print"
+                  '(("EXPRESSION"     'string " ")))
+            (cons "save"
+                  '(("SAVE"           'list   " " "functions" "variables" "set")
+                    ("FILE"           'file   " ")))
+            (cons "update"
+                  '(("INITIAL FILE"   'file   " " t)
+                    ("UPDATED FILE"   'file   " " t))) ))
+
+(defcustom gnuplot-gui-plot-splot-fit-style 'simple
+  "Control the complexity of the GUI display for plot, splot, and fit.
+The values are \\='simple, which causes a limited set of plot, splot, or
+fit options to be displayed, and \\='complete, which attempts to display
+all options.  The \\='complete setting is prone to making errors when
+parsing values already in the script buffer."
+  :type '(radio (const :tag "Simple listing"   simple)
+                (const :tag "Complete listing" complete)))
+
+(defconst gnuplot-gui-plot-simple-list
+  '(("X RANGE"     'range (" " . " ") ":")
+    ("Y RANGE"     'range (" " . " ") ":")
+    ("DATA FILE"   'file   " ")
+    ("THRU"        'string* " " "thru")
+    ("USING"       'modifier " ")
+    ("TITLE"       'string " ")
+    ("WITH"        'list* " " "boxerrorbars" "boxes"
+     "boxxyerrorbars" "candlesticks" "dots" "financebars"
+     "fsteps" "histeps" "impulses" "lines" "linespoints"
+     "points" "steps" "vector" "xerrorbars" "xyerrorbars"
+     "yerrorbars")))
+(defconst gnuplot-gui-plot-full-list
+  '(;;("T RANGE"     'range (" " . " ") ":")
+    ("X RANGE"     'range (" " . " ") ":")
+    ("Y RANGE"     'range (" " . " ") ":")
+    ("xa"          'text   "\t---------------------")
+    ("FUNCTION"    'string " ")
+    ("xc"          'text   "   or")
+    ("DATA FILE"   'file   " ")
+    ("INDEX"       'modifier " ")
+    ("EVERY"       'modifier " ")
+    ("THRU"        'string* " " "thru")
+    ("USING"       'modifier " ")
+    ("SMOOTH"      'list* " " "unique" "csplines" "acsplines"
+     "bezier" "sbezier")
+    ;; datafile modifiers
+    ("AXES"        'list* " " "x1y1" "x2y2" "x1y2" "x2y1")
+    ("TITLE"       'string " ")
+    ("NOTITLE"     'list   " " "notitle")
+    ("xf"          'text   "\t---------------------")
+    ("xi"          'text   "Select a standard plotting style")
+    ("WITH"        'list* " " "boxerrorbars" "boxes"
+     "boxxyerrorbars" "candlesticks" "dots" "financebars"
+     "fsteps" "histeps" "impulses" "lines" "linespoints"
+     "points" "steps" "vector" "xerrorbars" "xyerrorbars"
+     "yerrorbars")
+    ("xo"          'text   "     or a previously defined style")
+    ("LINE STYLE " 'number " " "ls")
+    ("xr"          'text   "     or specify a style in-line")
+    ("LINE TYPE  " 'number " " "lt")
+    ("LINE WIDTH " 'number " " "lw")
+    ("POINT TYPE " 'number " " "pt")
+    ("POINT STYLE" 'number " " "ps")))
+(defconst gnuplot-gui-splot-simple-list
+  '(("DATA FILE"   'file   " ")
+    ("TITLE"       'string " ")
+    ("WITH"        'list* " " "lines" "linespoints" "points" "dots" "impulses")))
+(defconst gnuplot-gui-splot-full-list
+  '(;;("U RANGE"     'range (" " . " ") ":")
+    ;;("V RANGE"     'range (" " . " ") ":")
+    ("X RANGE"     'range (" " . " ") ":")
+    ("Y RANGE"     'range (" " . " ") ":")
+    ("Z RANGE"     'range (" " . " ") ":")
+    ("xa"          'text   "\t---------------------")
+    ("FUNCTION"    'string " ")
+    ("xc"          'text   "   or")
+    ("DATA FILE"   'file   " ")
+    ("INDEX"       'modifier " ")
+    ("EVERY"       'modifier " ")
+    ("THRU"        'string* " " "thru")
+    ("USING"       'modifier " ")
+    ("SMOOTH"      'list* " " "unique" "csplines" "acsplines"
+     "bezier" "sbezier")
+    ("TITLE"       'string " ")
+    ("NOTITLE"     'list   " " "notitle")
+    ("WITH"        'list* " " "lines" "linespoints" "points" "dots" "impulses")))
+(defconst gnuplot-gui-fit-simple-list
+  '(("FUNCTION"     'string* " " "")
+    ("DATA FILE"    'file    " ")
+    ("VIA (params)" 'string* " " "via") ))
+(defconst gnuplot-gui-fit-full-list
+  '(("X RANGE"      'range  (" " . " ") ":")
+    ("Y RANGE"      'range  (" " . " ") ":")
+    ("xa"           'text    "----- fitting functionn and file --------")
+    ("FUNCTION"     'string* " " "")
+    ("DATA FILE"    'file    " ")
+    ("xb"           'text    "----- datafile modifiers ----------------")
+    ("INDEX"        'modifier " ")
+    ("EVERY"        'modifier " ")
+    ("THRU"         'string* " " "thru")
+    ("USING"        'modifier " ")
+    ("SMOOTH"       'list* " " "unique" "csplines" "acsplines"
+     "bezier" "sbezier")
+    ("xc"           'text    "----- parameters (file or parameters) ---")
+    ("VIA (file)"   'string  " " "via")
+    ("VIA (params)" 'string* " " "via") ))
+
+(defvar gnuplot-gui-plot-splot-fit nil
+  "Associated list of plot, splot, and fit descriptions.
+See the doc-string for `gnuplot-gui-all-types'.")
+(setq gnuplot-gui-plot-splot-fit
+      (list (cons "plot"  (if (equal gnuplot-gui-plot-splot-fit-style 'complete)
+                              gnuplot-gui-plot-full-list
+                            gnuplot-gui-plot-simple-list))
+            (cons "splot" (if (equal gnuplot-gui-plot-splot-fit-style 'complete)
+                              gnuplot-gui-splot-full-list
+                            gnuplot-gui-splot-simple-list))
+            (cons "fit"   (if (equal gnuplot-gui-plot-splot-fit-style 'complete)
+                              gnuplot-gui-fit-full-list
+                            gnuplot-gui-fit-simple-list))) )
+
+(defvar gnuplot-gui-test-type nil)
+(setq gnuplot-gui-test-type
+      (list (cons "test"
+                  '(("TAG"      'tag      " ")
+                    ("LIST"     'list     " " "1" "2" "3")
+                    ("LIST*"    'list*    " " "1" "2" "3")
+                    ("NUMBER"   'number   " " "number")
+                    ("RANGE"    'range   (" " . " ") ":")
+                    ("PAIR"     'pair    (" " . " ") "pair")
+                    ("LABELS"   'labels   ())
+                    ("FILE"     'file     " ")
+                    ("TEXT"     'text     "this is text")
+                    ("STRING"   'string   " ")
+                    ("STRING*"  'string*  " " "string*")
+                    ("FORMAT"   'format   " ")
+                    ("POSITION" 'position " " "at" 3)
+                    ("FONTSIZE" 'fontsize " ") ))))
+
+(defvar gnuplot-gui-all-types nil
+  "Associated list of terminal, set option, and command arguments.
+
+Each entry in the list is a cons cell of the form
+      (OPTION . ALIST)
+where OPTION is one of the recognized options in Gnuplot, either a
+command, something that is set, or a terminal type.  Only those
+commands, set options, and terminal types that actually take arguments
+are in this associated list.
+
+ALIST is itself an associated list where each entry is of the form:
+
+      (TAG TYPE DEFAULT REST)
+
+TAG is the name used on the widget and indicates one of the options
+for this command, set option, or terminal type.
+
+TYPE is one of
+     \\='list       a menu-list of strings
+     \\='list*      a menu-list of strings with a prefix
+     \\='number     a number with an optional prefix
+     \\='tag        like number but must be the first argument
+     \\='fontsize   like number but must be the last argument
+     \\='range      a pair of numbers like [#,#] or [#:#]
+     \\='pair       a pair of numbers with no punctuation and a prefix
+     \\='file       a quoted string and a file browser
+     \\='string     a quoted string with an optional prefix
+     \\='string*    an unquoted string with a prefix
+     \\='format     a quoted string and an info-link to (gnuplot)format
+     \\='labels     an array as needed for xtics, ytics, etc
+     \\='position   2 or 3 comma separated numbers with an optional prefix
+
+DEFAULT is the default value for this option.  Note that the default
+for \\='range and \\='pair is a cons cell and the default for \\='labels is a
+list.  For most things, the best choice of DEFAULT is a string of
+white space or a cons cell of two strings of white space.  Strings of
+white space are better defaults than empty strings or nil.
+
+The value of REST depends upon TYPE:
+
+  For \\='list &    REST is the list of options that will go into the
+      \\='list*       menu-button.  This can also be a symbol which
+                   evaluates to a list containing the options to go into
+                   the menu-button.  This list variable must contain the
+                   DEFAULT.
+  For \\='number    REST is the prefix string (if it exists) for that number.
+  For \\='range     REST is the separator, \":\" for plot ranges and
+                   \",\" for plot dimensions (see for example the tgif
+                   terminal type)
+  For \\='string &  REST may a number denoting the width of the editable-text
+      \\='string*     field or it may be a string denoting a prefix.  By
+                   default, the width is half the width of the frame
+                   and there is no prefix.  It may be useful to
+                   specify \"1\" when the input is a single character
+                   as in \"set missing\".
+  For \\='file      REST determines the label placed before the file insertion
+                   field.  If non-nil, then TAG is used.  If nil, then
+                   the default \"File\" is used.
+  For \\='position  REST is the prefix and the number of comma separated numbers
+  For others     REST is not used.
+
+Here is an example entry for the png terminal type:
+
+  (cons \"png\"
+    \\='((\"SIZE\"  \\='list \" \" \"small\" \"medium\" \"large\")
+      (\"COLOR\" \\='list \" \" \"monochrome\" \"gray\" \"color\")))
+
+This alist is formed at load time by appending together
+`gnuplot-gui-terminal-types', `gnuplot-gui-set-types' and
+`gnuplot-gui-command-types'.")
+
+(setq gnuplot-gui-all-types (append gnuplot-gui-terminal-types
+                                    gnuplot-gui-set-types
+                                    gnuplot-gui-command-types
+                                    gnuplot-gui-plot-splot-fit
+                                    gnuplot-gui-test-type))
+
+(defun gnuplot-gui-swap-simple-complete ()
+  (interactive nil gnuplot-mode)
+  (setq gnuplot-gui-plot-splot-fit-style
+        (if (equal gnuplot-gui-plot-splot-fit-style 'complete)
+            'simple 'complete))
+  (if (equal gnuplot-gui-plot-splot-fit-style 'complete)
+      (progn
+        (setcdr (assoc "plot"  gnuplot-gui-all-types) gnuplot-gui-plot-full-list)
+        (setcdr (assoc "splot" gnuplot-gui-all-types) gnuplot-gui-splot-full-list)
+        (setcdr (assoc "fit"   gnuplot-gui-all-types) gnuplot-gui-fit-full-list))
+    (setcdr (assoc "plot"  gnuplot-gui-all-types) gnuplot-gui-plot-simple-list)
+    (setcdr (assoc "splot" gnuplot-gui-all-types) gnuplot-gui-splot-simple-list)
+    (setcdr (assoc "fit"   gnuplot-gui-all-types) gnuplot-gui-fit-simple-list))
+  (message "Using %s lists for plot, splot, and fit."
+           gnuplot-gui-plot-splot-fit-style) )
+
+
+;;; user interface to the widget-y stuff
+
+(defun gnuplot-gui-get-frame-param (param)
+  (cdr (assoc param gnuplot-gui-frame-parameters)))
+
+(defun gnuplot-gui-set-frame-param (param value)
+  (setcdr (assoc param gnuplot-gui-frame-parameters) value))
+
+(defun gnuplot-gui-set-options-and-insert (&optional event)
+  "Insert arguments using a GUI interface.
+Determine contents of current line and set up the appropriate GUI
+frame.  Bound to \\[gnuplot-gui-set-options-and-insert]
+Note that \"cntrparam\" is not currently supported."
+  (interactive (list last-nonmenu-event) gnuplot-mode)
+  (save-excursion
+    (if event (mouse-set-point event))
+    (let ((begin  (gnuplot--point-at-beginning-of-command))
+          (end    (save-excursion (end-of-line)       (point-marker)))
+          (termin (concat "\\(,\\s-*" (regexp-quote "\\") "\\|;\\)"))
+          (set nil) (term nil))
+      (save-excursion
+        ;; there can be more then one command per line
+        (when (re-search-forward termin end "to_limit")
+          (backward-char (length (match-string 1)))
+          (setq end (point-marker)))
+        (goto-char begin)
+        (skip-syntax-forward "-" end)
+        ;; various constructions are recognized here. at the end of this
+        ;; cond, point should be just after the word whose arguments are
+        ;; to be set
+        (cond ((looking-at "set\\s-+")
+               (setq set t)
+               (goto-char (match-end 0))
+               (if (looking-at "\\sw+") (goto-char (match-end 0)))
+               (when (string-match "^ter" (gnuplot-gui-this-word)) ; terminal?
+                 (setq term t)
+                 (forward-word 1))
+               (when (string-match "^\\(da\\|fu\\)" (gnuplot-gui-this-word))
+                 (unless (looking-at "\\s-+st")
+                   (insert " style") (forward-word 1))
+                 (forward-word 1)))
+              ((looking-at (concat "\\(cd\\|ca\\|lo\\|pa\\|pr\\|sa\\|u\\)"
+                                   "\\w*"
+                                   "[\\s-\\']"))
+               (forward-word 1))
+              ;;(goto-char (match-end 0)))
+              (t
+               (forward-word 1)))
+        (if (> (point) end) (goto-char end))
+        (let* ((w (gnuplot-gui-this-word))
+               (wd (try-completion w gnuplot-gui-all-types))
+               (word "") wrd list)
+          (cond ((equal wd t)                     (setq word w))
+                ((equal wd nil)                   (setq word w))
+                ((assoc wd gnuplot-gui-all-types) (setq word wd))
+                (t                                (setq wd nil)))
+          (cond ((equal (string-match "^\\s-*$" w) 0)
+                 (message "Blank line"))
+                ((and wd (stringp word))
+                 (gnuplot-gui-correct-command word set term begin)
+                 (setq gnuplot-gui-alist nil
+                       gnuplot-gui-current-string
+                       (buffer-substring-no-properties (point) end))
+                 (gnuplot-gui-set-alist word gnuplot-gui-current-string)
+                 (let* ((old-height (gnuplot-gui-get-frame-param 'height))
+                        (old-top    (gnuplot-gui-get-frame-param 'top)))
+                   (when (or
+                          (and (equal gnuplot-gui-plot-splot-fit-style 'complete)
+                               (member word '("plot" "splot" "fit")))
+                          (equal word "test"))
+                     (gnuplot-gui-set-frame-param 'height 32)
+                     (gnuplot-gui-set-frame-param 'top    50))
+                   (gnuplot-gui-prompt-for-frame word)
+                   (when (or
+                          (and (equal gnuplot-gui-plot-splot-fit-style 'complete)
+                               (member word '("plot" "splot" "fit")))
+                          (equal word "test"))
+                     (gnuplot-gui-set-frame-param 'height old-height)
+                     (gnuplot-gui-set-frame-param 'top    old-top)) ))
+                ((setq wrd (car (all-completions w '(("cntrparam")))))
+                 (message
+                  "Setting arguments for %S is currently unsuported in gnuplot-mode"
+                  wrd))
+                ((setq list (all-completions w gnuplot-gui-all-types))
+                 (message "%S could be one of %S" w list))
+                (t
+                 (message
+                  "%S is not a gnuplot command which takes options" w)))) ))))
+
+(defun gnuplot-gui-toggle-popup ()
+  (interactive nil gnuplot-mode)
+  (setq gnuplot-gui-popup-flag (not gnuplot-gui-popup-flag))
+  (message (if gnuplot-gui-popup-flag
+               "Argument popup will appear after insertions."
+             "Argument popup will no longer appear after insertions.")))
+
+(defalias 'gnuplot-gui-y-n 'y-or-n-p)
+
+(defun gnuplot-gui-correct-command (word set term begin)
+  "Check syntax of set command and terminal specifications.
+WORD is the item being set.  SET and TERM are non-nil if the words
+\"set\" and \"terminal\" were found preceding WORD in the buffer.
+BEGIN is the beginning of the command."
+  (save-excursion
+    (cond ((assoc word gnuplot-gui-terminal-types)
+           (when (and (not (and set term))
+                      (gnuplot-gui-y-n
+                       (format
+                        "%S must be preceded by \"set terminal\".  Add it? "
+                        word)))
+             (backward-word 1)
+             (let ((e (point-marker)))
+               (goto-char begin)
+               (skip-syntax-forward "-" e)
+               (delete-region (point) e)
+               (insert "set terminal "))))
+          ((assoc word gnuplot-gui-set-types)
+           (when (and (not set)
+                      (gnuplot-gui-y-n
+                       (format
+                        "%S must be preceded by \"set\".  Add \"set\"? " word)))
+             (backward-word 1)
+             (let ((e (point-marker)))
+               (goto-char begin)
+               (skip-syntax-forward "-" e)
+               (delete-region (point) e)
+               (insert "set "))))))
+  (message nil))
+
+
+;;; handle the actual arguments
+
+(defun gnuplot-gui-fix-arg-list (list)
+  "Correct the result of splitting `gnuplot-gui-current-string'.
+LIST is the split string.  This removes empty and all-blank strings
+from the list and concatenates the strings that are part of a quoted
+argument, for example an axis label or a font name.  It also replaces
+bounding single quotes with double quotes, since double quotes are
+used in `gnuplot-gui-all-types'."
+  (let (fixed-list quote quoted)    ; remove blanks
+    (setq list (cl-remove "\\s-+" list :test #'string-match)
+          list (remove "" list))
+    (while list             ; concatinate parts of quoted string
+      (if (not (string-match "^\\([\]\[()'\"]\\)" (car list)))
+          (setq fixed-list (append fixed-list (list (car list))))
+        (setq quote (match-string 1 (car list))
+              quoted (car list))
+        (if (equal quote "[") (setq quote "]"))
+        (if (equal quote "(") (setq quote ")"))
+        (while (and list
+                    (or (equal (length quoted) 1)
+                        (not (string-match (concat (regexp-quote quote) "$")
+                                           quoted))))
+          (setq quoted (concat quoted " " (cadr list))
+                list (cdr list)))
+        (if (equal quote "'")
+            (setq quoted (concat "\"" (substring quoted 1))
+                  quoted (concat (substring quoted 0 -1) "\"")))
+        (setq fixed-list (append fixed-list (list quoted))))
+      (setq list (cdr list)) )
+    fixed-list))
+
+(defun gnuplot-gui-set-alist (word string)
+  "Set defaults for arguments, using text from buffer if appropriate.
+WORD is the Gnuplot expression whose arguments are being set.  STRING
+is text from the buffer containing the previous values for WORD's
+arguments."
+  (let ((alist    (cdr (assoc word gnuplot-gui-all-types)))
+        (arg-list (gnuplot-gui-fix-arg-list (split-string string)) ))
+    ;; arg-list contains the arguments taken from the buffer
+    (setq gnuplot-gui-alist nil)
+    (while alist
+      (let* ((list      (car alist))
+             (tag       (gnuplot-gui-type-tag     list))
+             (symbol    (eval (gnuplot-gui-type-symbol list)))
+             (default   (gnuplot-gui-type-default list))
+             (prefix    (gnuplot-gui-type-prefix  list))
+             (values    (gnuplot-gui-type-list    list))
+             (this-cons (cond ((stringp default) (cons tag default))
+                              ((consp default) ; set cons valued default w/care
+                               (cons tag (cons (car default) (cdr default))))
+                              (t (cons tag default))))
+             (temp-list arg-list) )
+        ;;(message "%S" temp-list)  ; want to lop values off arg-list
+                                        ; as they are found
+        (if (symbolp (cadr values))
+            (setq values (symbol-value (cadr values))))
+        ;; check if an argument of this type is in arg-list
+        ;; set the current cons cell if it is
+        (while temp-list
+          (cond
+           ;; ---------------------------- list
+           ((memq symbol '(list list*))
+            (let* ((case-fold-search nil)
+                   (match-cons (cl-member (concat "^" (car temp-list))
+                                          values :test #'string-match)))
+              (if (and (car match-cons) ; " " may be first elem. of list
+                       (not (equal " " (car match-cons))))
+                  (setq this-cons (cons tag (car match-cons))
+                        arg-list (cl-remove (car temp-list) arg-list
+                                            :test #'equal :count 1)
+                        temp-list nil)
+                (setq temp-list (cdr temp-list)))))
+           ;; ---------------------------- tag (first number in list)
+           ((equal symbol 'tag)
+            (if (string-match "^[-0-9.]+$" (car arg-list))
+                (setq this-cons (cons  tag (car arg-list))
+                      temp-list nil)
+              (setq temp-list (cdr temp-list))) )
+           ;; ---------------------------- fontsize (last number in list)
+           ((equal symbol 'fontsize)
+            (if (string-match "^[-0-9.]+$" (car (last arg-list)))
+                (setq this-cons (cons  tag (car (last arg-list)))
+                      temp-list nil)
+              (setq temp-list (cdr temp-list))) )
+           ;; ---------------------------- number with prefix
+           ((equal symbol 'number)
+            (cond ((and (equal prefix (car temp-list))
+                        (string-match "^[-0-9.]+$" (cadr temp-list)))
+                   (setq this-cons (cons tag (cadr temp-list))
+                         arg-list (cl-remove (car temp-list) arg-list
+                                             :test #'equal :count 1)
+                         arg-list (cl-remove (cadr temp-list) arg-list
+                                             :test #'equal :count 1)
+                         temp-list nil))
+                  ;; --------------------- number without prefix
+                  ((and (not prefix)
+                        (string-match "^[-0-9.]+$" (car temp-list)))
+                   (setq this-cons (cons tag (car temp-list))
+                         arg-list (cl-remove (car temp-list) arg-list
+                                             :test #'equal :count 1)
+                         temp-list nil))
+                  (t
+                   (setq temp-list (cdr temp-list)))))
+           ;; ---------------------------- pair with prefix
+           ((equal symbol 'pair)
+            (if (and (equal prefix (car temp-list))
+                     (string-match "^[-0-9.]+$" (cadr temp-list)))
+                (let ((this-car (cadr temp-list))
+                      (this-cdr (if (string-match "^[-0-9.]+$" (caddr temp-list))
+                                    (caddr temp-list) "")))
+                  (setq this-cons (cons tag (cons this-car this-cdr))
+                        temp-list nil))
+              (setq temp-list (cdr temp-list))))
+           ;; ---------------------------- range
+           ((equal symbol 'range)
+            (if (string-match (concat "\\[\\s-*" ; opening bracket
+                                      "\\([^:, \t]*\\)" ; first argument
+                                      "\\s-*[:,]\\s-*" ; separator
+                                      "\\([^\] \t]*\\)" ; second argument
+                                      "\\s-*\\]") ; closing bracket
+                              (car temp-list))
+                (setq this-cons
+                      (cons tag (cons (match-string 1 (car temp-list))
+                                      (match-string 2 (car temp-list))))
+                      arg-list (cl-remove (car temp-list) arg-list
+                                          :test #'equal :count 1)
+                      temp-list nil)
+              (setq temp-list (cdr temp-list)) ))
+           ;; ---------------------------- labels
+           ((equal symbol 'labels)
+            (if (string-match (concat "(" ; opening paren
+                                      "\\([^\)]*\\)" ; string
+                                      ")") ; closing paren
+                              (car temp-list))
+                (let* ((list (split-string (car temp-list) "[ \t(),]+"))
+                       (list (remove "" list))
+                       (return ()))
+                  (while list
+                    (if (string-match "['\"]\\([^'\"]*\\)['\"]" (car list))
+                        (setq return (append return
+                                             (list (match-string 1 (car list))))
+                              list (cdr list)
+                              return (append return (list (car list))) )
+                      (setq return (append return (list "" (car list)))))
+                    (setq list (cdr list)) )
+                  (setq this-cons (cons tag return)
+                        arg-list (cl-remove (car temp-list) arg-list
+                                            :test #'equal :count 1)
+                        temp-list nil))
+              (setq temp-list (cdr temp-list))) )
+           ;; ---------------------------- string, file, format
+           ((memq symbol '(string file format))
+            (if (string-match (concat "['\"]" ; opening quote
+                                      "\\([^'\"]*\\)" ; string
+                                      "['\"]") ; closing quote
+                              (car temp-list))
+                (setq this-cons (cons tag (match-string 0 (car temp-list)))
+                      arg-list (cl-remove (car temp-list) arg-list
+                                          :test #'equal :count 1)
+                      temp-list nil)
+              (setq temp-list (cdr temp-list)) ))
+           ;; ---------------------------- string*
+           ((equal symbol 'string*)
+            (if (equal prefix (car temp-list))
+                (setq this-cons (cons tag (cadr temp-list))
+                      arg-list (cl-remove (car temp-list) arg-list
+                                          :test #'equal :count 1)
+                      arg-list (cl-remove (cadr temp-list) arg-list
+                                          :test #'equal :count 1)
+                      temp-list nil)
+              (setq temp-list (cdr temp-list)) ) )
+           ;; ---------------------------- other or unknown
+           (t
+            (setq temp-list nil))))
+        (setq gnuplot-gui-alist
+              (append gnuplot-gui-alist (list this-cons))))
+      (setq alist (cdr alist))) ))
+
+(defun gnuplot-gui-post-process-alist (type)
+  "A few types need some additional processing.
+\\='range, \\='pair, and \\='labels are cons or list valued and need to b made
+into strings.  This is called right before inserting the arguments
+into the buffer.  TYPE is the object whose arguments are being set."
+  (let ((alist gnuplot-gui-alist)
+        (types (cdr (assoc type gnuplot-gui-all-types))) )
+    (while alist  ;; loop thru alist looking for tyeps needing post-processing
+      (let* ((list   (assoc (caar alist) types))
+             (value  (cdr (assoc (caar alist) gnuplot-gui-alist)))
+             (prefix (gnuplot-gui-type-prefix list))
+             (symb   (gnuplot-gui-type-symbol list)) )
+        (cond
+         ;;-------------------------- flat text
+         ((equal (eval symb) 'text)
+          (setcdr (assoc (caar alist) gnuplot-gui-alist) ""))
+         ;;-------------------------- range [#:#] or [#,#]
+         ((equal (eval symb) 'range)
+          (if (and (string-match "^\\s-*$" (car value))
+                   (string-match "^\\s-*$" (cdr value)))
+              (setcdr (assoc (caar alist) gnuplot-gui-alist) "")
+            (setcdr (assoc (caar alist) gnuplot-gui-alist)
+                    (concat "[" (car value) prefix (cdr value) "]")) ) )
+         ;;-------------------------- pair
+         ((equal (eval symb) 'pair)
+          (if (and (string-match "^\\s-*$" (car value))
+                   (string-match "^\\s-*$" (cdr value)))
+              (setcdr (assoc (caar alist) gnuplot-gui-alist) "")
+            (setcdr (assoc (caar alist) gnuplot-gui-alist)
+                    (concat prefix " " (car value) " " (cdr value) )) ) )
+         ;;-------------------------- labels
+         ((equal (eval symb) 'labels)
+          (if (consp value)
+              (let ((word "") (list value))
+                (while list
+                  (if (string-match "^\\s-*$" (car list))
+                      (setq word (concat word (format "%s, " (cadr list))))
+                    (setq word (concat word (format "%S %s, " (car list)
+                                                    (cadr list)))))
+                  (setq list (cddr list)) )
+                (setq value (concat "(" (substring word 0 -2) ")")))
+            (setq value "") )
+          (setcdr (assoc (caar alist) gnuplot-gui-alist) value) ))
+
+        (setq alist (cdr alist))) )))
+
+
+;;; GUI frames
+
+(defun gnuplot-gui-prompt-for-frame (&optional option save-frame)
+  (setq option (or option (completing-read "Option: " gnuplot-gui-all-types
+                                           nil t nil t)))
+  (gnuplot-gui-make-frame
+   option (cdr (assoc option gnuplot-gui-all-types)) save-frame) )
+
+(defgroup gnuplot-gui-faces nil
+  "Text faces used by `gnuplot-gui'."
+  :prefix "gnuplot-gui-"
+  :group 'gnuplot-gui)
+
+(defface gnuplot-gui-error-face '((((class color) (background light))
+                                   (:foreground "grey30"))
+                                  (((class color) (background dark))
+                                   (:foreground "grey70")))
+  "Face used to display message about unknown widget types.")
+
+(defface gnuplot-gui-flat-text-face '((((class color) (background light))
+                                       (:foreground "MediumBlue"))
+                                      (((class color) (background dark))
+                                       (:foreground "LightSteelBlue")))
+  "Face used to display message about unknown widget types.")
+
+(defun gnuplot-gui-make-frame (item alist &optional save-frame)
+  "Open the frame and populate it with widgets.
+ITEM is the object for which arguments are being set.  ALIST is
+the alist of arguments for ITEM taken from `gnuplot-gui-all-types'.
+SAVE-FRAME is non-nil when the widgets are being reset."
+  (unless save-frame
+    (setq gnuplot-gui-current-frame (selected-frame)
+          gnuplot-gui-current-buffer (current-buffer)
+          gnuplot-gui-current-buffer-point (point-marker))
+    (unless (frame-live-p gnuplot-gui-frame)
+      (setq gnuplot-gui-frame (make-frame gnuplot-gui-frame-parameters)))
+    (select-frame gnuplot-gui-frame)
+    ;;(set-frame-position gnuplot-gui-frame 150 150) ;; so herky-jerky
+    (set-mouse-position gnuplot-gui-frame 0 0))
+  (kill-buffer (get-buffer-create "*Gnuplot GUI*"))
+  (switch-to-buffer (get-buffer-create "*Gnuplot GUI*"))
+  (kill-all-local-variables)
+  (modify-frame-parameters (selected-frame)
+                           '((title . "Set Gnuplot Options")))
+  (widget-insert "\nSet options for \"" item "\"  ")
+  (let (tag help val)
+    (cond ((string-match "^[xyz]2?tics" item)
+           (setq tag  "info on tic labels"
+                 help "Open a frame displaying the info entry for tic labels"
+                 val  "xtics"))
+          ((string-match "^no" item)
+           (setq tag  (concat "info on " (substring item 2))
+                 help (format "Open a frame displaying the info entry for %S"
+                              item)
+                 val  item))
+          (t
+           (setq tag  (concat "info on " item)
+                 help (format "Open a frame displaying the info entry for %S"
+                              item)
+                 val  item)))
+    (widget-create 'gnuplot-gui-info-link :tag tag :help-echo help :value val))
+
+  (widget-insert "\n\n")
+  (while alist
+    (let* ((this    (car   alist))
+           (tag     (gnuplot-gui-type-tag    this))
+           (wtype   (gnuplot-gui-type-symbol this))
+           (prefix  (gnuplot-gui-type-prefix this))
+           (default (cdr (assoc tag gnuplot-gui-alist)))
+           (list    (gnuplot-gui-type-list   this)))
+      (if (symbolp (cadr list))
+          (setq list (symbol-value (cadr list))))
+      (widget-insert "\t")      ; insert the appropriate widget
+      (cond
+       ;;------------------------------ list, list* ------------
+       ((memq (eval wtype) '(list list*))
+        (let ((starred (if (equal (eval wtype) 'list*) t nil)))
+          (gnuplot-gui-menu-choice tag default list starred)))
+       ;;------------------------------ number, tag, fontsize --
+       ((memq (eval wtype) '(number tag fontsize))
+        (gnuplot-gui-number tag default prefix))
+       ;;------------------------------ position ---------------
+       ;;------------------------------ range, pair ------------
+       ((memq (eval wtype) '(range pair))
+        (let ((is-range (equal (eval wtype) 'range)))
+          (gnuplot-gui-range tag default prefix is-range)))
+       ;;------------------------------ string, string* --------
+       ((memq (eval wtype) '(string string*))
+        (let ((starred (if (equal (eval wtype) 'string) nil t)))
+          (gnuplot-gui-string tag default prefix starred)))
+       ;;------------------------------ format -----------------
+       ((equal (eval wtype) 'format)
+        (gnuplot-gui-format tag default))
+       ;;------------------------------ file -------------------
+       ((equal (eval wtype) 'file)
+        (gnuplot-gui-file tag default prefix))
+       ;;------------------------------ labels -----------------
+       ((equal (eval wtype) 'labels)
+        (gnuplot-gui-labels tag default))
+       ;;------------------------------ text -------------------
+       ((equal (eval wtype) 'text)
+        (let ((str (gnuplot-gui-type-default this)))
+          (put-text-property 0 (length str) 'face 'gnuplot-gui-flat-text-face str)
+          (widget-insert str "\n")))
+       ;;------------------------------ unknown ----------------
+       (t
+        (let ((str (concat "<" (downcase tag) "> ('"
+                           (symbol-name (eval wtype))
+                           " arguments are not yet supported)\n")))
+          (put-text-property 0 (length str) 'face 'gnuplot-gui-error-face str)
+          (widget-insert str)) )))
+    (setq alist (cdr alist)))
+  ;; insert control buttons: [Set options]   [Reset]   [Clear]   [Cancel]
+  (widget-insert "\n\t")
+  (widget-create 'push-button
+                 :value "Set options"
+                 :doc item
+                 :button-face 'gnuplot-gui-button-face
+                 :help-echo "Push this button to set options"
+                 :notify
+                 (lambda (widget &rest _ignore)
+                   (kill-buffer (get-buffer-create "*Gnuplot GUI*"))
+                   (delete-frame)
+                   (select-frame gnuplot-gui-current-frame)
+                   (switch-to-buffer gnuplot-gui-current-buffer)
+                   (goto-char gnuplot-gui-current-buffer-point)
+                   (gnuplot-gui-post-process-alist
+                    (widget-get widget :doc))
+                   (let ((alist gnuplot-gui-alist) marker
+                         (eol (save-excursion (end-of-line) (point-marker) )) )
+                     (if (re-search-forward ";" eol "to_limit")
+                         (backward-char 1))
+                     (delete-region gnuplot-gui-current-buffer-point (point-marker))
+                     (delete-horizontal-space)
+                     (setq marker (point-marker))
+                     (while alist
+                       (let ((val (cdar alist)))
+                         (if (string-match "^\\s-+$" val) ()
+                           (if (string-match "^['\"]\\(.*\\)['\"]$" val)
+                               (setq val (concat gnuplot-quote-character
+                                                 (match-string 1 val)
+                                                 gnuplot-quote-character)))
+                           (insert (format " %s" val))))
+                       (setq alist (cdr alist)))
+                     (setq eol (point-marker))
+                     (goto-char marker)
+                     (while (< (point) eol) ; a few odd cases
+                       (unless (looking-at (concat "[" (regexp-quote "(")
+                                                   (regexp-quote "*") ",]"))
+                         (just-one-space))
+                       (forward-sexp)))
+                   (delete-horizontal-space)
+                   (if (equal "terminal" (widget-get widget :doc))
+                       (gnuplot-gui-set-options-and-insert)) ))
+  (widget-insert "   ")
+  (widget-create 'push-button :value "Reset"
+                 :help-echo "Push this button to reset all values"
+                 :button-face 'gnuplot-gui-button-face
+                 :doc item
+                 :notify
+                 (lambda (widget &rest _ignore)
+                   (let ((word (widget-get widget :doc)))
+                     (gnuplot-gui-set-alist word gnuplot-gui-current-string)
+                     (gnuplot-gui-prompt-for-frame word t))))
+  (widget-insert "   ")
+  (widget-create 'push-button :value "Clear"
+                 :help-echo "Push this button to clear all values"
+                 :button-face 'gnuplot-gui-button-face
+                 :doc item
+                 :notify
+                 (lambda (widget &rest _ignore)
+                   (let* ((word (widget-get widget :doc))
+                          (alist (cdr (assoc word gnuplot-gui-all-types))))
+                     (while alist
+                       (setcdr (assoc (gnuplot-gui-type-tag (car alist))
+                                      gnuplot-gui-alist)
+                               (gnuplot-gui-type-default (car alist)))
+                       (setq alist (cdr alist)))
+                     (gnuplot-gui-prompt-for-frame word t))) )
+  (widget-insert "   ")
+  (widget-create 'push-button :value "Cancel"
+                 :help-echo "Quit setting options and dismiss frame"
+                 :button-face 'gnuplot-gui-button-face
+                 :notify (lambda (_widget &rest _ignore)
+                           (kill-buffer (get-buffer-create "*Gnuplot GUI*"))
+                           (setq gnuplot-gui-alist nil
+                                 gnuplot-gui-current-string nil)
+                           (delete-frame)
+                           (select-frame gnuplot-gui-current-frame)))
+  (goto-char (point-min))
+  (use-local-map widget-keymap)
+  (widget-setup))
+
+
+;;; widgets
+
+(defface gnuplot-gui-menu-face '((((class color) (background light))
+                                  (:bold t :foreground "darkolivegreen"))
+                                 (((class color) (background dark))
+                                  (:bold t :foreground "seagreen"))
+                                 (t
+                                  (:italic t)))
+  "Face used for menu-buttons.")
+(defface gnuplot-gui-button-face '((((class color) (background light))
+                                    (:bold t :foreground "sienna"))
+                                   (((class color) (background dark))
+                                    (:bold t :foreground "tan"))
+                                   (t
+                                    (:italic t)))
+  "Face used for push-buttons.")
+(defface gnuplot-gui-labels-face '((((class color) (background light))
+                                    (:bold t :foreground "darkslateblue"))
+                                   (((class color) (background dark))
+                                    (:bold t :foreground "lightslateblue"))
+                                   (t
+                                    (:italic t)))
+  "Face used for insert and delete button in the labels widget.")
+
+(defun gnuplot-gui-menu-choice (item default list &optional starred)
+  "Create a menu widget for the Gnuplot GUI.
+ITEM is the object whose arguments are set by this widget, DEFAULT
+is the default argument value, LIST contains the items for the pop-up
+menu.  STARRED is true if this a \\='list* widget."
+  (let ((widget
+         (apply 'widget-create
+                'menu-choice :value default :tag item :doc starred
+                :button-face 'gnuplot-gui-menu-face
+                :button-prefix "[" :button-suffix "]"
+                :help-echo (format "Mouse-2 to view the %S menu" (downcase item))
+                :notify
+                (lambda (widget &rest _ignore)
+                  (let ((lab (if (widget-get widget :doc)
+                                 (concat (downcase (widget-get widget :tag)) " ")
+                               "" )))
+                    (setcdr (assoc (widget-get widget :tag) gnuplot-gui-alist)
+                            (if (equal (widget-value widget) " ") ""
+                              (format "%s%s" lab (widget-value widget))) )))
+                (mapcar (lambda (x) (list 'item :value x))
+                        list))))
+    (widget-value-set widget default)
+    (if (and starred (not (string-match "^\\s-*$" default)))
+        (setcdr (assoc item gnuplot-gui-alist)
+                (format "%s %s" (downcase item) default)))
+    widget))
+
+(defun gnuplot-gui-number (item default &optional prefix)
+  "Create a number widget for the Gnuplot GUI.
+ITEM is the object whose arguments are set by this widget, DEFAULT
+is the default value for the widget, PREFIX is a text string preceding
+the numerical argument."
+  (let ((help-label (or prefix (downcase item))))
+    (widget-insert (capitalize item) ": ")
+    (widget-create 'editable-field
+                   :size 2 :tag item :value default :doc prefix
+                   :help-echo (format "Insert new value of %S here" help-label)
+                   :notify (lambda (widget &rest _ignore)
+                             (let ((val (widget-value widget))
+                                   (pre (concat (widget-get widget :doc) " ")))
+                               (setcdr (assoc (widget-get widget :tag)
+                                              gnuplot-gui-alist)
+                                       (if (string-match
+                                            "^\\s-*[-0-9.*]+\\s-*$" val)
+                                           (format "%s%s" pre val) "") )))))
+  (unless (string-match "^\\s-*$" default)
+    (setcdr (assoc item gnuplot-gui-alist) (format "%s %s" prefix default)))
+  (widget-insert " " (make-string (- 40 (current-column)) ?.)
+                 " (numeric value)\n"))
+
+(defun gnuplot-gui-string (item default &optional width_or_prefix starred)
+  "Create a string widget for the Gnuplot GUI.
+ITEM is the object whose arguments are set by this widget, DEFAULT is
+the default value for the widget, and WIDTH_OR_PREFIX is the width of
+the text entry field (which defaults to half the frame width) or the
+prefix for the string.  STARRED is t if quotes are not to be used."
+  (let ((help-label (downcase item)) width (prefix "") (pp ""))
+    (cond ((stringp width_or_prefix)
+           (setq prefix width_or_prefix
+                 pp prefix)
+           (if starred (setq prefix (concat prefix "_star"))) )
+          ((numberp width_or_prefix)
+           (setq width width_or_prefix)))
+    (setq width (or width (/ (frame-width) 2)))
+    (if (string-match "^['\"]" default)
+        (setq default (replace-match "" nil nil default)))
+    (if (string-match "['\"]$" default)
+        (setq default (replace-match "" nil nil default)))
+    (widget-insert (capitalize item) ": ")
+    (widget-create
+     'editable-field
+     :size width :tag item :doc prefix :value default
+     :help-echo (format "Insert new value of %S here" help-label)
+     :notify (lambda (widget &rest _ignore)
+               (let ((val (widget-value widget))
+                     (q gnuplot-quote-character)
+                     (p (widget-get widget :doc)) )
+                 (setcdr (assoc (widget-get widget :tag) gnuplot-gui-alist)
+                         (if (string-match "^\\s-*$" val)
+                             ""
+                           (progn
+                             (if (string-match "_star$" p)
+                                 (setq p (concat (substring p 0 -5) " ")
+                                       q ""))
+                             (if (string-match "^\\s-+" val)
+                                 (setq val (replace-match "" nil nil val)))
+                             (if (string-match "\\s-+$" val)
+                                 (setq val (replace-match "" nil nil val)))
+                             (format "%s%s%s%s" p q val q)))))))
+    (unless (string-match "^\\s-*$" default)
+      (setcdr (assoc item gnuplot-gui-alist) (format "%s %s" pp default)))
+    (widget-insert "\n")))
+
+(defun gnuplot-gui-format (item default)
+  "Create a string widget for the Gnuplot GUI.
+ITEM is the object whose arguments are set by this widget, DEFAULT is
+the default value for the widget, and WIDTH_OR_PREFIX is the width of
+the text entry field (which defaults to half the frame width) or the
+prefix for the string."
+  (if (string-match "^['\"]" default)
+      (setq default (replace-match "" nil nil default)))
+  (if (string-match "['\"]$" default)
+      (setq default (replace-match "" nil nil default)))
+  (widget-insert (capitalize item) ": ")
+  (widget-create 'editable-field
+                 :size (/ (frame-width) 3) :tag item :value default
+                 :help-echo (format "Insert new format string here")
+                 :notify (lambda (widget &rest _ignore)
+                           (let ((val (widget-value widget)))
+                             (setcdr (assoc (widget-get widget :tag)
+                                            gnuplot-gui-alist)
+                                     (format "%s%s%s"
+                                             gnuplot-quote-character
+                                             val
+                                             gnuplot-quote-character)))))
+  (widget-insert "   ")
+  (widget-create 'gnuplot-gui-info-link
+                 :tag (concat "info on format")
+                 :help-echo "Open a frame displaying the info entry for format"
+                 :value "format")
+  (widget-insert "\n"))
+
+;; swiped from widget-color-complete
+(defun gnuplot-gui-file-completion (widget)
+  "Complete the filename in WIDGET."
+  (let* ((str (buffer-substring-no-properties (widget-field-start widget)
+                                              (point)))
+         (file (or (file-name-nondirectory str) ""))
+         (dir  (or (file-name-directory str) "./"))
+         (val  (file-name-completion file dir)) )
+    (cond ((eq val t)
+           (message "Exact match"))
+          ((null val)
+           (error "Can't find completion for \"%s\"" str))
+          ((not (string-equal str val))
+           (insert (substring val (length file))))
+          (t
+           (message "Making completion list...")
+           (let ((list (file-name-all-completions file dir)))
+             (with-output-to-temp-buffer "*Completions*"
+               (display-completion-list list)))
+           (message "Making completion list...done")))))
+
+(defun gnuplot-gui-file (item default &optional tag)
+  "Create a file widget for the Gnuplot GUI.
+ITEM is the object whose arguments is set by this widget, DEFAULT is
+the default value for the argument.  TAG is non-nil if ITEM rather than
+\"File:\" is to be used as the tag."
+  (setq tag (if tag (capitalize item) "File"))
+  (if (string-match "^['\"]" default)
+      (setq default (replace-match "" nil nil default)))
+  (if (string-match "['\"]$" default)
+      (setq default (replace-match "" nil nil default)))
+  (let ((widg (widget-create
+               'file
+               :value default :tag tag
+               :size (- (/ (frame-width) 2) 3)
+               :doc item :help-echo "Insert a filename here"
+               :complete 'gnuplot-gui-file-completion
+               :notify
+               (lambda (widget &rest _ignore)
+                 (setcdr (assoc (widget-get widget :doc) gnuplot-gui-alist)
+                         (format "%s%s%s" gnuplot-quote-character
+                                 (widget-value widget)
+                                 gnuplot-quote-character)) )) ))
+    (widget-insert " ")
+    (widget-create
+     'push-button :value "Browse"
+     :doc item :help-echo "Browse directories for a filename."
+     :parent widg
+     :notify (lambda (widget &rest _ignore)
+               (let ((fname (file-relative-name (read-file-name "File: ")
+                                                default-directory))
+                     (q gnuplot-quote-character))
+                 (widget-value-set (widget-get widget :parent) fname)
+                 (setcdr (assoc (widget-get widget :doc) gnuplot-gui-alist)
+                         (format "%s%s%s" q fname q))
+                 (widget-setup))))
+    (widget-insert "\n")))
+
+(defun gnuplot-gui-labels (item default)
+  "Create a labels widget for the Gnuplot GUI.
+ITEM is the object whose arguments is set by this widget, DEFAULT is
+the default value for the argument."
+  (widget-create
+   '(editable-list
+     (list :inline t :tag "Tic label"
+           (string :tag "label" :size 10
+                   :help-echo "Enter the tic label here" )
+           (string :tag "  position" :size 10
+                   :help-echo "Enter an expression for the tic location here" )))
+   :tag (capitalize item)
+   :value default
+   :format "%{%t%}:\n%v\t  %i\n"
+   :entry-format "\t  %i %d %v\n"
+   :button-face 'gnuplot-gui-labels-face
+   :notify (lambda (widget &rest _ignore)
+             (setcdr (assoc (upcase (widget-get widget :tag))
+                            gnuplot-gui-alist)
+                     (widget-value widget)))))
+
+(defun gnuplot-gui-range (item default separator is-range)
+  "Create a range or pair widget for the Gnuplot GUI.
+ITEM is the object whose arguments are set by this widget, DEFAULT is
+the default value for the widget, SEPARATOR is a text string preceding
+the numerical argument, or the prefix for a pair operator.  IS-RANGE
+is non-nil if this is a \\='range widget."
+  (widget-insert (capitalize item) ": ")
+  (if is-range (widget-insert "["))
+  (widget-create 'editable-field
+                 :size 4 :tag item :value (car default)
+                 :help-echo (format "Insert the first value of the %S here"
+                                    (downcase item))
+                 :notify (lambda (widget &rest _ignore)
+                           (setcar (cdr (assoc (widget-get widget :tag)
+                                               gnuplot-gui-alist))
+                                   (format "%s" (widget-value widget)))))
+  (if is-range (widget-insert separator) (widget-insert "  "))
+  (widget-create 'editable-field
+                 :size 4 :tag item :value (cdr default)
+                 :help-echo (format "Insert the second value of the %S here"
+                                    (downcase item))
+                 :notify (lambda (widget &rest _ignore)
+                           (setcdr (cdr (assoc (widget-get widget :tag)
+                                               gnuplot-gui-alist))
+                                   (format "%s" (widget-value widget)))))
+  (if is-range (widget-insert "]"))
+  (widget-insert " " (make-string (- 39 (current-column)) ?.)
+                 " (numeric values)\n"))
+
+;; suppress compiler warning
+;;(eval-when-compile (defun gnuplot-info-lookup-symbol (sym mode)))
+(define-widget 'gnuplot-gui-info-link 'info-link
+  "A link to an info file for the Gnuplot GUI."
+  :action '(lambda (widget &optional event)
+             (let ((gnuplot-info-display 'frame))
+               (when (eq gnuplot--info-keywords 'pending)
+                 (gnuplot--setup-info-look))
+               (gnuplot-info-lookup-symbol (widget-value widget)
+                                           'gnuplot-mode))))
+
+(provide 'gnuplot-gui)
+;;; gnuplot-gui.el ends here
diff --git a/elpa/gnuplot-20260322.20/gnuplot-pkg.el b/elpa/gnuplot-20260322.20/gnuplot-pkg.el
new file mode 100644
index 00000000..464b48ab
--- /dev/null
+++ b/elpa/gnuplot-20260322.20/gnuplot-pkg.el
@@ -0,0 +1,11 @@
+;; -*- no-byte-compile: t; lexical-binding: nil -*-
+(define-package "gnuplot" "20260322.20"
+  "Major-mode and interactive frontend for gnuplot."
+  '((emacs  "28.1")
+    (compat "30"))
+  :url "https://github.com/emacs-gnuplot/gnuplot"
+  :commit "39ba1dec5e8e227ba093a30ca07b20d8eb038f29"
+  :revdesc "39ba1dec5e8e"
+  :keywords '("data" "gnuplot" "plotting")
+  :maintainers '(("Maxime Tréca" . "maxime@gmail.com")
+                 ("Daniel Mendler" . "mail@daniel-mendler.de")))
diff --git a/elpa/gnuplot-20260322.20/gnuplot.el b/elpa/gnuplot-20260322.20/gnuplot.el
new file mode 100644
index 00000000..cefe01f1
--- /dev/null
+++ b/elpa/gnuplot-20260322.20/gnuplot.el
@@ -0,0 +1,1886 @@
+;;; gnuplot.el --- Major-mode and interactive frontend for gnuplot -*- lexical-binding: t -*-
+
+;; Copyright (C) 1998, 2011 Phil Type and Bruce Ravel, 1999-2012 Bruce Ravel
+
+;; Author:           Jon Oddie, Bruce Ravel, Phil Type
+;; Maintainer:       Maxime Tréca <maxime@gmail.com>, Daniel Mendler <mail@daniel-mendler.de>
+;; Created:          1998
+;; Package-Version: 20260322.20
+;; Package-Revision: 39ba1dec5e8e
+;; Keywords:         data gnuplot plotting
+;; URL:              https://github.com/emacs-gnuplot/gnuplot
+;; Package-Requires: ((emacs "28.1") (compat "30"))
+
+;; This program is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+;;; Commentary:
+
+;; This is a major mode for composing gnuplot scripts and displaying
+;; their results using gnuplot.  It supports features of recent Gnuplot
+;; versions (5.0 and up), but should also work fine with older
+;; versions.
+;;
+;; Gnuplot-mode includes context-sensitive support for keyword
+;; completion and, optionally, eldoc-mode help text.  See the
+;; commentary in gnuplot-context.el for more information.  If you
+;; don't find it useful, it can be turned off by customizing
+;; `gnuplot-context-sensitive-mode'.
+
+;;; Acknowledgements:
+
+;;    David Batty          numerous corrections
+;;    Laurent Bonnaud      suggestions regarding font-lock rules
+;;    Markus Dickebohm     suggested `gnuplot-send-line-and-forward'
+;;    Stephen Eglan        suggested the use of info-look and various fixes
+;;    Robert Fenk          suggested respecting continuation lines
+;;    Michael Karbach      suggested trimming the gnuplot process buffer
+;;    Alex Chan Libchen    suggested font-lock for plotting words
+;;    Kuang-Yu Liu         pointed out buggy dependence on font-lock
+;;    Hrvoje Niksic        help with defcustom arguments for insertions
+;;    Andreas Rechtsteiner pointed out problem with C-c C-v
+;;    Michael Sanders      help with the info-look interface
+;;    Jinwei Shen          suggested functionality in comint buffer
+;;    Michael M. Tung      prompted me to add pm3d support
+;;    Holger Wenzel        suggested using `gnuplot-keywords-when'
+;;    Wolfgang Zocher      pointed out problem with gnuplot-mode + speedbar
+;;    Jon Oddie            indentation, inline images, context mode
+;;    Lars Hecking         gnuplot distribution and installation materials
+;;    Maxime F. Treca      package update, XEmacs deprecation
+;;    Daniel Mendler       package update, support for recent Emacs
+
+;;; Code:
+
+(require 'compat)
+(require 'cl-lib)
+(require 'comint)
+(require 'info)
+(require 'info-look)
+
+(defgroup gnuplot nil
+  "Gnuplot-mode for Emacs."
+  :prefix "gnuplot-"
+  :group 'processes
+  :group 'applications
+  :link '(emacs-library-link :tag "Lisp File" "gnuplot.el")
+  :link '(url-link :tag "Homepage" "https://github.com/emacs-gnuplot/gnuplot/")
+  :link '(info-link :tag "Info Manual" "(gnuplot)")
+  :link '(emacs-commentary-link :tag "Commentary" "gnuplot.el"))
+
+(defcustom gnuplot-program "gnuplot"
+  "The name of the gnuplot executable."
+  :type 'string)
+
+(defcustom gnuplot-program-args nil
+  "Whitespace-separated flags to pass to the gnuplot executable."
+  :type 'string)
+
+(defcustom gnuplot-process-name "gnuplot"
+  "Name given to the gnuplot buffer and process."
+  :type 'string)
+
+(defcustom gnuplot-gnuplot-buffer "plot.gp"
+  "The name of the gnuplot scratch buffer opened by `gnuplot-make-buffer'."
+  :type 'string)
+
+(defcustom gnuplot-display-process 'window
+  "This controls how the gnuplot process buffer is displayed.
+The values are
+   \\='frame    display gnuplot process in a separate frame
+   \\='window   display gnuplot process in this frame but in another window
+   nil       `gnuplot-process' is in the current frame but not displayed"
+  :type '(radio (const :tag "Separate frame"  frame)
+                (const :tag "Separate window" window)
+                (const :tag "Not displayed"   nil)))
+
+(defcustom gnuplot-info-display 'window
+  "Determines how `gnuplot-info-lookup-symbol' displays the info file.
+The values are
+   \\='frame    display info file in a separate frame
+   \\='window   display info file in another window
+   nil       display info file in the current window"
+  :type '(radio (const :tag "Separate frame"  frame)
+                (const :tag "Separate window" window)
+                (const :tag "This window"     nil)))
+
+(defcustom gnuplot-echo-command-line-flag
+  (not (string-match "msvc" (emacs-version)))
+  "Non-nil means the gnuplot subprocess echoes any input.
+This sets the fall-back value of `comint-process-echoes'.
+If `gnuplot-mode' cannot figure out what version number of gnuplot
+this is, then the value of this variable will be used for
+`comint-process-echos'.  It seems that gnuplot 3.5 wants this to be
+nil and 3.7 wants it to be t.  If lines that you send to gnuplot from
+the `gnuplot-mode' buffer are not appearing at the gnuplot prompt in
+the process buffer, try toggling it.  Also see the document string for
+`comint-process-echos'.  If you change this, kill the gnuplot process
+and start it again."
+  :type 'boolean)
+
+(defcustom gnuplot-delay 0.02
+  "Amount of time to delay before sending a new line to gnuplot.
+This is needed so that the the line is not written in the gnuplot
+buffer in advance of its prompt.  Increase this number if the
+prompts and lines are displayed out of order."
+  :type 'number)
+
+(defcustom gnuplot-buffer-max-size 1000
+  "The maximum size in lines of the gnuplot process buffer.
+Each time text is written in the gnuplot process buffer, lines are
+trimmed from the beginning of the buffer so that the buffer is this
+many lines long.  The lines are deleted after the most recent lines
+were interpretted by gnuplot.  Setting to 0 turns off this feature."
+  :type 'integer)
+
+(defcustom gnuplot-quote-character "\'"
+  "Quotation character used for inserting quoted strings.
+Gnuplot can use single or double quotes.  If you prefer to have the
+filename insertion function never insert quotes for you, set this
+to the empty string."
+  :type '(radio (const :tag "double quote"  "\"")
+                (const :tag "single quote"  "\'")
+                (const :tag "none"          ""  )))
+
+(defcustom gnuplot-basic-offset 4
+  "Number of columns to indent lines inside a do- or if-else-block.
+
+This applies only to new-style do- and if-statements using
+braces.  Commands continued over a linebreak using a backslash
+are always indented to line up with the second word on the line
+beginning the continued command."
+  :type 'integer)
+
+(defvar gnuplot-context-sensitive-mode nil)
+(autoload 'gnuplot-context-sensitive-mode "gnuplot-context")
+(autoload 'gnuplot-gui-set-options-and-insert "gnuplot-gui" nil '(gnuplot-mode))
+(autoload 'gnuplot-gui-swap-simple-complete "gnuplot-gui" nil '(gnuplot-mode))
+(autoload 'gnuplot-gui-toggle-popup "gnuplot-gui" nil '(gnuplot-mode))
+
+(defcustom gnuplot-use-context-sensitive-completion t
+  "Non-nil if `gnuplot-context-sensitive-mode' should be enabled by default.
+
+In context-sensitive mode, `gnuplot-mode' parses the current
+command line to provide smarter completion and documentation
+suggestions."
+  :type 'boolean
+  :set (lambda (sym value)
+         (set sym value)
+         (cond
+          (value
+           (add-hook 'gnuplot-mode-hook #'gnuplot-context-sensitive-mode nil nil)
+           (add-hook 'gnuplot-comint-mode-hook #'gnuplot-context-sensitive-mode nil nil))
+          (t
+           (remove-hook 'gnuplot-mode-hook #'gnuplot-context-sensitive-mode)
+           (remove-hook 'gnuplot-comint-mode-hook #'gnuplot-context-sensitive-mode)))
+         (dolist (buffer (buffer-list))
+           (with-current-buffer buffer
+             (when (derived-mode-p 'gnuplot-mode 'gnuplot-comint-mode)
+               (gnuplot-context-sensitive-mode (if value 1 0))))))
+  :link '(emacs-commentary-link "gnuplot-context"))
+
+(defun gnuplot--set-display-mode (variable value &rest _args)
+  "Customize :set function for `gnuplot-inline-image-mode'.
+Set VARIABLE to VALUE.  ARGS is optional args."
+  (if (and (eq variable 'gnuplot-inline-image-mode)
+           value
+           (not (display-images-p)))
+      (progn
+        (message "Displaying images is not supported.")
+        (set variable nil))
+    (set variable value))
+  (gnuplot--setup-comint-for-image-mode))
+
+(defcustom gnuplot-inline-image-mode (and (display-graphic-p)
+                                          (image-type-available-p 'png)
+                                          'inline)
+  "Whether to display Gnuplot output in Emacs.
+
+Possible values are nil, `inline' and `dedicated'.
+
+When this is nil, Gnuplot output is handled outside of Emacs in
+the normal way.  Otherwise, Emacs attempts to capture Gnuplot's
+output and display it in a buffer.  Output is inserted inline in
+the Gnuplot interaction buffer it this is `inline', in a
+separate dedicated buffer if it is `dedicated'.
+
+Use Customize to set this variable, or the commands
+`gnuplot-external-display-mode', `gnuplot-inline-display-mode',
+and `gnuplot-dedicated-display-mode'."
+  :type '(radio
+          (const :tag "No" nil)
+          (const :tag "In Comint buffer" inline)
+          (const :tag "In dedicated buffer" dedicated))
+  :initialize #'custom-initialize-default
+  :set #'gnuplot--set-display-mode)
+
+(defcustom gnuplot-image-format "png"
+  "Image format to use for displaying images within Emacs.
+
+This will be sent directly to Gnuplot as a command of the form
+\"set terminal <FORMAT>\".  Common values are \"png\" and
+\"svg\".
+
+This only has an effect when `gnuplot-inline-image-mode' is
+non-nil."
+  :type 'string
+  :initialize #'custom-initialize-default
+  :set #'gnuplot--set-display-mode)
+
+(defcustom gnuplot-image-buffer "*gnuplot image*"
+  "Buffer name for dedicated gnuplot image output."
+  :type 'string)
+
+(defcustom gnuplot-hidden-output-buffer " *gnuplot hidden*"
+  "Buffer name for hidden gnuplot output.
+Send commands to GNUPLOT silently & without generating an extra prompt."
+  :type 'string)
+
+
+;;; customizable hooks
+
+(defgroup gnuplot-hooks nil
+  "Hook variables used by `gnuplot-mode'."
+  :prefix "gnuplot-"
+  :group 'gnuplot)
+
+(defcustom gnuplot-mode-hook nil
+  "Hook run when `gnuplot-mode' is entered."
+  :type 'hook)
+
+(defcustom gnuplot-after-plot-hook (list #'gnuplot-trim-comint-buffer)
+  "Hook run after gnuplot plots something.
+This is the last thing done by the functions for plotting a line, a
+region, a buffer, or a file."
+  :type 'hook)
+
+(defcustom gnuplot-comint-mode-hook nil
+  "Hook run after setting up the gnuplot buffer in `gnuplot-comint-mode'."
+  :type 'hook)
+
+
+
+;;; --- insertions variables and menus
+
+(defgroup gnuplot-insertions nil
+  "Insert commands into gnuplot-scripts from a pull-down menu."
+  :prefix "gnuplot-insertions-"
+  :group 'gnuplot)
+
+(defvar gnuplot--insertions-menu nil
+  "Menu for insertions in `gnuplot-mode'.
+
+The insertions menu is composed of several sub-menus.  The variables
+describing the sub-menus are:
+  `gnuplot-insertions-adornments'
+  `gnuplot-insertions-plot-options'
+  `gnuplot-insertions-terminal'
+  `gnuplot-insertions-x-axis'
+  `gnuplot-insertions-y-axis'
+  `gnuplot-insertions-z-axis'
+  `gnuplot-insertions-x2-axis'
+  `gnuplot-insertions-y2-axis'
+  `gnuplot-insertions-parametric-plots'
+  `gnuplot-insertions-polar-plots'
+  `gnuplot-insertions-surface-plots'
+These variables can be customized by the user.  For example, there are
+many terminal types which are not in the terminal submenu but which
+may be compiled into your copy of gnuplot.
+
+Each of these variables is a list whose first element is a string and
+all the rest are vectors as described in the document string for
+`easy-menu-define'.  The callback used throughout these menus is
+`gnuplot-insert' which inserts the appropriate set expression and,
+optionally, looks up that item in the gnuplot info file.
+
+The easiest way to customize the submenus is to use the custom
+package.  Just type \\[gnuplot-customize] and follow your nose.
+
+You can also add new items to any of these sub-menus by adding to the
+`with-eval-after-load' blocks in your .emacs file.  Here is an example of
+adding the \"regis\" terminal type to the terminal sub-menu:
+
+ (with-eval-after-load \\='gnuplot
+      (setq gnuplot-insertions-terminal
+            (append gnuplot-insertions-terminal
+                    (list
+                     [\"regis\"
+                      (gnuplot-insert \"set terminal regis\")
+                       t]))))")
+
+(defcustom gnuplot-insertions-show-help-flag nil
+  "Non-nil means to display certain help messages automatically.
+These messages are shown after menu insertion of gnuplot commands."
+  :type 'boolean)
+
+(defcustom gnuplot-insertions-menu-flag t
+  "Non-nil means to place the insertion menu in the menubar.
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type 'boolean)
+
+(defvar gnuplot-insertions-top
+  '("insert set expression" "---")
+  "Top part of insertions menu.
+See the document string for `gnuplot--insertions-menu'")
+
+(defcustom gnuplot-insertions-adornments ; this is icky...
+  '("adornments"
+    ["arrow"       (gnuplot-insert "set arrow ")          t]
+    ["bar"         (gnuplot-insert "set bar")             t]
+    ["border"      (gnuplot-insert "set border")          t]
+    ["boxwidth"    (gnuplot-insert "set boxwidth ")       t]
+    ["format"      (gnuplot-insert "set format ")         t]
+    ["grid"        (gnuplot-insert "set grid")            t]
+    ["key"         (gnuplot-insert "set key ")            t]
+    ["label"       (gnuplot-insert "set label ")          t]
+    ["pointsize"   (gnuplot-insert "set pointsize ")      t]
+    ["samples"     (gnuplot-insert "set samples ")        t]
+    ["size"        (gnuplot-insert "set size ")           t]
+    ["style"       (gnuplot-insert "set style ")          t]
+    ["tics"        (gnuplot-insert "set tics ")           t]
+    ["timefmt"     (gnuplot-insert "set timefmt ")        t]
+    ["timestamp"   (gnuplot-insert "set timestamp ")      t]
+    ["title"       (gnuplot-insert "set title ")          t]
+    ["zeroaxis"    (gnuplot-insert "set zeroaxis")        t])
+
+  "Adornments submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defcustom gnuplot-insertions-plot-options
+  '("plot options"
+    ["autoscale"  (gnuplot-insert "set autoscale ")          t]
+    ["clip"       (gnuplot-insert "set clip ")               t]
+    ["encoding"   (gnuplot-insert "set encoding ")           t]
+    ["locale"     (gnuplot-insert "set locale ")             t]
+    ["logscale"   (gnuplot-insert "set logscale ")           t]
+    ["multiplot"  (gnuplot-insert "set multiplot")           t]
+    ["missing"    (gnuplot-insert "set missing \"\"")        t]
+    ["palette"    (gnuplot-insert "set palette ")            t]
+    ["pm3d"       (gnuplot-insert "set pm3d ")               t]
+    ["offsets"    (gnuplot-insert "set offsets ")            t]
+    ["output"     (gnuplot-insert "set output ")             t]
+    ["zero"       (gnuplot-insert "set zero ")               t])
+  "Plot options submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defcustom gnuplot-insertions-terminal
+  '("terminal"
+    ["eepic"      (gnuplot-insert "set terminal eepic")      t]
+    ["fig"        (gnuplot-insert "set terminal fig")        t]
+    ["gpic"       (gnuplot-insert "set terminal gpic")       t]
+    ["latex"      (gnuplot-insert "set terminal latex")      t]
+    ["linux"      (gnuplot-insert "set terminal linux")      t]
+    ["pbm"        (gnuplot-insert "set terminal pbm")        t]
+    ["png"        (gnuplot-insert "set terminal png")        t]
+    ["postscript" (gnuplot-insert "set terminal postscript") t]
+    ["pslatex"    (gnuplot-insert "set terminal pslatex")    t]
+    ["table"      (gnuplot-insert "set terminal table")      t]
+    ["tek40xx"    (gnuplot-insert "set terminal tek40xx")    t]
+    ["tkcanvas"   (gnuplot-insert "set terminal tkcanvas")   t]
+    ["tpic"       (gnuplot-insert "set terminal tpic")       t]
+    ["vgagl"      (gnuplot-insert "set terminal vgagl")      t]         ; for pm3d patch
+    ["vttek"      (gnuplot-insert "set terminal vttek")      t]
+    ["x11"        (gnuplot-insert "set terminal x11")        t])
+  "Terminal submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defcustom gnuplot-insertions-x-axis
+  '("x-axis"
+    ["xdata"      (gnuplot-insert "set xdata ")              t]
+    ["xlabel"     (gnuplot-insert "set xlabel ")             t]
+    ["xrange"     (gnuplot-insert "set xrange [:]")          t]
+    ["xtics"      (gnuplot-insert "set xtics ")              t]
+    ["mxtics"     (gnuplot-insert "set mxtics ")             t]
+    ["xzeroaxis"  (gnuplot-insert "set xzeroaxis ")          t]
+    ["xdtics"     (gnuplot-insert "set xdtics ")             t]
+    ["xmtics"     (gnuplot-insert "set xmtics ")             t])
+  "X-axis submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defcustom gnuplot-insertions-x2-axis
+  '("x2-axis"
+    ["x2data"     (gnuplot-insert "set xdata ")              t]
+    ["x2label"    (gnuplot-insert "set xlabel ")             t]
+    ["x2range"    (gnuplot-insert "set xrange [:]")          t]
+    ["x2tics"     (gnuplot-insert "set xtics ")              t]
+    ["mx2tics"    (gnuplot-insert "set mxtics ")             t]
+    ["x2zeroaxis" (gnuplot-insert "set xzeroaxis ")          t]
+    ["x2dtics"    (gnuplot-insert "set xdtics ")             t]
+    ["x2mtics"    (gnuplot-insert "set xmtics ")             t])
+  "X2-axis submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defcustom gnuplot-insertions-y-axis
+  '("y-axis"
+    ["ydata"      (gnuplot-insert "set ydata ")              t]
+    ["ylabel"     (gnuplot-insert "set ylabel ")             t]
+    ["ymtics"     (gnuplot-insert "set ymtics ")             t]
+    ["yrange"     (gnuplot-insert "set yrange [:]")          t]
+    ["ytics"      (gnuplot-insert "set ytics ")              t]
+    ["yzeroaxis"  (gnuplot-insert "set yzeroaxis ")          t]
+    ["ydtics"     (gnuplot-insert "set ydtics ")             t]
+    ["mytics"     (gnuplot-insert "set mytics ")             t])
+  "Y-axis submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defcustom gnuplot-insertions-y2-axis
+  '("y2-axis"
+    ["y2data"     (gnuplot-insert "set ydata ")              t]
+    ["y2label"    (gnuplot-insert "set ylabel ")             t]
+    ["y2range"    (gnuplot-insert "set yrange [:]")          t]
+    ["y2tics"     (gnuplot-insert "set ytics ")              t]
+    ["my2tics"    (gnuplot-insert "set mytics ")             t]
+    ["y2zeroaxis"  (gnuplot-insert "set yzeroaxis ")         t]
+    ["y2mtics"    (gnuplot-insert "set ymtics ")             t]
+    ["y2dtics"    (gnuplot-insert "set ydtics ")             t])
+  "Y2-axis submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defcustom gnuplot-insertions-z-axis
+  '("z-axis"
+    ["zdata"      (gnuplot-insert "set zdata ")              t]
+    ["zlabel"     (gnuplot-insert "set zlabel ")             t]
+    ["zrange"     (gnuplot-insert "set zrange [:]")          t]
+    ["ztics"      (gnuplot-insert "set ztics ")              t]
+    ["mztics"     (gnuplot-insert "set mztics ")             t]
+    ["zdtics"     (gnuplot-insert "set zdtics ")             t]
+    ["zmtics"     (gnuplot-insert "set zmtics ")             t])
+  "Z-axis submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defcustom gnuplot-insertions-parametric-plots
+  '("parametric plots"
+    ["parametric" (gnuplot-insert "set parametric")          t]
+    ["isosamples" (gnuplot-insert "set isosamples ")         t]
+    ["dummy"      (gnuplot-insert "set dummy ")              t]
+    ["trange"     (gnuplot-insert "set trange [:]")          t]
+    ["urange"     (gnuplot-insert "set urange [:]")          t]
+    ["vrange"     (gnuplot-insert "set vrange [:]")          t])
+  "Parametric plots submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defcustom gnuplot-insertions-polar-plots
+  '("polar plots"
+    ["polar"      (gnuplot-insert "set polar")               t]
+    ["angles"     (gnuplot-insert "set angles ")             t]
+    ["rrange"     (gnuplot-insert "set rrange [:]")          t])
+  "Polar plots submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defcustom gnuplot-insertions-surface-plots
+  '("surface plots"
+    ["clabel"     (gnuplot-insert "set clabel ")             t]
+    ["cntrparam"  (gnuplot-insert "set cntrparam ")          t]
+    ["contour"    (gnuplot-insert "set contour")             t]
+    ["dgrid3d"    (gnuplot-insert "set dgrid3d ")            t]
+    ["hidden3d"   (gnuplot-insert "set hidden3d ")           t]
+    ["mapping"    (gnuplot-insert "set mapping ")            t]
+    ["surface"    (gnuplot-insert "set surface ")            t]
+    ["view"       (gnuplot-insert "set view ")               t])
+  "Surface plots submenu in the insertions menu.
+See the document string for `gnuplot--insertions-menu'
+Changing this will not effect a change in any currently existing
+`gnuplot-mode' buffer.  You will see the change the next time you
+create a `gnuplot-mode' buffer."
+  :type '(list (string :tag "Title")
+               (repeat :inline t
+                       (vector (string   :tag "Name")
+                               (function :tag "Callback")
+                               (boolean  :tag "Enabled" t)))))
+
+(defvar gnuplot-insertions-bottom
+  '("---"
+    ["Display of info with insertion" gnuplot-toggle-info-display
+     :style toggle :selected gnuplot-insertions-show-help-flag]
+    ["Display GUI popup with insertion" gnuplot-gui-toggle-popup
+     :active t
+     :style toggle :selected gnuplot-gui-popup-flag])
+  "Bottom part of the insertions menu.
+This part contains the toggle buttons for displaying info or
+opening an argument-setting popup.")
+
+(defvar gnuplot-recently-sent nil
+  "This is a record of the most recent kind of text sent to gnuplot.
+It takes as its value nil, `line', `region', `buffer', or `file'.  It is
+useful for functions included in `gnuplot-after-plot-hook'.")
+
+(defvar gnuplot-buffer nil
+  "The name of the buffer displaying the gnuplot process.")
+
+(defvar gnuplot-process nil
+  "Variable holding the process handle.")
+
+(defvar gnuplot--comint-recent-buffer nil
+  "The most recently plotted gnuplot script buffer.
+This is used by the function that plot from the comint buffer.  It is
+reset every time something is plotted from a script buffer.")
+
+(defvar gnuplot--process-frame nil
+  "The frame for displaying the gnuplot process.
+This is used when `gnuplot-display-process' is equal to `frame'.")
+
+(defvar gnuplot--info-frame nil)
+
+;; with info-look, there is no need to carry this list around -- it
+;; can be generated on the fly appropriate to the currently installed
+;; version of gnuplot.info
+(defvar gnuplot--info-keywords 'pending
+  "A list of keywords used in GNUPLOT.
+These are set by `gnuplot--set-keywords-list' from the values in
+`info-lookup-cache'.")
+
+
+;;; --- key bindings and menus
+
+(defvar-keymap gnuplot-mode-map
+  :doc "Keymap used by `gnuplot-mode'."
+  :parent prog-mode-map
+  "C-c C-b"     #'gnuplot-send-buffer-to-gnuplot
+  "C-c C-o"     #'gnuplot-gui-set-options-and-insert
+  "C-c C-e"     #'gnuplot-show-comint-buffer
+  "C-c C-f"     #'gnuplot-send-file-to-gnuplot
+  "C-c C-d"     #'gnuplot-info-lookup-symbol
+  "C-c C-i"     #'gnuplot-insert-filename
+  "C-c C-j"     #'gnuplot-forward-script-line
+  "C-c C-k"     #'gnuplot-kill-comint-buffer
+  "C-c C-l"     #'gnuplot-send-line-to-gnuplot
+  "C-c C-n"     #'gnuplot-negate-option
+  "C-c C-r"     #'gnuplot-send-region-to-gnuplot
+  "C-M-x"       #'gnuplot-send-line-to-gnuplot
+  "C-c C-v"     #'gnuplot-send-line-and-forward
+  "C-c C-z"     #'gnuplot-customize
+  "}"           #'gnuplot-electric-insert
+  "M-TAB"       #'completion-at-point
+  "S-<mouse-2>" #'gnuplot-gui-set-options-and-insert)
+
+(defvar gnuplot--display-options-menu
+  (cl-flet ((make-image-setter (type)
+              `[,(concat (upcase type) " images")
+                (lambda () (interactive) (gnuplot-set-image-format ,type))
+                :style toggle
+                :selected (eq gnuplot-image-format ,type)]))
+    `("Display plot output"
+      ["Externally" gnuplot-external-display-mode
+       :style toggle
+       :selected (null gnuplot-inline-image-mode)]
+      ["In Comint buffer" gnuplot-inline-display-mode
+       :active (display-images-p)
+       :style toggle
+       :selected (eq gnuplot-inline-image-mode 'comint)]
+      ["In dedicated buffer" gnuplot-dedicated-display-mode
+       :style toggle
+       :selected (eq gnuplot-inline-image-mode 'dedicated)]
+      "---"
+      ,@(mapcar #'make-image-setter (list "png" "jpeg" "svg"))
+      ["Other image type..." gnuplot-set-image-format])))
+
+(easy-menu-define gnuplot-mode-menu gnuplot-mode-map
+  "Menu used in `gnuplot-mode'."
+  `("Gnuplot"
+    ["Send line to gnuplot"             gnuplot-send-line-to-gnuplot   t]
+    ["Send line & move forward"         gnuplot-send-line-and-forward (not (eobp))]
+    ["Send region to gnuplot"           gnuplot-send-region-to-gnuplot
+     (gnuplot--mark-active)]
+    ["Send buffer to gnuplot"           gnuplot-send-buffer-to-gnuplot t]
+    ["Send file to gnuplot"             gnuplot-send-file-to-gnuplot t]
+    "---"
+    ,gnuplot--display-options-menu
+    ["Contextual completion and help"   gnuplot-context-sensitive-mode
+     :style toggle
+     :selected gnuplot-context-sensitive-mode]
+    ["Echo area help (eldoc-mode)" eldoc-mode
+     :active gnuplot-context-sensitive-mode
+     :style toggle
+     :selected eldoc-mode]
+    "---"
+    ["Insert filename at point"         gnuplot-insert-filename t]
+    ["Negate set option"                gnuplot-negate-option t]
+    ["Keyword help"                     gnuplot-info-lookup-symbol]
+    ["Quick help for thing at point"    gnuplot-context-help-at-point
+     gnuplot-context-sensitive-mode]
+    ["Info documentation on thing at point"
+     gnuplot-context-info-at-point
+     gnuplot-context-sensitive-mode]
+    ["Show gnuplot process buffer"      gnuplot-show-comint-buffer t]
+    ["Set arguments at point"           gnuplot-gui-set-options-and-insert t]
+    ["Swap plot/splot/fit lists in GUI" gnuplot-gui-swap-simple-complete t]
+    "---"
+    ["Customize gnuplot"                gnuplot-customize t]
+    "---"
+    ["Kill gnuplot"                     gnuplot-kill-comint-buffer t]))
+
+
+;;; --- syntax colorization, syntax table
+
+(defvar gnuplot-mode-abbrev-table)
+(defvar gnuplot-mode-syntax-table
+  (let ((table (make-syntax-table)))
+    (modify-syntax-entry ?* "." table)
+    (modify-syntax-entry ?+ "." table)
+    (modify-syntax-entry ?- "." table)
+    (modify-syntax-entry ?/ "." table)
+    (modify-syntax-entry ?% "." table)
+    (modify-syntax-entry ?= "." table)
+    (modify-syntax-entry ?: "." table)
+    (modify-syntax-entry ?& "." table )
+    (modify-syntax-entry ?^ "." table )
+    (modify-syntax-entry ?| "." table )
+    (modify-syntax-entry ?& "." table )
+    (modify-syntax-entry ?? "." table )
+    (modify-syntax-entry ?~ "." table )
+    (modify-syntax-entry ?_ "w" table )
+    (modify-syntax-entry ?\" "." table)
+    (modify-syntax-entry ?\' "." table)
+    (modify-syntax-entry ?` "." table)
+    (modify-syntax-entry ?\\ "." table)
+
+    table)
+
+  "Syntax table in use in `gnuplot-mode' buffers.
+This is the same as the standard syntax table except that ` and _
+are word characters, and math operators are punctuation
+characters.")
+
+;; Macro to generate efficient regexps for keyword matching
+;;
+;; These regular expressions treat the gnuplot vocabulary as complete
+;; words.  Although gnuplot will recognise unique abbreviations, these
+;; regular expressions will not.
+(defmacro gnuplot--make-regexp (list)
+  "Macro to generate efficient regexps for keyword matching from LIST."
+  `(regexp-opt ,list 'words))
+
+;; Lists of gnuplot keywords for syntax coloring etc.
+(defvar gnuplot--keywords-builtin-functions
+  '("abs" "acosh" "acos" "arg" "asinh" "asin" "atan" "atanh" "atan2" "besj1"
+    "besj0" "besy1" "besy0" "ceil" "column" "cosh" "cos" "erfc" "erf" "exp"
+    "floor" "gamma" "ibeta" "igamma" "imag" "int" "inverf" "invnorm" "lgamma"
+    "log" "log10" "norm" "rand" "real" "sgn" "sinh" "sin" "sqrt" "tanh" "tan"
+    "tm_hour" "tm_mday" "tm_min" "tm_mon" "tm_sec" "tm_wday" "tm_yday" "tm_year"
+    "valid" "EllipticPi" "EllipticE" "EllipticK" "words" "word" "value"
+    "timecolumn" "substr" "strstrt" "strptime" "strlen" "stringcolumn"
+    "strftime" "sprintf" "lambertw" "gprintf" "exists" "defined" "columnhead")
+
+  "List of GNUPLOT built-in functions, as strings.
+
+These are highlighted using `font-lock-function-name-face'.")
+
+(defvar gnuplot--keywords-plotting
+  '("axes" "every" "index" "lw" "lt" "ls" "linestyle" "linetype" "linewidth"
+    "notitle" "pt" "ps" "pointsize" "pointtype" "smooth" "thru" "title" "using"
+    "with" "noautoscale" "volatile" "matrix" "nonuniform" "binary" "fillstyle"
+    "linecolor" "pointinterval" "nosurface" "nocontours" "nohidden3d")
+  "List of GNUPLOT keywords associated with plotting, as strings.
+
+These are highlighted using `font-lock-type-face'.
+This list does not include plotting styles -- for that, see
+`gnuplot--keywords-plotting-styles'")
+
+(defvar gnuplot--keywords-plotting-styles
+  '("boxerrorbars" "boxes" "boxxyerrorbars" "candlesticks" "dots" "errorbars"
+    "financebars" "fsteps" "histeps" "impulses" "lines" "linespoints" "points"
+    "steps" "vector" "xerrorbars" "xyerrorbars" "yerrorbars" "vectors"
+    "filledcurves" "labels" "rgbalpha" "rgbimage" "image" "circles" "pm3d"
+    "histograms" "xyerrorlines" "xerrorlines" "errorlines" "yerrorlines")
+
+  "List of GNUPLOT plotting styles, as strings.
+
+These are highlighted using `font-lock-function-name-face'.")
+
+(defvar gnuplot--keywords-misc
+  '("bind" "cd" "clear" "exit" "fit" "help" "history" "load" "pause" "print"
+    "pwd" "quit" "replot" "save" "set" "show" "unset" "if" "else" "do" "update"
+    "undefine" "test" "system" "raise" "lower" "eval" "shell" "reset" "reread"
+    "refresh" "call")
+  "List of GNUPLOT miscellaneous commands, as strings.
+
+These are highlighted using `font-lock-constant-face'.")
+
+(defvar gnuplot--keywords-negatable-options
+  '("arrow" "autoscale" "border" "clabel" "clip" "contour" "dgrid3d" "grid"
+    "hidden3d" "historysize" "key" "label" "linestyle" "logscale" "mouse"
+    "multiplot" "mx2tics" "mxtics" "my2tics" "mytics" "mztics" "offsets" "polar"
+    "surface" "timestamp" "title" "x2dtics" "x2mtics" "x2tics" "x2zeroaxis"
+    "xdtics" "xmtics" "xtics" "xzeroaxis" "y2dtics" "y2mtics" "y2tics"
+    "y2zeroaxis" "ydtics" "ymtics" "ytics" "yzeroaxis" "zdtics" "zmtics" "ztics"
+    "zzeroaxis")
+
+  "List of gnuplot options which can be negated using `gnuplot-negate-option'.")
+
+(defvar gnuplot--negatable-options-regexp
+  (gnuplot--make-regexp gnuplot--keywords-negatable-options))
+
+;; Set up colorization for gnuplot.
+(defvar gnuplot-font-lock-keywords
+  `(; stuff in brackets
+    ("\\[\\([^]]+\\)\\]" (1 'font-lock-constant-face))
+
+    ;; variable/function definitions
+    ("\\(\\(\\sw\\|\\s_\\)+\\s-*\\((\\s-*\\(\\sw\\|\\s_\\)*\\s-*\\(,\\s-*\\sw*\\)*\\s-*)\\)?\\s-*=\\)[^=]"
+     (1 'font-lock-variable-name-face))
+
+    ;; built-in function names
+    (,(gnuplot--make-regexp gnuplot--keywords-builtin-functions)
+     (0 'font-lock-function-name-face))
+
+    ;; reserved words associated with plotting
+    (,(gnuplot--make-regexp gnuplot--keywords-plotting)
+     (0 'font-lock-type-face))
+    (,(gnuplot--make-regexp gnuplot--keywords-plotting-styles)
+     (0 'font-lock-function-name-face))
+
+    ;; (s)plot -- also thing (s)plotted
+    ("\\<s?plot\\>" (0 'font-lock-keyword-face))
+    ;; ("\\<s?plot\\s-+\\([^'\" ]+\\)[) \n,\\\\]"
+    ;;  (1 'font-lock-variable-name-face))
+
+    ;; other common commands
+    (,(gnuplot--make-regexp gnuplot--keywords-misc)
+     (0 'font-lock-constant-face))
+    ("!.*$" (0 'font-lock-constant-face))))
+
+(defvar gnuplot-font-lock-defaults
+  '(gnuplot-font-lock-keywords
+    nil                           ; Use syntactic fontification
+    t                             ; Use case folding
+    nil                           ; No extra syntax
+    ;; calls `gnuplot--beginning-of-continuation'
+    ;; to find a safe place to begin syntactic highlighting
+    beginning-of-defun))
+
+;; Some corner cases in Gnuplot's comment and string syntax are
+;; difficult to handle accurately using Emacs's built-in syntax tables
+;; and parser:
+;;
+;; - strings can continue over several lines, but only by using a
+;;   backslash to escape the newline
+;;
+;; - double-quoted strings can contain escaped quotes, \", and escaped
+;;   backslashes, \\; but in single-quoted strings the quote is
+;;   escaped by doubling it, '', and backslash is only special at
+;;   end-of-line
+;;
+;; - either type of string can end at newline without needing a
+;; - closing delimiter
+;;
+;; - comments continue over continuation lines
+;;
+;; The following syntax-propertize rules should accurately mark string
+;; and comment boundaries using the "generic string fence" and
+;; "generic comment fence" syntax properties.
+(defalias 'gnuplot--syntax-propertize
+  (syntax-propertize-rules
+   ;; Double quoted strings
+   ((rx
+     (group "\"")
+     (* (or (seq "\\" anything)
+            (not (any "\"" "\n"))))
+     (group (or "\"" "\n" buffer-end)))
+    (1 "|") (2 "|"))
+
+   ;; Single quoted strings
+   ((rx
+     (group "'")
+     (* (or (seq "\\" "\n")
+            "''"
+            (not (any "'" "\n"))))
+     (group (or "'" "\n" buffer-end)))
+    (1 "|") (2 "|"))
+
+   ;; Comments
+   ((rx
+     (group "#")
+     (* (or (seq "\\" "\n")
+            any))
+     (or (group "\n") buffer-end))
+    (1 "!") (2 "!"))))
+
+(defun gnuplot--syntax-propertize-extend-region (start end)
+  "Expand the region to `syntax-propertize' for strings and comments.
+
+Region range is START to END.
+Ensures that the region being searched begins and ends outside of
+any lines continued with a backslash.
+
+This function is added to `syntax-propertize-extend-region-functions'
+in `gnuplot-mode' buffers."
+  (let ((continuation-start
+         (min start
+              (gnuplot--point-at-beginning-of-continuation start)))
+        (continuation-end
+         (max end
+              (gnuplot--point-at-end-of-continuation end))))
+    (if (and (= continuation-start start)
+             (= continuation-end end))
+        nil
+      (cons continuation-start continuation-end))))
+
+;; Parsing utilities to tell if we are inside a string or comment
+(defun gnuplot--in-string (&optional where)
+  "Return non-nil if the text at WHERE is within a string.
+
+If WHERE is omitted, defaults to text at point.
+This is a simple wrapper for `syntax-ppss'."
+  (save-excursion
+    (let ((parse-state (syntax-ppss where)))
+      (nth 3 parse-state))))
+
+(defun gnuplot--in-comment (&optional where)
+  "Return non-nil if the text at WHERE is within a comment.
+
+If WHERE is omitted, defaults to text at point.
+This is a simple wrapper for `syntax-ppss'."
+  (save-excursion
+    (let ((parse-state (syntax-ppss where)))
+      (nth 4 parse-state))))
+
+(defun gnuplot--in-string-or-comment (&optional where)
+  "Return non-nil if the text at WHERE is within a string or comment.
+
+If WHERE is omitted, defaults to text at point.
+This is a simple wrapper for `syntax-ppss'."
+
+  (save-excursion
+    (let ((parse-state (syntax-ppss where)))
+      (or (nth 3 parse-state)
+          (nth 4 parse-state)))))
+
+
+;;; --- functions for sending commands to gnuplot
+
+(defun gnuplot--split-string (string)
+  "Break STRING at each carriage return, returning a list of lines."
+  (let ((list ()) (line "") (index 0))
+    (while (< index (length string))
+      (if (char-equal (elt string index) ?\n)
+          (setq list (append list (list line))
+                line "")
+        (setq line (concat line (char-to-string (elt string index)))))
+      (setq index (1+ index)))
+    list))
+
+;; -- the calls to `sleep-for' are to allow enough time for gnuplot
+;;    to write to the buffer before the next line is inserted
+;; -- note that the input string is split into lines and each line is
+;;    sent to gnuplot individually.  this is a bit slow, but it puts
+;;    each line on the comint history.
+(defun gnuplot-send-string-to-gnuplot (string text)
+  "Sends STRING to the gnuplot program.
+If no gnuplot process exists, a new one is created.  TEXT indicates
+the type of text being sent to gnuplot and is typically one of
+nil, `line', `region', `buffer', or `file'.  TEXT may be useful for
+functions in `gnuplot-after-plot-hook'.  `gnuplot-after-plot-hook' is
+called by this function after all of STRING is sent to gnuplot."
+  (gnuplot--make-comint-buffer)         ; make sure a gnuplot buffer exists
+  (setq gnuplot--comint-recent-buffer (current-buffer))
+
+  ;; Create a gnuplot frame if needed
+  (when (and (equal gnuplot-display-process 'frame)
+             (not (frame-live-p gnuplot--process-frame)))
+    (let ((frame (selected-frame)))
+      (setq gnuplot--process-frame (make-frame))
+      (select-frame gnuplot--process-frame)
+      (switch-to-buffer gnuplot-buffer)
+      (delete-other-windows)
+      (select-frame frame)))
+
+  (let ((list (gnuplot--split-string string)))
+    (with-current-buffer (get-buffer gnuplot-buffer)
+      (goto-char (point-max))
+      ;; bruce asks: what is this next line for?
+      (set-marker (process-mark gnuplot-process) (point-marker))
+      (sleep-for (* 10 gnuplot-delay))
+      (while list
+        (insert (car list))
+        (comint-send-input)
+        (sleep-for gnuplot-delay)
+        (setq list (cdr list))
+        (goto-char (point-max))))
+
+    (cond ((equal gnuplot-display-process 'window)
+           (gnuplot--display-and-recenter-comint-buffer))
+          ((equal gnuplot-display-process 'frame)
+           ;;(raise-frame gnuplot--process-frame)
+           (with-selected-frame gnuplot--process-frame
+             (gnuplot--display-and-recenter-comint-buffer))))
+
+    (setq gnuplot-recently-sent text)
+    (run-hooks 'gnuplot-after-plot-hook)))
+
+(defun gnuplot--display-and-recenter-comint-buffer ()
+  "Make sure the gnuplot comint buffer is displayed.
+Move point to the end if necessary."
+  (save-selected-window
+    (select-window (display-buffer (get-buffer gnuplot-buffer)))
+    (goto-char (point-max))
+    (unless (pos-visible-in-window-p (point) (selected-window)) (recenter 5))))
+
+(defun gnuplot-send-region-to-gnuplot (&optional begin end text)
+  "Sends a selected region to the gnuplot program.
+If BEGIN and END are not specified, point and mark are used.  TEXT
+indicates the type of text being sent to gnuplot.  This will be
+`region' unless explicitly set by a function calling this one.  Other
+typical values are of nil, `line', `buffer', or `file'.  TEXT may be
+useful for function in `gnuplot-after-plot-hook'."
+  (interactive "r" gnuplot-mode)
+  (let (string (txt (or text 'region)))
+    (setq string (buffer-substring-no-properties begin end))
+    (unless (equal (substring string -1) "\n")
+      (setq string (concat string "\n")))
+    (gnuplot-send-string-to-gnuplot string txt)))
+
+(defun gnuplot-send-line-to-gnuplot ()
+  "Sends the current line to the gnuplot program.
+Respects continuation lines.
+This sets `gnuplot-recently-sent' to `line'."
+  (interactive nil gnuplot-mode)
+  (let (start end)
+    (save-excursion
+      ;; go to start of continued command, or beginning of line
+      ;; if this is not a continuation of a previous line
+      (gnuplot--beginning-of-continuation)
+      (setq start (point))
+      (end-of-line)
+      (while (save-excursion
+               (backward-char)
+               (looking-at "\\\\"))      ; go to end of last continuation line
+        (end-of-line 2))
+      (beginning-of-line 2)
+      (setq end (point)))
+    (unless (string-match "\\`\\s-*\\'"
+                          (buffer-substring-no-properties start end))
+      (gnuplot-send-region-to-gnuplot start end 'line))
+    end))
+
+;; I chose a very easy to type but slightly non-mnemonic key-binding
+;; for this (C-c C-v).  It seems like the kind of thing one would want
+;; to do repeatedly without incurring RSI. 8^)
+(defun gnuplot-send-line-and-forward (&optional num)
+  "Call `gnuplot-send-line-to-gnuplot' and move forward 1 line.
+You can use a numeric prefix to send more than one line.  Blank lines and
+lines with only comments are skipped when moving forward.
+NUM is optional arg."
+  (interactive "p" gnuplot-mode)
+  (let (end)
+    (while (> num 0)
+      (setq end (gnuplot-send-line-to-gnuplot))
+      (goto-char end)
+      (backward-char 1)
+      (gnuplot-forward-script-line 1)
+      (setq num (1- num)))))
+
+(defun gnuplot-send-line-and-newline ()
+  "Call `gnuplot-send-line-to-gnuplot' and insert a new line."
+  (interactive nil gnuplot-mode)
+  (end-of-line)
+  (gnuplot-send-line-to-gnuplot)
+  (insert "\n"))
+
+(defun gnuplot-forward-script-line (&optional num)
+  "Move forward my NUM script lines.
+Blank lines and commented lines are not included in the NUM count."
+  (interactive "p" gnuplot-mode)
+  (while (> num 0)
+    (and (not (eobp)) (forward-line 1))
+    (while (and (not (eobp))
+                (or (looking-at "^\\s-*$")
+                    (looking-at "^\\s-*#")))
+      (forward-line 1))
+    (setq num (1- num))))
+
+(defun gnuplot-send-buffer-to-gnuplot ()
+  "Sends the entire buffer to the gnuplot program.
+This sets `gnuplot-recently-sent' to `buffer'."
+  (interactive nil gnuplot-mode)
+  (gnuplot-send-region-to-gnuplot (point-min) (point-max) 'buffer))
+
+(defun gnuplot-send-file-to-gnuplot ()
+  "Sends a selected file to the gnuplot program using the \"load\" command.
+This sets `gnuplot-recently-sent' to `file'."
+  (interactive)
+  (let ((string (read-file-name "Name of file to send to gnuplot > " nil nil t)))
+    (setq string (concat "load '" (expand-file-name string) "'\n"))
+    (message "%S" string)
+    (gnuplot--make-comint-buffer)       ; make sure a gnuplot buffer exists
+    (gnuplot-send-string-to-gnuplot string 'file)))
+
+(defun gnuplot-plot-from-comint ()
+  "Send the contents of a script to gnuplot from the process buffer.
+This inserts the contents of the most recently used gnuplot script
+into the process buffer and sends those lines to gnuplot.  It does
+this by copying the script line by line."
+  (interactive nil gnuplot-comint-mode)
+  (unless (buffer-live-p gnuplot--comint-recent-buffer)
+    (error "Script buffer has been deleted"))
+  (let (string list (buffer (current-buffer)))
+    (set-buffer gnuplot--comint-recent-buffer)
+    (setq string (buffer-substring-no-properties (point-min) (point-max))
+          string (concat string "\n")
+          list   (gnuplot--split-string string))
+    (set-buffer buffer)
+    (while list
+      (insert (car list))
+      (comint-send-input)
+      (sleep-for gnuplot-delay)
+      (setq list (cdr list)))
+    (comint-send-input)))
+
+(defun gnuplot-save-and-plot-from-comint ()
+  "Send a current script to gnuplot from the process buffer.
+This sends the most recently used gnuplot script to gnuplot using the
+\"load\" command.  This function first saves the script buffer to a
+file, prompting for a filename if one is not associated with the script
+buffer.  Then it sends a load command to gnuplot using the name of the
+file visited by the script buffer."
+  (interactive nil gnuplot-comint-mode)
+  (unless (buffer-live-p gnuplot--comint-recent-buffer)
+    (error "Script buffer has been deleted"))
+  (let (fname)
+    (with-current-buffer gnuplot--comint-recent-buffer
+      (save-buffer)
+      (setq fname (buffer-file-name)))
+    (goto-char (point-max))
+    (insert (format "load '%s'" fname))
+    (comint-send-input)))
+
+(defun gnuplot-pop-to-recent-buffer ()
+  "Switch to the most recently-plotted gnuplot script buffer."
+  (interactive)
+  (when (buffer-live-p gnuplot--comint-recent-buffer)
+    (pop-to-buffer gnuplot--comint-recent-buffer)))
+
+(defun gnuplot-trim-comint-buffer ()
+  "Trim lines from the beginning of the *gnuplot* buffer.
+This keeps that buffer from growing excessively in size.  Normally,
+this function is attached to `gnuplot-after-plot-hook'"
+  (when (> gnuplot-buffer-max-size 0)
+    (with-current-buffer gnuplot-buffer
+      (let ((gnuplot-lines (count-lines (point-min) (point-max))))
+        (dotimes (_n (- gnuplot-lines gnuplot-buffer-max-size))
+          (goto-char (point-min))
+          (delete-region (line-beginning-position) (1+ (line-end-position))))
+        (goto-char (point-max))))))
+
+
+;;; --- functions controlling the gnuplot process
+
+(defvar-keymap gnuplot-comint-mode-map
+  :doc "Keymap used by `gnuplot-comint-mode'."
+  :parent comint-mode-map
+  "C-M-p"   #'gnuplot-plot-from-comint
+  "C-M-f"   #'gnuplot-save-and-plot-from-comint
+  "C-d"      #'gnuplot-delchar-or-maybe-eof
+  "M-TAB"    #'completion-at-point
+  "C-c C-d"  #'gnuplot-info-lookup-symbol
+  "C-c C-i"  #'gnuplot-insert-filename
+  "C-c C-n"  #'gnuplot-negate-option
+  "C-c C-z"  #'gnuplot-customize
+  "C-c C-e"  #'gnuplot-pop-to-recent-buffer)
+
+(easy-menu-define
+  gnuplot-comint-mode-menu gnuplot-comint-mode-map
+  "Menu used in `gnuplot-comint-mode'."
+  `("Gnuplot"
+    ["Plot most recent gnuplot buffer"          gnuplot-plot-from-comint
+     (buffer-live-p gnuplot--comint-recent-buffer)]
+    ["Save and plot most recent gnuplot buffer"         gnuplot-save-and-plot-from-comint
+     (buffer-live-p gnuplot--comint-recent-buffer)]
+    "---"
+    ,gnuplot--display-options-menu
+    ["Contextual completion and help"           gnuplot-context-sensitive-mode
+     :style toggle
+     :selected gnuplot-context-sensitive-mode]
+    ["Echo area help (eldoc-mode)" eldoc-mode
+     :active gnuplot-context-sensitive-mode
+     :style toggle
+     :selected eldoc-mode]
+    "---"
+    ["Insert filename at point"                         gnuplot-insert-filename t]
+    ["Negate set option"                        gnuplot-negate-option t]
+    ["Keyword help"                             gnuplot-info-lookup-symbol]
+    ["Quick help for thing at point"            gnuplot-context-help-at-point
+     gnuplot-context-sensitive-mode]
+    ["Info documentation on thing at point"
+     gnuplot-context-info-at-point
+     gnuplot-context-sensitive-mode]
+    ["Switch to recent gnuplot script buffer"   gnuplot-pop-to-recent-buffer
+     (buffer-live-p gnuplot--comint-recent-buffer)]
+    "---"
+    ["Customize gnuplot"                        gnuplot-customize t]
+    "---"
+    ["Kill gnuplot"                             gnuplot-kill-comint-buffer t]))
+
+;; Major mode `gnuplot-comint-mode' for the interaction buffer
+(define-derived-mode gnuplot-comint-mode comint-mode "Gnuplot interaction"
+  "Major mode for interacting with a gnuplot process in a buffer.
+
+This sets font-lock and keyword completion in the comint/gnuplot
+buffer."
+  :interactive nil
+  :syntax-table gnuplot-mode-syntax-table
+  :abbrev-table gnuplot-mode-abbrev-table
+
+  (setq-local font-lock-defaults gnuplot-font-lock-defaults
+              parse-sexp-lookup-properties t
+              syntax-propertize-function #'gnuplot--syntax-propertize)
+
+  (add-hook 'kill-buffer-hook #'gnuplot--close-down nil t)
+  (add-hook 'comint-output-filter-functions
+            #'comint-postoutput-scroll-to-bottom
+            nil t)
+  (add-hook 'comint-output-filter-functions
+            #'gnuplot--protect-prompt-fn
+            nil t)
+  (add-hook 'completion-at-point-functions #'gnuplot-completion-at-point-info-look nil t))
+
+(defun gnuplot--make-comint-buffer ()
+  "Switch to the gnuplot program buffer or create one if none exists."
+  (unless (and gnuplot-process (eq (process-status gnuplot-process) 'run)
+               (buffer-live-p gnuplot-buffer))
+    (setq gnuplot-buffer (apply #'make-comint gnuplot-process-name gnuplot-program nil
+                                (and gnuplot-program-args (split-string gnuplot-program-args)))
+          gnuplot-process (get-buffer-process gnuplot-buffer))
+    (set-process-query-on-exit-flag gnuplot-process nil)
+    (with-current-buffer gnuplot-buffer
+      (gnuplot-comint-mode)
+      (when gnuplot-inline-image-mode
+        (sleep-for (* 10 gnuplot-delay))
+        (gnuplot--setup-comint-for-image-mode)))))
+
+(defvar gnuplot--prompt-regexp
+  (regexp-opt '("gnuplot> " "multiplot> "))
+  "Regexp for recognizing the GNUPLOT prompt.")
+
+(defun gnuplot--protect-prompt-fn (_string)
+  "Prevent the Gnuplot prompt from being deleted or overwritten.
+STRING is the text as originally inserted in the comint buffer."
+  (save-excursion
+    (goto-char (point-max))
+    (beginning-of-line)
+    (let ((b (point)) e)
+      (when (re-search-forward gnuplot--prompt-regexp (point-max) t)
+        (setq e (point))
+        (put-text-property b e 'rear-nonsticky '(read-only intangible face))
+        (put-text-property b e 'intangible t)
+        ;;(put-text-property b e 'read-only t)
+        ))))
+
+(defun gnuplot--close-down ()
+  "Tidy up when deleting the gnuplot buffer."
+  (if (and gnuplot-process
+           (eq (process-status gnuplot-process) 'run))
+      (kill-process gnuplot-process))
+  (setq gnuplot-process nil
+        gnuplot-buffer nil))
+
+(defun gnuplot-delchar-or-maybe-eof (arg)
+  "Delete ARG characters forward, or (if at eob) send an EOF to subprocess.
+This is very similar to `comint-delchar-or-maybe-eof'."
+  (interactive "p" gnuplot-comint-mode)
+  (if (eobp)
+      (gnuplot-kill-comint-buffer)
+    (delete-char arg)))
+
+(defun gnuplot-kill-comint-buffer ()
+  "Kill the gnuplot process and its display buffers."
+  (interactive)
+  (if (and gnuplot-process
+           (eq (process-status gnuplot-process) 'run))
+      (kill-process gnuplot-process))
+  (when (and gnuplot-buffer (get-buffer gnuplot-buffer))
+    (if (one-window-p) ()
+      (delete-window (get-buffer-window gnuplot-buffer)))
+    (kill-buffer gnuplot-buffer))
+  (setq gnuplot-process nil
+        gnuplot-buffer nil))
+
+(defun gnuplot-show-comint-buffer ()
+  "Switch to the buffer containing the gnuplot process.
+When `gnuplot-display-process' is nil this will switch to
+the gnuplot process buffer.  When that variable is non-nil, the
+gnuplot process buffer will be displayed in a window."
+  (interactive)
+  (unless (and gnuplot-buffer (get-buffer gnuplot-buffer))
+    (gnuplot--make-comint-buffer))
+  (cond ((equal gnuplot-display-process 'window)
+         (switch-to-buffer-other-window gnuplot-buffer))
+        ((equal gnuplot-display-process 'frame)
+         (or (frame-live-p gnuplot--process-frame)
+             (setq gnuplot--process-frame (make-frame)))
+         (raise-frame gnuplot--process-frame)
+         (select-frame gnuplot--process-frame)
+         (switch-to-buffer gnuplot-buffer))
+        (t
+         (switch-to-buffer gnuplot-buffer))))
+
+
+;;; Support for displaying plotted images within Emacs
+
+(defvar gnuplot--inline-image-filename nil
+  "Name of the current Gnuplot output file.")
+
+(defun gnuplot-external-display-mode ()
+  "Display image in external."
+  (interactive nil gnuplot-mode gnuplot-comint-mode)
+  (gnuplot--set-display-mode 'gnuplot-inline-image-mode nil))
+
+(defun gnuplot-inline-display-mode ()
+  "Display image in inline."
+  (interactive nil gnuplot-mode gnuplot-comint-mode)
+  (gnuplot--set-display-mode 'gnuplot-inline-image-mode 'inline))
+
+(defun gnuplot-dedicated-display-mode ()
+  "Display image in dedicated."
+  (interactive nil gnuplot-mode gnuplot-comint-mode)
+  (gnuplot--set-display-mode 'gnuplot-inline-image-mode 'dedicated))
+
+(defun gnuplot-set-image-format (format)
+  "Display image in FORMAT."
+  (interactive "sGnuplot image format: " gnuplot-mode gnuplot-comint-mode)
+  (gnuplot--set-display-mode 'gnuplot-image-format format)
+  (unless gnuplot-inline-image-mode
+    (message "Setting will take effect when plots are displayed in Emacs")))
+
+(defun gnuplot--setup-comint-for-image-mode ()
+  "Setup comint for image."
+  (when (and (buffer-live-p gnuplot-buffer) (get-buffer-process gnuplot-buffer))
+    (with-current-buffer gnuplot-buffer
+      (if gnuplot-inline-image-mode
+          (progn
+            (gnuplot-send-hiding-output
+             (format "set terminal %s\n" gnuplot-image-format))
+            (gnuplot--inline-image-set-output)
+            (add-hook 'comint-output-filter-functions
+                      #'gnuplot--insert-inline-image-output nil t))
+        (gnuplot-send-hiding-output "set terminal pop\n")
+        (remove-hook 'comint-output-filter-functions
+                     #'gnuplot--insert-inline-image-output t)))))
+
+(defun gnuplot--inline-image-set-output ()
+  "Set Gnuplot's output file to `gnuplot--inline-image-filename'."
+  (let ((tmp (make-temp-file "gnuplot")))
+    (setq gnuplot--inline-image-filename tmp)
+    (gnuplot-send-hiding-output (format "set output '%s'\n" tmp))))
+
+(defvar gnuplot--inhibit-filter nil)
+
+(defun gnuplot--insert-inline-image-output (_string)
+  "Insert Gnuplot graphical output STRING in the gnuplot-comint buffer.
+
+Called via `comint-preoutput-filter-functions' hook when
+`gnuplot-inline-image-mode' is enabled.  Checks the status of the
+file `gnuplot--inline-image-filename'; if it exists and has
+nonzero size, inserts it as an inline image, stores a new
+temporary filename in `gnuplot--inline-image-filename', and
+updates Gnuplot with the appropriate \"set output\" command."
+  (unless gnuplot--inhibit-filter        ; Prevent recursively entering this filter
+    (let ((gnuplot--inhibit-filter t))   ; (causing an infinite loop)
+      (save-excursion
+        (goto-char (point-max))
+        (beginning-of-line)
+        (when (looking-at gnuplot--prompt-regexp)
+          (let* ((filename gnuplot--inline-image-filename)
+                 (size (nth 7 (file-attributes filename))))
+            (when (and size (> size 0))
+              (gnuplot-send-hiding-output "set output\n") ; Flush output file
+              (sit-for 0.1)             ; Hack: wait for Gnuplot IO to finish
+              (cl-ecase gnuplot-inline-image-mode
+                ((nil) nil)
+                (inline
+                  (ignore-errors
+                    (let ((image (create-image filename)))
+                      (beginning-of-line)
+                      (insert-image image)
+                      (insert "\n")
+                      (gnuplot--inline-image-set-output))))
+                (dedicated
+                 (with-current-buffer (get-buffer-create gnuplot-image-buffer)
+                   (let ((inhibit-read-only t))
+                     (erase-buffer)
+                     (insert-file-contents filename)
+                     (ignore-errors (normal-mode))
+                     (display-buffer (current-buffer))
+                     (gnuplot--inline-image-set-output))))))))))))
+
+(defun gnuplot-send-hiding-output (string)
+  "Send STRING to the running Gnuplot process invisibly."
+  (with-current-buffer gnuplot-buffer
+    (add-hook 'comint-preoutput-filter-functions
+              #'gnuplot--discard-output nil t))
+  (with-current-buffer (get-buffer-create gnuplot-hidden-output-buffer)
+    (erase-buffer))
+  (comint-send-string (get-buffer-process gnuplot-buffer) string))
+
+(defun gnuplot--discard-output (string)
+  "Temporary preoutput filter for hiding Gnuplot output & prompt.
+Accumulates output STRING in a buffer until it finds the next prompt,
+then removes itself from `comint-preoutput-filter-functions'."
+  (with-current-buffer
+      (get-buffer-create gnuplot-hidden-output-buffer)
+    (insert string)
+    (when (looking-back gnuplot--prompt-regexp (point-min))
+      (with-current-buffer gnuplot-buffer
+        (remove-hook 'comint-preoutput-filter-functions
+                     #'gnuplot--discard-output t))))
+  "")
+
+
+;;; --- miscellaneous functions: insert file name, indentation, negation
+
+(defun gnuplot-insert-filename ()
+  "Insert a filename at point, prompting for name in the minibuffer.
+This inserts a filename relative to the buffer's default directory.
+Uses completion and the value of `gnuplot-quote-character'.
+Bound to \\[gnuplot-insert-filename]"
+  (interactive nil gnuplot-mode gnuplot-comint-mode)
+  (insert gnuplot-quote-character
+          (file-relative-name (read-file-name "Filename > " "")
+                              default-directory)
+          gnuplot-quote-character))
+
+;; Adjust indentation for the line containing point
+(defun gnuplot-indent-line ()
+  "Set indentation in gnuplot buffer.
+For most lines, set indentation to previous level of indentation.
+Add additional indentation for continuation lines."
+  (interactive nil gnuplot-mode)
+  (let (indent)
+    (if (gnuplot--in-string (line-beginning-position))
+        ;; Continued strings begin at left margin
+        (setq indent 0)
+      (save-excursion
+        (if (gnuplot--continuation-line-p)
+            ;; This is a continuation line. Indent to the same level as
+            ;; the second word on the line beginning this command (i.e.,
+            ;; the first non-whitespace character after whitespace)
+            (progn
+              (gnuplot--beginning-of-continuation)
+              (back-to-indentation)
+              (re-search-forward "\\S-+\\s-+" (line-end-position) 'end-at-limit)
+              (setq indent (current-column)))
+
+          ;; Not a continuation line; indent according to block
+          ;; nesting depth
+          (save-excursion
+            (condition-case nil
+                (progn
+                  (beginning-of-line)
+                  (skip-syntax-forward "-" (line-end-position))
+                  (if (looking-at "\\s)") (forward-char))
+                  (backward-up-list)
+                  (gnuplot--beginning-of-continuation)
+                  (setq indent (+ gnuplot-basic-offset (current-indentation))))
+              (error
+               (setq indent 0)))))))
+
+    ;; Set indentation
+    (save-excursion
+      (indent-line-to indent))
+
+    ;; Move point after indentation when at beginning of line
+    (when (< (current-column) indent)
+      (move-to-column indent))))
+
+(defun gnuplot-electric-insert (BRACE)
+  "Adjust indentation on inserting a close BRACE.
+The blink-paren fix is stolen from cc-mode"
+  (interactive "*p" gnuplot-mode)
+  (let ((old-blink-paren blink-paren-function)
+        (blink-paren-function nil))
+    (self-insert-command BRACE)
+    (gnuplot-indent-line)
+    (when old-blink-paren (funcall old-blink-paren))))
+
+;;
+;; Functions for finding the start and end of continuation blocks
+;;
+
+;; Check if line containing point is a continuation
+(defun gnuplot--continuation-line-p ()
+  "Return t if the line containing point is a continuation of the previous line."
+  (save-excursion
+    (condition-case ()
+        (progn
+          (end-of-line 0)
+          (backward-char)
+          (looking-at "\\\\"))
+      (error nil))))
+
+;; Move point to start of continuation block
+(defun gnuplot--beginning-of-continuation ()
+  "Move point to the beginning of the continuation lines containing point.
+
+If not in a continuation line, move point to beginning of line."
+  (beginning-of-line)
+  (while (gnuplot--continuation-line-p)
+    (beginning-of-line 0)))
+
+;; Move point to end of continuation block
+(defun gnuplot--end-of-continuation ()
+  "Move point to the end of the continuation lines containing point.
+
+If there are no continuation lines, move point to `end-of-line'."
+  (end-of-line)
+  (unless (bobp)
+    (catch 'eob
+      (while (save-excursion (backward-char)
+                             (looking-at "\\\\"))
+        (end-of-line 2)
+        (if (eobp) (throw 'eob nil))))))
+
+;; Save-excursion wrappers for the above to return point at beginning
+;; or end of continuation
+(defun gnuplot--point-at-beginning-of-continuation (&optional pos)
+  "Return value of point at beginning of the continued block containing point.
+
+If there are no continuation lines, returns `line-beginning-position'.
+If specify POS, move POS befere execution."
+  (save-excursion
+    (when pos (goto-char pos))
+    (gnuplot--beginning-of-continuation)
+    (point)))
+
+(defun gnuplot--point-at-end-of-continuation (&optional pos)
+  "Return value of point at the end of the continued block containing point.
+
+If there are no continuation lines, returns `line-end-position'.
+If specify POS, move POS before execution."
+  (save-excursion
+    (when pos (goto-char pos))
+    (gnuplot--end-of-continuation)
+    (point)))
+
+(defun gnuplot--beginning-of-defun (&optional arg)
+  "We also treat a block of continuation lines as a `defun'.
+ARG is optional arg."
+  (unless arg (setq arg 1))
+  (if (> arg 0)
+      (catch 'bob               ; go to beginning of ARGth prev. defun
+        (dotimes (_n arg)
+          (when (= (point)
+                   (gnuplot--point-at-beginning-of-continuation))
+            (forward-line -1)
+            (if (bobp) (throw 'bob t))
+            (while (looking-at "^\\s-*$")
+              (forward-line -1)
+              (if (bobp) (throw 'bob t))))
+          (gnuplot--beginning-of-continuation))
+        t)
+
+    (catch 'eob                   ; find beginning of (-ARG)th following defun
+      (dotimes (_n (- arg))
+        (gnuplot--end-of-continuation)
+        (forward-line)
+        (if (eobp) (throw 'eob t))
+        (while (looking-at "^\\s-*$")
+          (forward-line)
+          (if (eobp) (throw 'eob t)))))))
+
+;; Movement to start or end of command, including multiple commands
+;; separated by semicolons
+(defun gnuplot--beginning-of-command ()
+  "Move point to beginning of command containing point."
+  (let ((limit (gnuplot--point-at-beginning-of-continuation)))
+    (while
+        (and
+         (search-backward ";" limit 'lim)
+         (gnuplot--in-string-or-comment)))
+    (skip-chars-forward ";")
+    (skip-syntax-forward "-")))
+
+(defun gnuplot--end-of-command ()
+  "Move point to end of command containing point."
+  (let ((limit (gnuplot--point-at-end-of-continuation)))
+    (while
+        (and
+         (search-forward ";" limit 'lim)
+         (gnuplot--in-string-or-comment)))
+    (skip-chars-backward ";")
+    (skip-syntax-backward "-")))
+
+(defun gnuplot--point-at-beginning-of-command ()
+  "Return position at the beginning of command containing point."
+  (save-excursion (gnuplot--beginning-of-command) (point)))
+
+(defun gnuplot--point-at-end-of-command ()
+  "Return position at the end of command containing point."
+  (save-excursion (gnuplot--end-of-command) (point)))
+
+(defun gnuplot-negate-option ()
+  "Append \"no\" to or remove \"no\" from the set option on the current line.
+This checks if the set option is one which has a negated form.
+
+Negatable options are defined in `gnuplot--keywords-negatable-options'."
+  (interactive nil gnuplot-mode gnuplot-comint-mode)
+  (let ((begin (gnuplot--point-at-beginning-of-command))
+        (end   (gnuplot--point-at-end-of-command))
+        (regex gnuplot--negatable-options-regexp))
+    (save-excursion
+      (goto-char begin)
+      (skip-syntax-forward "-" end)
+      (if (looking-at "\\(un\\)?set\\s-+")
+          (cond ((looking-at "unset")
+                 (delete-char 2))
+                ((looking-at (concat "set\\s-+\\(" regex "\\)"))
+                 (insert "un"))
+                (t
+                 (message "There is not a negatable set option on this line")))
+        (message "There is not a set option on this line")))))
+
+(defun gnuplot-customize ()
+  "Customize `gnuplot-mode'."
+  (interactive nil gnuplot-mode gnuplot-comint-mode)
+  (customize-group "gnuplot"))
+
+
+;;; --- help from the info file, keyword list + completion, insert function
+
+(defun gnuplot--setup-info-look ()
+  "Setup info-look in the gnuplot buffer.
+Also set the variable `gnuplot--info-keywords'."
+  ;; TODO Update info layout
+  (let ((doc-spec
+         '(("(gnuplot)Command_Index"   nil "[_a-zA-Z0-9]+")
+           ("(gnuplot)Options_Index"   nil "[_a-zA-Z0-9]+")
+           ("(gnuplot)Function_Index"  nil "[_a-zA-Z0-9]+")
+           ("(gnuplot)Terminal_Index"  nil "[_a-zA-Z0-9]+"))))
+    (info-lookup-add-help
+     :mode 'gnuplot-mode :topic 'symbol
+     :regexp "[a-zA-Z][_a-zA-Z0-9]*"
+     :doc-spec doc-spec)
+    (info-lookup-add-help
+     :mode 'gnuplot-comint-mode :topic 'symbol
+     :regexp "[a-zA-Z][_a-zA-Z0-9]*"
+     :doc-spec doc-spec))
+
+  (let ((there (bufferp (get-buffer "*info*"))))
+    (info-lookup-setup-mode 'symbol 'gnuplot-mode)
+    (or there (and (get-buffer "*info*") (kill-buffer "*info*")))
+    ;; why are these buffers here?  I think that the general
+    ;; user will not want them lying around
+    (and (get-buffer "info dir")    (kill-buffer "info dir"))
+    (and (get-buffer "info dir<2>") (kill-buffer "info dir<2>")))
+  (setq gnuplot--info-keywords (gnuplot--set-keywords-list)))
+
+(defun gnuplot--set-keywords-list ()
+  "Set `gnuplot--info-keywords' from `info-lookup-cache'.
+Return a list of keywords."
+  (let* ((list (cdr (assoc 'symbol info-lookup-cache)))
+         (list (cdr (cdr (assoc 'gnuplot-mode list))))
+         (list (car list))
+         (store ()) item)
+    (while list
+      (setq item (car (car list))
+            item (format "%s" item) ; keep this line for the sake of
+            store (append (list item) store) ; info-look.el w/o my patch
+            list  (cdr list)))
+    (delete "nil" store)
+    store ))
+
+
+;;;; Completion at point and Eldoc.
+
+;; There are two alternative completion-at-point mechanisms: the old
+;; one using info-look and the new one (enabled by default) which
+;; parses the command line to provide smarter completions.
+
+;; Older completion method using info-look
+(defun gnuplot-completion-at-point-info-look ()
+  "Return completions of keyword preceding point.
+
+Uses the cache of keywords generated by `info-lookup'.  See
+`gnuplot--setup-info-look'.  If non-nil, the return value is in the form
+\(BEGIN END COMPLETIONS) where BEGIN and END are buffer
+positions and COMPLETIONS is a list."
+
+  (when (eq gnuplot--info-keywords 'pending)
+    (gnuplot--setup-info-look))
+  (list (condition-case _err
+            (save-excursion (backward-sexp 1) (point))
+          (error (point)))
+        (point) gnuplot--info-keywords))
+
+
+(defun gnuplot-info-lookup-symbol (symbol &optional mode)
+  "Wrapper for `info-lookup-symbol'.
+Takes SYMBOL and MODE as arguments exactly as
+`info-lookup-symbol'.  After doing the info lookup, calls
+`gnuplot--adjust-info-display' to display the info buffer
+according to the value of `gnuplot-info-display'."
+  (interactive
+   (progn
+     (when (eq gnuplot--info-keywords 'pending)
+       (gnuplot--setup-info-look))
+     (info-lookup-interactive-arguments 'symbol))
+   gnuplot-mode gnuplot-comint-mode)
+  (when (eq gnuplot--info-keywords 'pending)
+    (gnuplot--setup-info-look))
+  (unless symbol (setq symbol "Commands"))
+  (save-window-excursion
+    (info-lookup-symbol symbol mode))
+  (gnuplot--adjust-info-display))
+
+(defun gnuplot--adjust-info-display ()
+  "Displays the *info* buffer in a window or frame.
+Specified by the value of `gnuplot-info-display'.
+If `gnuplot-info-display' is `window', then the window will be
+shrunk to the size of the info entry if it is smaller than half
+the height of the frame.
+
+The *info* buffer should already exist when this function is
+called."
+  (cl-case gnuplot-info-display
+    (window
+     (switch-to-buffer-other-window "*info*")
+     ;; Adjust window height only if the frame is split
+     ;; horizontally, so as not to mess up the minibuffer
+     ;; we can't use shrink-window-if-larger-than-buffer here
+     ;; because it doesn't work with Info mode's narrowing
+     (with-selected-window (get-buffer-window "*info*")
+       (unless (window-full-height-p)
+         (enlarge-window
+          (min (- (count-lines (point-min) (point-max)) (window-height) -1)
+               (- (/ (frame-height) 2) (window-height)))))))
+
+    (frame
+     (unless (frame-live-p gnuplot--info-frame)
+       (setq gnuplot--info-frame (make-frame)))
+     (select-frame gnuplot--info-frame)
+     (raise-frame gnuplot--info-frame)
+     (switch-to-buffer "*info*"))
+
+    (t
+     (switch-to-buffer "*info*"))))
+
+(defun gnuplot-insert (string)
+  "Insert STRING at point and display help for for STRING.
+Help is not shown if `gnuplot-insertions-show-help-flag' is nil.  The
+help shown is for STRING unless STRING begins with the word \"set\" or
+\"show\", in which case help is shown for the thing being set or
+shown."
+  (insert string)
+  (let ((topic string) term)
+    (when (string-match
+           "\\(set\\|show\\)[ \t]+\\([^ \t]+\\)\\(\\s-+\\([^ \t]+\\)\\)?"
+           string)
+      (setq topic (downcase (match-string 2 string))
+            term            (match-string 4 string))
+      (if (equal topic "terminal") (setq topic (downcase term))))
+    (cond ((bound-and-true-p gnuplot-gui-popup-flag)
+           (gnuplot-gui-set-options-and-insert))
+          (gnuplot-insertions-show-help-flag
+           (when (eq gnuplot--info-keywords 'pending)
+             (gnuplot--setup-info-look))
+           (gnuplot-info-lookup-symbol topic)))))
+
+(defun gnuplot-toggle-info-display ()
+  "Toggle info display."
+  (interactive nil gnuplot-mode)
+  (setq gnuplot-insertions-show-help-flag (not gnuplot-insertions-show-help-flag))
+  (message (if gnuplot-insertions-show-help-flag
+               "Help will be displayed after insertions."
+             "Help no longer displayed after insertions.")))
+
+(defun gnuplot--setup-insertions-menu ()
+  "Initial setup of insertions menu."
+  (when (and gnuplot-insertions-menu-flag (not gnuplot--insertions-menu))
+    (easy-menu-define gnuplot--insertions-menu gnuplot-mode-map
+      "Insertions menu used in Gnuplot-mode"
+      `("Insertions"
+        ,@gnuplot-insertions-top
+        ,gnuplot-insertions-adornments
+        ,gnuplot-insertions-plot-options
+        ,gnuplot-insertions-terminal
+        ,gnuplot-insertions-x-axis
+        ,gnuplot-insertions-y-axis
+        ,gnuplot-insertions-z-axis
+        ,gnuplot-insertions-x2-axis
+        ,gnuplot-insertions-y2-axis
+        ,gnuplot-insertions-parametric-plots
+        ,gnuplot-insertions-polar-plots
+        ,gnuplot-insertions-surface-plots
+        ,@gnuplot-insertions-bottom))))
+
+(defun gnuplot--mark-active ()
+  "Return non-nil if the mark is active and it is not equal to point."
+  (condition-case nil
+      (and (mark) (/= (mark) (point)))
+    (error nil)))
+
+
+;;; --- autoloaded functions: gnuplot-mode and gnuplot-make-buffer
+
+;;;###autoload
+(define-derived-mode gnuplot-mode prog-mode "Gnuplot"
+  "Major mode for editing and executing GNUPLOT scripts.
+This was written with version 4.6 of gnuplot in mind, but should
+work with newer and older versions.
+
+Report bugs at https://github.com/emacs-gnuplot/gnuplot/issues
+
+                            ------O------
+
+Gnuplot-mode includes two different systems for keyword completion and
+documentation lookup: a newer one, `gnuplot-context-sensitive-mode' ,
+which is enabled by default, and a older one which extracts keywords
+from gnuplot's Info file.  Both systems allow looking up documentation
+in the Info file.  With the context-sensitive mode active,
+`gnuplot-mode' can also provide Eldoc syntax hints as you type.
+
+                            ------O------
+
+There are several known shortcomings of `gnuplot-mode', version 0.5g
+and up.  Many of the shortcomings involve the graphical interface
+\(refered to as the GUI) to setting arguments to plot options.  Here is
+a list:
+
+ 1.  Currently there is no way for `gnuplot-mode' to know if information
+     sent to gnuplot was correctly plotted.
+ 2.  \"plot\", \"splot\", and \"fit\" are handled in the GUI, but are
+     a bit flaky.  Their arguments may not be read correctly from
+     existing text, and continuation lines (common for plot and splot)
+     are not supported.
+ 3.  The GUI does not know how to read from continuation lines.
+ 4.  Comma separated position arguments to plot options are
+     unsupported in the GUI.  Colon separated datafile modifiers (used
+     for plot, splot, and fit) are not supported either.  Arguments
+     not yet supported by the GUI generate messages printed in grey
+     text.
+ 5.  The GUI handling of \"hidden3d\" is flaky and \"cntrparam\" is
+     unsupported."
+  (setq-local comment-start "# "
+              comment-end ""
+              comment-column 32
+              comment-start-skip "#[ \t]*"
+              indent-line-function #'gnuplot-indent-line
+              beginning-of-defun-function #'gnuplot--beginning-of-defun
+              end-of-defun-function #'gnuplot--end-of-continuation
+              syntax-propertize-function #'gnuplot--syntax-propertize
+              font-lock-defaults gnuplot-font-lock-defaults
+              font-lock-multiline t
+              parse-sexp-lookup-properties t
+              comint-process-echoes gnuplot-echo-command-line-flag)
+  (add-hook 'completion-at-point-functions #'gnuplot-completion-at-point-info-look nil t)
+  (add-hook 'syntax-propertize-extend-region-functions
+            #'gnuplot--syntax-propertize-extend-region nil t)
+  (setq gnuplot--comint-recent-buffer (current-buffer))
+  (gnuplot--setup-insertions-menu))
+
+;;;###autoload
+(defun gnuplot-make-buffer ()
+  "Open a new buffer in `gnuplot-mode'.
+When invoked, it switches to a new, empty buffer visiting no file
+and then starts `gnuplot-mode'.
+
+It is convenient to bind this function to a global key sequence.  For
+example, to make the F10 key open a gnuplot script buffer, put the
+following in your .emacs file:
+     (global-set-key [(f10)] \\='gnuplot-make-buffer)"
+  (interactive)
+  (switch-to-buffer gnuplot-gnuplot-buffer)
+  (gnuplot-mode))
+
+;;;###autoload
+(defun run-gnuplot ()
+  "Run an inferior Gnuplot process."
+  (interactive)
+  (gnuplot-show-comint-buffer))
+
+;;;###autoload
+(progn
+  (add-to-list 'auto-mode-alist '("\\.gp\\'" . gnuplot-mode))
+  (add-to-list 'interpreter-mode-alist '("gnuplot" . gnuplot-mode)))
+
+(provide 'gnuplot)
+;;; gnuplot.el ends here
diff --git a/elpa/gnuplot-20260322.20/gnuplot.info b/elpa/gnuplot-20260322.20/gnuplot.info
new file mode 100644
index 00000000..f132fd30
--- /dev/null
+++ b/elpa/gnuplot-20260322.20/gnuplot.info
@@ -0,0 +1,26562 @@
+This is gnuplot.info, produced by makeinfo version 6.8 from
+gnuplot.texi.
+
+INFO-DIR-SECTION Math
+START-INFO-DIR-ENTRY
+* GNUPLOT: (gnuplot).             An Interactive Plotting Program
+END-INFO-DIR-ENTRY
+
+
+File: gnuplot.info,  Node: Top,  Next: Gnuplot,  Prev: (dir),  Up: (dir)
+
+Master Menu
+***********
+
+                            GNUPLOT
+
+                 An Interactive Plotting Program
+                  Thomas Williams & Colin Kelley
+                     Version 5.0 organized by
+            Ethan A Merritt with help from many others
+
+        Copyright (C) 1986 - 1993, 1998, 2004   Thomas Williams, Colin Kelley
+                Copyright (C) 2004 - 2012  various authors
+
+            Mailing list for comments: gnuplot-info@lists.sourceforge.net
+          Mailing list for bug reports: gnuplot-bugs@lists.sourceforge.net
+
+              This manual was originally prepared by Dick Crawford
+                        Version 5.0 - March 2014
+
+
+     Major contributors (alphabetic order):
+
+* Menu:
+
+* Gnuplot::
+* Plotting_styles::
+* Commands::
+* Terminal_types::
+* Concept_Index::
+* Command_Index::
+* Options_Index::
+* Function_Index::
+* Terminal_Index::
+
+
+File: gnuplot.info,  Node: Gnuplot,  Next: Plotting_styles,  Prev: Top,  Up: Top
+
+1 Gnuplot
+*********
+
+bugs (https://sourceforge.net/p/gnuplot/bugs) &nbsp;&nbsp; feature
+requests (https://sourceforge.net/p/gnuplot/feature-requests)
+
+* Menu:
+
+* Copyright::
+* Introduction::
+* Seeking-assistance_/_Bugs::
+* New_features_in_version_6::
+* Differences_between_versions_5_and_6::
+* Demos_and_Online_Examples::
+* Batch/Interactive_Operation::
+* Canvas_size::
+* Command-line-editing::
+* Comments::
+* Coordinates::
+* Datastrings::
+* Enhanced_text_mode::
+* Environment::
+* Expressions::
+* Fonts::
+* Glossary::
+* inline_data_and_datablocks::
+* iteration::
+* linetypes::
+* layers::
+* mouse_input::
+* Persist::
+* Plotting::
+* Plugins::
+* Scope_of_variables::
+* Start-up_(initialization)::
+* String_constants::
+* Substitution_and_Command_line_macros::
+* Syntax::
+* Time/Date_data::
+* Watchpoints_::
+
+
+File: gnuplot.info,  Node: Copyright,  Next: Introduction,  Prev: Gnuplot,  Up: Gnuplot
+
+1.1 Copyright
+=============
+
+         Copyright (C) 1986 - 1993, 1998, 2004, 2007  Thomas Williams, Colin Kelley
+         Copyright (C) 2004-2024  various authors
+
+
+   Permission to use, copy, and distribute this software and its
+documentation for any purpose with or without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation.
+
+   Permission to modify the software is granted, but not the right to
+distribute the complete modified source code.  Modifications are to be
+distributed as patches to the released version.  Permission to
+distribute binaries produced by compiling modified sources is granted,
+provided you
+       1. distribute the corresponding source modifications from the
+        released version in the form of a patch file along with the binaries,
+       2. add special version identification to distinguish your version
+        in addition to the base release version number,
+       3. provide your name and address as the primary contact for the
+        support of your modified version, and
+       4. retain our contact information in regard to use of the base software.
+
+   Permission to distribute the released version of the source code
+along with corresponding source modifications in the form of a patch
+file is granted with same provisions 2 through 4 for binary
+distributions.
+
+   This software is provided "as is" without express or implied warranty
+to the extent permitted by applicable law.
+
+           AUTHORS
+                   Original Software:
+                      Thomas Williams,  Colin Kelley.
+                   Gnuplot 2.0 additions:
+                      Russell Lang, Dave Kotz, John Campbell.
+                   Gnuplot 3.0 additions:
+                      Gershon Elber and many others.
+                   Gnuplot 4.0 and subsequent releases:
+                      See list of contributors at head of this document.
+
+
+
+File: gnuplot.info,  Node: Introduction,  Next: Seeking-assistance_/_Bugs,  Prev: Copyright,  Up: Gnuplot
+
+1.2 Introduction
+================
+
+'Gnuplot' is a portable command-line driven graphing utility for Linux,
+OS/2, MS Windows, macOS, VMS, and many other platforms.  The source code
+is copyrighted but freely distributed (i.e., you don't have to pay for
+it).  It was originally created to allow scientists and students to
+visualize mathematical functions and data interactively, but has grown
+to support many non-interactive uses such as web scripting.  It is also
+used as a plotting engine by third-party applications like Octave.
+Gnuplot has been supported and under active development since 1986.
+
+   Gnuplot can generate many types of plot in 2D and 3D. It can draw
+using lines, points, boxes, contours, vector fields, images, surfaces,
+and associated text.  It also supports specialized graphs such as heat
+maps, spider plots, polar projection, histograms, boxplots, bee swarm
+plots, and nonlinear coordinates.
+
+   Gnuplot supports many different types of output: interactive screen
+terminals (with mouse and hotkey input), direct output to pen plotters
+or modern printers, and output to many file formats (eps, emf, fig,
+jpeg, LaTeX, pdf, png, postscript, ...).  Gnuplot is easily extensible
+to include new output modes.  A recent example is support for webp
+animation.  Mouseable plots embedded in web pages can be generated using
+the svg or HTML5 canvas terminal drivers.
+
+   The command language of 'gnuplot' is case sensitive, i.e.  commands
+and function names written in lowercase are not the same as those
+written in capitals.  All command names may be abbreviated as long as
+the abbreviation is not ambiguous.  Any number of commands may appear on
+a line, separated by semicolons (;).  Strings may be set off by either
+single or double quotes, although there are some subtle differences.
+See 'syntax' and 'quotes' for more details.  Example:
+
+           set title "My First Plot";  plot 'data';  print "all done!"
+
+
+   Commands may extend over several input lines by ending each line but
+the last with a backslash (\).  The backslash must be the _last_
+character on each line.  The effect is as if the backslash and newline
+were not there.  That is, no white space is implied, nor is a comment
+terminated.  Therefore, commenting out a continued line comments out the
+entire command (see 'comments').  But note that if an error occurs
+somewhere on a multi-line command, the parser may not be able to locate
+precisely where the error is and in that case will not necessarily point
+to the correct line.
+
+   In this document, curly braces ({}) denote optional arguments and a
+vertical bar (|) separates mutually exclusive choices.  'Gnuplot'
+keywords or *note help:: topics are indicated by backquotes or
+'boldface' (where available).  Angle brackets (<>) are used to mark
+replaceable tokens.  In many cases, a default value of the token will be
+taken for optional arguments if the token is omitted, but these cases
+are not always denoted with braces around the angle brackets.
+
+   For built-in help on any topic, type *note help:: followed by the
+name of the topic or 'help ?'  to get a menu of available topics.
+
+   A large set of demo plots is available on the web page
+http://www.gnuplot.info/demo/ (http://www.gnuplot.info/demo/) When run
+from command line, gnuplot is invoked using the syntax
+           gnuplot {OPTIONS} file1 file2 ...
+
+   where file1, file2, etc.  are input files as in the 'load' command.
+Options interpreted by gnuplot may come anywhere on the line.  Files are
+executed in the order specified, as are commands supplied by the -e
+option, for example
+           gnuplot   file1.in   -e "reset"   file2.in
+
+
+   The special filename "-" is used to force reading from stdin.
+'Gnuplot' exits after the last file is processed.  If no load files are
+named, 'Gnuplot' takes interactive input from stdin.  See help
+'batch/interactive' for more details.  See 'command-line-options' for
+more details, or type
+           gnuplot --help
+
+
+   In sessions with an interactive plot window you can hit 'h' anywhere
+on the plot for help about 'hotkeys' and 'mousing' features.
+
+
+File: gnuplot.info,  Node: Seeking-assistance_/_Bugs,  Next: New_features_in_version_6,  Prev: Introduction,  Up: Gnuplot
+
+1.3 Seeking-assistance / Bugs
+=============================
+
+The canonical gnuplot home page can be found at http://www.gnuplot.info
+(http://www.gnuplot.info)
+
+   Before seeking help, please check file FAQ.pdf or the above website
+for a FAQ (Frequently Asked Questions) list.
+(http://www.gnuplot.info/faq/)
+
+   Another resource for help with specific plotting problems (not bugs)
+is
+               https://stackoverflow.com/questions/tagged/gnuplot
+
+
+   Bug reports and feature requests should be uploaded to the trackers
+at
+               https://sourceforge.net/p/gnuplot/_list/tickets
+
+   Please check previous reports to see if the bug you want to report
+has already been fixed in a newer version.
+
+   When reporting a bug or posting a question, please include full
+details of the gnuplot version, the terminal type, and the operating
+system.  A short self-contained script demonstrating the problem is very
+helpful.
+
+   Instructions for subscribing to gnuplot mailing lists may be found
+via the gnuplot development website
+http://sourceforge.net/projects/gnuplot
+(http://sourceforge.net/projects/gnuplot)
+
+   Please note that before you write to any of the gnuplot mailing lists
+you must first subscribe to the list.  This helps reduce the amount of
+spam.
+
+   The address for mailing to list members is:
+               gnuplot-info@lists.sourceforge.net
+
+
+   A mailing list for those interested in the development version of
+gnuplot is:
+               gnuplot-beta@lists.sourceforge.net
+
+
+
+File: gnuplot.info,  Node: New_features_in_version_6,  Next: Differences_between_versions_5_and_6,  Prev: Seeking-assistance_/_Bugs,  Up: Gnuplot
+
+1.4 New features in version 6
+=============================
+
+Version 6 is the latest major release in a history of gnuplot
+development dating back to 1986.  It follows major version 5 (2015) and
+subsequent minor version releases 5.2 (2017) and 5.4 (2020).
+Development continues in a separate unreleased branch in the project git
+repository on SourceForge.
+
+   Some features described in this document are present only if chosen
+and configured at the time gnuplot is compiled from source.  To
+determine what configuration options were used to build the particular
+copy of gnuplot you are running, type 'show version long'.
+
+* Menu:
+
+* Function_blocks_and_scoped_variables::
+* Special_and_complex-valued_functions::
+* New_plot_styles::
+* Hulls::
+* Named_palettes::
+* New_data_formats::
+* New_built-in_functions_and_array_operations::
+* Program_control_flow::
+* Multiplots::
+* New_terminals_and_terminal_options::
+* Watchpoints::
+* Week-date_time_support::
+* Other_new_features::
+* Brief_summary_of_features_introduced_in_version_5::
+
+
+File: gnuplot.info,  Node: Function_blocks_and_scoped_variables,  Next: Special_and_complex-valued_functions,  Prev: New_features_in_version_6,  Up: New_features_in_version_6
+
+1.4.1 Function blocks and scoped variables
+------------------------------------------
+
+This version of gnuplot introduces a mechanism for invoking a block of
+standard gnuplot commands as a callable function.  A function block can
+accept from 0 to 9 parameters and returns a value.  Function blocks can
+be used to calculate and assign a new value to a variable, to combine
+with other functions and operators, or to perform a repetitive task
+preparing data.  There are three components to this mechanism.  See
+'local', 'scope', 'function blocks', *note return::.
+   * The 'local' qualifier allows optional declaration of a variable or
+     array whose scope is limited to the duration of execution of the
+     program unit in which it is found.  These units currently include
+     execution of a 'load' or *note call:: statement, function block
+     evaluation, and the code block in curly brackets following an *note
+     if::, 'else', 'do for', or 'while' statement.  If the name of a
+     local variable duplicates the name of a global variable, the global
+     variable is shadowed until exit from the local scope.
+   * The 'function' command declares a named function block (effectively
+     an array of strings) containing gnuplot commands.  When the
+     function block is invoked, commands are executed successively until
+     the end of the block or until a *note return:: command is
+     encountered.
+   * The 'return <expression>' command terminates execution of a
+     function block.  The result of evaluating <expression> is returned
+     as the value of the function.  Anywhere outside a function block
+     *note return:: acts like *note exit::.
+
+   For an example of using this mechanism to define and plot a
+non-trivial function that is too complicated for a simple one-line
+definition 'f(x) = ...'  please see 'function_block.dem'
+(http://www.gnuplot.info/demo_6.0/function_block.html)
+
+
+File: gnuplot.info,  Node: Special_and_complex-valued_functions,  Next: New_plot_styles,  Prev: Function_blocks_and_scoped_variables,  Up: New_features_in_version_6
+
+1.4.2 Special and complex-valued functions
+------------------------------------------
+
+Gnuplot 6 provides an expanded set of complex-valued functions and
+updated versions of some functions that were present in earlier
+versions.
+   * New: Riemann zeta function with complex domain and range.  See
+     *note zeta::.
+   * Updated lower incomplete gamma function with improved domain and
+     precision.  Complex arguments accepted.  See 'igamma'.
+   * New upper incomplete gamma function (real arguments only).  See
+     *note uigamma::.
+   * Updated incomplete beta function with improved domain and
+     precision.  See 'ibeta'.
+   * New function for the inverse incomplete gamma function.  See
+     'invigamma'.
+   * New function for the inverse incomplete beta function.  See
+     'invibeta'.
+   * New complex function LambertW(z,k) returns the kth branch of
+     multivalued function W_k(z).  Note that the older function
+     lambertw(x) = real(LambertW( real(z), 0 )).  See *note LambertW::.
+   * New complex function lnGamma(z).  Note that existing function
+     lgamma(x) = real(lnGamma(real(z)).  See *note lnGamma::.
+   * Complex function conj(z) returns the complex conjugate of z.
+   * Synchrotron function F(x), see 'SynchrotronF'.
+   * acosh(z) domain extended to cover negative real axis.
+   * asin(z) asinh(z) improved precision for complex arguments.
+   * Predefined variable I = sqrt(-1) = {0,1} for convenience.  This is
+     useful because gnuplot does not accept {a,b} as a valid complex
+     constant but does accept (a + b*I) as a valid complex expression.
+
+   Additional special functions are supported if a suitable external
+library is found at build time.  See 'special_functions'.
+   * Complex Bessel functions Iν(z), Jν(z), Kν(z), Yν(z) of order ν
+     (real) with complex argument z.  See 'BesselK'.
+   * Complex Hankel functions H1ν(z), H2ν(z) of order ν with complex z.
+     See 'BesselH1'.
+   * Complex Airy functions Ai(z), Bi(z).
+   * Complex exponential integral of order n.  See 'expint'.
+   * Fresnel integrals C(x) and S(x).  See 'FresnelC'.
+   * Function 'VP_fwhm(sigma,gamma)' returns the full width at half
+     maximum of the Voigt profile.  See 'VP', 'VP_fwhm'.
+
+
+File: gnuplot.info,  Node: New_plot_styles,  Next: Hulls,  Prev: Special_and_complex-valued_functions,  Up: New_features_in_version_6
+
+1.4.3 New plot styles
+---------------------
+
+   * The plot style 'with surface' works in 2D polar coordinates to
+     produce a solid-fill gridded representation of the plane, colored
+     by weighted contributions from an arbitrary set of input points.
+     This is analogous to the use of *note dgrid3d:: and style 'with
+     pm3d' to produce a 3D gridded surface.  See 'set polar grid' and
+     'polar heatmap'.
+   * New 2D plot style *note sectors:: is an alternative to generating a
+     full polar gridded surface.  For each input data point it generates
+     a single annular wedge in a conceptual polar grid.  Unlike polar
+     mode 'with surface' it can be used in either a polar or cartesian
+     coordinate graph.
+   * New 2D plot style *note hsteps:: allows construction of step-like
+     plots with a variety of representations in addition to those
+     offered by existing styles *note steps::, *note histeps::, *note
+     fsteps::, and *note fillsteps::.  See *note hsteps::.
+   * Plot style 'with lines' now has a filter option 'sharpen'.  This
+     filter detects spikes in a function plot that appear truncated in
+     the output because the peak lies between two x-coordinates at which
+     the function has been sampled.  It adds a new sample point at the
+     location of each such peak.  See *note filters::.
+   * Although it is not strictly speaking a new plot style, the
+     combination of the concave hull filter with along-path smoothing of
+     filled areas allows creation of 'blobby region' plots showing, for
+     example, the extents of overlapping data clusters.  See
+     'concavehull'.
+   * 3D plot style 'with pm3d' accepts an optional modifier 'zclip
+     [zmin:zmax]' that selects only a slice of the full surface.
+     Successive plots with incremental changes to the clipping limits
+     can be used to animate a cross-sectional cutaway view in 3D or to
+     create a filled area contour map.  This is automated by a new plot
+     style *note contourfill:: that is particularly useful in 2D
+     projection.  See *note contourfill::.
+
+   D polargrid 4 DB D windrose 1 D sectors 4 DB D sharpen 1 D iris 2 DB
+D contourfill 4 DB D logic_timing 1 D rank_sequence 1
+
+
+File: gnuplot.info,  Node: Hulls,  Next: Named_palettes,  Prev: New_plot_styles,  Up: New_features_in_version_6
+
+1.4.4 Hulls, masks, and smoothing
+---------------------------------
+
+   * A cluster of 2D points can be replaced by its bounding polygon
+     using the new filter 'convexhull'.  A path-smoothed bounding curve
+     can be plotted as a filled area using "convexhull smooth path with
+     filledcurves".  See 'convexhull'.
+   * An alternative filter 'concavehull' generates a bounding polygon
+     that is not necessarily convex; instead it forms a χ-shape
+     determined by a characteristic length parameter that controls the
+     degree of concavity.  This essentially draws a blob around the data
+     points.  See 'concavehull'.
+   * A convex hull or other polygon can be used as a mask to display
+     only selected portions of a pm3d surface or an image plot.  See new
+     plot style 'with mask' (defines a mask) and keyword 'mask' (applies
+     the mask to a subsequent plot component).
+   * curve smoothing using along-path cubic splines suitable for closed
+     curves or for 2D curves that are not monotonic on x.  See 'smooth
+     path'.  This allows smoothing of hulls and masks.
+   * cubic spline smoothing of 3D lines.  See 'splot smooth csplines'
+   * Smoothing options apply to plotting *note filledcurves::
+     {above|below|between}.
+   * New keyword 'period' for smoothing periodic data.  See 'smooth
+     kdensity'.
+   D convex_hull 2 D mask_pm3d 3 D smooth_path 2
+
+
+File: gnuplot.info,  Node: Named_palettes,  Next: New_data_formats,  Prev: Hulls,  Up: New_features_in_version_6
+
+1.4.5 Named palettes
+--------------------
+
+   * The current palette can be saved to a named colormap for future
+     use.  See *note colormap::.
+   * pm3d and image plots can specify a previously saved palette by
+     name.  This permits the use of multiple palettes in a single plot
+     command.  See *note palette::.
+   * Named palette colormaps can be manipulated as arrays of 32-bit ARGB
+     color values.  This permits addition of alpha-channel values or
+     other modifications not easily specified in a *note palette::
+     command.
+   * There is a new predefined color scheme *note viridis::.
+   * Palettes read from a file or datablock ('set palette file') may be
+     specified either using fractional color components or 24-bit packed
+     RGB values.
+   D named_palettes 4 D viridis 1
+
+
+File: gnuplot.info,  Node: New_data_formats,  Next: New_built-in_functions_and_array_operations,  Prev: Named_palettes,  Up: New_features_in_version_6
+
+1.4.6 New data formats
+----------------------
+
+   * The 'sparse matrix=(cols,rows)' option to 'plot' and 'splot'
+     generates a uniform pixel grid into which individual pixel values
+     may be loaded in any order.  This is useful for plotting heat maps
+     from incomplete data.  See 'sparse'.
+   * During input of non-uniform matrix data, column(0) now returns the
+     linear ordering of matrix elements.  I.e.  for element A[i,j] in an
+     MxN matrix A, column(0)/M gives the row index i, and column(0)%M
+     gives the column index j.
+
+
+File: gnuplot.info,  Node: New_built-in_functions_and_array_operations,  Next: Program_control_flow,  Prev: New_data_formats,  Up: New_features_in_version_6
+
+1.4.7 New built-in functions and array operations
+-------------------------------------------------
+
+   * 'palette(z)' returns the current RGB palette color mapping z into
+     cbrange.
+   * 'rgbcolor("name")' returns the 32bit ARGB value for a named color.
+   * 'index( Array, element )' returns the first index 'i' for which
+     Array[i] is equal to element.  See *note arrays::.
+   * User-defined functions allow an array as a parameter.  Example:
+     dot(A,B) = sum [i=1:|A|] A[i]*B[i]
+   * Array slices are generated by appending a range to the array name.
+     Array[n] is single element.  Array[n:n+5] is a six element slice of
+     the original array.  See *note arrays::, 'slice'.
+   * 'split("string", "separator")' unpacks the fields in a string into
+     an array of strings.  See *note split::.
+   * 'join(array, "separator")' is the complement to *note split::.  It
+     concatenates the elements of a string array into a single string
+     with field separators.  See *note join::.
+   * 'stats <non-existent file>' yields a testable value.  See 'stats
+     test'.
+   * 'stats $vgrid' finds min/max/mean/stddev of voxels in grid
+
+
+File: gnuplot.info,  Node: Program_control_flow,  Next: Multiplots,  Prev: New_built-in_functions_and_array_operations,  Up: New_features_in_version_6
+
+1.4.8 Program control flow
+--------------------------
+
+   * New syntax 'if ...  else if ...  else ...'
+   * XDG base directory conventions for configuration preferences are
+     supported.  The program reads initial commands from
+     $XDG_CONFIG_HOME/gnuplot/gnuplotrc.  Session command history is
+     saved to $XDG_STATE_HOME/gnuplot_history.  If these files are not
+     found, $HOME/.gnuplot and $HOME/.gnuplot_history are used as in
+     previous gnuplot versions.
+   * *note warnings:: suppresses output of warning messages to stderr.
+   * 'warn "message"' prints filename, line number and message to
+     stderr.
+   * Exception handling for the "fit" command.  Control always returns
+     to the next line of input, even in the case of fit errors.  On
+     return, FIT_ERROR is non-zero if an error occurred.  This allows
+     scripted recovery from a bad fit.  See 'fit error_recovery'.
+
+
+File: gnuplot.info,  Node: Multiplots,  Next: New_terminals_and_terminal_options,  Prev: Program_control_flow,  Up: New_features_in_version_6
+
+1.4.9 Multiplots
+----------------
+
+Commands executed during initial creation of a multiplot are now stored
+in a datablock $GPVAL_LAST_MULTIPLOT. They can be replayed by the new
+command *note remultiplot::.  Certain saved commands that would be
+problematic during replay are not reexecuted.  Note that the regenerated
+multiplot may not exactly match the original if graphics settings (axis
+ranges, logscale, etc) have changed in the interim.
+
+   The following sequence of commands will save both the original
+graphics state and the multiplot commands to a script file that can be
+reloaded later.
+
+          save "my_multiplot.gp"
+          set multiplot
+          ... various commands to generate the component plots ...
+          unset multiplot
+          set print "my_multiplot.gp" append
+          print $GPVAL_LAST_MULTIPLOT
+          unset print
+
+
+   * The *note replot:: command will check to see if the most recent
+     plot command was part of a completed multiplot.  If so, it will
+     execute *note remultiplot:: instead of reexecuting that single plot
+     command.
+   * EXPERIMENTAL. Replot requests generated by window events, mouse
+     events, or hot keys in a displayed multiplot will call *note
+     remultiplot:: if appropriate.  This means, for example, that you
+     can now resize a multiplot displayed on the screen.  However the
+     mouse coordinate readout and thus zoom/pan operations are still
+     based solely on the axis settings for the final component plot, as
+     was the case in earlier gnuplot versions.  Because the commands
+     stored in $GPVAL_LAST_MULTIPLOT may not be sufficient to recreate
+     the appropriate graphics settings for each component plot, mousing
+     in a multiplot may not act as you would like.  This will be
+     improved in the future.
+
+
+File: gnuplot.info,  Node: New_terminals_and_terminal_options,  Next: Watchpoints,  Prev: Multiplots,  Up: New_features_in_version_6
+
+1.4.10 New terminals and terminal options
+-----------------------------------------
+
+   * New terminals 'kittygd' and 'kittycairo' provide in-window graphics
+     for terminal emulators that support the kitty protocol.  Kitty is
+     an alternative to sixel graphics that offers full 24-bit RGB color.
+     See 'kittycairo'.
+   * New terminal 'block' for text-mode pseudo-graphics uses Unicode
+     block or Braille characters to offer improved resolution compared
+     to the 'dumb' or 'caca' terminals.
+   * New terminal 'webp' generates a single frame or an animation
+     sequence using webp encoding.  Frames are generated using pngcairo,
+     then encoded through the WebPAnimEncoder API exported by libwebp
+     and libwebpmux.
+   * Terminals that use the same window for text entry and graphical
+     display, including 'dumb', 'sixel', 'kitty', and 'block' now
+     respond to keyboard input during a 'pause mouse' command.  While
+     paused, they interpret keystrokes in the same way that a mousing
+     terminal would.  See 'pseudo-mousing'.  For example the
+     left/right/up/down arrow keys change the view angle of 3D plots and
+     perform incremental pan/zoom steps for 2D plots.
+
+
+File: gnuplot.info,  Node: Watchpoints,  Next: Week-date_time_support,  Prev: New_terminals_and_terminal_options,  Up: New_features_in_version_6
+
+1.4.11 Watchpoints
+------------------
+
+Watchpoints are target values associated with individual plots in a
+graph.  As that plot is drawn, each component line segment is monitored
+to see if its endpoints bracket the target value of a watchpoint
+coordinate (x, y, or z) or function f(x,y).  If a match is found, the
+[x,y] coordinates of the match point are saved for later use.  See *note
+watchpoints::.  Possible uses include
+   * Find the intersection points of two curves
+   * Find zeros of a function
+   * Find and notate where a dependent variable (y or z) or function
+     f(x,y) crosses a threshold value
+   * Use the mouse to track values along multiple plots simultaneously
+   D watchpoints 2
+
+
+File: gnuplot.info,  Node: Week-date_time_support,  Next: Other_new_features,  Prev: Watchpoints,  Up: New_features_in_version_6
+
+1.4.12 Week-date time support
+-----------------------------
+
+The Covid-19 pandemic that began in 2020 generated increased interest in
+plotting epidemiological data, which is often tabulated using a "week
+date" reporting convention.  Deficiencies with gnuplot support for this
+convention were remedied and the support for week-date time was
+extended.
+   * Time specifier format %W has been brought into accord with the ISO
+     8601 week date standard.
+   * Time specifier format %U has been brought into accord with the
+     CDC/MMWR week date standard.
+   * New function 'tm_week(time, std)' returns ISO or CDC standard week
+     of year.
+   * New function 'weekdate_iso(year, week, day)' converts ISO standard
+     week date to calendar time.
+   * New function 'weekdate_cdc(year, week, day)' converts CDC standard
+     week date to calendar time.
+   D epi_data 1
+
+
+File: gnuplot.info,  Node: Other_new_features,  Next: Brief_summary_of_features_introduced_in_version_5,  Prev: Week-date_time_support,  Up: New_features_in_version_6
+
+1.4.13 Other new features
+-------------------------
+
+   * 'Time units for setting major and minor tics.'  Both major and
+     minor tics along a time axis now accept tic intervals given in
+     units of minutes/hours/days/weeks/months/years.  See 'set xtics',
+     'set mxtics time'.
+   * The character sequence $# in a 'using' specifier evaluates to the
+     total number of columns available in the current line of data.  For
+     example 'plot FOO using 0:(column($# - 1))' plots the last-but-one
+     field of each row.
+   * keyword 'binvalue=avg' plots the average, rather than the sum, of
+     binned data.
+   * 'set colorbox bottom' places a horizontal color box underneath the
+     plot rather than a vertical box on the right.
+   * Improved rendering of intersecting pm3d surfaces - overlapping
+     surface tiles are split into two pieces along the line of
+     intersection so that tiles from one surface do not incorrectly
+     protrude though the other surface.
+   * User-controlled spotlight added to the pm3d lighting model.  See
+     'set pm3d spotlight'.
+   * New options to force total key width and number of columns.  See
+     'key layout'.
+   * 'set pm3d border retrace' draws a border around each pm3d
+     quadrangle in the same color as the filled area.  In principle this
+     should have no visible effect, but it prevents some display modes
+     like glitchy pdf or postscript viewers from introducing aliasing
+     artifacts.
+   * *note isotropic:: adjusts the axis scaling in both 2D and 3D plots
+     such that the x, y, and z axes all have the same scale.
+   * Change: Text rotation angle is not limited to integral degrees.
+   * Special (non-numerical) linetypes 'lt nodraw', 'lt black', 'lt
+     background' See 'special_linetypes'.
+   * Data-driven color assignments in histogram plots.  See 'histograms
+     colors'.
+   * The position of the key box can be manually tweaked by specifying
+     an offset to be added to whatever position the program would
+     otherwise use.  See 'set key offset'.
+   * A keyentry with text but no plot style can be used to generate a
+     secondary title in the key spanning the entire width of the key.
+     For example
+              `plot A, keyentry "left-justified text" left, B`
+
+     This can also be used to create a key with two columns of text by
+     providing both a text string and a title.  See 'keyentry'.
+
+
+File: gnuplot.info,  Node: Brief_summary_of_features_introduced_in_version_5,  Prev: Other_new_features,  Up: New_features_in_version_6
+
+1.4.14 Brief summary of features introduced in version 5
+--------------------------------------------------------
+
+* Menu:
+
+* Features_introduced_in_5.4::
+* Features_introduced_in_5.2::
+* Features_introduced_in_5.0::
+
+
+File: gnuplot.info,  Node: Features_introduced_in_5.4,  Next: Features_introduced_in_5.2,  Prev: Brief_summary_of_features_introduced_in_version_5,  Up: Brief_summary_of_features_introduced_in_version_5
+
+1.4.14.1 Features introduced in 5.4
+...................................
+
+   * Expressions and functions use 64-bit integer arithmetic.  See
+     'integer'
+   * 2D plot styles *note polygons::, *note spiderplot::, 'arrows'
+   * 3D plot styles *note boxes::, *note circles::, *note polygons::,
+     *note isosurface:: and other representations of gridded voxel data
+   * Data preprocessing filter 'zsort'
+   * Construction of customized keys using 'keyentry'
+   * New LaTeX terminal pict2e supersedes older terminals 'latex',
+     'emtex', 'eepic', and 'tpic'.  The older terminals are no longer
+     built by default
+   * 'set pixmap' imports a png/jpeg/gif image as a pixmap that can be
+     scaled and positioned anywhere in a plot or on the page
+   * Enhanced text mode accepts \U+xxxx (xxxx is a 4 or 5 character
+     hexadecimal) as representing a Unicode code point that is converted
+     to the corresponding UTF-8 byte sequence on output
+   * Revised syntax for *note parallelaxes:: allows convenient iteration
+     inside the plot command, similar to plot styles 'histogram' and
+     *note spiderplot::
+
+
+File: gnuplot.info,  Node: Features_introduced_in_5.2,  Next: Features_introduced_in_5.0,  Prev: Features_introduced_in_5.4,  Up: Brief_summary_of_features_introduced_in_version_5
+
+1.4.14.2 Features introduced in 5.2
+...................................
+
+   * Nonlinear coordinate systems (see *note nonlinear::)
+   * Automated binning of data (see 'bins')
+   * 2D beeswarm plots.  See *note jitter::
+   * 3D plot style 'zerrorfill'
+   * 3D lighting model provides shading and specular highlighted (see
+     *note lighting::).
+   * Array data type, associated commands and operators.  See *note
+     arrays::.
+   * New terminals 'sixelgd', 'domterm'
+   * New format descriptors tH tM tS handle relative times (interval
+     lengths).  See 'time_specifiers'.
+
+
+File: gnuplot.info,  Node: Features_introduced_in_5.0,  Prev: Features_introduced_in_5.2,  Up: Brief_summary_of_features_introduced_in_version_5
+
+1.4.14.3 Features introduced in 5.0
+...................................
+
+   * Terminal independent dash types.
+   * The default sequence of colors used for successive elements in a
+     plot is more easily distinguished by users with color-vision
+     defects.
+   * New plot types *note parallelaxes::, *note table::.
+   * Hypertext labels activated by a mouse-over event.
+   * Explicit sampling ranges in 2D and 3D function plots and
+     pseudofiles '+' and '++'.
+   * Plugin support through new command *note import:: that attaches a
+     user-defined function name to a function provided by an external
+     shared object.
+
+
+File: gnuplot.info,  Node: Differences_between_versions_5_and_6,  Next: Demos_and_Online_Examples,  Prev: New_features_in_version_6,  Up: Gnuplot
+
+1.5 Differences between versions 5 and 6
+========================================
+
+Some changes introduced in version 5 could cause certain scripts written
+for earlier versions of gnuplot to fail or to behave differently.  There
+are very few such changes in version 6.
+
+* Menu:
+
+* Plot_style_details::
+* Deprecated_syntax::
+
+
+File: gnuplot.info,  Node: Plot_style_details,  Next: Deprecated_syntax,  Prev: Differences_between_versions_5_and_6,  Up: Differences_between_versions_5_and_6
+
+1.5.1 Plot style details
+------------------------
+
+Apart from adding entirely new plot styles, version 6 also makes a few
+tweaks to existing plot styles.
+   * More terminals (png/jpeg/sixel/kitty) scale the size of a "dot" by
+     the current line width.  Some other terminals already did this.
+   * Plot styles that draw error bars place a gap at the position of the
+     data point.  The size of the gap is controlled by *note
+     pointintervalbox::.
+   * Multiplots can now be redrawn or rescaled (see 'new multiplots').
+     Because of this it is no longer possible to read in-line data from
+     pseudofile '-'.  Use a data block instead.
+
+
+File: gnuplot.info,  Node: Deprecated_syntax,  Prev: Plot_style_details,  Up: Differences_between_versions_5_and_6
+
+1.5.2 Deprecated syntax
+-----------------------
+
+Deprecated in version 5.4, removed in 6.0
+           # use of a file containing *note reread:: to perform iteration
+           N = 0;  load "file-containing-reread";
+           file content:
+               N = N+1
+               plot func(N,x)
+               pause -1
+               if (N<5) reread
+
+   Current equivalent
+           do for [N=1:5] {
+               plot func(N, x)
+               pause -1
+           }
+
+
+   Deprecated in version 5.4, removed in 6.0
+           set dgrid3d ,,foo     # no keyword to indicate meaning of foo
+
+   Current equivalent
+           set dgrid3d qnorm foo # (example only; qnorm is not the only option)
+
+
+   Deprecated in version 5.0, not present in 6.0 unless built with
+configuration optione -enable-backward-compatibility
+           set style increment user
+
+   Current equivalent
+           use "set linetype" to redefine a convenient range of linetypes
+           explicit use of "linestyle N" or "linestyle variable"
+
+
+   Deprecated in version 5.0, removed in 6.0
+           set clabel
+
+   Current equivalent
+           `set clabel "format"` is replaced by `set cntrlabel format "format"`.
+           *note clabel:: is replaced by `set cntrlabel onecolor`.
+
+
+   Deprecated in version 5.0, removed in 6.0
+           show palette fit2rgbformulae
+
+
+
+File: gnuplot.info,  Node: Demos_and_Online_Examples,  Next: Batch/Interactive_Operation,  Prev: Differences_between_versions_5_and_6,  Up: Gnuplot
+
+1.6 Demos and Online Examples
+=============================
+
+The 'gnuplot' distribution contains a collection of examples in the
+'demo' directory.  You can browse on-line versions of these examples
+produced by the png, svg, and canvas terminals at
+http://gnuplot.info/demos (http://gnuplot.info/demos/) The commands that
+produced each demo plot are shown next to the plot, and the
+corresponding gnuplot script can be downloaded to serve as a model for
+generating similar plots.
+
+
+File: gnuplot.info,  Node: Batch/Interactive_Operation,  Next: Canvas_size,  Prev: Demos_and_Online_Examples,  Up: Gnuplot
+
+1.7 Batch/Interactive Operation
+===============================
+
+'Gnuplot' may be executed in either batch or interactive modes, and the
+two may even be mixed together.
+
+   Command-line arguments are assumed to be either program options or
+names of files containing 'gnuplot' commands.  Each file or command
+string will be executed in the order specified.  The special filename
+"-" is indicates that commands are to be read from stdin.  'Gnuplot'
+exits after the last file is processed.  If no load files and no command
+strings are specified, 'gnuplot' accepts interactive input from stdin.
+
+* Menu:
+
+* command_line_options::
+* Examples::
+
+
+File: gnuplot.info,  Node: command_line_options,  Next: Examples,  Prev: Batch/Interactive_Operation,  Up: Batch/Interactive_Operation
+
+1.7.1 command line options
+--------------------------
+
+Gnuplot accepts the following options on the command line
+          -V, --version
+          -h, --help
+          -p, --persist
+          -d, --default-settings
+          -s, --slow
+          -e  "command1; command2; ..."
+          -c  scriptfile ARG1 ARG2 ...
+
+
+   -p tells the program not to close any remaining interactive plot
+windows when the program exits.
+
+   -d tells the program not to execute any private or system
+initialization (see 'initialization').
+
+   -s tells the program to wait for slow font initialization on startup.
+Otherwise it prints an error and continues with bad font metrics.
+
+   -e "command" tells gnuplot to execute that single command before
+continuing.
+
+   -c is equivalent to -e "call scriptfile ARG1 ARG2 ...".  See *note
+call::.
+
+
+File: gnuplot.info,  Node: Examples,  Prev: command_line_options,  Up: Batch/Interactive_Operation
+
+1.7.2 Examples
+--------------
+
+To launch an interactive session:
+           gnuplot
+
+
+   To execute two command files "input1" and "input2" in batch mode:
+           gnuplot input1 input2
+
+
+   To launch an interactive session after an initialization file
+"header" and followed by another command file "trailer":
+           gnuplot header - trailer
+
+
+   To give 'gnuplot' commands directly in the command line, using the
+"-persist" option so that the plot remains on the screen afterwards:
+           gnuplot -persist -e "set title 'Sine curve'; plot sin(x)"
+
+
+   To set user-defined variables a and s prior to executing commands
+from a file:
+           gnuplot -e "a=2; s='file.png'" input.gpl
+
+
+
+File: gnuplot.info,  Node: Canvas_size,  Next: Command-line-editing,  Prev: Batch/Interactive_Operation,  Up: Gnuplot
+
+1.8 Canvas size
+===============
+
+This documentation uses the term "canvas" to mean the full drawing area
+available for positioning the plot and associated elements like labels,
+titles, key, etc.  NB: For information about the HTML5 canvas terminal
+see 'set term canvas'.
+
+   'set term <terminal_type> size <XX>, <YY>' controls the size of the
+output file, or "canvas".  By default, the plot will fill this canvas.
+
+   'set size <XX>, <YY>' scales the plot itself relative to the size of
+the canvas.  Scale values less than 1 will cause the plot to not fill
+the entire canvas.  Scale values larger than 1 will cause only a portion
+of the plot to fit on the canvas.  Please be aware that setting scale
+values larger than 1 may cause problems.
+
+   Example:
+
+           set size 0.5, 0.5
+           set term png size 600, 400
+           set output "figure.png"
+           plot "data" with lines
+
+
+   These commands produce an output file "figure.png" that is 600 pixels
+wide and 400 pixels tall.  The plot will fill the lower left quarter of
+this canvas.
+
+   Note: In early versions of gnuplot some terminal types used *note
+size:: to control the size of the output canvas.  This was deprecated in
+version 4.
+
+
+File: gnuplot.info,  Node: Command-line-editing,  Next: Comments,  Prev: Canvas_size,  Up: Gnuplot
+
+1.9 Command-line-editing
+========================
+
+Command-line editing and command history are supported using either an
+external gnu readline library, an external BSD libedit library, or a
+built-in equivalent.  This choice is a configuration option at the time
+gnuplot is built.
+
+   The editing commands of the built-in version are given below.  Please
+note that the action of the DEL key is system-dependent.  The gnu
+readline and BSD libedit libraries have their own documentation.
+
+           `Line-editing`:
+
+
+           ^B    moves back a single character.
+           ^F    moves forward a single character.
+           ^A    moves to the beginning of the line.
+           ^E    moves to the end of the line.
+           ^H    deletes the previous character.
+           DEL   deletes the current character.
+           ^D    deletes current character, sends EOF if the line is empty.
+           ^K    deletes from current position to the end of line.
+           ^L    redraws line in case it gets trashed.
+           ^U    deletes the entire line.
+           ^W    deletes previous word.
+           ^V    inhibits the interpretation of the following key as editing command.
+           TAB   performs filename-completion.
+
+
+           `History`:
+
+
+           ^P    moves back through history.
+           ^N    moves forward through history.
+           ^R    starts a backward-search.
+
+
+
+File: gnuplot.info,  Node: Comments,  Next: Coordinates,  Prev: Command-line-editing,  Up: Gnuplot
+
+1.10 Comments
+=============
+
+The comment character '#' may appear almost anywhere in a command line,
+and 'gnuplot' will ignore the rest of that line.  A '#' does not have
+this effect inside a quoted string.  Note that if a commented line ends
+in '\' then the subsequent line is also treated as part of the comment.
+
+   See also 'set datafile commentschars' for specifying a comment
+character for data files.
+
+
+File: gnuplot.info,  Node: Coordinates,  Next: Datastrings,  Prev: Comments,  Up: Gnuplot
+
+1.11 Coordinates
+================
+
+The commands 'set arrow', 'set key', 'set label' and *note object::
+allow you to draw something at an arbitrary position on the graph.  This
+position is specified by the syntax:
+
+           {<system>} <x>, {<system>} <y> {,{<system>} <z>}
+
+
+   Each <system> can either be 'first', 'second', 'polar', 'graph',
+'screen', or 'character'.
+
+   'first' places the x, y, or z coordinate in the system defined by the
+left and bottom axes; 'second' places it in the system defined by the
+x2,y2 axes (top and right); 'graph' specifies the area within the
+axes--0,0 is bottom left and 1,1 is top right (for splot, 0,0,0 is
+bottom left of plotting area; use negative z to get to the base--see
+*note xyplane::); 'screen' specifies the screen area (the entire
+area--not just the portion selected by *note size::), with 0,0 at bottom
+left and 1,1 at top right.  'character' coordinates are used primarily
+for offsets, not absolute positions.  The 'character' vertical and
+horizontal size depend on the current font.
+
+   'polar' causes the first two values to be interpreted as angle theta
+and radius r rather than as x and y.  This could be used, for example,
+to place labels on a 2D plot in polar coordinates or a 3D plot in
+cylindrical coordinates.
+
+   If the coordinate system for x is not specified, 'first' is used.  If
+the system for y is not specified, the one used for x is adopted.
+
+   In some cases, the given coordinate is not an absolute position but a
+relative value (e.g., the second position in 'set arrow' ...  'rto').
+In most cases, the given value serves as difference to the first
+position.  If the given coordinate belongs to a log-scaled axis, a
+relative value is interpreted as multiplier.  For example,
+
+           set logscale x
+           set arrow 100,5 rto 10,2
+
+
+   plots an arrow from position 100,5 to position 1000,7 since the x
+axis is logarithmic while the y axis is linear.
+
+   If one (or more) axis is timeseries, the appropriate coordinate
+should be given as a quoted time string according to the *note timefmt::
+format string.  See *note xdata:: and *note timefmt::.  'Gnuplot' will
+also accept an integer expression, which will be interpreted as seconds
+relative to 1 January 1970.
+
+
+File: gnuplot.info,  Node: Datastrings,  Next: Enhanced_text_mode,  Prev: Coordinates,  Up: Gnuplot
+
+1.12 Datastrings
+================
+
+Data files may contain string data consisting of either an arbitrary
+string of printable characters containing no whitespace or an arbitrary
+string of characters, possibly including whitespace, delimited by double
+quotes.  The following line from a datafile is interpreted to contain
+four columns, with a text field in column 3:
+
+       1.000 2.000 "Third column is all of this text" 4.00
+
+
+   Text fields can be positioned within a 2-D or 3-D plot using the
+commands:
+
+       plot 'datafile' using 1:2:4 with labels
+       splot 'datafile' using 1:2:3:4 with labels
+
+
+   A column of text data can also be used to label the ticmarks along
+one or more of the plot axes.  The example below plots a line through a
+series of points with (X,Y) coordinates taken from columns 3 and 4 of
+the input datafile.  However, rather than generating regularly spaced
+tics along the x axis labeled numerically, gnuplot will position a tic
+mark along the x axis at the X coordinate of each point and label the
+tic mark with text taken from column 1 of the input datafile.
+
+       set xtics
+       plot 'datafile' using 3:4:xticlabels(1) with linespoints
+
+
+   There is also an option that will interpret the first entry in a
+column of input data (i.e.  the column heading) as a text field, and use
+it as the key title for data plotted from that column.  The example
+given below will use the first entry in column 2 to generate a title in
+the key box, while processing the remainder of columns 2 and 4 to draw
+the required line:
+
+       plot 'datafile' using 1:(f($2)/$4) with lines title columnhead(2)
+
+
+   Another example:
+
+       plot for [i=2:6] 'datafile' using i title "Results for ".columnhead(i)
+
+
+   This use of column headings is automated by *note columnheaders:: or
+'set key autotitle columnhead'.  See *note labels::, 'using xticlabels',
+*note title::, 'using', 'key autotitle'.
+
+
+File: gnuplot.info,  Node: Enhanced_text_mode,  Next: Environment,  Prev: Datastrings,  Up: Gnuplot
+
+1.13 Enhanced text mode
+=======================
+
+Many terminal types support an enhanced text mode in which additional
+formatting information can be embedded in the text string.  For example,
+"x^2" will write x-squared as we are used to seeing it, with a
+superscript 2.  This mode is selected by default when you set the
+terminal, but may be toggled afterward using "set termoption
+[no]enhanced", or disabled for individual strings as in 'set label "x_2"
+noenhanced'.
+
+   Note: For output to TeX-based terminals (e.g.  cairolatex, pict2e,
+pslatex, tikz) all text strings should instead use TeX/LaTeX syntax.
+See 'latex'.
+
+      Control      Examples        Explanation
+       ^           a^x             superscript
+       _           a_x             subscript
+       @           @x or a@^b_{cd} phantom box (occupies no width)
+       &           &{space}        inserts space of specified length
+       ~           ~a{.8-}         overprints '-' on 'a', raised by .8
+                                   times the current fontsize
+       {/Times abc}                print abc in font Times at current size
+       {/Times*2 abc}              print abc in font Times at twice current size
+       {/Times:Italic abc}         print abc in font Times with style italic
+       {/Arial:Bold=20 abc}        print abc in boldface Arial font size 20
+       \U+         \U+221E         Unicode point U+221E (INFINITY)
+
+
+   The markup control characters act on the following single character
+or bracketed clause.  The bracketed clause may contain a string of
+characters with no additional markup, e.g.  2^{10}, or it may contain
+additional markup that changes font properties.  Font specifiers MUST be
+preceded by a '/' character that immediately follows the opening '{'.
+If a font name contains spaces it must be enclosed in single or double
+quotes.
+
+   Examples: The first example illustrates nesting one bracketed clause
+inside another to produce a boldface A with an italic subscript i, all
+in the current font.  If the clause introduced by :Normal were omitted
+the subscript would be both italic and boldface.  The second example
+illustrates the same markup applied to font "Times New Roman" at 20
+point size.
+          {/:Bold A_{/:Normal{/:Italic i}}}
+          {/"Times New Roman":Bold=20 A_{/:Normal{/:Italic i}}}
+
+
+   The phantom box is useful for a@^b_c to align superscripts and
+subscripts but does not work well for overwriting a diacritical mark on
+a letter.  For that purpose it is much better to use an encoding (e.g.
+utf8) that contains letters with accents or other diacritical marks.
+See *note encoding::.  Since the box is non-spacing, it is sensible to
+put the shorter of the subscript or superscript in the box (that is,
+after the @).
+
+   Space equal in length to a string can be inserted using the '&'
+character.  Thus
+             'abc&{def}ghi'
+
+   would produce
+             'abc   ghi'.
+
+
+   The '~' character causes the next character or bracketed text to be
+overprinted by the following character or bracketed text.  The second
+text will be horizontally centered on the first.  Thus '~a/' will result
+in an 'a' with a slash through it.  You can also shift the second text
+vertically by preceding the second text with a number, which will define
+the fraction of the current fontsize by which the text will be raised or
+lowered.  In this case the number and text must be enclosed in brackets
+because more than one character is necessary.  If the overprinted text
+begins with a number, put a space between the vertical offset and the
+text ('~{abc}{.5 000}'); otherwise no space is needed ('~{abc}{.5--}').
+You can change the font for one or both strings ('~a{.5 /*.2 o}'--an 'a'
+with a one-fifth-size 'o' on top--and the space between the number and
+the slash is necessary), but you can't change it after the beginning of
+the string.  Neither can you use any other special syntax within either
+string.  Control characters must be escaped, e.g.  '~a{.8\^}' to print
+â.  See 'escape sequences' below.
+
+   Note that strings in double-quotes are parsed differently than those
+enclosed in single-quotes.  The major difference is that backslashes may
+need to be doubled when in double-quoted strings.
+
+   The file "ps_guide.ps" in the /docs/psdoc subdirectory of the gnuplot
+source distribution contains more examples of the enhanced syntax, as
+does the demo 'enhanced_utf8.dem'
+(http://www.gnuplot.info/demo/enhanced_utf8.html)
+
+* Menu:
+
+* escape_sequences::
+
+
+File: gnuplot.info,  Node: escape_sequences,  Prev: Enhanced_text_mode,  Up: Enhanced_text_mode
+
+1.13.1 escape sequences
+-----------------------
+
+The backslash character \ is used to escape single byte character codes
+or Unicode entry points.
+
+   The form \ooo (where ooo is a 3 character octal value) can be used to
+index a known character code in a specific font encoding.  For example
+the Adobe Symbol font uses a custom encoding in which octal 245
+represents the infinity symbol.  You could embed this in an enhanced
+text string by giving the font name and the character code "{/Symbol
+\245}".  This is mostly useful for the PostScript terminal, which cannot
+easily handle UTF-8 encoding.
+
+   You can specify a character by its Unicode code point as \U+hhhh,
+where hhhh is the 4 or 5 character hexadecimal code point.  For example
+the code point for the infinity symbol ∞ is \U+221E. This will be
+converted to a UTF-8 byte sequence on output if appropriate.  In a UTF-8
+environment this mechanism is not needed for printable special
+characters since they are handled in a text string like any other
+character.  However it is useful for combining forms or supplemental
+diacritical marks (e.g.  an arrow over a letter to represent a vector).
+See *note encoding::, 'utf8', and the online unicode demo.
+(http://www.gnuplot.info/demo_5.4/unicode.html)
+
+
+File: gnuplot.info,  Node: Environment,  Next: Expressions,  Prev: Enhanced_text_mode,  Up: Gnuplot
+
+1.14 Environment
+================
+
+A number of shell environment variables are understood by 'gnuplot'.
+None of these are required.
+
+   GNUTERM, if defined, is passed to "set term" on start-up.  This can
+be overridden by a system or personal initialization file (see
+'startup') and of course by later explicit 'set term' commands.
+Terminal options may be included.  E.g.
+          bash$ export GNUTERM="postscript eps color size 5in, 3in"
+
+
+   GNUHELP, if defined, sets the pathname of the HELP file
+(gnuplot.gih).
+
+   Initialization at start-up may search for configuration files
+$HOME/.gnuplot, and $XDG_CONFIG_HOME/gnuplot/gnuplotrc.  On MS-DOS,
+Windows and OS/2, files in GNUPLOT or USERPROFILE are searched.  For
+more details see 'startup'.
+
+   On Unix, PAGER is used as an output filter for help messages.
+
+   On Unix, SHELL is used for the *note shell:: command.  On MS-DOS and
+OS/2, COMSPEC is used.
+
+   FIT_SCRIPT may be used to specify a 'gnuplot' command to be executed
+when a fit is interrupted--see *note fit::.  FIT_LOG specifies the
+default filename of the logfile maintained by fit.
+
+   GNUPLOT_LIB may be used to define additional search directories for
+data and command files.  The variable may contain a single directory
+name, or a list of directories separated by a platform-specific path
+separator, eg.  ':' on Unix, or ';' on DOS/Windows/OS/2 platforms.  The
+contents of GNUPLOT_LIB are appended to the *note loadpath:: variable,
+but not saved with the *note save:: and 'save set' commands.
+
+   Several gnuplot terminal drivers access TrueType fonts via the gd
+library (see 'fonts').  For these terminals GDFONTPATH and
+GNUPLOT_DEFAULT_GDFONT may affect font selection.
+
+   The postscript terminal uses its own font search path.  It is
+controlled by the environmental variable GNUPLOT_FONTPATH.
+
+   GNUPLOT_PS_DIR is used by the postscript driver to search for
+external prologue files.  Depending on the build process, gnuplot
+contains either a built-in copy of those files or a default hardcoded
+path.  You can use this variable to have the postscript terminal use
+custom prologue files rather than the default prologue files.  See
+'postscript prologue'.
+
+
+File: gnuplot.info,  Node: Expressions,  Next: Fonts,  Prev: Environment,  Up: Gnuplot
+
+1.15 Expressions
+================
+
+In general, any mathematical expression accepted by C, FORTRAN, Pascal,
+or BASIC is valid.  The precedence of these operators is determined by
+the specifications of the C programming language.  White space (spaces
+and tabs) is ignored inside expressions.
+
+   Note that gnuplot uses both "real" and "integer" arithmetic, like
+FORTRAN and C. Integers are entered as "1", "-10", etc; reals as "1.0",
+"-10.0", "1e1", 3.5e-1, etc.  The most important difference between the
+two forms is in division: division of integers truncates: 5/2 = 2;
+division of reals does not: 5.0/2.0 = 2.5.  In mixed expressions,
+integers are "promoted" to reals before evaluation: 5/2e0 = 2.5.  The
+result of division of a negative integer by a positive one may vary
+among compilers.  Try a test like "print -5/2" to determine if your
+system always rounds down (-5/2 yields -3) or always rounds toward zero
+(-5/2 yields -2).
+
+   The integer expression "1/0" may be used to generate an "undefined"
+flag, which causes a point to be ignored.  Or you can use the
+pre-defined variable NaN to achieve the same result.  See 'using' for an
+example.
+
+   Gnuplot can also perform simple operations on strings and string
+variables.  For example, the expression ("A" .  "B" eq "AB") evaluates
+as true, illustrating the string concatenation operator and the string
+equality operator.
+
+   A string which contains a numerical value is promoted to the
+corresponding integer or real value if used in a numerical expression.
+Thus ("3" + "4" == 7) and (6.78 == "6.78") both evaluate to true.  An
+integer, but not a real or complex value, is promoted to a string if
+used in string concatenation.  A typical case is the use of integers to
+construct file names or other strings; e.g.  ("file" .  4 eq "file4") is
+true.
+
+   Substrings can be specified using a postfixed range descriptor
+[beg:end].  For example, "ABCDEF"[3:4] == "CD" and "ABCDEF"[4:*] ==
+"DEF" The syntax "string"[beg:end] is exactly equivalent to calling the
+built-in string-valued function substr("string",beg,end), except that
+you cannot omit either beg or end from the function call.
+
+* Menu:
+
+* Complex_values::
+* Constants::
+* Functions::
+* operators::
+* summation::
+* Gnuplot-defined_variables::
+* User-defined_variables_and_functions::
+* arrays::
+
+
+File: gnuplot.info,  Node: Complex_values,  Next: Constants,  Prev: Expressions,  Up: Expressions
+
+1.15.1 Complex values
+---------------------
+
+Arithmetic operations and most built-in functions support the use of
+complex arguments.  Complex constants are expressed as {<real>,<imag>},
+where <real> and <imag> must be numerical constants.  Thus {0,1}
+represents 'i'.  The program predefines a variable I = {0,1} on entry
+that can be used to generate complex values in terms of other variables.
+Thus 'x + y*I' is a valid expression but '{x,y}' is not.  The real and
+imaginary components of complex value z can be extracted as real(z) and
+imag(z).  The modulus is given by abs(z).  The phase angle is given by
+arg(z).
+
+   Gnuplot's 2D and 3D plot styles expect real values; to plot a
+complex-valued function f(z) with non-zero imaginary components you must
+plot the real or imaginary component, or the modulus or phase.  For
+example to represent the modulus and phase of a function f(z) with
+complex argument and complex result it is possible to use the height of
+the surface to represent modulus and use the color to represent the
+phase.  It is convenient to use a color palette in HSV space with
+component H (hue), running from 0 to 1, mapped to the range of the phase
+returned by arg(z), [-π:π], so that the color wraps when the phase angle
+does.  By default this would be at H = 0 (red).  You can change this
+with the 'start' keyword in *note palette:: so that some other value of
+H is mapped to 0.  The example shown starts and wraps at H = 0.3
+(green).  See *note defined::, *note arg::, *note angles::.
+
+          set palette model HSV start 0.3 defined (0 0 1 1, 1 1 1 1)
+          set cbrange [-pi:pi]
+          set cbtics ("-π" -pi, "π" pi)
+          set pm3d corners2color c1
+          E0(z) = exp(-z)/z
+          I = {0,1}
+          splot '++' using 1:2:(abs(E0(x+I*y))):(arg(E0(x+I*y))) with pm3d
+
+
+
+File: gnuplot.info,  Node: Constants,  Next: Functions,  Prev: Complex_values,  Up: Expressions
+
+1.15.2 Constants
+----------------
+
+Integer constants are interpreted via the C library routine strtoll().
+This means that constants beginning with "0" are interpreted as octal,
+and constants beginning with "0x" or "0X" are interpreted as
+hexadecimal.
+
+   Floating point constants are interpreted via the C library routine
+atof().
+
+   Complex constants are expressed as {<real>,<imag>}, where <real> and
+<imag> must be numerical constants.  For example, {0,1} represents 'i'
+itself; {3,2} represents 3 + 2i.  The curly braces are explicitly
+required here.  The program predefines a variable I = {0,1} on entry
+that can be used to avoid typing the explicit form.  For example '3 +
+2*I' is the same as '{3,2}', with the advantage that it can be used with
+variable coefficient for the imaginary component.  Thus 'x + y*I' is a
+valid expression but '{x,y}' is not.
+
+   String constants consist of any sequence of characters enclosed
+either in single quotes or double quotes.  The distinction between
+single and double quotes is important.  See 'quotes'.
+
+   Examples:
+          1 -10 0xffaabb        # integer constants
+          1.0 -10. 1e1 3.5e-1   # floating point constants
+          {1.2, -3.4}           # complex constant
+          "Line 1\nLine 2"      # string constant (\n is expanded to newline)
+          '123\na\456'          # string constant (\ and n are ordinary characters)
+
+
+
+File: gnuplot.info,  Node: Functions,  Next: operators,  Prev: Constants,  Up: Expressions
+
+1.15.3 Functions
+----------------
+
+Arguments to math functions in 'gnuplot' can be integer, real, or
+complex unless otherwise noted.  Functions that accept or return angles
+(e.g.  sin(x)) treat angle values as radians, but this may be changed to
+degrees using the command *note angles::.
+
+* Menu:
+
+* abs::
+* acos::
+* acosh::
+* airy::
+* arg::
+* asin::
+* asinh::
+* atan::
+* atan2::
+* atanh::
+* besj0::
+* besj1::
+* besjn::
+* besy0::
+* besy1::
+* besyn::
+* besi0::
+* besi1::
+* besin::
+* cbrt::
+* conj::
+* cos::
+* cosh::
+* EllipticK::
+* EllipticE::
+* EllipticPi::
+* erf::
+* erfc::
+* exp::
+* gamma::
+* inverf::
+* imag::
+* invnorm::
+* lambertw::
+* lgamma::
+* lngamma::
+* log::
+* log10::
+* norm::
+* rand::
+* real::
+* sgn::
+* Sign::
+* sin::
+* sinh::
+* sqrt::
+* tan::
+* tanh::
+* voigt::
+* cerf::
+* cdawson::
+* faddeeva::
+* erfi::
+* Voigt_Profile::
+* gprintf::
+* sprintf::
+* strlen::
+* strstrt::
+* substr::
+* split::
+* join::
+* strftime::
+* strptime::
+* system::
+* trim::
+* word::
+* words::
+* exists::
+* hsv2rgb::
+* palette::
+* rgbcolor::
+* voxel::
+* integer_conversion_functions_(int_floor_ceil_round)::
+* elliptic_integrals::
+* Complex_Airy_functions::
+* Complex_Bessel_functions::
+* Expint::
+* Fresnel_integrals_FresnelC(x)_and_FresnelS(x)::
+* Gamma::
+* Igamma::
+* Invigamma::
+* Ibeta::
+* Invibeta::
+* LambertW::
+* lnGamma::
+* Random_number_generator::
+* Special_functions_with_complex_arguments::
+* Synchrotron_function::
+* Time_functions::
+* uigamma::
+* using_specifier_functions::
+* value::
+* Counting_and_extracting_words::
+* zeta::
+
+
+File: gnuplot.info,  Node: abs,  Next: acos,  Prev: Functions,  Up: Functions
+
+1.15.3.1 abs
+............
+
+The 'abs(x)' function returns the absolute value of its argument.  The
+returned value is of the same type as the argument.
+
+   For complex arguments, abs(x) is defined as the length of x in the
+complex plane [i.e., sqrt(real(x)**2 + imag(x)**2) ].  This is also
+known as the norm or complex modulus of x.
+
+
+File: gnuplot.info,  Node: acos,  Next: acosh,  Prev: abs,  Up: Functions
+
+1.15.3.2 acos
+.............
+
+The 'acos(x)' function returns the arc cosine (inverse cosine) of its
+argument.  'acos' returns its argument in radians or degrees, as
+selected by *note angles::.
+
+
+File: gnuplot.info,  Node: acosh,  Next: airy,  Prev: acos,  Up: Functions
+
+1.15.3.3 acosh
+..............
+
+The 'acosh(x)' function returns the inverse hyperbolic cosine of its
+argument in radians or degrees, as selected by *note angles::.
+
+
+File: gnuplot.info,  Node: airy,  Next: arg,  Prev: acosh,  Up: Functions
+
+1.15.3.4 airy
+.............
+
+The 'airy(x)' function returns the value of the Airy function Ai(x) of
+its argument.  The function Ai(x) is that solution of the equation y" -
+x y = 0 which is everywhere finite.  If the argument is complex, its
+imaginary part is ignored.
+
+
+File: gnuplot.info,  Node: arg,  Next: asin,  Prev: airy,  Up: Functions
+
+1.15.3.5 arg
+............
+
+The 'arg(x)' function returns the phase of a complex number in radians
+or degrees, as selected by *note angles::.
+
+
+File: gnuplot.info,  Node: asin,  Next: asinh,  Prev: arg,  Up: Functions
+
+1.15.3.6 asin
+.............
+
+The 'asin(x)' function returns the arc sin (inverse sin) of its
+argument.  'asin' returns its argument in radians or degrees, as
+selected by *note angles::.
+
+
+File: gnuplot.info,  Node: asinh,  Next: atan,  Prev: asin,  Up: Functions
+
+1.15.3.7 asinh
+..............
+
+The 'asinh(x)' function returns the inverse hyperbolic sin of its
+argument in radians or degrees, as selected by *note angles::.
+
+
+File: gnuplot.info,  Node: atan,  Next: atan2,  Prev: asinh,  Up: Functions
+
+1.15.3.8 atan
+.............
+
+The 'atan(x)' function returns the arc tangent (inverse tangent) of its
+argument.  'atan' returns its argument in radians or degrees, as
+selected by *note angles::.
+
+
+File: gnuplot.info,  Node: atan2,  Next: atanh,  Prev: atan,  Up: Functions
+
+1.15.3.9 atan2
+..............
+
+The 'atan2(y,x)' function returns the arc tangent (inverse tangent) of
+the ratio of the real parts of its arguments.  *note atan2:: returns its
+argument in radians or degrees, as selected by *note angles::, in the
+correct quadrant.
+
+
+File: gnuplot.info,  Node: atanh,  Next: besj0,  Prev: atan2,  Up: Functions
+
+1.15.3.10 atanh
+...............
+
+The 'atanh(x)' function returns the inverse hyperbolic tangent of its
+argument in radians or degrees, as selected by *note angles::.
+
+
+File: gnuplot.info,  Node: besj0,  Next: besj1,  Prev: atanh,  Up: Functions
+
+1.15.3.11 besj0
+...............
+
+The 'besj0(x)' function returns the J0th Bessel function of its
+argument.  *note besj0:: expects its argument to be in radians.
+
+
+File: gnuplot.info,  Node: besj1,  Next: besjn,  Prev: besj0,  Up: Functions
+
+1.15.3.12 besj1
+...............
+
+The 'besj1(x)' function returns the J1st Bessel function of its
+argument.  *note besj1:: expects its argument to be in radians.
+
+
+File: gnuplot.info,  Node: besjn,  Next: besy0,  Prev: besj1,  Up: Functions
+
+1.15.3.13 besjn
+...............
+
+The 'besjn(n,x)' functions returns the Jn Bessel function of x in
+radians.
+
+
+File: gnuplot.info,  Node: besy0,  Next: besy1,  Prev: besjn,  Up: Functions
+
+1.15.3.14 besy0
+...............
+
+The 'besy0(x)' function returns the Y0th Bessel function of its
+argument.  *note besy0:: expects its argument to be in radians.
+
+
+File: gnuplot.info,  Node: besy1,  Next: besyn,  Prev: besy0,  Up: Functions
+
+1.15.3.15 besy1
+...............
+
+The 'besy1(x)' function returns the Y1st Bessel function of its
+argument.  *note besy1:: expects its argument to be in radians.
+
+
+File: gnuplot.info,  Node: besyn,  Next: besi0,  Prev: besy1,  Up: Functions
+
+1.15.3.16 besyn
+...............
+
+The 'besyn(n,x)' functions returns the Yn Bessel function of x in
+radians.
+
+
+File: gnuplot.info,  Node: besi0,  Next: besi1,  Prev: besyn,  Up: Functions
+
+1.15.3.17 besi0
+...............
+
+The 'besi0(x)' function is the modified Bessel function or order 0.
+*note besi0:: expects its argument to be in radians.
+
+
+File: gnuplot.info,  Node: besi1,  Next: besin,  Prev: besi0,  Up: Functions
+
+1.15.3.18 besi1
+...............
+
+The 'besi1(x)' function is the modified Bessel function or order 1.
+*note besi1:: expects its argument to be in radians.
+
+
+File: gnuplot.info,  Node: besin,  Next: cbrt,  Prev: besi1,  Up: Functions
+
+1.15.3.19 besin
+...............
+
+'besin(n,x)' is the modified Bessel function or order n for integer n
+and x in radians.
+
+
+File: gnuplot.info,  Node: cbrt,  Next: conj,  Prev: besin,  Up: Functions
+
+1.15.3.20 cbrt
+..............
+
+'cbrt(x)' returns the cube root of x.  If x is not real, returns NaN.
+
+   'ceil(x)' returns the smallest integer not less than the real part of
+x.  Outside the domain |x|<2^52 ceil(x) returns NaN.
+
+
+File: gnuplot.info,  Node: conj,  Next: cos,  Prev: cbrt,  Up: Functions
+
+1.15.3.21 conj
+..............
+
+The 'conj(x)' function returns the complex conjugate x.  conj( {r, i} )
+= {r, -i}
+
+
+File: gnuplot.info,  Node: cos,  Next: cosh,  Prev: conj,  Up: Functions
+
+1.15.3.22 cos
+.............
+
+The 'cos(x)' function returns the cosine of its argument.  'cos' accepts
+its argument in radians or degrees, as selected by *note angles::.
+
+
+File: gnuplot.info,  Node: cosh,  Next: EllipticK,  Prev: cos,  Up: Functions
+
+1.15.3.23 cosh
+..............
+
+The 'cosh(x)' function returns the hyperbolic cosine of its argument.
+*note cosh:: expects its argument to be in radians.
+
+
+File: gnuplot.info,  Node: EllipticK,  Next: EllipticE,  Prev: cosh,  Up: Functions
+
+1.15.3.24 EllipticK
+...................
+
+The 'EllipticK(k)' function returns the complete elliptic integral of
+the first kind.  See 'elliptic integrals' for more details.
+
+
+File: gnuplot.info,  Node: EllipticE,  Next: EllipticPi,  Prev: EllipticK,  Up: Functions
+
+1.15.3.25 EllipticE
+...................
+
+The 'EllipticE(k)' function returns the complete elliptic integral of
+the second kind.  See 'elliptic integrals' for more details.
+
+
+File: gnuplot.info,  Node: EllipticPi,  Next: erf,  Prev: EllipticE,  Up: Functions
+
+1.15.3.26 EllipticPi
+....................
+
+The 'EllipticPi(n,k)' function returns the complete elliptic integral of
+the third kind.  See 'elliptic integrals' for more details.
+
+
+File: gnuplot.info,  Node: erf,  Next: erfc,  Prev: EllipticPi,  Up: Functions
+
+1.15.3.27 erf
+.............
+
+The 'erf(x)' function returns the error function of the real part of its
+argument.  If the argument is a complex value, the imaginary component
+is ignored.  See *note cerf::, *note erfc::, *note inverf::, and *note
+norm::.
+
+
+File: gnuplot.info,  Node: erfc,  Next: exp,  Prev: erf,  Up: Functions
+
+1.15.3.28 erfc
+..............
+
+The 'erfc(x)' function returns 1.0 - the error function of the real part
+of its argument.  If the argument is a complex value, the imaginary
+component is ignored.  See *note cerf::, 'erf', *note inverf::, and
+*note norm::.
+
+
+File: gnuplot.info,  Node: exp,  Next: gamma,  Prev: erfc,  Up: Functions
+
+1.15.3.29 exp
+.............
+
+The 'exp(x)' function returns 'e' raised to the power of x, which can be
+an integer, real, or complex value.
+
+   'floor(x)' returns the largest integer not greater than the real part
+of x.  Outside the domain |x|<2^52 floor(x) returns NaN.
+
+
+File: gnuplot.info,  Node: gamma,  Next: inverf,  Prev: exp,  Up: Functions
+
+1.15.3.30 gamma
+...............
+
+The 'gamma(x)' function returns the gamma function of the real part of
+its argument.  For integer n, gamma(n+1) = n!.  If the argument is a
+complex value, the imaginary component is ignored.  For complex
+arguments see *note lnGamma::.
+
+
+File: gnuplot.info,  Node: inverf,  Next: imag,  Prev: gamma,  Up: Functions
+
+1.15.3.31 inverf
+................
+
+The 'inverf(x)' function returns the inverse error function of the real
+part of its argument.  See 'erf' and *note invnorm::.
+
+
+File: gnuplot.info,  Node: imag,  Next: invnorm,  Prev: inverf,  Up: Functions
+
+1.15.3.32 imag
+..............
+
+The 'imag(x)' function returns the imaginary part of its argument as a
+real number.
+
+   int(x) returns the integer part of its argument, truncated toward
+zero.
+
+
+File: gnuplot.info,  Node: invnorm,  Next: lambertw,  Prev: imag,  Up: Functions
+
+1.15.3.33 invnorm
+.................
+
+The 'invnorm(x)' function returns the inverse cumulative normal
+(Gaussian) distribution function of the real part of its argument.  See
+*note norm::.
+
+
+File: gnuplot.info,  Node: lambertw,  Next: lgamma,  Prev: invnorm,  Up: Functions
+
+1.15.3.34 lambertw
+..................
+
+The 'lambertw(x)' function returns the value of the principal branch
+(k=0) of Lambert's W function, which is defined by the equation
+(W(x)*exp(W(x))=x.  x must be a real number with x >= -exp(-1).
+
+
+File: gnuplot.info,  Node: lgamma,  Next: lngamma,  Prev: lambertw,  Up: Functions
+
+1.15.3.35 lgamma
+................
+
+The 'lgamma(x)' function returns the natural logarithm of the gamma
+function of the real part of its argument.  If the argument is a complex
+value, the imaginary component is ignored.  For complex values use
+lnGamma(z).
+
+
+File: gnuplot.info,  Node: lngamma,  Next: log,  Prev: lgamma,  Up: Functions
+
+1.15.3.36 lngamma
+.................
+
+The 'lnGamma(x)' function returns the natural logarithm of the gamma
+function.  This implementation uses a Lanczos approximation valid over
+the entire complex plane.  The imaginary component of the result is
+phase-shifted to yield a continuous surface everywhere except the
+negative real axis.
+
+
+File: gnuplot.info,  Node: log,  Next: log10,  Prev: lngamma,  Up: Functions
+
+1.15.3.37 log
+.............
+
+The 'log(x)' function returns the natural logarithm (base 'e') of its
+argument.  See *note log10::.
+
+
+File: gnuplot.info,  Node: log10,  Next: norm,  Prev: log,  Up: Functions
+
+1.15.3.38 log10
+...............
+
+The 'log10(x)' function returns the logarithm (base 10) of its argument.
+
+
+File: gnuplot.info,  Node: norm,  Next: rand,  Prev: log10,  Up: Functions
+
+1.15.3.39 norm
+..............
+
+The 'norm(x)' function returns the cumulative normal (Gaussian)
+distribution function of the real part of its argument.  See *note
+invnorm::, 'erf' and *note erfc::.
+
+
+File: gnuplot.info,  Node: rand,  Next: real,  Prev: norm,  Up: Functions
+
+1.15.3.40 rand
+..............
+
+The 'rand(x)' function returns a pseudo random number in the interval
+(0:1).  See 'random' for more details.
+
+
+File: gnuplot.info,  Node: real,  Next: sgn,  Prev: rand,  Up: Functions
+
+1.15.3.41 real
+..............
+
+The 'real(x)' function returns the real part of its argument.
+
+   'round(x)' returns the integer nearest to the real part of x.
+Outside the domain |x|<2^52 round(x) returns NaN.
+
+
+File: gnuplot.info,  Node: sgn,  Next: Sign,  Prev: real,  Up: Functions
+
+1.15.3.42 sgn
+.............
+
+The 'sgn(x)' function returns 1 if its argument is positive, -1 if its
+argument is negative, and 0 if its argument is 0.  If the argument is a
+complex value, the imaginary component is ignored.
+
+
+File: gnuplot.info,  Node: Sign,  Next: sin,  Prev: sgn,  Up: Functions
+
+1.15.3.43 Sign
+..............
+
+The 'Sign(x)' function returns 0 if its argument is zero, otherwise it
+returns the complex value Sign(x) = x/|x|.
+
+
+File: gnuplot.info,  Node: sin,  Next: sinh,  Prev: Sign,  Up: Functions
+
+1.15.3.44 sin
+.............
+
+The 'sin(x)' function returns the sine of its argument.  'sin' expects
+its argument to be in radians or degrees, as selected by *note angles::.
+
+
+File: gnuplot.info,  Node: sinh,  Next: sqrt,  Prev: sin,  Up: Functions
+
+1.15.3.45 sinh
+..............
+
+The 'sinh(x)' function returns the hyperbolic sine of its argument.
+*note sinh:: expects its argument to be in radians.
+
+
+File: gnuplot.info,  Node: sqrt,  Next: tan,  Prev: sinh,  Up: Functions
+
+1.15.3.46 sqrt
+..............
+
+The 'sqrt(x)' function returns the square root of its argument.  If the
+x is a complex value, this always returns the root with positive real
+part.
+
+
+File: gnuplot.info,  Node: tan,  Next: tanh,  Prev: sqrt,  Up: Functions
+
+1.15.3.47 tan
+.............
+
+The 'tan(x)' function returns the tangent of its argument.  'tan'
+expects its argument to be in radians or degrees, as selected by *note
+angles::.
+
+
+File: gnuplot.info,  Node: tanh,  Next: voigt,  Prev: tan,  Up: Functions
+
+1.15.3.48 tanh
+..............
+
+The 'tanh(x)' function returns the hyperbolic tangent of its argument.
+*note tanh:: expects its argument to be in radians.
+
+
+File: gnuplot.info,  Node: voigt,  Next: cerf,  Prev: tanh,  Up: Functions
+
+1.15.3.49 voigt
+...............
+
+The function 'voigt(x,y)' returns an approximation to the Voigt/Faddeeva
+function used in spectral analysis.  The approximation is accurate to
+one part in 10^4.  If the libcerf library is available, the re_w_of_z()
+routine is used to provide a more accurate value.  Note that voigt(x,y)
+= real(faddeeva( x + y*{0,1} )).
+
+
+File: gnuplot.info,  Node: cerf,  Next: cdawson,  Prev: voigt,  Up: Functions
+
+1.15.3.50 cerf
+..............
+
+'cerf(z)' is the complex version of the error function erf(x) Requires
+external library libcerf.
+
+
+File: gnuplot.info,  Node: cdawson,  Next: faddeeva,  Prev: cerf,  Up: Functions
+
+1.15.3.51 cdawson
+.................
+
+'cdawson(z)' returns Dawson's Integral evaluated for the complex
+argument z.  cdawson(z) = sqrt(pi)/2 * exp(-z^2) * erfi(z) Requires
+external library libcerf.
+
+
+File: gnuplot.info,  Node: faddeeva,  Next: erfi,  Prev: cdawson,  Up: Functions
+
+1.15.3.52 faddeeva
+..................
+
+'faddeeva(z)' returns the scaled complex complementary error function
+faddeeva(z) = exp(-z^2) * erfc(-i*z) This corresponds to Eqs 7.1.3 and
+7.1.4 of Abramowitz and Stegun.  Requires external library libcerf.
+
+
+File: gnuplot.info,  Node: erfi,  Next: Voigt_Profile,  Prev: faddeeva,  Up: Functions
+
+1.15.3.53 erfi
+..............
+
+Imaginary error function erfi(x) = -i * erf(ix) Requires external
+library libcerf.
+
+
+File: gnuplot.info,  Node: Voigt_Profile,  Next: gprintf,  Prev: erfi,  Up: Functions
+
+1.15.3.54 Voigt Profile
+.......................
+
+'VP(x,sigma,gamma)' corresponds to the Voigt profile defined by
+convolution of a Gaussian G(x;sigma) with a Lorentzian L(x;gamma).
+'VP_fwhm(sigma,gamma)' gives the full width at half maximum value of
+this function.
+
+
+File: gnuplot.info,  Node: gprintf,  Next: sprintf,  Prev: Voigt_Profile,  Up: Functions
+
+1.15.3.55 gprintf
+.................
+
+'gprintf("format",x)' applies gnuplot's own format specifiers to the
+single variable x and returns the resulting string.  If you want
+standard C-language format specifiers, you must instead use
+'sprintf("format",x)'.  See 'format specifiers'.
+
+
+File: gnuplot.info,  Node: sprintf,  Next: strlen,  Prev: gprintf,  Up: Functions
+
+1.15.3.56 sprintf
+.................
+
+'sprintf("format",var1,var2,...)'  applies standard C-language format
+specifiers to multiple arguments and returns the resulting string.  If
+you want to use gnuplot's own format specifiers, you must instead call
+'gprintf()'.  For information on sprintf format specifiers, please see
+standard C-language documentation or the unix sprintf man page.
+
+
+File: gnuplot.info,  Node: strlen,  Next: strstrt,  Prev: sprintf,  Up: Functions
+
+1.15.3.57 strlen
+................
+
+'strlen("string")' returns the number of characters in a string taking
+into account the current encoding.  If the current encoding supports
+multibyte characters (SJIS UTF8), this may be less than the number of
+bytes in the string.  If the string contains multibyte UTF8 characters
+but the current encoding is set to something other than UTF8,
+strlen("utf8string") will return a value that is larger than the actual
+number of characters.
+
+
+File: gnuplot.info,  Node: strstrt,  Next: substr,  Prev: strlen,  Up: Functions
+
+1.15.3.58 strstrt
+.................
+
+'strstrt("string","key")' searches for the character string "key" in
+"string" and returns the index to the first character of "key".  If
+"key" is not found, it returns 0.  Similar to C library function strstr
+except that it returns an index rather than a string pointer.
+strstrt("hayneedlestack","needle") = 4.  This function is aware of utf8
+encoding, so strstrt("αβγ","β") returns 2.
+
+
+File: gnuplot.info,  Node: substr,  Next: split,  Prev: strstrt,  Up: Functions
+
+1.15.3.59 substr
+................
+
+'substr("string",beg,end)' returns the substring consisting of
+characters beg through end of the original string.  This is exactly
+equivalent to the expression "string"[beg:end] except that you do not
+have the option of omitting beg or end.
+
+
+File: gnuplot.info,  Node: split,  Next: join,  Prev: substr,  Up: Functions
+
+1.15.3.60 split
+...............
+
+'split("string", "sep")' uses the character sequence in "sep" as a field
+separator to split the content of "string" into individual fields.  It
+returns an array of strings, each corresponding to one field of the
+original string.  The second parameter "sep" is optional.  If "sep" is
+omitted or if it contains a single space character the fields are split
+by any amount of whitespace (space, tab, formfeed, newline, return).
+Otherwise the full sequence of characters in "sep" must be matched.  For
+examples, see 'counting_words'.
+
+
+File: gnuplot.info,  Node: join,  Next: strftime,  Prev: split,  Up: Functions
+
+1.15.3.61 join
+..............
+
+'join(array, "sep")' concatenates the string elements of an array into a
+single string containing fields delimited by the character sequence in
+"sep".  Non-string array elements generate an empty field.  For
+examples, see 'counting_words'.
+
+
+File: gnuplot.info,  Node: strftime,  Next: strptime,  Prev: join,  Up: Functions
+
+1.15.3.62 strftime
+..................
+
+'strftime("timeformat",t)' applies the timeformat specifiers to the time
+t given in seconds since the year 1970.  See 'time_specifiers' and *note
+strptime::.
+
+
+File: gnuplot.info,  Node: strptime,  Next: system,  Prev: strftime,  Up: Functions
+
+1.15.3.63 strptime
+..................
+
+'strptime("timeformat",s)' reads the time from the string s using the
+timeformat specifiers and converts it into seconds since the year 1970.
+See 'time_specifiers' and *note strftime::.
+
+
+File: gnuplot.info,  Node: system,  Next: trim,  Prev: strptime,  Up: Functions
+
+1.15.3.64 system
+................
+
+'system("command")' executes "command" using the standard shell and
+returns the resulting character stream from stdout as string variable.
+One optional trailing newline is ignored.
+
+   This can be used to import external functions into gnuplot scripts
+using 'f(x) = real(system(sprintf("somecommand %f", x)))'.
+
+
+File: gnuplot.info,  Node: trim,  Next: word,  Prev: system,  Up: Functions
+
+1.15.3.65 trim
+..............
+
+'trim(" padded string ")' returns the original string stripped of
+leading and trailing whitespace.  This is useful for string comparisons
+of input data fields that may contain extra whitespace.  For example
+          plot FOO using 1:( trim(strcol(3)) eq "A" ? $2 : NaN )
+
+
+
+File: gnuplot.info,  Node: word,  Next: words,  Prev: trim,  Up: Functions
+
+1.15.3.66 word
+..............
+
+'word("string",n)' returns the nth word in string.  For example,
+'word("one two three",2)' returns the string "two".
+
+
+File: gnuplot.info,  Node: words,  Next: exists,  Prev: word,  Up: Functions
+
+1.15.3.67 words
+...............
+
+'words("string")' returns the number of words in string.  For example,
+'words(" a b c d")' returns 4.
+
+   The 'tm_hour(t)' function interprets its argument as a time, in
+seconds from 1 Jan 1970.  It returns the hour (an integer in the range
+0-23) as a real.
+
+   The 'tm_mday(t)' function interprets its argument as a time, in
+seconds from 1 Jan 1970.  It returns the day of the month (an integer in
+the range 1-31) as a real.
+
+   The 'tm_min(t)' function interprets its argument as a time, in
+seconds from 1 Jan 1970.  It returns the minute (an integer in the range
+0-59) as a real.
+
+   The 'tm_mon(t)' function interprets its argument as a time, in
+seconds from 1 Jan 1970.  It returns the month (an integer in the range
+0-11) as a real.
+
+   The 'tm_sec(t)' function interprets its argument as a time, in
+seconds from 1 Jan 1970.  It returns the second (an integer in the range
+0-59) as a real.
+
+   The 'tm_wday(t)' function interprets its argument as a time, in
+seconds from 1 Jan 1970.  It returns the day of the week (Sun..Sat) as
+an integer (0..6).
+
+   The 'tm_yday(t)' function interprets its argument as a time, in
+seconds from 1 Jan 1970.  It returns the day of the year (an integer in
+the range 0-365) as a real.
+
+   The 'tm_year(t)' function interprets its argument as a time, in
+seconds from 1 Jan 1970.  It returns the year (an integer) as a real.
+
+
+File: gnuplot.info,  Node: exists,  Next: hsv2rgb,  Prev: words,  Up: Functions
+
+1.15.3.68 exists
+................
+
+The argument to 'exists()' is a string constant or a string variable; if
+the string contains the name of a defined variable, the function returns
+1.  Otherwise the function returns 0.
+
+
+File: gnuplot.info,  Node: hsv2rgb,  Next: palette,  Prev: exists,  Up: Functions
+
+1.15.3.69 hsv2rgb
+.................
+
+The 'hsv2rgb(h,s,v)' function converts HSV (Hue/Saturation/Value)
+triplet to an equivalent RGB value.
+
+
+File: gnuplot.info,  Node: palette,  Next: rgbcolor,  Prev: hsv2rgb,  Up: Functions
+
+1.15.3.70 palette
+.................
+
+'palette(z)' returns the 24 bit RGB representation of the palette color
+      mapped to z given the current extremes of cbrange.
+
+
+
+File: gnuplot.info,  Node: rgbcolor,  Next: voxel,  Prev: palette,  Up: Functions
+
+1.15.3.71 rgbcolor
+..................
+
+'rgbcolor("name")' returns an integer containing the 32 bit alpha + RGB
+color value of a named color or a string of the form "0xAARRGGBB" or
+"#AARRGGBB". If the string is not recognized as a color description the
+function returns 0.  This can be used to read a color name from a data
+file or to add an alpha channel to a named color in the upper byte of
+the returned value.  See *note colorspec::.
+
+
+File: gnuplot.info,  Node: voxel,  Next: integer_conversion_functions_(int_floor_ceil_round),  Prev: rgbcolor,  Up: Functions
+
+1.15.3.72 voxel
+...............
+
+The function voxel(x,y,z) returns the value of the voxel in the
+currently active grid that contains the point (x,y,z).  It may also be
+used on the left side of an assignment statement to set the value of
+that voxel.  E.g.  voxel(x,y,z) = 0.0 See 'splot voxel-grids', *note
+vgrid::.
+
+
+File: gnuplot.info,  Node: integer_conversion_functions_(int_floor_ceil_round),  Next: elliptic_integrals,  Prev: voxel,  Up: Functions
+
+1.15.3.73 integer conversion functions (int floor ceil round)
+.............................................................
+
+Gnuplot integer variables are stored with 64 bits of precision if that
+is supported by the platform.
+
+   Gnuplot complex and real variables are on most platforms stored in
+IEEE754 binary64 (double) floating point representation.  Their
+precision is limited to 53 bits, corresponding to roughly 16 significant
+digits.
+
+   Therefore integers with absolute value larger than 2^53 cannot be
+uniquely represented in a floating point variable.  I.e.  for large N
+the operation int(real(N)) may return an integer near but not equal to
+N.
+
+   Furthermore, functions that convert from a floating point value to an
+integer by truncation may not yield the expected value if the operation
+depends on more than 15 significant digits of precision even if the
+magnitude is small.  For example int(log10(0.1)) returns 0 rather than
+-1 because the floating point representation is equivalent to
+-0.999999999999999...  See also *note overflow::.
+
+   'int(x)' returns the integer part of its argument, truncated toward
+zero.  If |x| > 2^63, i.e.  too large to represent as an integer, NaN is
+returned.  If |x| > 2^52 the return value will lie within a range of
+neighboring integers that cannot be distinguished due to limited
+floating point precision.  See 'integer conversion'.
+
+   'floor(x)' returns the largest integer not greater than the real part
+of x.  If |x| > 2^52 the true value cannot be uniquely determined; in
+this case the return value is NaN. See 'integer conversion'.
+
+   'ceil(x)' returns the smallest integer not less than the real part of
+x.  If |x| > 2^52 the true value cannot be uniquely determined; in this
+case the return value is NaN. See 'integer conversion'.
+
+   'round(x)' returns the integer nearest to the real part of x.  If |x|
+> 2^52 the true value cannot be uniquely determined; in this case the
+return value is NaN. See 'integer conversion'.
+
+
+File: gnuplot.info,  Node: elliptic_integrals,  Next: Complex_Airy_functions,  Prev: integer_conversion_functions_(int_floor_ceil_round),  Up: Functions
+
+1.15.3.74 elliptic integrals
+............................
+
+The 'EllipticK(k)' function returns the complete elliptic integral of
+the first kind, i.e.  the definite integral between 0 and pi/2 of the
+function '(1 - k^2*sin^2(θ))^(-0.5)'.  The domain of 'k' is -1 to 1
+(exclusive).
+
+   The 'EllipticE(k)' function returns the complete elliptic integral of
+the second kind, i.e.  the definite integral between 0 and pi/2 of the
+function '(1 - k^2*sin^2(θ))^0.5'.  The domain of 'k' is -1 to 1
+(inclusive).
+
+   The 'EllipticPi(n,k)' function returns the complete elliptic integral
+of the third kind, i.e.  the definite integral between 0 and pi/2 of the
+function '(1 - k^2*sin^2(θ))^(-0.5) / (1 - n*sin^2(θ))'.  The parameter
+'n' must be less than 1, while 'k' must lie between -1 and 1
+(exclusive).  Note that by definition EllipticPi(0,k) == EllipticK(k)
+for all possible values of 'k'.
+
+   Elliptic integral algorithm: B.C.Carlson 1995, Numerical Algorithms
+10:13-26.
+
+
+File: gnuplot.info,  Node: Complex_Airy_functions,  Next: Complex_Bessel_functions,  Prev: elliptic_integrals,  Up: Functions
+
+1.15.3.75 Complex Airy functions
+................................
+
+'Ai(z)' and 'Bi(z)' are the Airy functions of complex argument z,
+computed in terms of the modified Bessel functions K and I. Supported
+via an external library containing routines by Donald E. Amos, Sandia
+National Laboratories, SAND85-1018 (1985).
+
+
+File: gnuplot.info,  Node: Complex_Bessel_functions,  Next: Expint,  Prev: Complex_Airy_functions,  Up: Functions
+
+1.15.3.76 Complex Bessel functions
+..................................
+
+'BesselJ(nu,z)' is the Bessel function of the first kind J_nu for real
+argument nu and complex argument z.  Supported via external library
+containing routines by Donald E. Amos, Sandia National Laboratories,
+SAND85-1018 (1985).
+
+   'BesselY(nu,z)' is the Bessel function of the second kind Y_nu for
+real argument nu and complex argument z.  Supported via external library
+containing routines by Donald E. Amos, Sandia National Laboratories,
+SAND85-1018 (1985).
+
+   'BesselI(nu,z)' is the modified Bessel function of the first kind
+I_nu for real argument nu and complex argument z.  Supported via
+external library containing routines by Donald E. Amos, Sandia National
+Laboratories, SAND85-1018 (1985).
+
+   'BesselK(nu,z)' is the modified Bessel function of the second kind
+K_nu for real argument nu and complex argument z.  Supported via
+external library containing routines by Donald E. Amos, Sandia National
+Laboratories, SAND85-1018 (1985).
+
+   'BesselH1(nu,z)' and 'BesselH2(nu,z)' are the Hankel functions of the
+first and second kind
+         H1(nu,z) = J(nu,z) + iY(nu,z)
+         H2(nu,z) = J(nu,z) - iY(nu,z)
+
+   for real argument nu and complex argument z.  Supported via external
+library containing routines by Donald E. Amos, Sandia National
+Laboratories, SAND85-1018 (1985).
+
+
+File: gnuplot.info,  Node: Expint,  Next: Fresnel_integrals_FresnelC(x)_and_FresnelS(x),  Prev: Complex_Bessel_functions,  Up: Functions
+
+1.15.3.77 Expint
+................
+
+'expint(n,z)' returns the exponential integral of order n, where n is an
+integer >= 0.  This is the integral from 1 to infinity of t^(-n) e^(-tz)
+dt.
+
+   If your copy of gnuplot was built with support for complex functions
+from the Amos library, then for n>0 the evaluation uses Amos routine
+cexint [Amos 1990 Algorithm 683, ACM Trans Math Software 16:178].  In
+this case z may be any complex number with -pi < arg(z) <= pi.
+expint(0,z) is calculated as exp(-z)/z.
+
+   If Amos library support is not present, z is limited to real values z
+>= 0.
+
+
+File: gnuplot.info,  Node: Fresnel_integrals_FresnelC(x)_and_FresnelS(x),  Next: Gamma,  Prev: Expint,  Up: Functions
+
+1.15.3.78 Fresnel integrals FresnelC(x) and FresnelS(x)
+.......................................................
+
+The cosine and sine Fresnel integrals are calculated using their
+relationship to the complex error function erf(z).  Due to dependence on
+erf(z), these functions are only available if libcerf library support is
+present.
+
+
+File: gnuplot.info,  Node: Gamma,  Next: Igamma,  Prev: Fresnel_integrals_FresnelC(x)_and_FresnelS(x),  Up: Functions
+
+1.15.3.79 Gamma
+...............
+
+'gamma(x)' returns the gamma function of the real part of its argument.
+For integer n, gamma(n+1) = n!.  If the argument is a complex value, the
+imaginary component is ignored.  For complex arguments see *note
+lnGamma::.
+
+
+File: gnuplot.info,  Node: Igamma,  Next: Invigamma,  Prev: Gamma,  Up: Functions
+
+1.15.3.80 Igamma
+................
+
+'igamma(a, z)' returns the lower incomplete gamma function P(a, z),
+[Abramowitz and Stegun (6.5.1); NIST DLMF 8.2.4].  If complex function
+support is present a and z may be complex values; real(a) > 0; For the
+complementary upper incomplete gamma function, see *note uigamma::.
+
+   One of four algorithms is used depending on a and z.  Case (1) When a
+is large (>100) and (z-a)/a is small (<0.2) use Gauss-Legendre
+quadrature with coefficients from Numerical Recipes 3rd Edition section
+6.2, Press et al (2007).  Case (2) When z > 1 and z > (a+2) use a
+continued fraction following Shea (1988) J. Royal Stat.  Soc.  Series C
+(Applied Statistics) 37:466-473.  Case (3) When z < 0 and a < 75 and
+imag(a) == 0 use the series from Abramowitz & Stegun (6.5.29).
+Otherwise (Case 4) use Pearson's series expansion.
+
+   Note that convergence is poor in some regions of the full domain.  If
+the chosen algorithm does not converge to within 1.E-14 the function
+returns NaN and prints a warning.
+
+   If no complex function support is present the domain is limited to
+real arguments a > 0, z >= 0.
+
+
+File: gnuplot.info,  Node: Invigamma,  Next: Ibeta,  Prev: Igamma,  Up: Functions
+
+1.15.3.81 Invigamma
+...................
+
+The inverse incomplete gamma function 'invigamma(a,p)' returns the value
+z such that p = igamma(a,z).  p is limited to (0;1].  a must be a
+positive real number.  The implementation in gnuplot has relative
+accuracy that ranges from 1.e-16 for a<1 to 5.e-6 for a = 1.e10.
+Convergence may fail for a < 0.005.
+
+
+File: gnuplot.info,  Node: Ibeta,  Next: Invibeta,  Prev: Invigamma,  Up: Functions
+
+1.15.3.82 Ibeta
+...............
+
+'ibeta(a,b,x)' returns the normalized lower incomplete beta integral of
+real arguments a,b > 0, x in [0:1].
+
+   If the arguments are complex, the imaginary components are ignored.
+The implementation in gnuplot uses code from the Cephes library [Moshier
+1989, "Methods and Programs for Mathematical Functions", Prentice-Hall].
+
+
+File: gnuplot.info,  Node: Invibeta,  Next: LambertW,  Prev: Ibeta,  Up: Functions
+
+1.15.3.83 Invibeta
+..................
+
+The inverse incomplete beta function 'invibeta(a,b,p)' returns the value
+z such that p = ibeta(a,b,z).  a, b are limited to positive real values
+and p is in the interval [0,1].  Note that as a, b approach zero
+invibeta() approaches 1.0 and its relative accuracy is limited by
+floating point precision.
+
+
+File: gnuplot.info,  Node: LambertW,  Next: lnGamma,  Prev: Invibeta,  Up: Functions
+
+1.15.3.84 LambertW
+..................
+
+Lambert W function with complex domain and range.  LambertW( z, k )
+returns the kth branch of the function W defined by the equation W(z) *
+exp(W(z)) = z.  The complex value is obtained using Halley's method as
+described by Corless et al [1996], Adv.  Comp.  Math 5:329.  The nominal
+precision is 1.E-13 but convergence can be poor very close to
+discontinuities, e.g.  branch points.
+
+
+File: gnuplot.info,  Node: lnGamma,  Next: Random_number_generator,  Prev: LambertW,  Up: Functions
+
+1.15.3.85 lnGamma
+.................
+
+lnGamma(z) returns the natural log of the gamma function with complex
+domain and range.  Implemented using 14 term approximation following
+Lanczos [1964], SIAM JNA 1:86-96.  The imaginary component of the result
+is phase-shifted to yield a continuous surface everywhere except the
+negative real axis.
+
+
+File: gnuplot.info,  Node: Random_number_generator,  Next: Special_functions_with_complex_arguments,  Prev: lnGamma,  Up: Functions
+
+1.15.3.86 Random number generator
+.................................
+
+The function 'rand()' produces a sequence of pseudo-random numbers
+between 0 and 1 using an algorithm from P. L'Ecuyer and S. Cote,
+"Implementing a random number package with splitting facilities", ACM
+Transactions on Mathematical Software, 17:98-111 (1991).
+
+           rand(0)     returns a pseudo random number in the open interval (0:1)
+                       generated from the current value of two internal
+                       32-bit seeds.
+           rand(-1)    resets both seeds to a standard value.
+           rand(x)     for integer 0 < x < 2^31-1 sets both internal seeds
+                       to x.
+           rand({x,y}) for integer 0 < x,y < 2^31-1 sets seed1 to x and
+                       seed2 to y.
+
+
+
+File: gnuplot.info,  Node: Special_functions_with_complex_arguments,  Next: Synchrotron_function,  Prev: Random_number_generator,  Up: Functions
+
+1.15.3.87 Special functions with complex arguments
+..................................................
+
+Some special functions with complex domain are provided through external
+libraries.  If your copy of gnuplot was not configured to link against
+these libraries then it will support only the real domain or will not
+provide the function at all.
+
+   Functions requiring libcerf (http://apps.jcns.fz-juelich.de/libcerf)
+depend on configuration option '-with-libcerf'.  This is the default.
+See *note cerf::, *note cdawson::, *note faddeeva::, *note erfi::, 'VP',
+and 'VP_fwhm'.
+
+   Complex Airy, Bessel, and Hankel functions of real order nu and
+complex arguments require a library containing routines implemented by
+Douglas E. Amos, Sandia National Laboratories, SAND85-1018 (1985).
+These routines may be found in netlib (http://netlib.sandia.gov) or in
+libopenspecfun (https://github.com/JuliaLang/openspecfun).  The
+corresponding configuration option is '-with-amos=<library directory>'.
+See 'Ai', 'Bi', 'BesselJ', 'BesselY', 'BesselI', 'BesselK', 'Hankel'.
+The complex exponential integral is provided by netlib or libamos but
+not by libopenspecfun.  See 'expint'.
+
+
+File: gnuplot.info,  Node: Synchrotron_function,  Next: Time_functions,  Prev: Special_functions_with_complex_arguments,  Up: Functions
+
+1.15.3.88 Synchrotron function
+..............................
+
+The synchrotron function SynchrotronF(x) describes the power
+distribution spectrum of synchrotron radiation as a function of x given
+in units of the critical photon energy (i.e.  critical frequency vc).
+
+   Chebyshev coefficients for approximation accurate to 1.E-15 are taken
+from MacLead (2000) NuclInstMethPhysRes A443:540-545.
+
+
+File: gnuplot.info,  Node: Time_functions,  Next: uigamma,  Prev: Synchrotron_function,  Up: Functions
+
+1.15.3.89 Time functions
+........................
+
+-- TIME --
+
+   The 'time(x)' function returns the current system time.  This value
+can be converted to a date string with the *note strftime:: function, or
+it can be used in conjunction with 'timecolumn' to generate relative
+time/date plots.  The type of the argument determines what is returned.
+If the argument is an integer, time() returns the current time as an
+integer, in seconds from the epoch date, 1 Jan 1970.  If the argument is
+real (or complex), the result is real as well.  If the argument is a
+string, it is assumed to be a format and it is passed to *note
+strftime:: to provide a formatted time string.  See also
+'time_specifiers' and *note timefmt::.
+
+-- TIMECOLUMN --
+
+   'timecolumn(N,"timeformat")' reads string data starting at column N
+as a time/date value and uses "timeformat" to interpret this as "seconds
+since the epoch" to millisecond precision.  If no format parameter is
+given, the format defaults to the string from *note timefmt::.  This
+function is valid only in the 'using' specification of a plot or stats
+command.  See 'plot datafile using'.
+
+-- TM_STRUCTURE --
+
+   Gnuplot stores time internally as a 64-bit floating point value
+representing seconds since the epoch date 1 Jan 1970.  In order to
+interpret this as a time or date it is converted to or from a POSIX
+standard structure 'struct_tm'.  Note that fractional seconds, if any,
+cannot be retrieved via tm_sec().  The components may be accessed
+individually using the functions
+   * 'tm_hour(t)' integer hour in the range 0-23
+   * 'tm_mday(t)' integer day of month in the range 1-31
+   * 'tm_min(t)' integer minute in the range 0-59
+   * 'tm_mon(t)' integer month of year in the range 0-11
+   * 'tm_sec(t)' integer second in the range 0-59
+   * 'tm_wday(t)' integer day of the week in the range 0
+     (Sunday)-6(Saturday)
+   * 'tm_yday(t)' integer day of the year the range 0-365
+   * 'tm_year(t)' integer year
+
+-- TM_WEEK --
+
+   The 'tm_week(t, standard)' function interprets its first argument t
+as a time in seconds from 1 Jan 1970.  Despite the name of this function
+it does not report a field from the POSIX tm structure.
+
+   If standard = 0 it returns the week number in the ISO 8601 "week
+date" system.  This corresponds to gnuplot's %W time format.  If
+standard = 1 it returns the CDC epidemiological week number ("epi
+week").  This corresponds to gnuplot's %U time format.  For
+corresponding inverse functions that convert week dates to calendar time
+see 'weekdate_iso', 'weekdate_cdc'.
+
+   In brief, ISO Week 1 of year YYYY begins on the Monday closest to 1
+Jan YYYY. This may place it in the previous calendar year.  For example
+Tue 30 Dec 2008 has ISO week date 2009-W01-2 (2nd day of week 1 of
+2009).  Up to three days at the start of January may come before the
+Monday of ISO week 1; these days are assigned to the final week of the
+previous calendar year.  E.g.  Fri 1 Jan 2021 has ISO week date
+2020-W53-5.
+
+   The US Center for Disease Control (CDC) epidemiological week is a
+similar week date convention that differs from the ISO standard by
+defining a week as starting on Sunday, rather than on Monday.
+
+-- WEEKDATE_ISO --
+
+   Syntax:
+          time = weekdate_iso( year, week [, day] )
+
+
+   This function converts from the year, week, day components of a date
+in ISO 8601 "week date" format to the calendar date as a time in seconds
+since the epoch date 1 Jan 1970.  Note that the nominal year in the week
+date system is not necessarily the same as the calendar year.  The week
+is an integer from 1 to 53.  The day parameter is optional.  If it is
+omitted or equal to 0 the time returned is the start of the week.
+Otherwise day is an integer from 1 (Monday) to 7 (Sunday).  See
+'tm_week' for additional information on an inverse function that
+converts from calendar date to week number in the ISO standard
+convention.
+
+   Example:
+          # Plot data from a file with column 1 containing ISO weeks
+          #     Week     cases  deaths
+          #     2020-05    432       1
+          calendar_date(w) = weekdate_iso( int(w[1:4]), int(w[6:7]) )
+          set xtics time format "%b\n%Y"
+          plot FILE using (calendar_date(strcol(1))) : 2   title columnhead
+
+
+-- WEEKDATE_CDC --
+
+   Syntax:
+          time = weekdate_cdc( year, week [, day] )
+
+
+   This function converts from the year, week, day components of a date
+in the CDC/MMWR "epi week" format to the calendar date as a time in
+seconds since the epoch date 1 Jan 1970.  The CDC week date convention
+differs from the ISO week date in that it is defined in terms of each
+week running from day 1 = Sunday to day 7 = Saturday.  If the third
+parameter is 0 or is omitted, the time returned is the start of the
+week.  See 'tm_week' and 'weekdate_iso'.
+
+
+File: gnuplot.info,  Node: uigamma,  Next: using_specifier_functions,  Prev: Time_functions,  Up: Functions
+
+1.15.3.90 uigamma
+.................
+
+'uigamma(a, x)' returns the regularized upper incomplete gamma function
+Q(a, x), NIST DLMF eq 8.2.4 For the complementary lower incomplete gamma
+function P(a,x), see 'igamma'.  Q(a, x) + P(a, x) = 1.
+
+   The current implementation is from the Cephes library (Moshier 2000).
+The domain is restricted to real a>0, real x>=0.
+
+
+File: gnuplot.info,  Node: using_specifier_functions,  Next: value,  Prev: uigamma,  Up: Functions
+
+1.15.3.91 using specifier functions
+...................................
+
+These functions are valid only in the context of data input.  Usually
+this means use in an expression that provides an input field of the
+'using' specifier in a 'plot', 'splot', *note fit::, or 'stats' command.
+However the scope of the functions is actually the full clause of the
+plot command, including for example use of 'columnhead' in constructing
+the plot title.
+
+-- COLUMN --
+
+   The 'column(x)' function may be used only in the 'using' specifier of
+a plot, splot, fit, or stats command.  It evaluates to the numerical
+value of the content of column x.  If the column is expected to hold a
+string, use instead stringcolumn(x) or timecolumn(x, "timeformat").  See
+'plot datafile using', 'stringcolumn', 'timecolumn'.
+
+-- COLUMNHEAD --
+
+   The 'columnhead(x)' function may only be used as part of a plot,
+splot, or stats command.  It evaluates to a string containing the
+content of column x in the first line of a data file.  This is typically
+used to extract the column header for use in a plot title.  See 'plot
+datafile using'.  Example:
+          set datafile columnheader
+          plot for [i=2:4] DATA using 1:i title columnhead(i)
+
+
+-- STRINGCOLUMN --
+
+   The 'stringcolumn(x)' function may be used only in the 'using'
+specification of a data plot or *note fit:: command.  It returns the
+content of column x as a string.  'strcol(x)' is shorthand for
+'stringcolumn(x)'.  If the string is to be interpreted as a time or
+date, use instead timecolumn(x, "timeformat").  See 'plot datafile
+using'.
+
+-- VALID --
+
+   The 'valid(x)' function may be used only in expressions that are part
+of a 'using' specification.  It can be used to detect explicit NaN
+values or unexpected garbage in a field of the input stream, perhaps to
+substitute a default value or to prevent further arithmetic operations
+using NaN. Both "missing" and NaN (not-a-number) data values are
+considered to be invalid, but it is important to note that if the
+program recognizes that a field is truly missing or contains a "missing"
+flag then the input line is discarded before the expression invoking
+valid() would be called.  See 'plot datafile using', 'missing'.
+
+   Example:
+          # Treat an unrecognized bin value as contributing some constant
+          # prior expectation to the bin total rather than ignoring it.
+          plot DATA using 1 : (valid(2) ? $2 : prior) smooth unique
+
+
+
+File: gnuplot.info,  Node: value,  Next: Counting_and_extracting_words,  Prev: using_specifier_functions,  Up: Functions
+
+1.15.3.92 value
+...............
+
+B = value("A") is effectively the same as B = A, where A is the name of
+a user-defined variable.  This is useful when the name of the variable
+is itself held in a string variable.  See 'user-defined variables'.  It
+also allows you to read the name of a variable from a data file.  If the
+argument is a numerical expression, value() returns the value of that
+expression.  If the argument is a string that does not correspond to a
+currently defined variable, value() returns NaN.
+
+
+File: gnuplot.info,  Node: Counting_and_extracting_words,  Next: zeta,  Prev: value,  Up: Functions
+
+1.15.3.93 Counting and extracting words
+.......................................
+
+'word("string",n)' returns the nth word in string.  For example,
+'word("one two three",2)' returns the string "two".
+
+   'words("string")' returns the number of words in string.  For
+example, 'words(" a b c d")' returns 4.
+
+   Words must be separated by whitespace; if you need to extract
+individual fields from a string that are separated by some other
+character, use instead *note split::.
+
+   The 'word' and *note words:: functions provide limited support for
+quoted strings, both single and double quotes can be used:
+           print words("\"double quotes\" or 'single quotes'")   # 3
+
+   A starting quote must either be preceded by a white space, or start
+the string.  This means that apostrophes in the middle or at the end of
+words are considered as parts of the respective word:
+           print words("Alexis' phone doesn't work") # 4
+
+   Escaping quote characters is not supported.  If you want to keep
+certain quotes, the respective section must be surrounded by the other
+kind of quotes:
+           s = "Keep \"'single quotes'\" or '\"double quotes\"'"
+           print word(s, 2) # 'single quotes'
+           print word(s, 4) # "double quotes"
+
+   Note, that in this last example the escaped quotes are necessary only
+for the string definition.
+
+   'split("string", "sep")' uses the character sequence in "sep" as a
+field separator to split the content of "string" into individual fields.
+It returns an array of strings, each corresponding to one field of the
+original string.  The second parameter "sep" is optional.  If "sep" is
+omitted or if it contains a single space character the fields are split
+by any amount of whitespace (space, tab, formfeed, newline, return).
+Otherwise the full sequence of characters in "sep" must be matched.
+
+   The three examples below each produce an array [ "A", "B", "C", "D" ]
+         t1 = split( "A B C D" )
+         t2 = split( "A B C D", " ")
+         t3 = split( "A;B;C;D", ";")
+
+
+   However the command
+         t4 = split( "A;B; C;D", "; " )
+
+   produces an array containing only two strings [ "A;B", "C;D" ]
+because the two-character field separator sequence "; " is found only
+once.
+
+   Note: Breaking the string into an array of single characters using an
+empty string for sep is not currently implemneted.  You can instead
+accomplish this using single character substrings: Array[i] =
+"string"[i:i]
+
+   'join(array, "sep")' concatenates the string elements of an array
+into a single string containing fields delimited by the character
+sequence in "sep".  Non-string array elements generate an empty field.
+The complementary operation *note split:: break extracts fields from a
+string to create an array.  Example:
+         array A = ["A", "B", , 7, "E"]
+         print join(A,";")
+               A;B;;;E
+
+
+   'trim(" padded string ")' returns the original string stripped of
+leading and trailing whitespace.  This is useful for string comparisons
+of input data fields that may contain extra whitespace.  For example
+          plot FOO using 1:( trim(strcol(3)) eq "A" ? $2 : NaN )
+
+
+
+File: gnuplot.info,  Node: zeta,  Prev: Counting_and_extracting_words,  Up: Functions
+
+1.15.3.94 zeta
+..............
+
+zeta(s) is the Riemann zeta function with complex domain and range.
+
+   This implementation uses the polynomial series described in algorithm
+3 of P. Borwein [2000] Canadian Mathematical Society Conference
+Proceedings.  The nominal precision is 1.e-16 over the complex plane.
+However note that this does not guarantee that non-trivial zeros of the
+zeta function will evaluate exactly to 0.
+
+
+File: gnuplot.info,  Node: operators,  Next: summation,  Prev: Functions,  Up: Expressions
+
+1.15.4 operators
+----------------
+
+The operators in 'gnuplot' are the same as the corresponding operators
+in the C programming language, except that all operators accept integer,
+real, and complex arguments, unless otherwise noted.  The ** operator
+(exponentiation) is supported, as in FORTRAN.
+
+   Operator precedence is the same as in Fortran and C. As in those
+languages, parentheses may be used to change the order of operation.
+Thus -2**2 = -4, but (-2)**2 = 4.
+
+* Menu:
+
+* Unary::
+* Binary::
+* Ternary::
+
+
+File: gnuplot.info,  Node: Unary,  Next: Binary,  Prev: operators,  Up: operators
+
+1.15.4.1 Unary
+..............
+
+The following is a list of all the unary operators:
+
+         Symbol      Example    Explanation
+           -           -a          unary minus
+           +           +a          unary plus (no-operation)
+           ~           ~a        * one's complement
+           !           !a        * logical negation
+           !           a!        * factorial
+           $           $3        * data column in `using` specifier
+           ||          |A|         cardinality of array A
+
+   (*) Starred explanations indicate that the operator requires an
+integer argument.
+
+   The factorial operator returns an integer when N! is sufficiently
+small (N <= 20 for 64-bit integers).  It returns a floating point
+approximation for larger values of N.
+
+   The cardinality operator |...| returns the number of elements |A| in
+array A. It returns the number of data lines |$DATA| when applied to
+datablock $DATA.
+
+
+File: gnuplot.info,  Node: Binary,  Next: Ternary,  Prev: Unary,  Up: operators
+
+1.15.4.2 Binary
+...............
+
+The following is a list of all the binary operators:
+
+         Symbol       Example      Explanation
+           **          a**b          exponentiation
+           *           a*b           multiplication
+           /           a/b           division
+           %           a%b         * modulo
+           +           a+b           addition
+           -           a-b           subtraction
+           ==          a==b          equality
+           !=          a!=b          inequality
+           <           a<b           less than
+           <=          a<=b          less than or equal to
+           >           a>b           greater than
+           >=          a>=b          greater than or equal to
+           <<          0xff<<1       left shift unsigned
+           >>          0xff>>2       right shift unsigned
+           &           a&b         * bitwise AND
+           ^           a^b         * bitwise exclusive OR
+           |           a|b         * bitwise inclusive OR
+           &&          a&&b        * logical AND
+           ||          a||b        * logical OR
+           =           a = b         assignment
+           ,           (a,b)         serial evaluation
+           .           A.B           string concatenation
+           eq          A eq B        string equality
+           ne          A ne B        string inequality
+
+   (*) Starred explanations indicate that the operator requires integer
+arguments.  Capital letters A and B indicate that the operator requires
+string arguments.
+
+   Logical AND (&&) and OR (||) short-circuit the way they do in C. That
+is, the second '&&' operand is not evaluated if the first is false; the
+second '||' operand is not evaluated if the first is true.
+
+   Serial evaluation occurs only in parentheses and is guaranteed to
+proceed in left to right order.  The value of the rightmost
+subexpression is returned.
+
+
+File: gnuplot.info,  Node: Ternary,  Prev: Binary,  Up: operators
+
+1.15.4.3 Ternary
+................
+
+There is a single ternary operator:
+
+         Symbol       Example      Explanation
+           ?:          a?b:c     ternary operation
+
+
+   The ternary operator behaves as it does in C. The first argument (a),
+which must be an integer, is evaluated.  If it is true (non-zero), the
+second argument (b) is evaluated and returned; otherwise the third
+argument (c) is evaluated and returned.
+
+   The ternary operator is very useful both in constructing piecewise
+functions and in plotting points only when certain conditions are met.
+
+   Examples:
+
+   Plot a function that is to equal sin(x) for 0 <= x < 1, 1/x for 1 <=
+x < 2, and undefined elsewhere:
+           f(x) = 0<=x && x<1 ? sin(x) : 1<=x && x<2 ? 1/x : 1/0
+           plot f(x)
+
+   Note that 'gnuplot' quietly ignores undefined values when plotting,
+so the final branch of the function (1/0) will produce no plottable
+points.  Note also that f(x) will be plotted as a continuous function
+across the discontinuity if a line style is used.  To plot it
+discontinuously, create separate functions for the two pieces.
+
+   For data in a file, plot the average of the data in columns 2 and 3
+against the datum in column 1, but only if the datum in column 4 is
+non-negative:
+
+           plot 'file' using 1:( $4<0 ? 1/0 : ($2+$3)/2 )
+
+
+   For an explanation of the 'using' syntax, please see 'plot datafile
+using'.
+
+
+File: gnuplot.info,  Node: summation,  Next: Gnuplot-defined_variables,  Prev: operators,  Up: Expressions
+
+1.15.5 summation
+----------------
+
+A summation expression has the form
+           sum [<var> = <start> : <end>] <expression>
+
+   <var> is treated as an integer variable that takes on successive
+integral values from <start> to <end>.  For each of these, the current
+value of <expression> is added to a running total whose final value
+becomes the value of the summation expression.  Examples:
+           print sum [i=1:10] i
+               55.
+           # Equivalent to plot 'data' using 1:($2+$3+$4+$5+$6+...)
+           plot 'data' using 1 : (sum [col=2:MAXCOL] column(col))
+
+   It is not necessary that <expression> contain the variable <var>.
+Although <start> and <end> can be specified as variables or expressions,
+their value cannot be changed dynamically as a side-effect of carrying
+out the summation.  If <end> is less than <start> then the value of the
+summation is zero.
+
+
+File: gnuplot.info,  Node: Gnuplot-defined_variables,  Next: User-defined_variables_and_functions,  Prev: summation,  Up: Expressions
+
+1.15.6 Gnuplot-defined variables
+--------------------------------
+
+Gnuplot maintains a number of read-only variables that reflect the
+current internal state of the program and the most recent plot.  These
+variables begin with the prefix "GPVAL_".  Examples include GPVAL_TERM,
+GPVAL_X_MIN, GPVAL_X_MAX, GPVAL_Y_MIN. Type 'show variables all' to
+display the complete list and current values.  Values related to axes
+parameters (ranges, log base) are values used during the last plot, not
+those currently 'set'.
+
+   Example: To calculate the fractional screen coordinates of the point
+[X,Y]
+          GRAPH_X = (X - GPVAL_X_MIN) / (GPVAL_X_MAX - GPVAL_X_MIN)
+          GRAPH_Y = (Y - GPVAL_Y_MIN) / (GPVAL_Y_MAX - GPVAL_Y_MIN)
+          SCREEN_X = GPVAL_TERM_XMIN + GRAPH_X * (GPVAL_TERM_XMAX - GPVAL_TERM_XMIN)
+          SCREEN_Y = GPVAL_TERM_YMIN + GRAPH_Y * (GPVAL_TERM_YMAX - GPVAL_TERM_YMIN)
+          FRAC_X = SCREEN_X * GPVAL_TERM_SCALE / GPVAL_TERM_XSIZE
+          FRAC_Y = SCREEN_Y * GPVAL_TERM_SCALE / GPVAL_TERM_YSIZE
+
+
+   The read-only variable GPVAL_ERRNO is set to a non-zero value if any
+gnuplot command terminates early due to an error.  The most recent error
+message is stored in the string variable GPVAL_ERRMSG. Both GPVAL_ERRNO
+and GPVAL_ERRMSG can be cleared using the command 'reset errors'.
+
+   Interactive terminals with 'mouse' functionality maintain read-only
+variables with the prefix "MOUSE_".  See 'mouse variables' for details.
+
+   The *note fit:: mechanism uses several variables with names that
+begin "FIT_".  It is safest to avoid using such names.  When using 'set
+fit errorvariables', the error for each fitted parameter will be stored
+in a variable named like the parameter, but with "_err" appended.  See
+the documentation on *note fit:: and *note fit:: for details.
+
+   See 'user-defined variables', 'reset errors', 'mouse variables', and
+*note fit::.
+
+
+File: gnuplot.info,  Node: User-defined_variables_and_functions,  Next: arrays,  Prev: Gnuplot-defined_variables,  Up: Expressions
+
+1.15.7 User-defined variables and functions
+-------------------------------------------
+
+New user-defined variables and functions of one through twelve variables
+may be declared and used anywhere, including on the 'plot' command
+itself.
+
+   User-defined function syntax:
+           <func-name>( <dummy1> {,<dummy2>} ... {,<dummy12>} ) = <expression>
+
+
+   where <expression> is defined in terms of <dummy1> through <dummy12>.
+This form of function definition is limited to a single line.  More
+complicated multi-line functions can be defined using the function block
+mechanism (new in this version).  See 'function blocks'.
+
+   User-defined variable syntax:
+           <variable-name> = <constant-expression>
+
+
+   Examples:
+           w = 2
+           q = floor(tan(pi/2 - 0.1))
+           f(x) = sin(w*x)
+           sinc(x) = sin(pi*x)/(pi*x)
+           delta(t) = (t == 0)
+           ramp(t) = (t > 0) ? t : 0
+           min(a,b) = (a < b) ? a : b
+           comb(n,k) = n!/(k!*(n-k)!)
+           len3d(x,y,z) = sqrt(x*x+y*y+z*z)
+           plot f(x) = sin(x*a), a = 0.2, f(x), a = 0.4, f(x)
+
+
+           file = "mydata.inp"
+           file(n) = sprintf("run_%d.dat",n)
+
+
+   The final two examples illustrate a user-defined string variable and
+a user-defined string function.
+
+   Note that the variables 'pi' (3.14159...)  and *note NaN:: (IEEE "Not
+a Number") are already defined.  You can redefine these to something
+else if you really need to.  The original values can be recovered by
+setting:
+
+           NaN = GPVAL_NaN
+           pi  = GPVAL_pi
+
+
+   Other variables may be defined under various gnuplot operations like
+mousing in interactive terminals or fitting; see 'gnuplot-defined
+variables' for details.
+
+   You can check for existence of a given variable V by the exists("V")
+expression.  For example
+           a = 10
+           if (exists("a")) print "a is defined"
+           if (!exists("b")) print "b is not defined"
+
+
+   Valid names are the same as in most programming languages: they must
+begin with a letter, but subsequent characters may be letters, digits,
+or "_".
+
+   Each function definition is made available as a special string-valued
+variable with the prefix 'GPFUN_'.
+
+   Example:
+           set label GPFUN_sinc at graph .05,.95
+
+
+   See *note functions::, *note functions::, 'gnuplot-defined
+variables', *note macros::, *note value::.
+
+
+File: gnuplot.info,  Node: arrays,  Prev: User-defined_variables_and_functions,  Up: Expressions
+
+1.15.8 arrays
+-------------
+
+Arrays are implemented as indexed lists of user variables.  The elements
+in an array are not limited to a single type of variable.  Arrays must
+be created explicitly before being referenced.  The size of an array
+cannot be changed after creation.  Array elements are initially
+undefined unless they are provided in the array declaration.  In most
+places an array element can be used instead of a named user variable.
+
+   The cardinality (number of elements) of array A is given by the
+expression |A|.
+
+   Examples:
+          array A[6]
+          A[1] = 1
+          A[2] = 2.0
+          A[3] = {3.0, 3.0}
+          A[4] = "four"
+          A[6] = A[2]**3
+          array B[6] = [ 1, 2.0, A[3], "four", , B[2]**3 ]
+          array C = split("A B C D E F")
+
+
+          do for [i=1:6] { print A[i], B[i] }
+              1 1
+              2.0 2.0
+              {3.0, 3.0} {3.0, 3.0}
+              four four
+              <undefined> <undefined>
+              8.0 8.0
+
+
+   Note: Arrays and variables share the same namespace.  For example,
+assignment of a string to a variable named FOO will destroy any
+previously created array with name FOO.
+
+   The name of an array can be used in a 'plot', 'splot', *note fit::,
+or 'stats' command.  This is equivalent to providing a file in which
+column 1 holds the array index (from 1 to size), column 2 holds the
+value of real(A[i]) and column 3 holds the value of imag(A[i]).
+
+   Example:
+          array A[200]
+          do for [i=1:200] { A[i] = sin(i * pi/100.) }
+          plot A title "sin(x) in centiradians"
+
+
+   When plotting the imaginary component of complex array values, it may
+be referenced either as imag(A[$1]) or as $3.  These two commands are
+equivalent
+
+          plot A using (real(A[$1])) : (imag(A[$1]))
+          plot A using 2:3
+
+
+* Menu:
+
+* Array_functions::
+* Array_indexing::
+
+
+File: gnuplot.info,  Node: Array_functions,  Next: Array_indexing,  Prev: arrays,  Up: arrays
+
+1.15.8.1 Array functions
+........................
+
+Starting with gnuplot version 6, an array can be passed to a function or
+returned by a function.  For example a simple dot-product function
+acting on two equal-sized numerical arrays could be defined:
+
+          dot(A,B) = (|A| != |B|) ? NaN : sum [i=1:|A|] A[i] * B[i]
+
+
+   Built-in functions that return an array include the slice operation
+array[min:max] and the index retrieval function index(Array,value).
+
+          T = split("A B C D E F")
+          U = T[3:4]
+          print T
+             [ "A", "B", "C", "D", "E", "F" ]
+          print U
+             [ "C", "D" ]
+          print index( T, "D" )
+             4
+
+
+   Note that T and U in this example are now arrays, whether or not they
+had been previously declared.
+
+
+File: gnuplot.info,  Node: Array_indexing,  Prev: Array_functions,  Up: arrays
+
+1.15.8.2 Array indexing
+.......................
+
+Array indices run from 1 to N for an array with N elements.  Element i
+of array A is accessed by A[i].  The built-in function 'index(Array,
+<value>)' returns an integer i such that A[i] is equal to <value>, where
+<value> may be any expression that evaluates to a number (integer, real,
+or complex) or a string.  The array element must match in both type and
+value.  A return of 0 indicates that no match was found.
+
+         array A = [ 4.0, 4, "4" ]
+         print index( A, 4 )
+               2
+         print index( A, 2.+2. )
+               1
+         print index( A, "D4"[2:2] )
+               3
+
+
+
+File: gnuplot.info,  Node: Fonts,  Next: Glossary,  Prev: Expressions,  Up: Gnuplot
+
+1.16 Fonts
+==========
+
+Gnuplot does not provide any fonts of its own.  It relies on external
+font handling, the details of which unfortunately vary from one terminal
+type to another.  Brief documentation of font mechanisms that apply to
+more than one terminal type is given here.  For information on font use
+by other individual terminals, see the documentation for that terminal.
+
+   Although it is possible to include non-alphabetic symbols by
+temporarily switching to a special font, e.g.  the Adobe Symbol font,
+the preferred method is now to choose UTF-8 encoding and treat the
+symbol like any other character.  Alternatively you can specify the
+unicode entry point for the desired symbol as an escape sequence in
+enhanced text mode.  See *note encoding::, 'unicode', *note locale::,
+and 'escape sequences'.
+
+* Menu:
+
+* cairo_(pdfcairo::
+* gd_(png::
+* postscript__(also_encapsulated_postscript_*.eps)::
+
+
+File: gnuplot.info,  Node: cairo_(pdfcairo,  Next: gd_(png,  Prev: Fonts,  Up: Fonts
+
+1.16.1 cairo (pdfcairo, pngcairo, epscairo, wxt terminals)
+----------------------------------------------------------
+
+Some terminals, including all the cairo-based terminals, access fonts
+via the fontconfig system library.  Please see the fontconfig user
+manual.  (http://fontconfig.org/fontconfig-user.html) It is usually
+sufficient in gnuplot to request a font by a generic name and size,
+letting fontconfig substitute a similar font if necessary.  The
+following will probably all work:
+          set term pdfcairo font "sans,12"
+          set term pdfcairo font "Times,12"
+          set term pdfcairo font "Times-New-Roman,12"
+
+
+
+File: gnuplot.info,  Node: gd_(png,  Next: postscript__(also_encapsulated_postscript_*.eps),  Prev: cairo_(pdfcairo,  Up: Fonts
+
+1.16.2 gd (png, gif, jpeg, sixel terminals)
+-------------------------------------------
+
+Font handling for the png, gif, jpeg, and sixelgd terminals is done by
+the libgd library.  At a minimum it provides five basic fonts named
+'tiny', 'small', 'medium', 'large', and 'giant' that cannot be scaled or
+rotated.  Use one of these keywords instead of the 'font' keyword.  E.g.
+          set term png tiny
+
+
+   On many systems libgd can also use generic font handling provided by
+the fontconfig tools (see 'fontconfig').  On most systems without
+fontconfig, libgd provides access to Adobe fonts (*.pfa *.pfb) and to
+TrueType fonts (*.ttf).  You must give the name of the font file, not
+the name of the font inside it, in the form "<face> {,<size>}".  <face>
+is either the full pathname to the font file, or the first part of a
+filename in one of the directories listed in the GDFONTPATH
+environmental variable.  That is, 'set term png font "Face"' will look
+for a font file named either <somedirectory>/Face.ttf or
+<somedirectory>/Face.pfa.  For example, if GDFONTPATH contains
+'/usr/local/fonts/ttf:/usr/local/fonts/pfa' then the following pairs of
+commands are equivalent
+          set term png font "arial"
+          set term png font "/usr/local/fonts/ttf/arial.ttf"
+          set term png font "Helvetica"
+          set term png font "/usr/local/fonts/pfa/Helvetica.pfa"
+
+   To request a default font size at the same time:
+          set term png font "arial,11"
+
+
+   If no specific font is requested in the "set term" command, gnuplot
+checks the environmental variable GNUPLOT_DEFAULT_GDFONT.
+
+
+File: gnuplot.info,  Node: postscript__(also_encapsulated_postscript_*.eps),  Prev: gd_(png,  Up: Fonts
+
+1.16.3 postscript (also encapsulated postscript *.eps)
+------------------------------------------------------
+
+PostScript font handling is done by the printer or viewing program.
+Gnuplot can create valid PostScript or encapsulated PostScript (*.eps)
+even if no fonts at all are installed on your computer.  Gnuplot simply
+refers to the font by name in the output file, and assumes that the
+printer or viewing program will know how to find or approximate a font
+by that name.
+
+   All PostScript printers or viewers should know about the standard set
+of Adobe fonts 'Times-Roman', 'Helvetica', 'Courier', and 'Symbol'.  It
+is likely that many additional fonts are also available, but the
+specific set depends on your system or printer configuration.  Gnuplot
+does not know or care about this; the output *.ps or *.eps files that it
+creates will simply refer to whatever font names you request.
+
+   Thus
+          set term postscript eps font "Times-Roman,12"
+
+   will produce output that is suitable for all printers and viewers.
+
+   On the other hand
+          set term postscript eps font "Garamond-Premier-Pro-Italic"
+
+   will produce a valid PostScript output file, but since it refers to a
+specialized font only some printers or viewers will be able to display
+the exact font that was requested.  Most will substitute a different
+font.
+
+   However, it is possible to embed a specific font in the output file
+so that all printers will be able to use it.  This requires that the a
+suitable font description file is available on your system.  Note that
+some font files require specific licensing if they are to be embedded in
+this way.  See 'postscript fontfile' for more detailed description and
+examples.
+
+
+File: gnuplot.info,  Node: Glossary,  Next: inline_data_and_datablocks,  Prev: Fonts,  Up: Gnuplot
+
+1.17 Glossary
+=============
+
+As 'gnuplot' has evolved over more than 30 years, the meaning of certain
+words used in commands and in the documentation may have diverged from
+current common usage.  This section explains how some of these terms are
+used in 'gnuplot'.
+
+   The term "terminal" refers to an output mode, not to the thing you
+are typing on.  For example, the command 'set terminal pdf' means that
+subsequent plotting commands will produce pdf ouput.  Usually you would
+want to accompany this with a 'set output "filename"' command to control
+where the pdf output is written.
+
+   A "page" or "screen" or "canvas" is the entire area addressable by
+'gnuplot'.  On a desktop it is a full window; on a plotter, it is a
+single sheet of paper.
+
+   When discussing data files, the term "record" denotes a single line
+of text in the file, that is, the characters between newline or
+end-of-record characters.  A "point" is the datum extracted from a
+single record.  A "block" of data is a set of consecutive records
+delimited by blank lines.  A line, when referred to in the context of a
+data file, is a subset of a block.  Note that the term "data block" may
+also be used to refer to a named block of inline data (see
+'datablocks').
+
+
+File: gnuplot.info,  Node: inline_data_and_datablocks,  Next: iteration,  Prev: Glossary,  Up: Gnuplot
+
+1.18 inline data and datablocks
+===============================
+
+There are two mechanisms for embedding data into a stream of gnuplot
+commands.  If the special filename '-' appears in a plot command, then
+the lines immediately following the plot command are interpreted as
+inline data.  See *note special-filenames::.  Data provided in this way
+can only be used once, by the plot command it follows.
+
+   The second mechanism defines a named data block as a here-document.
+The named data is persistent and may be referred to by more than one
+plot command.  Example:
+          $Mydata << EOD
+          11 22 33 first line of data
+          44 55 66 second line of data
+          # comments work just as in a data file
+          77 88 99
+          EOD
+          stats $Mydata using 1:3
+          plot $Mydata using 1:3 with points, $Mydata using 1:2 with impulses
+
+
+   Data block names must begin with a $ character, which distinguishes
+them from other types of persistent variables.  The end-of-data
+delimiter (EOD in the example) may be any sequence of alphanumeric
+characters.
+
+   For a parallel mechanism that stores executable commands rather than
+data in a named block, see 'function blocks'.
+
+   The storage associated with named data blocks can be released using
+'undefine' command.  'undefine $*' frees all named data and function
+blocks at once.
+
+
+File: gnuplot.info,  Node: iteration,  Next: linetypes,  Prev: inline_data_and_datablocks,  Up: Gnuplot
+
+1.19 iteration
+==============
+
+gnuplot supports command iteration and block-structured if/else/while/do
+constructs.  See *note if::, 'while', and 'do'.  Simple iteration is
+possible inside 'plot' or 'set' commands.  See 'plot for'.  General
+iteration spanning multiple commands is possible using a block construct
+as shown below.  For a related new feature, see the *note summation::
+expression type.  Here is an example using several of these new syntax
+features:
+           set multiplot layout 2,2
+           fourier(k, x) = sin(3./2*k)/k * 2./3*cos(k*x)
+           do for [power = 0:3] {
+               TERMS = 10**power
+               set title sprintf("%g term Fourier series",TERMS)
+               plot 0.5 + sum [k=1:TERMS] fourier(k,x) notitle
+           }
+           unset multiplot
+
+
+   Iteration is controlled by an iteration specifier with syntax
+
+          for [<var> in "string of N elements"]
+
+
+   or
+
+          for [<var> = <start> : <end> { : <increment> }]
+
+
+   In the first case <var> is a string variable that successively
+evaluates to single-word substrings 1 to N of the string in the
+iteration specifier.  In the second case <start>, <end>, and <increment>
+are integers or integer expressions.
+
+   The scope of the iteration variable is private to that iteration.
+See 'scope'.  You cannot permanently change the value of the iteration
+variable inside the iterated clause.  If the iteration variable has a
+value prior to iteration, that value will be retained or restored at the
+end of the iteration.  For example, the following commands will print 1
+2 3 4 5 6 7 8 9 10 A.
+
+          i = "A"
+          do for [i=1:10] { print i; i=10; }
+          print i
+
+
+
+File: gnuplot.info,  Node: linetypes,  Next: layers,  Prev: iteration,  Up: Gnuplot
+
+1.20 linetypes, colors, and styles
+==================================
+
+In very old gnuplot versions, each terminal type provided a set of
+distinct "linetypes" that could differ in color, in thickness, in
+dot/dash pattern, or in some combination of color and dot/dash.  These
+colors and patterns were not guaranteed to be consistent across
+different terminal types although most used the color sequence
+red/green/blue/magenta/cyan/yellow.  You can select this old behaviour
+via the command 'set colorsequence classic', but by default gnuplot now
+uses a terminal-independent sequence of 8 colors.
+
+   You can further customize the sequence of linetype properties
+interactively or in an initialization file.  See 'set linetype'.
+Several sample initialization files are provided in the distribution
+package.
+
+   The current linetype properties for a particular terminal can be
+previewed by issuing the 'test' command after setting the terminal type.
+
+   Successive functions or datafiles plotted by a single command will be
+assigned successive linetypes in the current default sequence.  You can
+override this for any individual function, datafile, or plot element by
+giving explicit line properties in the plot command.
+
+   Examples:
+
+          plot "foo", "bar"                 # plot two files using linetypes 1, 2
+          plot sin(x) linetype 4            # use linetype color 4
+
+
+   In general, colors can be specified using named colors, rgb (red,
+green, blue) components, hsv (hue, saturation, value) components, or a
+coordinate along the current pm3d palette.  The keyword 'linecolor' may
+be abbreviated to 'lc'.
+
+   Examples:
+
+          plot sin(x) lc rgb "violet"       # use one of gnuplot's named colors
+          plot sin(x) lc rgb "#FF00FF"      # explicit RGB triple in hexadecimal
+          plot sin(x) lc palette cb -45     # whatever color corresponds to -45
+                                            # in the current cbrange of the palette
+          plot sin(x) lc palette frac 0.3   # fractional value along the palette
+
+
+   See *note colorspec::, *note colornames::, 'hsv', *note palette::,
+*note cbrange::.  See also *note monochrome::.
+
+   Linetypes also have an associated dot-dash pattern although not all
+terminal types are capable of using it.  You can specify the dot-dash
+pattern independent of the line color.  See *note dashtype::.
+
+* Menu:
+
+* colorspec::
+* dashtype::
+* linestyles_vs_linetypes::
+* special_linetypes::
+
+
+File: gnuplot.info,  Node: colorspec,  Next: dashtype,  Prev: linetypes,  Up: linetypes
+
+1.20.1 colorspec
+----------------
+
+Many commands allow you to specify a linetype with an explicit color.
+
+   Syntax:
+
+           ... {linecolor | lc} {"colorname" | <colorspec> | <n>}
+           ... {textcolor | tc} {<colorspec> | {linetype | lt} <n>}
+           ... {fillcolor | fc} {<colorspec> | linetype <n> | linestyle <n>}
+
+
+   where <colorspec> has one of the following forms:
+
+           rgbcolor "colorname"    # e.g. "blue"
+           rgbcolor "0xRRGGBB"     # string containing hexadecimal constant
+           rgbcolor "0xAARRGGBB"   # string containing hexadecimal constant
+           rgbcolor "#RRGGBB"      # string containing hexadecimal in x11 format
+           rgbcolor "#AARRGGBB"    # string containing hexadecimal in x11 format
+           rgbcolor <integer val>  # integer value representing AARRGGBB
+           rgbcolor variable       # integer value is read from input file
+           palette frac <val>      # <val> runs from 0 to 1
+           palette cb <value>      # <val> lies within cbrange
+           palette z
+           palette <colormap>      # use named colormap rather than current palette
+           variable                # color index is read from input file
+           background or bgnd      # background color
+           black
+
+
+   The "<n>" is the linetype number the color of which is used, see
+'test'.
+
+   "colorname" refers to one of the color names built in to gnuplot.
+For a list of the available names, see *note colornames::.
+
+   Hexadecimal constants can be given in quotes as "#RRGGBB" or
+"0xRRGGBB", where RRGGBB represents the red, green, and blue components
+of the color and must be between 00 and FF. For example, magenta =
+full-scale red + full-scale blue could be represented by "0xFF00FF",
+which is the hexadecimal representation of (255 << 16) + (0 << 8) +
+(255).
+
+   "#AARRGGBB" represents an RGB color with an alpha channel
+(transparency) value in the high bits.  An alpha value of 0 represents a
+fully opaque color; i.e., "#00RRGGBB" is the same as "#RRGGBB". An alpha
+value of 255 (FF) represents full transparency.
+
+   For a callable function that converts any of these forms to a 32bit
+integer representation of the color, see 'expressions functions
+rgbcolor'.
+
+   The color palette is a linear gradient of colors that smoothly maps a
+single numerical value onto a particular color.  Two such mappings are
+always in effect.  'palette frac' maps a fractional value between 0 and
+1 onto the full range of the color palette.  'palette cb' maps the range
+of the color axis onto the same palette.  See *note cbrange::.  See also
+'set colorbox'.  You can use either of these to select a constant color
+from the current palette.
+
+   "palette z" maps the z value of each plot segment or plot element
+into the cbrange mapping of the palette.  This allows smoothly-varying
+color along a 3d line or surface.  It also allows coloring 2D plots by
+palette values read from an extra column of data (not all 2D plot styles
+allow an extra column).
+
+   There are two special color specifiers: 'background' (short form
+'bgnd') for background color and 'black'.
+
+* Menu:
+
+* background_color::
+* linecolor_variable::
+* palette_::
+* rgbcolor_variable::
+
+
+File: gnuplot.info,  Node: background_color,  Next: linecolor_variable,  Prev: colorspec,  Up: colorspec
+
+1.20.1.1 background color
+.........................
+
+Most terminals allow you to set an explicit background color for the
+plot.  The special linetype 'background' (short form 'bgnd') will draw
+in this color, and is also recognized as a color name.  Examples:
+          # This will erase a section of the canvas by writing over it in the
+          # background color
+          set term wxt background rgb "gray75"
+          set object 1 rectangle from x0,y0 to x1,y1 fillstyle solid fillcolor bgnd
+          # Draw an "invisible" line at y=0, erasing whatever was underneath
+          plot 0 lt background
+
+
+
+File: gnuplot.info,  Node: linecolor_variable,  Next: palette_,  Prev: background_color,  Up: colorspec
+
+1.20.1.2 linecolor variable
+...........................
+
+'lc variable' tells the program to use the value read from one column of
+the input data as a linetype index, and use the color belonging to that
+linetype.  This requires a corresponding additional column in the
+'using' specifier.  'ls variable' does the same except the value read
+from the input data stream is interpreted as the index of a linestyle
+rather than a linetype.  Text colors can be set similarly using 'tc
+variable'.
+
+   Examples:
+           # Use the third column of data to assign colors to individual points
+           plot 'data' using 1:2:3 with points lc variable
+
+
+           # A single data file may contain multiple sets of data, separated by two
+           # blank lines.  Each data set is assigned as index value (see *note index::)
+           # that can be retrieved via the `using` specifier `column(-2)`.
+           # See `pseudocolumns`.  This example uses to value in column -2 to
+           # draw each data set in a different line color.
+           plot 'data' using 1:2:(column(-2)) with lines lc variable
+
+
+
+File: gnuplot.info,  Node: palette_,  Next: rgbcolor_variable,  Prev: linecolor_variable,  Up: colorspec
+
+1.20.1.3 palette
+................
+
+Syntax
+           ... {lc|fc|tc} palette {z}
+           ... {lc|fc|tc} palette frac <fraction>
+           ... {lc|fc|tc} palette cb <fixed z-value>
+           ... fc palette <colormap>
+
+
+   The palette defines a range of colors with gray values between 0 and
+1.  'palette frac <fraction>' selects the color with gray value
+<fraction>.
+
+   'palette cb <z-value>' selects the single color whose fractional gray
+value is (z - cbmin) / (cbmax - cbmin).
+
+   *note palette:: and 'palette z' both map the z coordinate of the plot
+element being colored onto the current palette.  If z is outside cbrange
+it is by default mapped to palette fraction 0 or palette fraction 1.  If
+the option 'set pm3d noclipcb' is set, then quadrangles in a pm3d plot
+whose z values are out of range will not be drawn at all.
+
+   'fillcolor palette <colormap>' maps the z coordinate of a plot
+element onto a previously saved named colormap instead of using the
+current palette.  See *note colormap::.
+
+   If the colormap has a separate range associated with it, that range
+is used to map z values analogous to the use of cbrange to map the
+standard palette.  If there is no separate range for this colormap then
+cbrange is used.
+
+
+File: gnuplot.info,  Node: rgbcolor_variable,  Prev: palette_,  Up: colorspec
+
+1.20.1.4 rgbcolor variable
+..........................
+
+You can assign a separate color for each data point, line segment, or
+label in your plot.  'lc rgbcolor variable' tells the program to read
+RGB color information for each line in the data file.  This requires a
+corresponding additional column in the 'using' specifier.  The extra
+column is interpreted as a 24-bit packed RGB triple.  If the value is
+provided directly in the data file it is easiest to give it as a
+hexadecimal value (see 'rgbcolor').  Alternatively, the 'using'
+specifier can contain an expression that evaluates to a 24-bit RGB color
+as in the example below.  Text colors are similarly set using 'tc
+rgbcolor variable'.
+
+   Example:
+           # Place colored points in 3D at the x,y,z coordinates corresponding to
+           # their red, green, and blue components
+           rgb(r,g,b) = 65536 * int(r) + 256 * int(g) + int(b)
+           splot "data" using 1:2:3:(rgb($1,$2,$3)) with points lc rgb variable
+
+
+
+File: gnuplot.info,  Node: dashtype,  Next: linestyles_vs_linetypes,  Prev: colorspec,  Up: linetypes
+
+1.20.2 dashtype
+---------------
+
+The dash pattern (*note dashtype::) is a separate property associated
+with each line, analogous to 'linecolor' or 'linewidth'.  It is not
+necessary to place the current terminal in a special mode just to draw
+dashed lines.  I.e.  the old command 'set term <termname>
+{solid|dashed}' is now ignored.
+
+   All lines have the property 'dashtype solid' unless you specify
+otherwise.  You can change the default for a particular linetype using
+the command 'set linetype' so that it affects all subsequent commands,
+or you can include the desired dashtype as part of the 'plot' or other
+command.
+
+   Syntax:
+           dashtype N          # predefined dashtype invoked by number
+           dashtype "pattern"  # string containing a combination of the characters
+                               # dot (.) hyphen (-) underscore(_) and space.
+           dashtype (s1,e1,s2,e2,s3,e3,s4,e4)  # dash pattern specified by 1 to 4
+                               # numerical pairs <solid length>, <emptyspace length>
+
+
+   Example:
+           # Two functions using linetype 1 but distinguished by dashtype
+           plot f1(x) with lines lt 1 dt solid, f2(x) with lines lt 1 dt 3
+
+
+   Some terminals support user-defined dash patterns in addition to
+whatever set of predefined dash patterns they offer.
+
+   Examples:
+          plot f(x) dt 3            # use terminal-specific dash pattern 3
+          plot f(x) dt ".. "        # construct a dash pattern on the spot
+          plot f(x) dt (2,5,2,15)   # numerical representation of the same pattern
+          set dashtype 11 (2,4,4,7) # define new dashtype to be called by index
+          plot f(x) dt 11           # plot using our new dashtype
+
+
+   If you specify a dash pattern using a string the program will convert
+this to a sequence of <solid>,<empty> pairs.  Dot "."  becomes (2,5),
+dash "-" becomes (10,10), underscore "_" becomes (20,10), and each space
+character " " adds 10 to the previous <empty> value.  The command *note
+dashtype:: will show both the original string and the converted
+numerical sequence.
+
+
+File: gnuplot.info,  Node: linestyles_vs_linetypes,  Next: special_linetypes,  Prev: dashtype,  Up: linetypes
+
+1.20.3 linestyles vs linetypes
+------------------------------
+
+A 'linestyle' is a temporary association of properties linecolor,
+linewidth, dashtype, and pointtype.  It is defined using the command
+'set style line'.  Once you have defined a linestyle, you can use it in
+a plot command to control the appearance of one or more plot elements.
+In other words, it is just like a linetype except for its lifetime.
+Whereas 'linetypes' are permanent (they last until you explicitly
+redefine them), 'linestyles' last until the next reset of the graphics
+state.
+
+   Examples:
+
+          # define a new line style with terminal-independent color cyan,
+          # linewidth 3, and associated point type 6 (a circle with a dot in it).
+          set style line 5 lt rgb "cyan" lw 3 pt 6
+          plot sin(x) with linespoints ls 5          # user-defined line style 5
+
+
+
+File: gnuplot.info,  Node: special_linetypes,  Prev: linestyles_vs_linetypes,  Up: linetypes
+
+1.20.4 special linetypes
+------------------------
+
+A few special (non-numerical) linetypes are recognized.
+
+   'lt black' specifies a solid black line.
+
+   'lt background' or 'lt bgnd' specifies a solid line with the
+background color of the current terminal.  See 'background'.
+
+   'lt nodraw' skips drawing the line altogether.  This is useful in
+conjunction with plot style *note linespoints::.  It allows you to
+suppress the line component of the plot while retaining point properties
+that are available only in this plot style.  For example
+          plot f(x) with linespoints lt nodraw pointinterval -3
+
+   will draw only every third point and will isolate it by placing a
+small circle of background color underneath it.  See *note
+linespoints::.  'lt nodraw' may also be used to suppress a particular
+set of lines that would otherwise be drawn automatically.  For example
+you could suppress certain contour levels in a contour plot by setting
+their linetype to 'nodraw'.
+
+
+File: gnuplot.info,  Node: layers,  Next: mouse_input,  Prev: linetypes,  Up: Gnuplot
+
+1.21 layers
+===========
+
+A gnuplot plot is built up by drawing its various components in a fixed
+order.  This order can be modified by assigning some components to a
+specific layer using the keywords 'behind', 'back', or 'front'.  For
+example, to replace the background color of the plot area you could
+define a colored rectangle with the attribute 'behind'.
+          set object 1 rectangle from graph 0,0 to graph 1,1 fc rgb "gray" behind
+
+   The order of drawing is
+          behind
+          back
+          the plot itself
+          the plot legend (`key`)
+          front
+
+   Within each layer elements are drawn in the order
+          grid, axis, and border elements
+          pixmaps in numerical order
+          objects (rectangles, circles, ellipses, polygons) in numerical order
+          labels in numerical order
+          arrows in numerical order
+
+   In the case of multiple plots on a single page (multiplot mode) this
+order applies separately to each component plot, not to the multiplot as
+a whole.
+
+   An exception to this is that several TeX-based terminals (e.g.
+pslatex, cairolatex) accumulate all text elements in one output stream
+and graphics in a separate output stream; the text and graphics are then
+combined to yield the final figure.  In general this leaves each text
+element either completely behind or completely in front of the graphics.
+
+
+File: gnuplot.info,  Node: mouse_input,  Next: Persist,  Prev: layers,  Up: Gnuplot
+
+1.22 mouse input
+================
+
+Many terminals allow interaction with the current plot using the mouse.
+Some also support the definition of hotkeys to activate pre-defined
+functions by hitting a single key while the mouse focus is in the active
+plot window.  It is even possible to combine mouse input with 'batch'
+command scripts, by invoking the command 'pause mouse' and then using
+the mouse variables returned by mouse clicking as parameters for
+subsequent scripted actions.  See 'bind' and 'mouse variables'.  See
+also the command 'set mouse'.
+
+* Menu:
+
+* bind::
+* Mouse_variables::
+
+
+File: gnuplot.info,  Node: bind,  Next: Mouse_variables,  Prev: mouse_input,  Up: mouse_input
+
+1.22.1 bind
+-----------
+
+Syntax:
+           bind {allwindows} [<key-sequence>] ["<gnuplot commands>"]
+           bind <key-sequence> ""
+           reset bind
+
+
+   The 'bind' allows defining or redefining a hotkey, i.e.  a sequence
+of gnuplot commands which will be executed when a certain key or key
+sequence is pressed while the driver's window has the input focus.  Note
+that 'bind' is only available if gnuplot was compiled with 'mouse'
+support and it is used by all mouse-capable terminals.  A user-specified
+binding supersedes any builtin bindings, except that <space> and 'q'
+cannot normally be rebound.  For an exception, see 'bind space'.
+
+   Mouse button bindings are only active in 2D plots.
+
+   You get the list of all hotkeys by typing 'show bind' or 'bind' or by
+typing the hotkey 'h' in the graph window.
+
+   Key bindings are restored to their default state by 'reset bind'.
+
+   Note that multikey-bindings with modifiers must be given in quotes.
+
+   Normally hotkeys are only recognized when the currently active plot
+window has focus.  'bind allwindows <key> ...'  (short form: 'bind all
+<key> ...')  causes the binding for <key> to apply to all gnuplot plot
+windows, active or not.  In this case gnuplot variable MOUSE_KEY_WINDOW
+is set to the ID of the originating window, and may be used by the bound
+command.
+
+   Examples:
+
+   - set bindings:
+
+         bind a "replot"
+         bind "ctrl-a" "plot x*x"
+         bind "ctrl-alt-a" 'print "great"'
+         bind Home "set view 60,30; replot"
+         bind all Home 'print "This is window ",MOUSE_KEY_WINDOW'
+
+
+   - show bindings:
+         bind "ctrl-a"          # shows the binding for ctrl-a
+         bind                   # shows all bindings
+         show bind              # show all bindings
+
+
+   - remove bindings:
+         bind "ctrl-alt-a" ""   # removes binding for ctrl-alt-a
+                                  (note that builtins cannot be removed)
+         reset bind             # installs default (builtin) bindings
+
+
+   - bind a key to toggle something:
+       v=0
+       bind "ctrl-r" "v=v+1;if(v%2)set term x11 noraise; else set term x11 raise"
+
+
+   Modifiers (ctrl / alt) are case insensitive, keys not:
+         ctrl-alt-a == CtRl-alT-a
+         ctrl-alt-a != ctrl-alt-A
+
+
+   List of modifiers (alt == meta):
+         ctrl, alt, shift (only valid for Button1 Button2 Button3)
+
+
+   List of supported special keys:
+
+        "BackSpace", "Tab", "Linefeed", "Clear", "Return", "Pause", "Scroll_Lock",
+        "Sys_Req", "Escape", "Delete", "Home", "Left", "Up", "Right", "Down",
+        "PageUp", "PageDown", "End", "Begin",
+
+
+        "KP_Space", "KP_Tab", "KP_Enter", "KP_F1", "KP_F2", "KP_F3", "KP_F4",
+        "KP_Home", "KP_Left", "KP_Up", "KP_Right", "KP_Down", "KP_PageUp",
+        "KP_PageDown", "KP_End", "KP_Begin", "KP_Insert", "KP_Delete", "KP_Equal",
+        "KP_Multiply", "KP_Add", "KP_Separator", "KP_Subtract", "KP_Decimal",
+        "KP_Divide",
+
+
+        "KP_1" - "KP_9", "F1" - "F12"
+
+
+   The following are window events rather than actual keys
+
+        "Button1" "Button2" "Button3" "Close"
+
+
+   See also help for 'mouse'.
+
+* Menu:
+
+* bind_space::
+
+
+File: gnuplot.info,  Node: bind_space,  Prev: bind,  Up: bind
+
+1.22.1.1 bind space
+...................
+
+If gnuplot was built with configuration option -enable-raise-console,
+then typing <space> in the plot window raises gnuplot's command window.
+Maybe.  In practice this is highly system-dependent.  This hotkey can be
+changed to ctrl-space by starting gnuplot as 'gnuplot -ctrlq', or by
+setting the XResource 'gnuplot*ctrlq'.
+
+
+File: gnuplot.info,  Node: Mouse_variables,  Prev: bind,  Up: mouse_input
+
+1.22.2 Mouse variables
+----------------------
+
+When 'mousing' is active, clicking in the active window will set several
+user variables that can be accessed from the gnuplot command line.  The
+coordinates of the mouse at the time of the click are stored in MOUSE_X
+MOUSE_Y MOUSE_X2 and MOUSE_Y2.  The mouse button clicked, and any
+meta-keys active at that time, are stored in MOUSE_BUTTON MOUSE_SHIFT
+MOUSE_ALT and MOUSE_CTRL. These variables are set to undefined at the
+start of every plot, and only become defined in the event of a mouse
+click in the active plot window.  To determine from a script if the
+mouse has been clicked in the active plot window, it is sufficient to
+test for any one of these variables being defined.
+
+           plot 'something'
+           pause mouse
+           if (exists("MOUSE_BUTTON")) call 'something_else'; \
+           else print "No mouse click."
+
+
+   It is also possible to track keystrokes in the plot window using the
+mousing code.
+
+           plot 'something'
+           pause mouse keypress
+           print "Keystroke ", MOUSE_KEY, " at ", MOUSE_X, " ", MOUSE_Y
+
+
+   When 'pause mouse keypress' is terminated by a keypress, then
+MOUSE_KEY will contain the ascii character value of the key that was
+pressed.  MOUSE_CHAR will contain the character itself as a string
+variable.  If the pause command is terminated abnormally (e.g.  by
+ctrl-C or by externally closing the plot window) then MOUSE_KEY will
+equal -1.
+
+   Note that after a zoom by mouse, you can read the new ranges as
+GPVAL_X_MIN, GPVAL_X_MAX, GPVAL_Y_MIN, and GPVAL_Y_MAX, see
+'gnuplot-defined variables'.
+
+
+File: gnuplot.info,  Node: Persist,  Next: Plotting,  Prev: mouse_input,  Up: Gnuplot
+
+1.23 Persist
+============
+
+Many gnuplot terminals (aqua, pm, qt, x11, windows, wxt, ...)  open
+separate display windows on the screen into which plots are drawn.  The
+'persist' option tells gnuplot to leave these windows open when the main
+program exits.  It has no effect on non-interactive terminal output.
+For example if you issue the command
+
+          gnuplot -persist -e 'plot sinh(x)'
+
+
+   gnuplot will open a display window, draw the plot into it, and then
+exit, leaving the display window containing the plot on the screen.  You
+can also specify 'persist' or 'nopersist' when you set a new terminal.
+
+          set term qt persist size 700,500
+
+
+   Depending on the terminal type, some mousing operations may still be
+possible in the persistent window.  However operations like zoom/unzoom
+that require redrawing the plot are not possible because the main
+program has exited.  If you want to leave a plot window open and fully
+mouseable after creating the plot, for example when running gnuplot from
+a script file rather than interactively, see 'pause mouse close'.
+
+
+File: gnuplot.info,  Node: Plotting,  Next: Plugins,  Prev: Persist,  Up: Gnuplot
+
+1.24 Plotting
+=============
+
+There are four 'gnuplot' commands which actually create a plot: 'plot',
+'splot', *note replot::, and *note refresh::.  Other commands control
+the layout, style, and content of the plot that will eventually be
+created.  'plot' generates 2D plots.  'splot' generates 3D plots
+(actually 2D projections, of course).  *note replot:: reexecutes the
+previous 'plot' or 'splot' command.  *note refresh:: is similar to *note
+replot:: but it reuses any previously stored data rather than rereading
+data from a file or input stream.
+
+   Each time you issue one of these four commands it will redraw the
+screen or generate a new page of output containing all of the currently
+defined axes, labels, titles, and all of the various functions or data
+sources listed in the original plot command.  If instead you need to
+place several complete plots next to each other on the same page, e.g.
+to make a panel of sub-figures or to inset a small plot inside a larger
+plot, use the command *note multiplot:: to suppress generation of a new
+page for each plot command.
+
+   Much of the general information about plotting can be found in the
+discussion of 'plot'; information specific to 3D can be found in the
+'splot' section.
+
+   'plot' operates in either rectangular or polar coordinates - see 'set
+polar'.  'splot' operates in Cartesian coordinates, but will accept
+azimuthal or cylindrical coordinates on input.  See *note mapping::.
+
+   'plot' also lets you use each of the four borders - x (bottom), x2
+(top), y (left) and y2 (right) - as an independent axis.  The *note
+axes:: option lets you choose which pair of axes a given function or
+data set is plotted against.  A full complement of 'set' commands exists
+to give you complete control over the scales and labeling of each axis.
+Some commands have the name of an axis built into their names, such as
+*note xlabel::.  Other commands have one or more axis names as options,
+such as 'set logscale xy'.  Commands and options controlling the z axis
+have no effect on 2D graphs.
+
+   'splot' can plot surfaces and contours in addition to points and/or
+lines.  See *note isosamples:: for information about defining the grid
+for a 3D function.  See *note datafile:: for information about the
+requisite file structure for 3D data.  For contours see 'set contour',
+*note cntrlabel::, and *note cntrparam::.
+
+   In 'splot', control over the scales and labels of the axes are the
+same as with 'plot' except that there is also a z axis and labeling the
+x2 and y2 axes is possible only for pseudo-2D plots created using 'set
+view map'.
+
+
+File: gnuplot.info,  Node: Plugins,  Next: Scope_of_variables,  Prev: Plotting,  Up: Gnuplot
+
+1.25 Plugins
+============
+
+The set of functions available for plotting or for evaluating
+expressions can be extended through a plugin mechanism that imports
+executable functions from a shared library.  For example, gnuplot
+versions through 5.4 did not provide a built-in implementation of the
+upper incomplete gamma function Q(a,x).  You could define an
+approximation directly in gnuplot like this:
+           Q(a,x) = 1. - igamma(a,x)
+
+   However this has inherently limited precision as igamma(a,x)
+approaches 1.  If you need a more accurate implementation, it would be
+better to provide one via a plugin (see below).  Once imported, the
+function can be used just as any other built-in or user-defined function
+in gnuplot.  See *note import::.
+
+   The gnuplot distribution includes source code and instructions for
+creating a plugin library in the directory demo/plugin.  You can modify
+the simple example file 'demo_plugin.c' by replacing one or more of the
+toy example functions with an implementation of the function you are
+interested in.  This could include invocation of functions from an
+external mathematical library.
+
+   The demo/plugin directory also contains source for a plugin that
+implements Q(a,x).  As noted above, this plugin allows earlier versions
+of gnuplot to provide the same function *note uigamma:: as version 6.
+          import Q(a,x) from "uigamma_plugin"
+          uigamma(a,x) = ((x<1 || x<a) ? 1.0-igamma(a,x) : Q(a,x))
+
+
+
+File: gnuplot.info,  Node: Scope_of_variables,  Next: Start-up_(initialization),  Prev: Plugins,  Up: Gnuplot
+
+1.26 Scope of variables
+=======================
+
+Gnuplot variables are global except in the special cases listed below.
+There is a single persistent list of active variables indexed by name.
+Assignment to a variable creates or replaces an entry in that list.  The
+only way to remove a variable from that list is the 'undefine' command.
+
+   Exception 1: The scope of the variable used in an iteration specifier
+is private to that iteration.  You cannot permanently change the value
+of the iteration variable inside the iterated clause.  If the iteration
+variable has a value prior to iteration, that value will be retained or
+restored at the end of the iteration.  For example, the following
+commands will print 1 2 3 4 5 6 7 8 9 10 A.
+
+          i = "A"
+          do for [i=1:10] { print i; i=10; }
+          print i
+
+
+   Exception 2: The parameter names used in defining a function are only
+placeholders for the actual values that will be provided when the
+function is called.  For example, any current or future values of x and
+y are not relevant to the definition shown here, but A must exist as a
+global variable when the function is later evaluated:
+
+          func(x,y) = A + (x+y)/2.
+
+
+   Exception 3: Variables declared with the 'local' command.  The
+'local' qualifier (new in version 6) allows optional declaration of a
+variable or array whose scope is limited to the execution of the code
+block in which it is found.  This includes 'load' and *note call::
+operations, evaluation of a function block, and the code in curly
+brackets that follows an *note if::, 'else', 'do for', or 'while'
+condition.  If the name of a local variable duplicates the name of a
+global variable, the global variable is shadowed until exit from the
+local scope.  EXPERIMENTAL: As currently implemented the scope of a
+local variable extends into functions called from the code block it was
+declared in; this includes *note call::, 'load', and function block
+invocation.  This will probably change in the future so that the scope
+is strictly confined to the declaring code block.
+
+
+File: gnuplot.info,  Node: Start-up_(initialization),  Next: String_constants,  Prev: Scope_of_variables,  Up: Gnuplot
+
+1.27 Start-up (initialization)
+==============================
+
+When gnuplot is run, it first looks for a system-wide initialization
+file 'gnuplotrc'.  The location of this file is determined when the
+program is built and is reported by *note loadpath::.  The program then
+looks in the user's HOME directory for a file called '.gnuplot' on
+Unix-like systems or 'GNUPLOT.INI' on other systems.  (OS/2 will look
+for it in the directory named in the environment variable 'GNUPLOT';
+Windows will use 'APPDATA'). On Unix-like systems gnuplot additionally
+checks for the file $XDG_CONFIG_HOME/gnuplot/gnuplotrc.
+
+
+File: gnuplot.info,  Node: String_constants,  Next: Substitution_and_Command_line_macros,  Prev: Start-up_(initialization),  Up: Gnuplot
+
+1.28 String constants, string variables, and string functions
+=============================================================
+
+In addition to string constants, most gnuplot commands also accept a
+string variable, a string expression, or a function that returns a
+string.  For example, the following four methods of creating a plot all
+result in the same plot title:
+
+           four = "4"
+           graph4 = "Title for plot #4"
+           graph(n) = sprintf("Title for plot #%d",n)
+
+
+           plot 'data.4' title "Title for plot #4"
+           plot 'data.4' title graph4
+           plot 'data.4' title "Title for plot #".four
+           plot 'data.4' title graph(4)
+
+
+   Since integers are promoted to strings when operated on by the string
+concatenation operator ('.'  character), the following method also
+works:
+
+           N = 4
+           plot 'data.'.N title "Title for plot #".N
+
+
+   In general, elements on the command line will only be evaluated as
+possible string variables if they are not otherwise recognizable as part
+of the normal gnuplot syntax.  So the following sequence of commands is
+legal, although probably should be avoided so as not to cause confusion:
+
+           plot = "my_datafile.dat"
+           title = "My Title"
+           plot plot title title
+
+
+* Menu:
+
+* substrings::
+* string_operators::
+* string_functions::
+* string_encoding::
+
+
+File: gnuplot.info,  Node: substrings,  Next: string_operators,  Prev: String_constants,  Up: String_constants
+
+1.28.1 substrings
+-----------------
+
+Substrings can be specified by appending a range specifier to any
+string, string variable, or string-valued function.  The range specifier
+has the form [begin:end], where begin is the index of the first
+character of the substring and end is the index of the last character of
+the substring.  The first character has index 1.  The begin or end
+fields may be empty, or contain '*', to indicate the true start or end
+of the original string.  Thus str[:] and str[*:*] both describe the full
+string str.  Example:
+          eos = strlen(file)
+          if (file[eos-3:*] eq ".dat") {
+              set output file[1:eos-4] . ".png"
+              plot file
+          }
+
+
+   There is also an equivalent function 'substr( string, begin, end )'.
+
+
+File: gnuplot.info,  Node: string_operators,  Next: string_functions,  Prev: substrings,  Up: String_constants
+
+1.28.2 string operators
+-----------------------
+
+Three binary operators require string operands: the string concatenation
+operator ".", the string equality operator "eq" and the string
+inequality operator "ne".  The following example will print TRUE.
+
+          if ("A"."B" eq "AB") print "TRUE"
+
+
+
+File: gnuplot.info,  Node: string_functions,  Next: string_encoding,  Prev: string_operators,  Up: String_constants
+
+1.28.3 string functions
+-----------------------
+
+Gnuplot provides several built-in functions that operate on strings.
+General formatting functions: see *note gprintf:: *note sprintf::.  Time
+formatting functions: see *note strftime:: *note strptime::.  String
+manipulation: see *note split::, 'substr' *note strstrt:: *note trim::
+'word' *note words::.
+
+
+File: gnuplot.info,  Node: string_encoding,  Prev: string_functions,  Up: String_constants
+
+1.28.4 string encoding
+----------------------
+
+Gnuplot's built-in string manipulation functions are sensitive to utf-8
+encoding (see *note encoding::).  For example
+
+      set encoding utf8
+      utf8string = "αβγ"
+      strlen(utf8string) returns 3 (number of characters, not number of bytes)
+      utf8string[2:2] evaluates to "β"
+      strstrt(utf8string,"β") evaluates to 2
+
+
+
+File: gnuplot.info,  Node: Substitution_and_Command_line_macros,  Next: Syntax,  Prev: String_constants,  Up: Gnuplot
+
+1.29 Substitution and Command line macros
+=========================================
+
+When a command line to gnuplot is first read, i.e.  before it is
+interpreted or executed, two forms of lexical substitution are
+performed.  These are triggered by the presence of text in backquotes
+(ascii character 96) or preceded by @ (ascii character 64).
+
+* Menu:
+
+* Substitution_of_system_commands_in_backquotes::
+* Substitution_of_string_variables_as_macros::
+* String_variables::
+
+
+File: gnuplot.info,  Node: Substitution_of_system_commands_in_backquotes,  Next: Substitution_of_string_variables_as_macros,  Prev: Substitution_and_Command_line_macros,  Up: Substitution_and_Command_line_macros
+
+1.29.1 Substitution of system commands in backquotes
+----------------------------------------------------
+
+Command-line substitution is specified by a system command enclosed in
+backquotes.  This command is spawned and the output it produces replaces
+the backquoted text on the command line.  Exit status of the system
+command is returned in variables GPVAL_SYSTEM_ERRNO and
+GPVAL_SYSTEM_ERRMSG.
+
+   Note: Internal carriage-return ('\r') and newline ('\n') characters
+are not stripped from the substituted string.
+
+   Command-line substitution can be used anywhere on the 'gnuplot'
+command line except inside strings delimited by single quotes.
+
+   For example, these will generate labels with the current time and
+userid:
+           set label "generated on `date +%Y-%m-%d` by `whoami`" at 1,1
+           set timestamp "generated on %Y-%m-%d by `whoami`"
+
+
+   This creates an array containing the names of files in the current
+directory:
+           FILES = split( "`ls -1`" )
+
+
+
+File: gnuplot.info,  Node: Substitution_of_string_variables_as_macros,  Next: String_variables,  Prev: Substitution_of_system_commands_in_backquotes,  Up: Substitution_and_Command_line_macros
+
+1.29.2 Substitution of string variables as macros
+-------------------------------------------------
+
+The character @ is used to trigger substitution of the current value of
+a string variable into the command line.  The text in the string
+variable may contain any number of lexical elements.  This allows string
+variables to be used as command line macros.  Only string constants may
+be expanded using this mechanism, not string-valued expressions.  For
+example:
+
+           style1 = "lines lt 4 lw 2"
+           style2 = "points lt 3 pt 5 ps 2"
+           range1 = "using 1:3"
+           range2 = "using 1:5"
+           plot "foo" @range1 with @style1, "bar" @range2 with @style2
+
+
+   The line containing @ symbols is expanded on input, so that by the
+time it is executed the effect is identical to having typed in full
+
+           plot "foo" using 1:3 with lines lt 4 lw 2, \
+                "bar" using 1:5 with points lt 3 pt 5 ps 2
+
+
+   The function exists() may be useful in connection with macro
+evaluation.  The following example checks that C can safely be expanded
+as the name of a user-defined variable:
+
+           C = "pi"
+           if (exists(C)) print C," = ", @C
+
+
+   Macro expansion does not occur inside either single or double quotes.
+However macro expansion does occur inside backquotes.
+
+   Macro expansion is handled as the very first thing the interpreter
+does when looking at a new line of commands and is only done once.
+Therefore, code like the following will execute correctly:
+
+          A = "c=1"
+          @A
+
+
+   but this line will not, since the macro is defined on the same line
+and will not be expanded in time
+
+          A = "c=1"; @A   # will not expand to c=1
+
+
+   Macro expansion inside a bracketed iteration occurs before the loop
+is executed; i.e.  @A will always act as the original value of A even if
+A itself is reassigned inside the loop.
+
+   For execution of complete commands the *note evaluate:: command may
+also be handy.
+
+
+File: gnuplot.info,  Node: String_variables,  Prev: Substitution_of_string_variables_as_macros,  Up: Substitution_and_Command_line_macros
+
+1.29.3 String variables, macros, and command line substitution
+--------------------------------------------------------------
+
+The interaction of string variables, backquotes and macro substitution
+is somewhat complicated.  Backquotes do not block macro substitution, so
+
+           filename = "mydata.inp"
+           lines = ` wc --lines @filename | sed "s/ .*//" `
+
+
+   results in the number of lines in mydata.inp being stored in the
+integer variable lines.  And double quotes do not block backquote
+substitution, so
+
+           mycomputer = "`uname -n`"
+
+
+   results in the string returned by the system command 'uname -n' being
+stored in the string variable mycomputer.
+
+   However, macro substitution is not performed inside double quotes, so
+you cannot define a system command as a macro and then use both macro
+and backquote substitution at the same time.
+
+            machine_id = "uname -n"
+            mycomputer = "`@machine_id`"  # doesn't work!!
+
+
+   This fails because the double quotes prevent @machine_id from being
+interpreted as a macro.  To store a system command as a macro and
+execute it later you must instead include the backquotes as part of the
+macro itself.  This is accomplished by defining the macro as shown
+below.  Notice that the sprintf format nests all three types of quotes.
+
+           machine_id = sprintf('"`uname -n`"')
+           mycomputer = @machine_id
+
+
+
+File: gnuplot.info,  Node: Syntax,  Next: Time/Date_data,  Prev: Substitution_and_Command_line_macros,  Up: Gnuplot
+
+1.30 Syntax
+===========
+
+Options and any accompanying parameters are separated by spaces whereas
+lists and coordinates are separated by commas.  Ranges are separated by
+colons and enclosed in brackets [], text and file names are enclosed in
+quotes, and a few miscellaneous things are enclosed in parentheses.
+
+   Commas are used to separate coordinates on the 'set' commands
+'arrow', 'key', and 'label'; the list of variables being fitted (the
+list after the 'via' keyword on the *note fit:: command); lists of
+discrete contours or the loop parameters which specify them on the *note
+cntrparam:: command; the arguments of the 'set' commands *note
+dgrid3d::, *note dummy::, *note isosamples::, *note offsets::, *note
+origin::, *note samples::, *note size::, 'time', and *note view::; lists
+of tics or the loop parameters which specify them; the offsets for
+titles and axis labels; parametric functions to be used to calculate the
+x, y, and z coordinates on the 'plot', *note replot:: and 'splot'
+commands; and the complete sets of keywords specifying individual plots
+(data sets or functions) on the 'plot', *note replot:: and 'splot'
+commands.
+
+   Parentheses are used to delimit sets of explicit tics (as opposed to
+loop parameters) and to indicate computations in 'using' specifiers of
+the *note fit::, 'plot', *note replot:: and 'splot' commands.
+
+   (Parentheses and commas are also used as usual in function notation.)
+
+   Square brackets are used to delimit ranges given in 'set', 'plot' or
+'splot' commands.
+
+   Colons are used to separate extrema in 'range' specifications
+(whether they are given on 'set', 'plot' or 'splot' commands) and to
+separate entries in the 'using' specifier of the 'plot', *note replot::,
+'splot' and *note fit:: commands.
+
+   Semicolons are used to separate commands given on a single command
+line.
+
+   Curly braces are used in the syntax for enhanced text mode and to
+delimit blocks in if/then/else statements.  They are also used to denote
+complex numbers: {3,2} = 3 + 2i.
+
+* Menu:
+
+* quote_marks::
+
+
+File: gnuplot.info,  Node: quote_marks,  Prev: Syntax,  Up: Syntax
+
+1.30.1 quote marks
+------------------
+
+Gnuplot uses three forms of quote marks for delimiting text strings,
+double-quote (ascii 34), single-quote (ascii 39), and backquote (ascii
+96).
+
+   Filenames may be entered with either single- or double-quotes.  In
+this manual the command examples generally single-quote filenames and
+double-quote other string tokens for clarity.
+
+   String constants and text strings used for labels, titles, or other
+plot elements may be enclosed in either single quotes or double quotes.
+Further processing of the quoted text depends on the choice of quote
+marks.
+
+   Backslash processing of special characters like \n (newline) and \345
+(octal character code) is performed only for double-quoted strings.  In
+single-quoted strings, backslashes are just ordinary characters.  To get
+a single-quote (ascii 39) in a single-quoted string, it must be doubled.
+Thus the strings "d\" s' b\\" and 'd" s" b\' are completely equivalent.
+
+   Text justification is the same for each line of a multi-line string.
+Thus the center-justified string
+           "This is the first line of text.\nThis is the second line."
+
+   will produce
+                            This is the first line of text.
+                               This is the second line.
+
+   but
+           'This is the first line of text.\nThis is the second line.'
+
+   will produce
+               This is the first line of text.\nThis is the second line.
+
+
+   Enhanced text processing is performed for both double-quoted text and
+single-quoted text.  See 'enhanced text'.
+
+   Back-quotes are used to enclose system commands for substitution into
+the command line.  See 'substitution'.
+
+
+File: gnuplot.info,  Node: Time/Date_data,  Next: Watchpoints_,  Prev: Syntax,  Up: Gnuplot
+
+1.31 Time/Date data
+===================
+
+'gnuplot' supports the use of time and/or date information as input
+data.  This feature is activated by the commands 'set xdata time', 'set
+ydata time', etc.
+
+   Internally all times and dates are converted to the number of seconds
+from the year 1970.  The command *note timefmt:: defines the default
+format for all inputs: data files, ranges, tics, label positions -
+anything that accepts a time data value defaults to receiving it in this
+format.  Only one default format can be in effect at a given time.  Thus
+if both x and y data in a file are time/date, by default they are
+interpreted in the same format.  However this default can be replaced
+when reading any particular file or column of input using the
+'timecolumn' function in the corresponding 'using' specifier.
+
+   The conversion to and from seconds assumes Universal Time (which is
+the same as Greenwich Standard Time).  There is no provision for
+changing the time zone or for daylight savings.  If all your data refer
+to the same time zone (and are all either daylight or standard) you
+don't need to worry about these things.  But if the absolute time is
+crucial for your application, you'll need to convert to UT yourself.
+
+   Commands like *note xrange:: will re-interpret the integer according
+to *note timefmt::.  If you change *note timefmt::, and then 'show' the
+quantity again, it will be displayed in the new *note timefmt::.  For
+that matter, if you reset the data type flag for that axis (e.g.  *note
+xdata::), the quantity will be shown in its numerical form.
+
+   The commands 'set format' or 'set tics format' define the format that
+will be used for tic labels, whether or not input for the specified axis
+is time/date.
+
+   If time/date information is to be plotted from a file, the 'using'
+option _must_ be used on the 'plot' or 'splot' command.  These commands
+simply use white space to separate columns, but white space may be
+embedded within the time/date string.  If you use tabs as a separator,
+some trial-and-error may be necessary to discover how your system treats
+them.
+
+   The 'time' function can be used to get the current system time.  This
+value can be converted to a date string with the *note strftime::
+function, or it can be used in conjunction with 'timecolumn' to generate
+relative time/date plots.  The type of the argument determines what is
+returned.  If the argument is an integer, 'time' returns the current
+time as an integer, in seconds from 1 Jan 1970.  If the argument is real
+(or complex), the result is real as well.  The precision of the
+fractional (sub-second) part depends on your operating system.  If the
+argument is a string, it is assumed to be a format string, and it is
+passed to *note strftime:: to provide a formatted time/date string.
+
+   The following example demonstrates time/date plotting.
+
+   Suppose the file "data" contains records like
+
+           03/21/95 10:00  6.02e23
+
+
+   This file can be plotted by
+
+           set xdata time
+           set timefmt "%m/%d/%y"
+           set xrange ["03/21/95":"03/22/95"]
+           set format x "%m/%d"
+           set timefmt "%m/%d/%y %H:%M"
+           plot "data" using 1:3
+
+
+   which will produce xtic labels that look like "03/21".
+
+   Gnuplot tracks time to millisecond precision.  Time formats have been
+modified to match this.  Example: print the current time to msec
+precision
+          print strftime("%H:%M:%.3S %d-%b-%Y",time(0.0))
+          18:15:04.253 16-Apr-2011
+
+
+   See 'time_specifiers', 'set xtics time', 'set mxtics time'.
+
+
+File: gnuplot.info,  Node: Watchpoints_,  Prev: Time/Date_data,  Up: Gnuplot
+
+1.32 Watchpoints
+================
+
+Support for watchpoints is present only if your copy of gnuplot was
+built with configuration option -enable-watchpoints.  This feature is
+EXPERIMENTAL [details may change in a subsequent release version].
+
+   Syntax:
+           plot FOO watch {x|y|z|F(x,y)} = <value>
+           plot FOO watch mouse
+
+
+           set style watchpoints nolabels
+           set style watchpoints label <label-properties>
+
+
+           unset style watchpoints      # return to default style
+
+
+           show watchpoints    # summarizes all watches from previous plot command
+
+
+   A watchpoint is a target value for the x, y, or z coordinate or for a
+function f(x,y).  Each watchpoint is attached to a single plot within a
+'plot' command.  Watchpoints are tracked only for styles 'with lines'
+and *note linespoints::.  Every component line segment of that plot is
+checked against all watchpoints attached the plot to see whether one or
+more of the watchpoint targets is satisfied at a point along that line
+segment.  A list of points that satisfy the the target condition
+("hits") is accumulated as the plot is drawn.
+
+   For example, if there is a watchpoint with a target y=100, each line
+segment is checked to see if the y coordinates of the two endpoints
+bracket the target y value.  If so then some point [x,y] on the line
+segment satisfies the target condition y = 100 exactly.  This target
+point is then found by linear interpolation or by iterative bisection.
+
+   Watchpoints within a single plot command are numbered successively.
+More than one watchpoint per plot component may be specified.  Example:
+          plot DATA using 1:2 smooth cnormal watch y=0.25 watch y=0.5 watch y=0.75
+
+
+   Watchpoint hits for each target in the previous plot command are
+stored in named arrays WATCH_n.  You can also display a summary of all
+watchpoint hits from the previous plot command; see *note watchpoints::.
+
+          gnuplot> show watchpoints
+          Plot title:     "DATA using 1:2 smooth cnormal"
+            Watch 1 target y = 0.25         (1 hits)
+                    hit 1   x 49.7  y 0.25
+            Watch 2 target y = 0.5          (1 hits)
+                    hit 1   x 63.1  y 0.5
+            Watch 3 target y = 0.75         (1 hits)
+                    hit 1   x 67.8  y 0.75
+
+
+   Smoothing: Line segments are checked as they are drawn.  For
+unsmoothed data plots this means a hit found by interpolation will lie
+exactly on a line segment connecting two data points.  If a data plot is
+smoothed, hits will lie on a line segment from the smoothed curve.
+Depending on the quality of the smoothed fit, this may or may not be
+more accurate than the hit from the unsmoothed data.
+
+   Accuracy: If the line segment was generated from a function plot, the
+exact value of x such that f(x) = y is found by iterative bisection.
+Otherwise the coordinates [x,y] are approximated by linear interpolation
+along the line segment.
+
+* Menu:
+
+* watch_mouse::
+* watch_labels::
+
+
+File: gnuplot.info,  Node: watch_mouse,  Next: watch_labels,  Prev: Watchpoints_,  Up: Watchpoints_
+
+1.32.1 watch mouse
+------------------
+
+Using the current mouse x coordinate as a watch target generates a label
+that moves along the line of the plot tracking the horizontal position
+of the mouse.  This allows simultaneous readout of the y values of
+multiple plot lines in the same graph.  The appearance of the point
+indicating the current position and of the label can be modified by 'set
+style watchpoint' and 'set style textbox'
+
+   Example:
+
+          set style watchpoint labels point pt 6 ps 2 boxstyle 1
+          set style textbox 1 lw 0.5 opaque
+          plot for [i=1:N] "file.dat" using 1:(column(i)) watch mouse
+
+
+
+File: gnuplot.info,  Node: watch_labels,  Prev: watch_mouse,  Up: Watchpoints_
+
+1.32.2 watch labels
+-------------------
+
+By default, labels are always generated for the target "watch mouse".
+You can turn labels on for other watch targets using the command *note
+labels::.  The label text is "x : y", where x and y are the coordinates
+of the point, formatted using the current settings for the corresponding
+axes.
+
+   Example:
+          set y2tics format "%.2f°"
+          set style watchpoint labels point pt 6
+          plot FOO axes x1y2 watch mouse
+
+   D watchpoints 2
+
+
+File: gnuplot.info,  Node: Plotting_styles,  Next: Commands,  Prev: Gnuplot,  Up: Top
+
+2 Plotting styles
+*****************
+
+Many plotting styles are available in gnuplot.  They are listed
+alphabetically below.  The commands 'set style data' and 'set style
+function' change the default plotting style for subsequent 'plot' and
+'splot' commands.
+
+   You can also specify the plot style explicitly as part of the 'plot'
+or 'splot' command.  If you want to mix plot styles within a single
+plot, you must specify the plot style for each component.
+
+   Example:
+
+          plot 'data' with boxes, sin(x) with lines
+
+
+   Each plot style has its own expected set of data entries in a data
+file.  For example, by default the 'lines' style expects either a single
+column of y values (with implicit x ordering) or a pair of columns with
+x in the first and y in the second.  For more information on how to
+fine-tune how columns in a file are interpreted as plot data, see
+'using'.
+
+* Menu:
+
+* arrows::
+* Bee_swarm_plots::
+* boxerrorbars::
+* boxes::
+* boxplot::
+* boxxyerror::
+* candlesticks::
+* circles::
+* contourfill::
+* dots::
+* ellipses::
+* filledcurves::
+* financebars::
+* fillsteps::
+* fsteps::
+* histeps::
+* heatmaps::
+* histograms::
+* hsteps::
+* image::
+* impulses::
+* labels::
+* lines::
+* linespoints::
+* masking::
+* parallelaxes::
+* Polar_plots::
+* points::
+* polygons::
+* rgbalpha::
+* rgbimage::
+* sectors::
+* spiderplot::
+* steps::
+* surface::
+* vectors::
+* xerrorbars::
+* xyerrorbars::
+* xerrorlines::
+* xyerrorlines::
+* yerrorbars::
+* yerrorlines::
+* 3D_plots::
+* Fence_plots::
+* isosurface::
+* Zerrorfill::
+* Animation::
+
+
+File: gnuplot.info,  Node: arrows,  Next: Bee_swarm_plots,  Prev: Plotting_styles,  Up: Plotting_styles
+
+2.1 arrows
+==========
+
+The 2D 'arrows' style draws an arrow with specified length and
+orientation angle at each point (x,y).  Additional input columns may be
+used to provide variable (per-datapoint) color information or arrow
+style.  It is identical to the 2D style *note vectors:: except that each
+arrow head is positioned using length + angle rather than delta_x +
+delta_y.  See *note vectors::.
+
+          4 columns:  x  y  length  angle
+
+
+   The keywords 'with arrows' may be followed by inline arrow style
+properties, a reference to a predefined arrow style, or 'arrowstyle
+variable' to load the index of the desired arrow style for each arrow
+from a separate column.
+
+   'length' > 0 is interpreted in x-axis coordinates.  -1 < 'length' < 0
+is interpreted in horizontal graph coordinates; i.e.  |length| is a
+fraction of the total graph width.  The program will adjust for
+differences in x and y scaling or plot aspect ratio so that the visual
+length is independent of the orientation angle.
+
+   'angle' is always specified in degrees.
+
+* Menu:
+
+* arrowstyle_variable::
+
+
+File: gnuplot.info,  Node: arrowstyle_variable,  Prev: arrows,  Up: arrows
+
+2.1.1 arrowstyle variable
+-------------------------
+
+For plot styles 'with arrows' and *note vectors::, you can provide an
+extra column of input data that provides an integer arrow style
+corresponding to style previously defined using 'set style arrow'.
+
+   Example:
+          set style arrow 1 head nofilled linecolor "blue" linewidth 0.5
+          set style arrow 2 head filled linecolor "red" linewidth 1.0
+          # column 5 is expected to contain either 1 or 2,
+          # determining which of the two previous defined styles to use
+          plot DATA using 1:2:3:4:5 with arrows arrowstyle variable
+
+
+
+File: gnuplot.info,  Node: Bee_swarm_plots,  Next: boxerrorbars,  Prev: arrows,  Up: Plotting_styles
+
+2.2 Bee swarm plots
+===================
+
+"Bee swarm" plots result from applying jitter to separate overlapping
+points.  A typical use is to compare the distribution of y values
+exhibited by two or more categories of points, where the category
+determines the x coordinate.  See the *note jitter:: command for how to
+control the overlap criteria and the displacement pattern used for
+jittering.  The plots in the figure were created by the same plot
+command but different jitter settings.
+
+          set jitter
+          plot $data using 1:2:1 with points lc variable
+
+
+
+File: gnuplot.info,  Node: boxerrorbars,  Next: boxes,  Prev: Bee_swarm_plots,  Up: Plotting_styles
+
+2.3 boxerrorbars
+================
+
+The *note boxerrorbars:: style is only relevant to 2D data plotting.  It
+is a combination of the *note boxes:: and *note yerrorbars:: styles.  It
+requires 3, 4, or 5 columns of data.  An additional (4th, 5th or 6th)
+input column may be used to provide variable (per-datapoint) color
+information (see 'linecolor' and 'rgbcolor variable').
+
+          3 columns:  x  y  ydelta
+          4 columns:  x  y  ydelta xdelta         (xdelta <= 0 means use boxwidth)
+          5 columns:  x  y  ylow  yhigh  xdelta   (xdelta <= 0 means use boxwidth)
+
+
+   The boxwidth will come from the fourth column if the y errors are
+given as "ydelta" or from the fifth column if they are in the form of
+"ylow yhigh".  If xdelta is zero or negative, the width of the box is
+controlled by the value previously given for boxwidth.  See *note
+boxwidth::.
+
+   A vertical error bar is drawn to represent the y error in the same
+way as for the *note yerrorbars:: style, either from y-ydelta to
+y+ydelta or from ylow to yhigh, depending on how many data columns are
+provided.  The line style used for the error bar may be controlled using
+'set bars'.  Otherwise the error bar will match the border of the box.
+
+   DEPRECATED: Old versions of gnuplot treated 'boxwidth = -2.0' as a
+special case for four-column data with y errors in the form "ylow
+yhigh".  In this case boxwidth was adjusted to leave no gap between
+adjacent boxes.  This treatment is retained for backward-compatibility
+but may be removed in a future version.
+
+
+File: gnuplot.info,  Node: boxes,  Next: boxplot,  Prev: boxerrorbars,  Up: Plotting_styles
+
+2.4 boxes
+=========
+
+In 2D plots the *note boxes:: style draws a rectangle centered about the
+given x coordinate that extends from the x axis, i.e.  from y=0 not from
+the graph border, to the given y coordinate.  The width of the box can
+be provided in an additional input column or controlled by *note
+boxwidth::.  Otherwise each box extends to touch the adjacent boxes.
+
+   In 3D plots the *note boxes:: style draws a box centered at the given
+[x,y] coordinate that extends from the plane at z=0 to the given z
+coordinate.  The width of the box on x can be provided in a separate
+input column or via *note boxwidth::.  The depth of the box on y is
+controlled by *note boxdepth::.  Boxes do not automatically expand to
+touch each other.
+
+* Menu:
+
+* 2D_boxes::
+* 3D_boxes::
+
+
+File: gnuplot.info,  Node: 2D_boxes,  Next: 3D_boxes,  Prev: boxes,  Up: boxes
+
+2.4.1 2D boxes
+--------------
+
+*note boxes:: uses 2 or 3 columns of basic data.  Additional input
+columns may be used to provide information such as variable line or fill
+color.  See 'rgbcolor variable'.
+
+          2 columns:  x  y
+          3 columns:  x  y  x_width
+
+
+   The width of the box is obtained in one of three ways.  If the input
+data has a third column, this will be used to set the box width.
+Otherwise if a width has been set using the *note boxwidth:: command,
+this will be used.  If neither of these is available, the width of each
+box will be calculated so that it touches the adjacent boxes.
+
+   The box interiors are drawn using the current fillstyle.
+Alternatively a fillstyle may be specified in the plot command.  See
+'set style fill'.  If no fillcolor is given in the plot command, the
+current line color is used.
+
+   Examples:
+
+   To plot a data file with solid filled boxes with a small vertical
+space separating them (bargraph):
+
+           set boxwidth 0.9 relative
+           set style fill solid 1.0
+           plot 'file.dat' with boxes
+
+
+   To plot a sine and a cosine curve in pattern-filled boxes style with
+explicit fill color:
+
+           set style fill pattern
+           plot sin(x) with boxes fc 'blue', cos(x) with boxes fc 'gold'
+
+
+   The sin plot will use pattern 0; the cos plot will use pattern 1.
+Any additional plots would cycle through the patterns supported by the
+terminal driver.
+
+
+File: gnuplot.info,  Node: 3D_boxes,  Prev: 2D_boxes,  Up: boxes
+
+2.4.2 3D boxes
+--------------
+
+*note boxes:: requires at least 3 columns of input data.  Additional
+input columns may be used to provide information such as box width or
+fill color.
+
+          3 columns:  x  y  z
+          4 columns:  x  y  z  [x_width or color]
+          5 columns:  x  y  z  x_width  color
+
+
+   The last column is used as a color only if the splot command
+specifies a variable color mode.  Examples
+
+          splot 'blue_boxes.dat' using 1:2:3 fc "blue"
+          splot 'rgb_boxes.dat' using 1:2:3:4 fc rgb variable
+          splot 'category_boxes.dat' using 1:2:3:4:5 lc variable
+
+
+   In the first example all boxes are blue and have the width previously
+set by *note boxwidth::.  In the second example the box width is still
+taken from *note boxwidth:: because the 4th column is interpreted as a
+24-bit RGB color.  The third example command reads box width from column
+4 and interprets the value in column 5 as an integer linetype from which
+the color is derived.
+
+   By default boxes have no thickness; they consist of a single
+rectangle parallel to the xz plane at the specified y coordinate.  You
+can change this to a true box with four sides and a top by setting a
+non-zero extent on y.  See *note boxdepth::.
+
+   3D boxes are processed as pm3d quadrangles rather than as surfaces.
+Because of this the front/back order of drawing is not affected by *note
+hidden3d::.  See 'set pm3d'.  In gnuplot version 6 the edges of the box
+are colored by the border color of the plot's fill style; this is a
+change from version 5.  For best results use a combination of 'set pm3d
+depthorder base' and *note lighting::.
+
+
+File: gnuplot.info,  Node: boxplot,  Next: boxxyerror,  Prev: boxes,  Up: Plotting_styles
+
+2.5 boxplot
+===========
+
+Boxplots are a common way to represent a statistical distribution of
+values.  Gnuplot boxplots are always vertical, showing a distribution of
+values along y.  Quartile boundaries are determined such that 1/4 of the
+points have a y value equal or less than the first quartile boundary,
+1/2 of the points have y value equal or less than the second quartile
+(median) value, etc.  A box is drawn around the region between the first
+and third quartiles with a horizontal line at the median value.
+Whiskers extend from the box to user-specified limits.  Points that lie
+outside these limits (outliers) are drawn individually.  The width of
+the boxplot can be controlled either by *note boxwidth:: or by providing
+it in a third field of the 'using' specifier in the plot command.
+
+   Syntax
+
+          2 columns:   x-position        y-value
+          3 columns:   x-position        y-value  boxwidth
+          4 columns:   first-x-position  y-value  boxwidth  category
+
+
+   The horizontal position of a boxplot is usually given as a constant
+value in the first field (x-position) of the 'using' specifier in the
+plot command.  You can place an identifying label at this position under
+the boxplot by adding an 'xticlabel' specifier in the plot command (two
+or three column syntax) or by providing it as a string in a separate
+data column (four column syntax).  Both examples below should produce a
+plot with layout similar to the one in the boxplot example figure.
+
+   Examples
+
+          #
+          # Compare distribution of y-values from two different files.
+          set border 2                    # left-hand border only
+          set xtics nomirror scale 0      # no tickmarks; only labels
+          set ytics rangelimited nomirror
+          plot 'dataset_A' using (1.):2:xticlabel('A') with boxplot, \
+               'dataset_B' using (2.):2:xticlabel('B') with boxplot
+
+          #
+          # Compare y-values from two categories of data in the same file.
+          # Each line contains a category string ("A" or "B") in column 1 and
+          # a data value in column 2.  Labels auto-generated from category string.
+          start_x = 1.0
+          boxwidth = 0.5
+          plot 'mixeddata' using (start_x):2:(boxwidth):1 with boxplot
+
+
+   By default a single boxplot is produced from all y values found in
+the column specified by the second field of the using specification.  If
+a fourth field is given in the 'using' specification the content of that
+input column will be used as a string that identifies a discrete
+category.  A separate boxplot will be drawn for each category found in
+the input.  The horizontal separation between these boxplots is 1.0 by
+default;, it can be changed by 'set style boxplot separation'.  By
+default the category identifier is shown as a tic label below each
+boxplot.  Note that if category column contains numerical values they
+are nevertheless treated as strings and thus do not usually correspond
+to the x coordinate of the boxplot.
+
+   The order of data points in the input file is not important.  If
+there are multiple blocks of data in the input file separated by two
+blank lines, individual blocks may be selected with the *note index::
+keyword or by using the the data block number ('column(-2)') as a level
+value in the fourth column.  See 'pseudocolumns', *note index::.
+
+   By default the whiskers extend vertically from the ends of the box to
+the most distant point whose y value lies within 1.5 times the
+interquartile range.  By default outliers are drawn as circles (point
+type 7).  The width of bars at the end of the whiskers may be controlled
+using 'set bars' or *note errorbars::.  Multiple outliers with the same
+y value are displaced horizontally by one character width.  This spacing
+can be controlled by *note jitter::.
+
+   These default properties may be changed using the *note boxplot::
+command.  See *note boxplot::, 'bars', *note boxwidth::, 'fillstyle',
+*note candlesticks::.
+
+
+File: gnuplot.info,  Node: boxxyerror,  Next: candlesticks,  Prev: boxplot,  Up: Plotting_styles
+
+2.6 boxxyerror
+==============
+
+The *note boxxyerror:: plot style is only relevant to 2D data plotting.
+It is similar to the *note xyerrorbars:: style except that it draws
+rectangular areas rather than crosses.  It uses either 4 or 6 basic
+columns of input data.  An additional (5th or 7th) input column may be
+used to provide variable (per-datapoint) color information (see
+'linecolor' and 'rgbcolor variable').
+
+          4 columns:  x  y  xdelta  ydelta
+          6 columns:  x  y  xlow  xhigh  ylow  yhigh
+
+
+   The box width and height are determined from the x and y errors in
+the same way as they are for the *note xyerrorbars:: style--either from
+xlow to xhigh and from ylow to yhigh, or from x-xdelta to x+xdelta and
+from y-ydelta to y+ydelta, depending on how many data columns are
+provided.
+
+   The 6 column form of the command provides a convenient way to plot
+rectangles with arbitrary x and y bounds.
+
+   The interior of the boxes is drawn according to the current
+fillstyle.  See 'set style fill' and *note boxes:: for details.
+Alternatively a new fillstyle may be specified in the plot command.
+
+
+File: gnuplot.info,  Node: candlesticks,  Next: circles,  Prev: boxxyerror,  Up: Plotting_styles
+
+2.7 candlesticks
+================
+
+The *note candlesticks:: style can be used for 2D data plotting of
+financial data or for generating box-and-whisker plots of statistical
+data.  The symbol is a rectangular box, centered horizontally at the x
+coordinate and limited vertically by the opening and closing prices.  A
+vertical line segment at the x coordinate extends up from the top of the
+rectangle to the high price and another down to the low.  The vertical
+line will be unchanged if the low and high prices are interchanged.
+
+   Five columns of basic data are required:
+
+           financial data:   date  open  low  high  close
+           whisker plot:     x  box_min  whisker_min  whisker_high  box_high
+
+
+   The width of the rectangle can be controlled by the *note boxwidth::
+command.  For backwards compatibility with earlier gnuplot versions,
+when the boxwidth parameter has not been set then the width of the
+candlestick rectangle is taken from 'set errorbars <width>'.
+
+   Alternatively, an explicit width for each box-and-whiskers grouping
+may be specified in an optional 6th column of data.  The width must be
+given in the same units as the x coordinate.
+
+   An additional (6th, or 7th if the 6th column is used for width data)
+input column may be used to provide variable (per-datapoint) color
+information (see 'linecolor' and 'rgbcolor variable').
+
+   By default the vertical line segments have no crossbars at the top
+and bottom.  If you want crossbars, which are typically used for
+box-and-whisker plots, then add the keyword 'whiskerbars' to the plot
+command.  By default these whiskerbars extend the full horizontal width
+of the candlestick, but you can modify this by specifying a fraction of
+the full width.
+
+   The usual convention for financial data is that the rectangle is
+empty if (open < close) and solid fill if (close < open).  This is the
+behavior you will get if the current fillstyle is set to "empty".  See
+'fillstyle'.  If you set the fillstyle to solid or pattern, then this
+will be used for all boxes independent of open and close values.  See
+also *note errorbars:: and *note financebars::.  See also the
+candlestick (http://www.gnuplot.info/demo/candlesticks.html) and finance
+(http://www.gnuplot.info/demo/finance.html) demos.
+
+   Note: To place additional symbols or lines on a box-and-whisker plot
+requires additional plot components.  The first example below uses a
+second component that squashes the candlestick onto a single line placed
+at the median value.
+
+       # Data columns:X Min 1stQuartile Median 3rdQuartile Max
+       set errorbars 4.0
+       set style fill empty
+       plot 'stat.dat' using 1:3:2:6:5 with candlesticks title 'Quartiles', \
+            ''         using 1:4:4:4:4 with candlesticks lt -1 notitle
+
+
+       # Plot with crossbars on the whiskers, crossbars are 50% of full width
+       plot 'stat.dat' using 1:3:2:6:5 with candlesticks whiskerbars 0.5
+
+
+   See *note boxwidth::, *note errorbars::, 'set style fill', and *note
+boxplot::.
+
+
+File: gnuplot.info,  Node: circles,  Next: contourfill,  Prev: candlesticks,  Up: Plotting_styles
+
+2.8 circles
+===========
+
+The *note circles:: style plots a circle with an explicit radius at each
+data point.  The radius is always interpreted in the units of the plot's
+horizontal axis (x or x2).  The scale on y and the aspect ratio of the
+plot are both ignored.  If the radius is not given in a separate column
+for each point it is taken from 'set style circle'.  In this case the
+radius may use graph or screen coordinates.
+
+   Many combinations of per-point and previously set properties are
+possible.  For 2D plots these include
+
+         using x:y
+         using x:y:radius
+         using x:y:color
+         using x:y:radius:color
+         using x:y:radius:arc_begin:arc_end
+         using x:y:radius:arc_begin:arc_end:color
+
+
+   By default a full circle will be drawn.  The result is similar to
+using a 'points' plot with variable size points and pointtype 7, except
+that the circles scale with the x axis range.  It is possible to instead
+plot arc segments by specifying a start and end angle (in degrees) in
+columns 4 and 5.
+
+   A per-circle color may be provided in the last column of the using
+specifier.  In this case the plot command must include a corresponding
+variable color term such as 'lc variable' or 'fillcolor rgb variable'.
+
+   See 'set style circle', 'set object circle', and 'set style fill'.
+
+   For 3D plots the using specifier must contain
+
+         splot DATA using x:y:z:radius:color
+
+
+   where the variable color column is optional.
+
+   Examples:
+
+         # draws circles whose area is proportional to the value in column 3
+         set style fill transparent solid 0.2 noborder
+         plot 'data' using 1:2:(sqrt($3)) with circles, \
+              'data' using 1:2 with linespoints
+
+
+         # draws Pac-men instead of circles
+         plot 'data' using 1:2:(10):(40):(320) with circles
+
+
+         # draw a pie chart with inline data
+         set xrange [-15:15]
+         set style fill transparent solid 0.9 noborder
+         plot '-' using 1:2:3:4:5:6 with circles lc var
+         0    0    5    0    30    1
+         0    0    5   30    70    2
+         0    0    5   70   120    3
+         0    0    5  120   230    4
+         0    0    5  230   360    5
+         e
+
+
+
+File: gnuplot.info,  Node: contourfill,  Next: dots,  Prev: circles,  Up: Plotting_styles
+
+2.9 contourfill
+===============
+
+Syntax:
+          splot f(x,y) with contourfill {at base} {fillstyle <style>}
+
+
+   Contourfill is a 3D plotting style used to color a pm3d surface in
+slices along the z axis.  It can be used in 2D projection ('set view
+map') to create 2D contour plots with solid color between contour lines.
+The slice boundaries and the assigned colors are both controlled using
+*note contourfill::.  See also 'pm3d', 'zclip'.
+
+   This style can be combined with 'set contours' to superimpose contour
+lines that bound the slices.  Care must be taken that the slice
+boundaries from *note contourfill:: match the contour boundaries from
+*note cntrparam::.
+
+          # slice boundaries determined by ztics
+          # coloring set by palette mapping the slice midpoint z value
+          set pm3d border retrace
+          set contourfill ztics
+          set ztics -20, 5, 20
+          set contour
+          set cntrparam cubic levels increment -20, 5, 20
+          set cntrlabel onecolor
+          set view map
+          splot g(x,y) with contourfill, g(x,y) with lines nosurface
+
+
+
+File: gnuplot.info,  Node: dots,  Next: ellipses,  Prev: contourfill,  Up: Plotting_styles
+
+2.10 dots
+=========
+
+The *note dots:: style plots a tiny dot at each point; this is useful
+for scatter plots with many points.  Either 1 or 2 columns of input data
+are required in 2D. Three columns are required in 3D.
+
+   For some terminals (post, pdf) the size of the dot can be controlled
+by changing the linewidth.
+
+          1 column    y         # x is row number
+          2 columns:  x  y
+          3 columns:  x  y  z   # 3D only (splot)
+
+
+
+File: gnuplot.info,  Node: ellipses,  Next: filledcurves,  Prev: dots,  Up: Plotting_styles
+
+2.11 ellipses
+=============
+
+Syntax:
+          plot <data> with ellipses {units [xx|xy|yy]}
+
+
+   The *note ellipses:: style plots an ellipse at each data point.  This
+style is only relevant for 2D plotting.  Each ellipse is described in
+terms of its center, major and minor diameters, and the angle between
+its major diameter and the x axis.
+
+          2 columns: x y
+          3 columns: x y diam  (used for both major and minor axes)
+          4 columns: x y major_diam minor_diam
+          5 columns: x y major_diam minor_diam angle
+
+
+   If only two input columns are present, they are taken as the
+coordinates of the centers, and the ellipses will be drawn with the
+default extent (see 'set style ellipse').  The orientation of the
+ellipse, which is defined as the angle between the major diameter and
+the plot's x axis, is taken from the default ellipse style (see 'set
+style ellipse').
+
+   If three input columns are provided, the third column is used for
+both diameters.  The orientation angle defaults to zero.
+
+   If four columns are present, they are interpreted as x, y, major
+diameter, minor diameter.  Note that these are diameters, not radii.  If
+either diameter is negative, both diameters will be taken from the
+default set by 'set style ellipse'.
+
+   An optional 5th column may specify the orientation angle in degrees.
+The ellipses will also be drawn with their default extent if either of
+the supplied diameters in the 3-4-5 column form is negative.
+
+   In all of the above cases, optional variable color data may be given
+in an additional last (3th, 4th, 5th or 6th) column.  See *note
+colorspec::.
+
+   'units keyword:' If 'units xy' is included in the plot specification,
+the major diameter is interpreted in the units of the plot's horizontal
+axis (x or x2) while the minor diameter in that of the vertical axis (y
+or y2).  If the x and y axis scales are not equal, the major/minor
+diameter ratio will no longer be correct after rotation.  'units xx'
+interprets both diameters in units of the x axis.  'units yy' interprets
+both diameters in units of the y axis.  In the latter two cases the
+ellipses will have the correct aspect ratio even if the plot is resized.
+If 'units' is omitted from the plot command, the setting from 'set style
+ellipse' will be used.
+
+   Example (draws ellipses, cycling through the available line types):
+
+         plot 'data' using 1:2:3:4:(0):0 with ellipses
+
+
+   See also 'set object ellipse', 'set style ellipse' and 'fillstyle'.
+
+
+File: gnuplot.info,  Node: filledcurves,  Next: financebars,  Prev: ellipses,  Up: Plotting_styles
+
+2.12 filledcurves
+=================
+
+The *note filledcurves:: style is available in both 2D and (since
+version 6.1) 3D.
+
+   The 2D style has three variants.  The first two variants require
+either a single function or two columns (x,y) of input data.
+
+   Syntax for 2D:
+
+         plot f(x) with filledcurves [option]
+         plot DATA using 1:2    with filledcurves [option]
+         plot DATA using 1:2:3  with filledcurves [option]
+
+
+   where the option can be one of the following
+
+         closed
+         {above|below} x1 x2  y r=<a> xy=<x>,<y>
+         between
+
+
+   The first variant, 'closed', treats the curve itself as a closed
+polygon.  This is the default if there are two columns of input data.
+
+         filledcurves closed   ... just filled closed curve,
+
+
+   The second variant is to fill the area between the curve and a given
+axis, a horizontal or vertical line, or a point.  This can be further
+restricted to filling the area above or below the specified line.
+
+         filledcurves x1       ... x1 axis,
+         filledcurves x2       ... x2 axis, etc for y1 and y2 axes,
+         filledcurves y=42     ... line at y=42, i.e. parallel to x axis,
+         filledcurves xy=10,20 ... point 10,20 of x1,y1 axes (arc-like shape).
+         filledcurves above r=1.5  the area of a polar plot outside radius 1.5
+
+
+   The third variant fills the area between two curves sampled at the
+same set of x coordinates.  It requires three columns of input data (x,
+y1, y2).  This is the default if there are three or more columns of
+input data.  If you have a y value in column 2 and an associated error
+value in column 3 the three column variant can be used in combination
+with a solid line to show the area of uncertainty on either side of that
+line.  See also the similar 3D plot style 'zerrorfill'.
+
+         plot $DAT using 1:($2-$3):($2+$3) with filledcurves, \
+              $DAT using 1:2 smooth mcs with lines
+
+
+* Menu:
+
+* above/below::
+* 3D_waterfall_plots::
+* fill_properties::
+
+
+File: gnuplot.info,  Node: above/below,  Next: 3D_waterfall_plots,  Prev: filledcurves,  Up: filledcurves
+
+2.12.1 above/below
+------------------
+
+The 'above' and 'below' options apply both to commands of the form
+         plot f(x) with filledcurves {above|below} {y|r}=<val>
+
+   and to commands of the form
+         plot DATA with filledcurves using 1:2:3 with filledcurves {above|below}
+
+   In either case the option limits the filled area to one side of the
+bounding line or curve.
+
+   Zooming a filled curve drawn from a datafile may produce empty or
+incorrect areas because gnuplot is clipping points and lines, and not
+areas.
+
+   If the values <x>, <y>, or <a> are outside the drawing boundary they
+are moved to the graph boundary.  Then the actual fill area in the case
+of option xy=<x>,<y> will depend on xrange and yrange.
+
+
+File: gnuplot.info,  Node: 3D_waterfall_plots,  Next: fill_properties,  Prev: above/below,  Up: filledcurves
+
+2.12.2 3D waterfall plots
+-------------------------
+
+          set style fill solid border lc "black"
+          splot for [scan=N:1:-1] DATA index scan \
+                using x:y:z with filledcurves fc background
+
+
+   In gnuplot 6.1 the 3D *note filledcurves:: plot style is designed to
+display a set of two-dimensional curves that are incrementally displaced
+along an orthogonal axis.  Normally x or y is a fixed value for each
+curve so that the lines either represent z=f(x) at sequential y values
+or z=f(y) at sequential x values.  This is convenient for drawing
+waterfall plots.
+
+   In order to ensure that foreground curves occlude more distant ones
+it is important to order the sequence of curves from back to front.
+
+   See also 'fenceplots'.  D waterfallplot 1
+
+
+File: gnuplot.info,  Node: fill_properties,  Prev: 3D_waterfall_plots,  Up: filledcurves
+
+2.12.3 fill properties
+----------------------
+
+Plotting *note filledcurves:: can be further customized by giving a
+fillstyle (solid/transparent/pattern) or a fillcolor.  If no fillstyle
+('fs') is given in the plot command then the current default fill style
+is used.  See 'set style fill'.  If no fillcolor ('fc') is given in the
+plot command, the current line color is used.
+
+   The {{no}border} property of the fillstyle is honored by filledcurves
+mode 'closed', the default.  It is ignored by all other filledcurves
+modes.  Example:
+          plot 'data' with filledcurves fc "cyan" fs solid 0.5 border lc "blue"
+
+
+
+File: gnuplot.info,  Node: financebars,  Next: fillsteps,  Prev: filledcurves,  Up: Plotting_styles
+
+2.13 financebars
+================
+
+The *note financebars:: style is only relevant for 2D data plotting of
+financial data.  It requires 1 x coordinate (usually a date) and 4 y
+values (prices).
+
+          5 columns:   date  open  low  high  close
+
+
+   An additional (6th) input column may be used to provide variable
+(per-record) color information (see 'linecolor' and 'rgbcolor
+variable').
+
+   The symbol is a vertical line segment, located horizontally at the x
+coordinate and limited vertically by the high and low prices.  A
+horizontal tic on the left marks the opening price and one on the right
+marks the closing price.  The length of these tics may be changed by
+*note errorbars::.  The symbol will be unchanged if the high and low
+prices are interchanged.  See *note errorbars:: and *note
+candlesticks::, and also the finance demo.
+(http://www.gnuplot.info/demo/finance.html)
+
+
+File: gnuplot.info,  Node: fillsteps,  Next: fsteps,  Prev: financebars,  Up: Plotting_styles
+
+2.14 fillsteps
+==============
+
+          plot <data> with fillsteps {above|below} {y=<baseline>}
+
+
+   The *note fillsteps:: style is only relevant to 2D plotting.  It is
+exactly like the style *note steps:: except that the area between the
+curve and the baseline (default y=0) is filled in the current fill
+style.  The options 'above' and 'below' fill only the portion to one
+side of the baseline.  Note that in moving from one data point to the
+next, both *note steps:: and *note fillsteps:: first trace the change in
+x coordinate and then the change in y coordinate.  See *note steps::.
+        1 column:   y     # implicit x from line number (column 0)
+        2 columns:  x y
+
+
+
+File: gnuplot.info,  Node: fsteps,  Next: histeps,  Prev: fillsteps,  Up: Plotting_styles
+
+2.15 fsteps
+===========
+
+The *note fsteps:: style is only relevant to 2D plotting.  It connects
+consecutive points with two line segments: the first from (x1,y1) to
+(x1,y2) and the second from (x1,y2) to (x2,y2).  The input column
+requires are the same as for plot styles 'lines' and 'points'.  The
+difference between *note fsteps:: and *note steps:: is that *note
+fsteps:: traces first the change in y and then the change in x.  *note
+steps:: traces first the change in x and then the change in y.
+
+   See also steps demo.  (http://www.gnuplot.info/demo/steps.html)
+        1 column:   y     # implicit x from line number (column 0)
+        2 columns:  x y
+
+
+
+File: gnuplot.info,  Node: histeps,  Next: heatmaps,  Prev: fsteps,  Up: Plotting_styles
+
+2.16 histeps
+============
+
+The *note histeps:: style is only relevant to 2D plotting.  It is
+intended for plotting histograms.  Y-values are assumed to be centered
+at the x-values; the point at x1 is represented as a horizontal line
+from ((x0+x1)/2,y1) to ((x1+x2)/2,y1).  The lines representing the end
+points are extended so that the step is centered on at x.  Adjacent
+points are connected by a vertical line at their average x, that is,
+from ((x1+x2)/2,y1) to ((x1+x2)/2,y2).  The input column requires are
+the same as for plot styles 'lines' and 'points'.
+
+   If *note autoscale:: is in effect, it selects the xrange from the
+data rather than the steps, so the end points will appear only half as
+wide as the others.  See also steps demo.
+(http://www.gnuplot.info/demo/steps.html)
+        1 column:   y     # implicit x from line number (column 0)
+        2 columns:  x y
+
+
+
+File: gnuplot.info,  Node: heatmaps,  Next: histograms,  Prev: histeps,  Up: Plotting_styles
+
+2.17 heatmaps
+=============
+
+Several of gnuplot's plot styles can be used to create heat maps.  The
+choice of which style to use is dictated by the type of data.
+
+   Pixel-based heat maps all have the property that each pixel in the
+map corresponds exactly to one original data value.  The pixel-based
+image styles require a regular rectangular grid of data values; see
+'with image'.  However it is possible to handle missing grid values (see
+'sparse') and it is also possible to mask out only a portion of the grid
+for display (see *note masking::).  Unless there are a large number of
+grid elements, it is usually good to render each rectangular element
+separately ('with image pixels') so that smoothing or lossy compression
+is not applied to the resulting "image".
+
+   A polar equivalent to image pixel-based heat maps can be generated
+using 2D plot style *note sectors::.  Each input point corresponds to
+exactly one annular sector of a polar grid, equivalent to a pixel.
+Unlike the polar grid surface option described below, any number of
+individual grid sectors may be provided.  This plot style can be used in
+either polar or cartesian coordinate plots to place polar sectors
+anywhere on the graph.  The figure here shows two halves of a polar heat
+map displaced across the origin by +/- Δx on a cartesian coordinate
+plot.  See *note sectors::.
+
+   If the data points do not constitute a regular rectangular grid, they
+can often be used to fit a gridded surface by interpolation or by
+splines.  Alternatively a point-density function can be mapped onto a
+gridded plane or smooth surface.  See *note dgrid3d::.  The gridded
+surface can then be plotted as a pm3d surface (see *note masking::
+example).  In this case the points on the heat map do not retain a
+one-to-one correspondence with the input data.  I.e.  the validity of
+the heat map represenation is only as good as the gridded approximation.
+The demo collection has examples of generating 2D heatmaps from a set of
+points heatmap_points.dem
+(http://www.gnuplot.info/demo/heatmap_points.html)
+
+   If your copy of gnuplot was built with the -enable-polar-grid option,
+polar coordinate data points can be used to generate a 2D polar heat map
+in which each "pixel" corresponded to a pre-determined range of theta
+and r.  See 'set polar grid' and 'with surface'.  This process is
+exactly analogous to the use of *note dgrid3d:: and 'with pm3d' except
+that it operates in 2D polar coordinate space.
+
+
+File: gnuplot.info,  Node: histograms,  Next: hsteps,  Prev: heatmaps,  Up: Plotting_styles
+
+2.18 histograms
+===============
+
+The *note histograms:: style is only relevant to 2D plotting.  It
+produces a bar chart from a sequence of parallel data columns.  Each
+element of the 'plot' command must specify a single input data source
+(e.g.  one column of the input file), possibly with associated tic
+values or key titles.  Four styles of histogram layout are currently
+supported.
+
+           set style histogram clustered {gap <gapsize>}
+           set style histogram errorbars {gap <gapsize>} {<linewidth>}
+           set style histogram rowstacked
+           set style histogram columnstacked
+           set style histogram {title font "name,size" tc <colorspec>}
+
+
+   The default style corresponds to 'set style histogram clustered gap
+2'.  In this style, each set of parallel data values is collected into a
+group of boxes clustered at the x-axis coordinate corresponding to their
+sequential position (row #) in the selected datafile columns.  Thus if
+<n> datacolumns are selected, the first cluster is centered about x=1,
+and contains <n> boxes whose heights are taken from the first entry in
+the corresponding <n> data columns.  This is followed by a gap and then
+a second cluster of boxes centered about x=2 corresponding to the second
+entry in the respective data columns, and so on.  The default gap width
+of 2 indicates that the empty space between clusters is equivalent to
+the width of 2 boxes.  All boxes derived from any one column are given
+the same fill color and/or pattern; however see the subsection
+'histograms colors'.
+
+   Each cluster of boxes is derived from a single row of the input data
+file.  It is common in such input files that the first element of each
+row is a label.  Labels from this column may be placed along the x-axis
+underneath the appropriate cluster of boxes with the 'xticlabels' option
+to 'using'.
+
+   The *note errorbars:: style is very similar to the 'clustered' style,
+except that it requires additional columns of input for each entry.  The
+first column holds the height (y value) of that box, exactly as for the
+'clustered' style.
+          2 columns:        y yerr          bar extends from y-yerr to y+err
+          3 columns:        y ymin ymax     bar extends from ymin to ymax
+
+   The appearance of the error bars is controlled by the current value
+of *note errorbars:: and by the optional <linewidth> specification.
+
+   Two styles of stacked histogram are supported, chosen by the command
+'set style histogram {rowstacked|columnstacked}'.  In these styles the
+data values from the selected columns are collected into stacks of
+boxes.  Positive values stack upwards from y=0; negative values stack
+downwards.  Mixed positive and negative values will produce both an
+upward stack and a downward stack.  The default stacking mode is
+'rowstacked'.
+
+   The 'rowstacked' style places a box resting on the x-axis for each
+data value in the first selected column; the first data value results in
+a box a x=1, the second at x=2, and so on.  Boxes corresponding to the
+second and subsequent data columns are layered on top of these,
+resulting in a stack of boxes at x=1 representing the first data value
+from each column, a stack of boxes at x=2 representing the second data
+value from each column, and so on.  All boxes derived from any one
+column are given the same fill color and/or pattern (see 'set style
+fill').
+
+   The 'columnstacked' style is similar, except that each stack of boxes
+is built up from a single data column.  Each data value from the first
+specified data column yields a box in the stack at x=1, each data value
+from the second specified data column yields a box in the stack at x=2,
+and so on.  In this style the color of each box is taken from the row
+number, rather than the column number, of the corresponding data field.
+
+   Box widths may be modified using the *note boxwidth:: command.  Box
+fill styles may be set using the 'set style fill' command.
+
+   Histograms always use the x1 axis, but may use either y1 or y2.  If a
+plot contains both histograms and other plot styles, the non-histogram
+plot elements may use either the x1 or the x2 axis.
+
+   One additional style option 'set style histogram nokeyseparators' is
+relevant only to plots that contain multiple histograms.  See *note
+newhistogram:: for additional discussion of this case.
+
+   Examples: Suppose that the input file contains data values in columns
+2, 4, 6, ...  and error estimates in columns 3, 5, 7, ...  This example
+plots the values in columns 2 and 4 as a histogram of clustered boxes
+(the default style).  Because we use iteration in the plot command, any
+number of data columns can be handled in a single command.  See 'plot
+for'.
+
+           set boxwidth 0.9 relative
+           set style data histograms
+           set style histogram cluster
+           set style fill solid 1.0 border lt -1
+           plot for [COL=2:4:2] 'file.dat' using COL
+
+
+   This will produce a plot with clusters of two boxes (vertical bars)
+centered at each integral value on the x axis.  If the first column of
+the input file contains labels, they may be placed along the x-axis
+using the variant command
+
+           plot for [COL=2:4:2] 'file.dat' using COL:xticlabels(1)
+
+
+   If the file contains both magnitude and range information for each
+value, then error bars can be added to the plot.  The following commands
+will add error bars extending from (y-<error>) to (y+<error>), capped by
+horizontal bar ends drawn the same width as the box itself.  The error
+bars and bar ends are drawn with linewidth 2, using the border linetype
+from the current fill style.
+
+           set errorbars fullwidth
+           set style fill solid 1 border lt -1
+           set style histogram errorbars gap 2 lw 2
+           plot for [COL=2:4:2] 'file.dat' using COL:COL+1
+
+
+   This shows how to plot the same data as a rowstacked histogram.  Just
+to be different, the plot command in this example lists the separate
+columns individually rather than using iteration.
+
+           set style histogram rowstacked
+           plot 'file.dat' using 2, '' using 4:xtic(1)
+
+
+   This will produce a plot in which each vertical bar corresponds to
+one row of data.  Each vertical bar contains a stack of two segments,
+corresponding in height to the values found in columns 2 and 4 of the
+datafile.  Finally, the commands
+
+           set style histogram columnstacked
+           plot 'file.dat' using 2, '' using 4
+
+
+   will produce two vertical stacks, one for each column of data.  The
+stack at x=1 will contain a box for each entry in column 2 of the
+datafile.  The stack at x=2 will contain a box for each parallel entry
+in column 4 of the datafile.
+
+   Because this interchanges gnuplot's usual interpretation of input
+rows and columns, the specification of key titles and x-axis tic labels
+must also be modified accordingly.  See the comments given below.
+
+           set style histogram columnstacked
+           plot '' u 5:key(1)            # uses first column to generate key titles
+           plot '' u 5 title columnhead  # uses first row to generate xtic labels
+
+
+   Note that the two examples just given present exactly the same data
+values, but in different formats.
+
+* Menu:
+
+* newhistogram::
+* automated_iteration_over_multiple_columns::
+* histogram_color_assignments::
+
+
+File: gnuplot.info,  Node: newhistogram,  Next: automated_iteration_over_multiple_columns,  Prev: histograms,  Up: histograms
+
+2.18.1 newhistogram
+-------------------
+
+Syntax:
+
+          newhistogram {"<title>" {font "name,size"} {tc <colorspec>}}
+                       {lt <linetype>} {fs <fillstyle>} {at <x-coord>}
+
+
+   More than one set of histograms can appear in a single plot.  In this
+case you can force a gap between them, and a separate label for each
+set, by using the *note newhistogram:: command.  For example
+
+           set style histogram  cluster
+           plot newhistogram "Set A", 'a' using 1, '' using 2, '' using 3, \
+                newhistogram "Set B", 'b' using 1, '' using 2, '' using 3
+
+
+   The labels "Set A" and "Set B" will appear beneath the respective
+sets of histograms, under the overall x axis label.
+
+   The newhistogram command can also be used to force histogram coloring
+to begin with a specific color (linetype).  By default colors will
+continue to increment successively even across histogram boundaries.
+Here is an example using the same coloring for multiple histograms
+           plot newhistogram "Set A" lt 4, 'a' using 1, '' using 2, '' using 3, \
+                newhistogram "Set B" lt 4, 'b' using 1, '' using 2, '' using 3
+
+
+   Similarly you can force the next histogram to begin with a specified
+fillstyle.  If the fillstyle is set to 'pattern', then the pattern used
+for filling will be incremented automatically.
+
+   Starting a new histogram will normally add a blank entry to the key,
+so that titles from this set of histogram components will be separated
+from those of the previous histogram.  This blank line may be
+undesirable if the components have no individual titles.  It can be
+suppressed by modifying the style with 'set style histogram
+nokeyseparators'.
+
+   The 'at <x-coord>' option sets the x coordinate position of the
+following histogram to <x-coord>.  For example
+
+            set style histogram cluster
+            set style data histogram
+            set style fill solid 1.0 border -1
+            set xtic 1 offset character 0,0.3
+            plot newhistogram "Set A", \
+                 'file.dat' u 1 t 1, '' u 2 t 2, \
+                 newhistogram "Set B" at 8, \
+                 'file.dat' u 2 t 2, '' u 2 t 2
+
+
+   will position the second histogram to start at x=8.
+
+
+File: gnuplot.info,  Node: automated_iteration_over_multiple_columns,  Next: histogram_color_assignments,  Prev: newhistogram,  Up: histograms
+
+2.18.2 automated iteration over multiple columns
+------------------------------------------------
+
+If you want to create a histogram from many columns of data in a single
+file, it is very convenient to use the plot iteration feature.  See
+'plot for'.  For example, to create stacked histograms of the data in
+columns 3 through 8
+
+           set style histogram columnstacked
+           plot for [i=3:8] "datafile" using i title columnhead
+
+
+
+File: gnuplot.info,  Node: histogram_color_assignments,  Prev: automated_iteration_over_multiple_columns,  Up: histograms
+
+2.18.3 histogram color assignments
+----------------------------------
+
+The program assigns a color to each component box in a histogram
+automatically such that equivalent data values maintain a consistent
+color wherever they appear in the rows or columns of the histogram.  The
+colors are taken from successive linetypes, starting either with the
+next unused linetype or an initial linetype provided in a *note
+newhistogram:: element.
+
+   In some cases this mechanism fails due to data sources that are not
+truly parallel (i.e.  some files contain incomplete data).  In other
+cases there may be additional properties of the data that could be
+visualized by, say, varying the intensity or saturation of their base
+color.  As an alternative to the automatic color assignment, you can
+provide an explicit color value for each data value in a second 'using'
+column via the 'linecolor variable' or 'rgb variable' mechanism.  See
+*note colorspec::.  Depending on the layout of your data, the color
+category might correspond to a row header or a column header or a data
+column.  Note that you will probably have to customize the key sample
+colors to match (see 'keyentry').
+
+   Example: Suppose file_001.dat through file_008.dat contain one column
+with a category identifier A, B, C, ...  and a second column with a data
+value.  Not all of the files contain a line for every category, so they
+are not truly parallel.  The program would be wrong to assign the same
+color to the value from line N in each file.  Instead we assign a color
+based on the category in column 1.
+
+          file(i) = sprintf("file_%03d.dat",i)
+          array Category = ["A", "B", "C", "D", "E", "F"]
+          color(c) = index(Category, strcol(c))
+          set style data histogram
+          plot for [i=1:8] file(i) using 2:(color(1)) linecolor variable
+
+
+   A more complete example including generation of a custom key is in
+the demo collection histogram_colors.dem
+(http://www.gnuplot.info/demo/histogram_colors.html) D histogram_colors
+1
+
+
+File: gnuplot.info,  Node: hsteps,  Next: image,  Prev: histograms,  Up: Plotting_styles
+
+2.19 hsteps
+===========
+
+The 2D plotting style *note hsteps:: renders a horizontal line segment
+("step") for each data point.  The step may extend to the left, to the
+right, or to both sides of the point's x-coordinate.  Additional
+keywords control the lines connecting adjacent steps and option area
+fill between the step and a baseline y value.
+
+   Syntax:
+          plot <data> with hsteps
+                              {forward|backward}
+                              {baseline|pillars|link|nolink}
+                              {{above|below} y=<baseline>}
+                              {offset <y-offset>}
+
+
+          2 columns:  x  y
+          3 columns:  x  y  width
+
+
+   This plot style requires 2 or 3 columns of data.  Additional input
+columns can be used to provide variable line or fill colors (see
+'rgbcolor variable').  The x values of the input data are assumed to be
+monotonic.
+
+   If the width of each step is not explicitly given through a third
+input column, each segment’s width is calculated so that it abuts the
+adjacent horizontal segments.  A negative value in column 3 will be
+treated as a request for a full-width step.
+
+   The 'forward' and 'backward' keywords can be used to specify the
+direction in which the horizontal segment extends from the given x
+coordinate.  If neither is specified, the horizontal segment extends on
+both sides of the given x-value halfway to the x-value of the next
+adjacent point.  However, for the first and last points, where there are
+no corresponding outer adjacent points, the horizontal segments are
+extrapolated using distances to the adjacent inner points (see *note
+histeps::, *note boxes::).
+
+   The default ('baseline') and 'pillar' variants employ a baseline y
+value.  If not provided in the plot command, the baseline is taken to be
+y=0.  If the plot command uses a fill style, the baseline also serves to
+delimit one boundary of the fill area.  Four style variants are
+possible.
+
+   'baseline' (default): If there is no gap along x between adjacent
+steps, they are connected by a vertical line segment between them.  This
+produces a curve like the *note steps::, *note histeps::, or *note
+fsteps:: styles.  If there is a gap between steps, usually because the
+width is less than the point spacing, the connecting line drops to the
+baseline and continues along it before rising again.  This produces a
+sequence of rectangular pulses.
+
+          set xzeroaxis
+          plot $data using 1:2 with hsteps
+          plot $data using 1:2:(0.5) with hsteps
+
+
+   'pillar': At each end of each step a vertical line is drawn to the
+baseline.  Note that no horizontal line segments are drawn at the
+baseline.
+
+          plot $data using 1:2       with hsteps pillar
+          plot $data using 1:2:(0.5) with hsteps pillar
+          plot $data using 1:2:(0.5) \
+                     with hsteps pillar above fc "blue", \
+               $data using 1:2:(0.5) \
+                     with hsteps pillar below fc "red"
+
+
+   'nolink': No connecting line is drawn between adjacent steps.
+Baseline and fill properties are not relevant to this variant.
+
+         plot $data using 1:2 with hsteps nolink, \
+              $data using 1:2 with hsteps nolink forward, \
+              $data using 1:2 with hsteps nolink backward, \
+              $data using 1:2 with points pt "|"
+
+
+   *note link::: Adjacent steps steps are connected by a single straight
+line segment.  Depending on the step widths, this line may be diagonal
+rather than vertical.
+
+   Example: The *note link:: variant can be superimposed onto the
+'pillar' variant to produce a stacked histogram plot in which category
+boundaries are connected.
+
+          set style line 11 lw 2 lc "gray" dt "."
+          set style line 12 lw 2 lc variable
+          plot $data using 1:3:(0.5)   ls 11 with hsteps link, \
+               $data using 1:3:(0.5):1 ls 12 with hsteps pillar fs solid 0.7 border, \
+               $data using 1:4:(0.5)   ls 11 with hsteps link, \
+               $data using 1:4:(0.5):1 ls 12 with hsteps pillar fs transparent pattern 1 border
+
+
+* Menu:
+
+* offset::
+* missing_data::
+
+
+File: gnuplot.info,  Node: offset,  Next: missing_data,  Prev: hsteps,  Up: hsteps
+
+2.19.1 offset
+-------------
+
+The offset value modifies any of the *note hsteps:: variants by adding
+an increment to the y value of both the data point itself (column 2) and
+the baseline of the plot it appears in.  An example of use is to draw a
+logic circuit timing chart in which pulse waveforms are aligned
+vertically.  In general the offset can be used to stack plots from
+multiple data sets that share a common range of y values.
+
+          # bit(k,char) is a function that returns 0 or 1
+          # for the state of bit k in an ASCII character
+          set style fill solid 0.2 border
+          plot for [k=1:8] STR using 1:(bit(k,STR[$1])):(0.5) \
+               with hsteps fillcolor "black" offset k
+
+
+
+File: gnuplot.info,  Node: missing_data,  Prev: offset,  Up: hsteps
+
+2.19.2 missing data
+-------------------
+
+In the hsteps style, empty lines, NaN values, and missing data have
+distinct meanings.  If an empty line is present in the data, the data
+series is reset at that point.  This is analogous to a blank line
+causing a break to start a new curve in the case of 'with lines'.  If an
+x-value contains NaN, it is processed in the same manner as an empty
+line.  If the x-value is valid but the y-value contains NaN, no
+horizontal line is drawn for that particular data point but the x-value
+is still used if needed to estimate the step width.
+
+
+File: gnuplot.info,  Node: image,  Next: impulses,  Prev: hsteps,  Up: Plotting_styles
+
+2.20 image
+==========
+
+The 'image', *note rgbimage::, and *note rgbalpha:: plotting styles all
+project a uniformly sampled grid of data values onto a plane in either
+2D or 3D. The input data may be an actual bitmapped image, perhaps
+converted from a standard format such as PNG, or a simple array of
+numerical values.  These plot styles are often used to produce heatmaps.
+For 2D heatmaps in polar coordinates, see 'set polar grid'.
+
+   This figure illustrates generation of a heat map from an array of
+scalar values.  The current palette is used to map each value onto the
+color assigned to the corresponding pixel.  See also 'sparse'.
+           plot '-' matrix with image
+           5 4 3 1 0
+           2 2 0 0 1
+           0 0 0 1 0
+           0 1 2 4 3
+           e
+           e
+
+
+   Each pixel (data point) of the input 2D image will become a rectangle
+or parallelepiped in the plot.  The coordinates of each data point will
+determine the center of the parallelepiped.  That is, an M x N set of
+data will form an image with M x N pixels.  This is different from the
+pm3d plotting style, where an M x N set of data will form a surface of
+(M-1) x (N-1) elements.  The scan directions for a binary image data
+grid can be further controlled by additional keywords.  See 'binary
+keywords flipx', 'keywords center', and 'keywords rotate'.
+
+   Image data can be scaled to fill a particular rectangle within a 2D
+plot coordinate system by specifying the x and y extent of each pixel.
+See 'binary keywords dx' and 'dy'.  To generate the figure at the right,
+the same input image was placed multiple times, each with a specified
+dx, dy, and origin.  The input PNG image of a building is 50x128 pixels.
+The tall building was drawn by mapping this using 'dx=0.5 dy=1.5'.  The
+short building used a mapping 'dx=0.5 dy=0.35'.
+
+   The 'image' style handles input pixels containing a grayscale or
+color palette value.  Thus 2D plots ('plot' command) require 3 columns
+of data (x,y,value), while 3D plots ('splot' command) require 4 columns
+of data (x,y,z,value).
+
+   The *note rgbimage:: style handles input pixels that are described by
+three separate values for the red, green, and blue components.  Thus 5D
+data (x,y,r,g,b) is needed for 'plot' and 6D data (x,y,z,r,g,b) for
+'splot'.  The individual red, green, and blue components are assumed to
+lie in the range [0:255].  This matches the convention used in PNG and
+JPEG files (see *note filetype::).  However some data files use an
+alternative convention in which RGB components are floating point values
+in the range [0:1].  To use the *note rgbimage:: style with such data,
+first use the command 'set rgbmax 1.0'.
+
+   The *note rgbalpha:: style handles input pixels that contain alpha
+channel (transparency) information in addition to the red, green, and
+blue components.  Thus 6D data (x,y,r,g,b,a) is needed for 'plot' and 7D
+data (x,y,z,r,g,b,a) for 'splot'.  The r, g, b, and alpha components are
+assumed to lie in the range [0:255].  To plot data for which RGBA
+components are floating point values in the range [0:1], first use the
+command 'set rgbmax 1.0'.
+
+   If only a single data column is provided for the color components of
+either rgbimage or rgbalpha plots, it is interpreted as containing 32
+bit packed ARGB data using the convention that alpha=0 means opaque and
+alpha=255 means fully transparent.  Note that this is backwards from the
+alpha convention if alpha is supplied in a separate column, but matches
+the ARGB packing convention for individual commands to set color.  See
+*note colorspec::.
+
+* Menu:
+
+* transparency::
+* image_pixels::
+
+
+File: gnuplot.info,  Node: transparency,  Next: image_pixels,  Prev: image,  Up: image
+
+2.20.1 transparency
+-------------------
+
+The *note rgbalpha:: plotting style assumes that each pixel of input
+data contains an alpha value in the range [0:255].  A pixel with alpha =
+0 is purely transparent and does not alter the underlying contents of
+the plot.  A pixel with alpha = 255 is purely opaque.  All terminal
+types can handle these two extreme cases.  A pixel with 0 < alpha < 255
+is partially transparent.  Terminal types that do not support partial
+transparency will round this value to 0 or 255.  D argb_hexdata 2
+
+
+File: gnuplot.info,  Node: image_pixels,  Prev: transparency,  Up: image
+
+2.20.2 image pixels
+-------------------
+
+Some terminals use device- or library-specific optimizations to render
+image data within a rectangular 2D area.  This sometimes produces
+undesirable output, e.g.  inter-pixel smoothing, bad clipping or missing
+edges.  An example of this is the smoothing applied by web browsers when
+rendering svg images.  The 'pixels' keyword tells gnuplot to use generic
+code to render the image pixel-by-pixel.  This rendering mode is slower
+and may result in larger output files, but should produce a consistent
+rendered view on all terminals.  It may in particular be preferable for
+heatmaps with a small number of pixels.  Example:
+           plot 'data' with image pixels
+
+
+
+File: gnuplot.info,  Node: impulses,  Next: labels,  Prev: image,  Up: Plotting_styles
+
+2.21 impulses
+=============
+
+The *note impulses:: style displays a vertical line from y=0 to the y
+value of each point (2D) or from z=0 to the z value of each point (3D).
+Note that the y or z values may be negative.  Data from additional
+columns can be used to control the color of each impulse.  To use this
+style effectively in 3D plots, it is useful to choose thick lines
+(linewidth > 1).  This approximates a 3D bar chart.
+
+          1 column:   y
+          2 columns:  x  y     # line from [x,0] to [x,y]  (2D)
+          3 columns:  x  y  z  # line from [x,y,0] to [x,y,z] (3D)
+
+
+
+File: gnuplot.info,  Node: labels,  Next: lines,  Prev: impulses,  Up: Plotting_styles
+
+2.22 labels
+===========
+
+The *note labels:: style reads coordinates and text from a data file and
+places the text string at the corresponding 2D or 3D position.  3 or 4
+input columns of basic data are required.  Additional input columns may
+be used to provide properties that vary point by point such as text
+rotation angle (keywords 'rotate variable') or color (see 'textcolor
+variable').
+
+          3 columns:  x  y  string    # 2D version
+          4 columns:  x  y  z  string # 3D version
+
+
+   The font, color, rotation angle and other properties of the printed
+text may be specified as additional command options (see 'set label').
+The example below generates a 2D plot with text labels constructed from
+the city whose name is taken from column 1 of the input file, and whose
+geographic coordinates are in columns 4 and 5.  The font size is
+calculated from the value in column 3, in this case the population.
+
+       CityName(String,Size) = sprintf("{/=%d %s}", Scale(Size), String)
+       plot 'cities.dat' using 5:4:(CityName(stringcolumn(1),$3)) with labels
+
+
+   If we did not want to adjust the font size to a different size for
+each city name, the command would be much simpler:
+
+       plot 'cities.dat' using 5:4:1 with labels font "Times,8"
+
+
+   If the labels are marked as *note hypertext:: then the text only
+appears if the mouse is hovering over the corresponding anchor point.
+See *note hypertext::.  In this case you must enable the label's 'point'
+attribute so that there is a point to act as the hypertext anchor:
+
+       plot 'cities.dat' using 5:4:1 with labels hypertext point pt 7
+
+
+   The *note labels:: style can also be used in place of the 'points'
+style when the set of predefined point symbols is not suitable or not
+sufficiently flexible.  For example, here we define a set of chosen
+single-character symbols and assign one of them to each point in a plot
+based on the value in data column 3:
+
+       set encoding utf8
+       symbol(z) = "∙□+⊙♠♣♡♢"[int(z):int(z)]
+       splot 'file' using 1:2:(symbol($3)) with labels
+
+
+   This example shows use of labels with variable rotation angle in
+column 4 and textcolor ("tc") in column 5.  Note that variable color is
+always taken from the last column in the 'using' specifier.
+
+       plot $Data using 1:2:3:4:5 with labels tc variable rotate variable
+
+
+
+File: gnuplot.info,  Node: lines,  Next: linespoints,  Prev: labels,  Up: Plotting_styles
+
+2.23 lines
+==========
+
+The 'lines' style connects adjacent points with straight line segments.
+It may be used in either 2D or 3D plots.  The basic form requires 1, 2,
+or 3 columns of input data.  Additional input columns may be used to
+provide information such as variable line color (see 'rgbcolor
+variable').
+
+   2D form (no "using" spec)
+        1 column:   y     # implicit x from row number
+        2 columns:  x y
+
+   3D form (no "using" spec)
+        1 column:   z     # implicit x from row, y from index
+        3 columns:  x y z
+
+
+   See also 'linetypes', 'linewidth', and 'linestyle'.
+
+
+File: gnuplot.info,  Node: linespoints,  Next: masking,  Prev: lines,  Up: Plotting_styles
+
+2.24 linespoints
+================
+
+The *note linespoints:: style (short form 'lp') connects adjacent points
+with straight line segments and then goes back to draw a small symbol at
+each point.  Points are drawn with the default size determined by *note
+pointsize:: unless a specific point size is given in the plot command or
+a variable point size is provided in an additional column of input data.
+Additional input columns may also be used to provide information such as
+variable line color.  See 'lines' and 'points'.
+
+   Two keywords control whether or not every point in the plot is marked
+with a symbol, 'pointinterval' (short form 'pi') and 'pointnumber'
+(short form 'pn').
+
+   'pi N' or 'pi -N' tells gnuplot to only place a symbol on every Nth
+point.  A negative value for N will erase the portion of line segment
+that passes underneath the symbol.  The size of the erased portion is
+controlled by *note pointintervalbox::.
+
+   'pn N' or 'pn -N' tells gnuplot to label only N of the data points,
+evenly spaced over the data set.  As with 'pi', a negative value for N
+will erase the portion of line segment that passes underneath the
+symbol.
+
+
+File: gnuplot.info,  Node: masking,  Next: parallelaxes,  Prev: linespoints,  Up: Plotting_styles
+
+2.25 masking
+============
+
+The plotting style 'with mask' is used to define a masking region that
+can be applied to pm3d surfaces or to images specified later in the same
+'plot' or 'splot' command.  Input data is interpreted as a stream of
+[x,y] or [x,y,z] coordinates defining the vertices of one or more
+polygons.  As in plotting style *note polygons::, polygons are separated
+by a blank line.  If the mask is part of a 3D (splot) command then a
+column of z values is required on input but is currently not used for
+anything.
+
+   If a mask definition is present in the plot command, then any
+subsequent image or pm3d surface in the same command can be masked by
+adding the keyword 'mask'.  If no mask has been defined, this keyword is
+ignored.
+
+   This example illustrates using the convex hull circumscribing a set
+of points to mask the corresponding region of a pm3d surface.
+        set table $HULL
+        plot $POINTS using 1:2 convexhull
+        unset table
+
+
+        set view map
+        set multiplot layout 1,2
+        splot $POINTS using 1:2:3 with pm3d, \
+              $POINTS using 1:2:(0) nogrid with points
+        splot $HULL using 1:2:(0) with mask, \
+              $POINTS using 1:2:3 mask with pm3d
+        unset multiplot
+
+   The 'splot' command for the first panel renders the unmasked surface
+created by dgrid3d from the original points and then the points
+themselves, in that order.  The 'splot' command for the second panel
+renders the masked surface.  Note that definition of the mask must come
+first (plot 'with mask'), followed by the pm3d surface it applies to
+(plot style 'with pm3d' modified by the 'mask' keyword).  A more
+complete version of this example is in the demo collection mask_pm3d.dem
+(http://www.gnuplot.info/demo/mask_pm3d.html)
+
+   Although it is not shown here, a single mask can include multiple
+polygonal regions.
+
+   The masking commands are EXPERIMENTAL. Details may change in a future
+release.
+
+
+File: gnuplot.info,  Node: parallelaxes,  Next: Polar_plots,  Prev: masking,  Up: Plotting_styles
+
+2.26 parallelaxes
+=================
+
+Parallel axis plots can highlight correlation in a multidimensional data
+set.  Individual columns of input data are each associated with a
+separately scaled vertical axis.  If all columns are drawn from a single
+file then each line on the plot represents values from a single row of
+data in that file.  It is common to use some discrete categorization to
+assign line colors, allowing visual exploration of the correlation
+between this categorization and the axis dimensions.
+
+   Syntax:
+
+         set style data parallelaxes
+         plot $DATA using col1{:varcol1} {at <xpos>} {<line properties}, \
+              $DATA using col2, ...
+
+
+   The 'at' keyword allows explicit placement of the parallel vertical
+axes along the x axis as in the example below.  If no explicit x
+coordinate is provide axis N will be placed at x=N.
+
+          array xpos[5] = [1, 5, 6, 7, 11, 12]
+          plot for [col=1:5] $DATA using col with parallelaxes at xpos[col]
+
+
+   By default gnuplot will automatically determine the range and scale
+of the individual axes from the input data, but the usual 'set axis
+range' commands can be used to customize this.  See *note paxis::.
+
+
+File: gnuplot.info,  Node: Polar_plots,  Next: points,  Prev: parallelaxes,  Up: Plotting_styles
+
+2.27 Polar plots
+================
+
+Polar plots are generated by changing the current coordinate system to
+polar before issuing a plot command.  The option 'set polar' tells
+gnuplot to interpret input 2D coordinates as <angle>,<radius> rather
+than <x>,<y>.  Many, but not all, of the 2D plotting styles work in
+polar mode.  The figure shows a combination of plot styles 'lines' and
+*note filledcurves::.  See 'set polar', *note rrange::, 'set size
+square', *note theta::, *note ttics::.
+
+   Polar heatmaps can be generated using plot style 'with surface'
+together with 'set polar grid'.
+          set size square
+          set angle degrees
+          set rtics
+          set grid polar
+          set palette cubehelix negative gamma 0.8
+          set polar grid gauss kdensity scale 35
+          set polar grid theta [0:190]
+          plot DATA with surface, DATA with points pt 7
+
+
+
+File: gnuplot.info,  Node: points,  Next: polygons,  Prev: Polar_plots,  Up: Plotting_styles
+
+2.28 points
+===========
+
+The 'points' style displays a small symbol at each point.  The command
+*note pointsize:: may be used to change the default size of all points.
+The point type defaults to that of the linetype.  See 'linetypes'.  If
+no 'using' spec is found in the plot command, input data columns are
+interpreted implicitly in the order 'x y pointsize pointtype color' as
+described below.
+
+   The first 8 point types are shared by all terminals.  Individual
+terminals may provide a much larger number of distinct point types.  Use
+the 'test' command to show what is provided by the current terminal
+settings.
+
+   Alternatively any single printable character may be given instead of
+a numerical point type, as in the example below.  You may use any
+unicode character as the pointtype (assumes utf8 support).  See 'escape
+sequences'.  Longer strings may be plotted using plot style *note
+labels:: rather than 'points'.
+
+          plot f(x) with points pt "#"
+          plot d(x) with points pt "\U+2299"
+
+
+* Menu:
+
+* variable_point_properties::
+
+
+File: gnuplot.info,  Node: variable_point_properties,  Prev: points,  Up: points
+
+2.28.1 variable point properties
+--------------------------------
+
+Plot styles that contain a point symbol optionally accept additional
+data columns in the 'using' specifier to control the appearance of that
+point.  This is indicated by modifying the keywords 'pointtype', *note
+pointsize::, or 'linecolor' in the plot command with the additional
+keyword 'variable' rather than providing a number.  Plot style *note
+labels:: also accepts a variable text rotation angle.  Example:
+          # Input data provides [x,y] in columns 1:2
+          # point size is given in column 5
+          # RGB color is given as hexadecimal value in column 4
+          # all points use pointtype 7
+            plot DATA using 1:2:5:4 with points lc rgb variable ps variable pt 7
+
+
+   If more than one variable property is specified, columns are
+interpreted in the order below regardless of the order of keywords in
+the plot command.
+
+         textrotation : pointsize : pointtype : color
+
+
+   Thus in the example above "lc rgb variable" appears first in the plot
+command but the color is taken from the final column (4) given by
+'using'.  Variable color is always taken from the last additional
+column.  There are several methods of specifying variable color.  See
+*note colorspec::.
+
+   Note: for information on user-defined program variables, see
+'variables'.
+
+
+File: gnuplot.info,  Node: polygons,  Next: rgbalpha,  Prev: points,  Up: Plotting_styles
+
+2.29 polygons
+=============
+
+2D plots:
+
+          plot DATA {using 1:2} with polygons
+
+
+   *note polygons:: is treated as 'plot with filledcurves closed' except
+that each polygon's border is rendered as a closed curve even if its
+first and last points are not the same.  The border line type is taken
+from the fill style.  The input data file may contain multiple polygons
+separated by single blank lines.  Each polygon can be assigned a
+separate fill color by providing a third using specifier and the
+keywords 'fc variable' (value is interpreted as a linetype) or 'fc rgb
+variable' (value is interpreted as a 24-bit RGB color).  Only the color
+value from the first vertex of the polygon is used.
+
+   3D plots:
+
+          splot DATA {using x:y:z} with polygons
+                {fillstyle <fillstyle spec>}
+                {fillcolor <colorspec>}
+
+
+   *note polygons:: uses pm3d to render individual triangles,
+quadrangles, and larger polygons in 3D. These may be facets of a 3D
+surface or isolated shapes.  The code assumes that the vertices lie in a
+plane.  Vertices defining individual polygons are read from successive
+records of the input file.  A blank line separates one polygon from the
+next.
+
+   The fill style and color may be specified in the splot command,
+otherwise the global fillstyle from 'set style fill' is used.  Due to
+limitations in the pm3d code, a single border line style from *note
+border:: is applied to all 3D polygons.  This restriction may be removed
+in a later gnuplot version, which will impose a distinction between the
+linecolor and fillcolor properties.
+
+   Each polygon may be assigned a separate fill color by providing a
+fourth using specifier and the keywords 'fc variable' (value is
+interpreted as a linetype) or 'fc rgb variable' (value is interpreted as
+a 24-bit RGB color).  Only the color value from the first vertex of the
+polygon is used.
+
+   pm3d sort order and lighting are applied to the faces.  It is
+probably always desirable to use 'set pm3d depthorder'.
+
+          set xyplane at 0
+          set view equal xyz
+          unset border
+          unset tics
+          set pm3d depth
+          set pm3d border lc "black" lw 1.5
+          splot 'icosahedron.dat' with polygons \
+                fs transparent solid 0.8 fc bgnd
+
+
+
+File: gnuplot.info,  Node: rgbalpha,  Next: rgbimage,  Prev: polygons,  Up: Plotting_styles
+
+2.30 rgbalpha
+=============
+
+See 'image'.
+
+
+File: gnuplot.info,  Node: rgbimage,  Next: sectors,  Prev: rgbalpha,  Up: Plotting_styles
+
+2.31 rgbimage
+=============
+
+See 'image'.
+
+
+File: gnuplot.info,  Node: sectors,  Next: spiderplot,  Prev: rgbimage,  Up: Plotting_styles
+
+2.32 sectors
+============
+
+The 2D plotting style *note sectors:: renders one annular segment
+("sector") for each line of input data.  The shape of each sector is
+described by four required data values.  An additional pair of data
+values can be included to specify the origin of the annulus this sector
+is taken from.  A per-sector color may be provided in an additional
+column.
+
+   The plot style itself can be used in either cartesian or polar mode
+('set polar').  The units and interpretation for the azimuth and the
+sector angle are controlled using *note angles:: and *note theta::.
+
+   Columns 1 and 2 specify the azimuth (theta) and radius (r) of one
+corner of the sector.  Columns 3 and 4 specify the angular and radial
+extents of the sector ("sector_angle" and "annular_width").  Columns 5
+and 6, if present, specify the coordinates of the center of the annulus
+(default [0,0]).  The interpretation is [x,y] in cartesian mode and
+[theta,r] in polar mode.
+
+   Syntax:
+         plot DATA {using specifier} {units xy | units xx | units yy}
+
+
+   using specifier
+         4 columns: azimuth radius sector_angle annular_width
+         5 columns: azimuth radius sector_angle annular_width color
+         6 columnd: azimuth radius sector_angle annular_width center_x center_y
+         7 columns: azimuth radius sector_angle annular_width center_x center_y color
+
+
+   Note that if the x and y axis scales are not equal, the envelope of
+the full annulus in x/y coordinates will appear as an ellipse rather
+than a circle.  The annulus envelope and thus the apparent sector
+annular width can be adjusted to correct for unequal axis scales using
+the same mechanism as for ellipses.  Adding 'units xx' to the command
+line causes the sector to be rendered as if the current x axis scale
+applied equally to both x and y.  Similarly 'units yy' causes the sector
+to be rendered as if the current y axis scale applied equally to both x
+and y.  See *note isotropic::, 'set style ellipse'.
+
+   Plotting with sectors can provide polar coordinate equivalents for
+the cartesian plot styles *note boxes:: (see wind rose figure), *note
+boxxyerror:: and 'image pixels' (see example in *note heatmaps::).
+Because sector plots are compatible with cartesian mode plot layout,
+multiple plots can be placed at different places on a single graph,
+which would not be possible for other polar mode plot styles.
+
+   An example of using sectors to create a wind rose in shown here.
+Other applications include polar heatmaps, dial charts, pie/donut
+charts, and annular error boxes for data points in polar coordinates.
+Worked examples for all of these are given in the sectors demo.
+(http://www.gnuplot.info/demo/sectors.html)
+
+
+File: gnuplot.info,  Node: spiderplot,  Next: steps,  Prev: sectors,  Up: Plotting_styles
+
+2.33 spiderplot
+===============
+
+Spider plots are essentially parallel axis plots in which the axes are
+arranged radially rather than vertically.  Such plots are sometimes
+called 'radar charts'.  In gnuplot this requires working within a
+coordinate system established by the command *note spiderplot::,
+analogous to 'set polar' except that the angular coordinate is
+determined implicitly by the parallel axis number.  The appearance,
+labelling, and tic placement of the axes is controlled by *note paxis::.
+Further style choices are controlled using *note spiderplot::, 'set
+grid', and the individual components of the plot command.
+
+   Because each spider plot corresponds to a row of data rather than a
+column, it would make no sense to generate key entry titles in the
+normal way.  Instead, if a plot component contains a title the text is
+used to label the corresponding axis.  This overrides any previous 'set
+paxis n label "Foo"'.  To place a title in the key, you can either use a
+separate 'keyentry' command or extract text from a column in the input
+file with the 'key(column)' using specifier.  See 'keyentry', 'using
+key'.
+
+   In this figure a spiderplot with 5 axes is used to compare multiple
+entities that are each characterized by five scores.  Each line (row) in
+$DATA generates a new polygon on the plot.
+
+          $DATA << EOD
+                   A      B      C      D      E      F
+          George  15     75     20     43     90     50
+          Harriet 40     40     40     60     30     50
+          EOD
+          set spiderplot
+          set style spiderplot fs transparent solid 0.2 border
+          set for [p=1:5] paxis p range [0:100]
+          set for [p=2:5] paxis p tics format ""
+          set             paxis 1 tics font ",9"
+          set for [p=1:5] paxis p label sprintf("Score %d",p)
+          set grid spiderplot
+          plot for [i=1:5] $DATA using i:key(1)
+
+
+* Menu:
+
+* newspiderplot::
+
+
+File: gnuplot.info,  Node: newspiderplot,  Prev: spiderplot,  Up: spiderplot
+
+2.33.1 newspiderplot
+--------------------
+
+Normally the sequential elements of a plot command *note spiderplot::
+each correspond to one vertex of a single polygon.  In order to describe
+multiple polygons in the same plot command, they must be separated by
+*note newspiderplot::.  Example:
+          # One polygon with 10 vertices
+          plot for [i=1:5] 'A' using i, for [j=1:5] 'B' using j
+          # Two polygons with 5 vertices
+          plot for [i=1:5] 'A' using i, newspiderplot, for [j=1:5] 'B' using j
+
+
+
+File: gnuplot.info,  Node: steps,  Next: surface,  Prev: spiderplot,  Up: Plotting_styles
+
+2.34 steps
+==========
+
+The *note steps:: style is only relevant to 2D plotting.  It connects
+consecutive points with two line segments: the first from (x1,y1) to
+(x2,y1) and the second from (x2,y1) to (x2,y2).  The input column
+requires are the same as for plot styles 'lines' and 'points'.  The
+difference between *note fsteps:: and *note steps:: is that *note
+fsteps:: traces first the change in y and then the change in x.  *note
+steps:: traces first the change in x and then the change in y.  To fill
+the area between the curve and the baseline at y=0, use *note
+fillsteps::.  See also steps demo.
+(http://www.gnuplot.info/demo/steps.html)
+        1 column:   y     # implicit x from line number (column 0)
+        2 columns:  x y
+
+
+
+File: gnuplot.info,  Node: surface,  Next: vectors,  Prev: steps,  Up: Plotting_styles
+
+2.35 surface
+============
+
+The plot style 'with surface' has two uses.
+
+   In 3D plots, 'with surface' always produces a surface.  If a 3D data
+set is recognizable as a mesh (grid) then by default the program
+implicitly treats the plot style 'with lines' as requesting a gridded
+surface, making 'with lines' a synonym for 'with surface'.  However the
+command 'set surface explicit' suppresses this treatment, in which case
+'with surface' and 'with lines' become distinct styles that may be used
+in the same plot.
+
+   If you have points in 3D that are not recognized as a grid, you may
+be able to fit a suitable grid first.  See *note dgrid3d::.
+
+   In 2D polar mode plots, 'with surface' is used to produce a solid
+fill gridded represention of the data.  Generation of the surface is
+controlled using the command 'set polar grid'.
+
+
+File: gnuplot.info,  Node: vectors,  Next: xerrorbars,  Prev: surface,  Up: Plotting_styles
+
+2.36 vectors
+============
+
+The 2D *note vectors:: style draws a vector from (x,y) to
+(x+xdelta,y+ydelta).  The 3D *note vectors:: style is similar, but
+requires six columns of basic data.  In both cases, an additional input
+column (5th in 2D, 7th in 3D) may be used to provide variable
+(per-datapoint) color information.  (see 'linecolor' and 'rgbcolor
+variable').  A small arrowhead is drawn at the end of each vector.
+
+          4 columns:  x  y  xdelta  ydelta
+          6 columns:  x  y  z  xdelta  ydelta  zdelta
+
+
+   The keywords "with vectors" may be followed by inline arrow style
+properties, by reference to a predefined arrow style, or by a request to
+read the index of the desired arrow style for each vector from a
+separate input column.  See the first three examples below.
+
+   Examples:
+
+          plot ... using 1:2:3:4 with vectors filled heads
+          plot ... using 1:2:3:4 with vectors arrowstyle 3
+          plot ... using 1:2:3:4:5 with vectors arrowstyle variable
+          splot 'file.dat' using 1:2:3:(1):(1):(1) with vectors filled head lw 2
+
+
+   Notes: You cannot mix the 'arrowstyle' keyword with other line style
+qualifiers in the plot command.  An additional column of color values is
+required if the arrow style includes 'lc variable' or 'lc rgb variable'.
+
+   splot with vectors is supported only for 'set mapping cartesian'.
+'set clip one' and 'set clip two' affect vectors drawn in 2D. See 'set
+clip' and 'arrowstyle'.
+
+   See also the 2D plot style 'with arrows' that is identical to *note
+vectors:: except that each arrow is specified using x:y:length:angle.
+
+
+File: gnuplot.info,  Node: xerrorbars,  Next: xyerrorbars,  Prev: vectors,  Up: Plotting_styles
+
+2.37 xerrorbars
+===============
+
+The *note xerrorbars:: style is only relevant to 2D data plots.  *note
+xerrorbars:: is like 'points', except that a horizontal error bar is
+also drawn.  At each point (x,y), a line is drawn from (xlow,y) to
+(xhigh,y) or from (x-xdelta,y) to (x+xdelta,y), depending on how many
+data columns are provided.  The appearance of the tic mark at the ends
+of the bar is controlled by *note errorbars::.  The clearance between
+the point and the error bars is controlled by *note pointintervalbox::.
+To have the error bars pass directly through the point with no
+interruption, use *note pointintervalbox::.  The basic style requires
+either 3 or 4 columns:
+
+          3 columns:  x  y  xdelta
+          4 columns:  x  y  xlow  xhigh
+
+
+   An additional input column (4th or 5th) may be used to provide
+variable color.  This style does not permit variable point properties.
+
+
+File: gnuplot.info,  Node: xyerrorbars,  Next: xerrorlines,  Prev: xerrorbars,  Up: Plotting_styles
+
+2.38 xyerrorbars
+================
+
+The *note xyerrorbars:: style is only relevant to 2D data plots.  *note
+xyerrorbars:: is like 'points', except that horizontal and vertical
+error bars are also drawn.  At each point (x,y), lines are drawn from
+(x,y-ydelta) to (x,y+ydelta) and from (x-xdelta,y) to (x+xdelta,y) or
+from (x,ylow) to (x,yhigh) and from (xlow,y) to (xhigh,y), depending
+upon the number of data columns provided.  The appearance of the tic
+mark at the ends of the bar is controlled by *note errorbars::.  The
+clearance between the point and the error bars is controlled by *note
+pointintervalbox::.  To have the error bars pass directly through the
+point with no interruption, use *note pointintervalbox::.  Either 4 or 6
+input columns are required.
+
+          4 columns:  x  y  xdelta  ydelta
+          6 columns:  x  y  xlow  xhigh  ylow  yhigh
+
+
+   If data are provided in an unsupported mixed form, the 'using'
+specifier of the 'plot' command should be used to set up the appropriate
+form.  For example, if the data are of the form (x,y,xdelta,ylow,yhigh),
+then you can use
+
+           plot 'data' using 1:2:($1-$3):($1+$3):4:5 with xyerrorbars
+
+
+   An additional input column (5th or 7th) may be used to provide
+variable color.  This style does not permit variable point properties.
+
+
+File: gnuplot.info,  Node: xerrorlines,  Next: xyerrorlines,  Prev: xyerrorbars,  Up: Plotting_styles
+
+2.39 xerrorlines
+================
+
+The *note xerrorlines:: style is only relevant to 2D data plots.  *note
+xerrorlines:: is like *note linespoints::, except that a horizontal
+error line is also drawn.  At each point (x,y), a line is drawn from
+(xlow,y) to (xhigh,y) or from (x-xdelta,y) to (x+xdelta,y), depending on
+how many data columns are provided.  The appearance of the tic mark at
+the ends of the bar is controlled by *note errorbars::.  The basic style
+requires either 3 or 4 columns:
+
+          3 columns:  x  y  xdelta
+          4 columns:  x  y  xlow  xhigh
+
+
+   An additional input column (4th or 5th) may be used to provide
+variable color.  This style does not permit variable point properties.
+
+
+File: gnuplot.info,  Node: xyerrorlines,  Next: yerrorbars,  Prev: xerrorlines,  Up: Plotting_styles
+
+2.40 xyerrorlines
+=================
+
+The *note xyerrorlines:: style is only relevant to 2D data plots.  *note
+xyerrorlines:: is like *note linespoints::, except that horizontal and
+vertical error bars are also drawn.  At each point (x,y), lines are
+drawn from (x,y-ydelta) to (x,y+ydelta) and from (x-xdelta,y) to
+(x+xdelta,y) or from (x,ylow) to (x,yhigh) and from (xlow,y) to
+(xhigh,y), depending upon the number of data columns provided.  The
+appearance of the tic mark at the ends of the bar is controlled by *note
+errorbars::.  Either 4 or 6 input columns are required.
+
+          4 columns:  x  y  xdelta  ydelta
+          6 columns:  x  y  xlow  xhigh  ylow  yhigh
+
+
+   If data are provided in an unsupported mixed form, the 'using'
+specifier of the 'plot' command should be used to set up the appropriate
+form.  For example, if the data are of the form (x,y,xdelta,ylow,yhigh),
+then you can use
+
+           plot 'data' using 1:2:($1-$3):($1+$3):4:5 with xyerrorlines
+
+
+   An additional input column (5th or 7th) may be used to provide
+variable color.  This style does not permit variable point properties.
+
+
+File: gnuplot.info,  Node: yerrorbars,  Next: yerrorlines,  Prev: xyerrorlines,  Up: Plotting_styles
+
+2.41 yerrorbars
+===============
+
+The *note yerrorbars:: (or *note errorbars::) style is only relevant to
+2D data plots.  *note yerrorbars:: is like 'points', except that a
+vertical error bar is also drawn.  At each point (x,y), a line is drawn
+from (x,y-ydelta) to (x,y+ydelta) or from (x,ylow) to (x,yhigh),
+depending on how many data columns are provided.  The appearance of the
+tic mark at the ends of the bar is controlled by *note errorbars::.  The
+clearance between the point and the error bars is controlled by *note
+pointintervalbox::.  To have the error bars pass directly through the
+point with no interruption, use *note pointintervalbox::.
+
+          2 columns:  [implicit x] y ydelta
+          3 columns:  x  y  ydelta
+          4 columns:  x  y  ylow  yhigh
+
+
+   Additional input columns may be used to provide information such as
+variable point size, point type, or color.
+
+   See also errorbar demo.  (http://www.gnuplot.info/demo/mgr.html)
+
+
+File: gnuplot.info,  Node: yerrorlines,  Next: 3D_plots,  Prev: yerrorbars,  Up: Plotting_styles
+
+2.42 yerrorlines
+================
+
+The *note yerrorlines:: (or 'errorlines') style is only relevant to 2D
+data plots.  *note yerrorlines:: is like *note linespoints::, except
+that a vertical error line is also drawn.  At each point (x,y), a line
+is drawn from (x,y-ydelta) to (x,y+ydelta) or from (x,ylow) to
+(x,yhigh), depending on how many data columns are provided.  The
+appearance of the tic mark at the ends of the bar is controlled by *note
+errorbars::.  Either 3 or 4 input columns are required.
+
+          3 columns:  x  y  ydelta
+          4 columns:  x  y  ylow  yhigh
+
+
+   Additional input columns may be used to provide information such as
+variable point size, point type, or color.
+
+   See also errorbar demo.  (http://www.gnuplot.info/demo/mgr.html)
+
+
+File: gnuplot.info,  Node: 3D_plots,  Next: Fence_plots,  Prev: yerrorlines,  Up: Plotting_styles
+
+2.43 3D plots
+=============
+
+3D plots are generated using the command 'splot' rather than 'plot'.
+Many of the 2D plot styles (points, images, impulse, labels, vectors)
+can also be used in 3D by providing an extra column of data containing z
+coordinate.  Some plot types (pm3d coloring, surfaces, contours) must be
+generated using the 'splot' command even if only a 2D projection is
+wanted.
+
+* Menu:
+
+* surface_plots::
+* 2D_projection_(set_view_map)::
+* PM3D_plots::
+
+
+File: gnuplot.info,  Node: surface_plots,  Next: 2D_projection_(set_view_map),  Prev: 3D_plots,  Up: 3D_plots
+
+2.43.1 surface plots
+--------------------
+
+The styles 'splot with lines' and 'splot with surface' both generate a
+surface made from a grid of lines.  Solid surfaces can be generated
+using the style 'splot with pm3d'.  Usually the surface is displayed at
+some convenient viewing angle, such that it clearly represents a 3D
+surface.  See *note view::.  In this case the X, Y, and Z axes are all
+visible in the plot.  The illusion of 3D is enhanced by choosing hidden
+line removal.  See *note hidden3d::.  The 'splot' command can also
+calculate and draw contour lines corresponding to constant Z values.
+These contour lines may be drawn onto the surface itself, or projected
+onto the XY plane.  See 'set contour'.
+
+
+File: gnuplot.info,  Node: 2D_projection_(set_view_map),  Next: PM3D_plots,  Prev: surface_plots,  Up: 3D_plots
+
+2.43.2 2D projection (set view map)
+-----------------------------------
+
+An important special case of the 'splot' command is to map the Z
+coordinate onto a 2D surface by projecting the plot along the Z axis
+onto the xy plane.  See 'set view map'.  This plot mode is useful for
+contour plots and heat maps.  This figure shows contours plotted once
+with plot style 'lines' and once with style *note labels::.
+
+
+File: gnuplot.info,  Node: PM3D_plots,  Prev: 2D_projection_(set_view_map),  Up: 3D_plots
+
+2.43.3 PM3D plots
+-----------------
+
+3D surfaces can also be drawn using solid pm3d quadrangles rather than
+lines.  In this case there is no hidden surface removal, but if the
+component facets are drawn back-to-front then a similar effect is
+achieved.  See 'set pm3d depthorder'.  While pm3d surfaces are by
+default colored using a smooth color palette (see *note palette::), it
+is also possible to specify a solid color surface or to specify distinct
+solid colors for the top and bottom surfaces as in the figure shown
+here.  See *note fillcolor::.  Unlike the line-trimming in hidden3d
+mode, pm3d surfaces can be smoothly clipped to the current zrange.  See
+*note clipping::.
+
+
+File: gnuplot.info,  Node: Fence_plots,  Next: isosurface,  Prev: 3D_plots,  Up: Plotting_styles
+
+2.44 Fence plots
+================
+
+Fence plots combine several 2D plots by aligning their Y coordinates and
+separating them from each other by a displacement along X. Filling the
+area between a base value and each plot's series of Z values enhances
+the visual impact of the alignment on Y and comparison on Z. There are
+several ways such plots can be created in gnuplot.  The simplest is to
+use the 5 column variant of the 'zerrorfill' style.  Suppose there are
+separate curves z = Fi(y) indexed by i.  A fence plot is generated by
+'splot with zerrorfill' using input columns
+          i y z_base z_base Fi(y)
+
+
+
+File: gnuplot.info,  Node: isosurface,  Next: Zerrorfill,  Prev: Fence_plots,  Up: Plotting_styles
+
+2.45 isosurface
+===============
+
+This 3D plot style requires a populated voxel grid (see *note vgrid::,
+*note vfill::).  Linear interpolation of voxel grid values is used to
+estimate fractional grid coordinates corresponding to the requested
+isolevel.  These points are then used to generate a tessellated surface.
+The facets making up the surface are rendered as pm3d polygons, so the
+surface coloring, transparency, and border properties are controlled by
+'set pm3d'.  In general the surface is easier to interpret visually if
+facets are given a thin border that is darker than the fill color.  By
+default the tessellation uses a mixture of quadrangles and triangles.
+To use triangle only, see *note isosurface::.  Example:
+          set style fill solid 0.3
+          set pm3d depthorder border lc "blue" lw 0.2
+          splot $helix with isosurface level 10 fc "cyan"
+
+
+
+File: gnuplot.info,  Node: Zerrorfill,  Next: Animation,  Prev: isosurface,  Up: Plotting_styles
+
+2.46 Zerrorfill
+===============
+
+Syntax:
+
+          splot DATA using 1:2:3:4[:5] with zerrorfill {fc|fillcolor <colorspec>}
+                     {lt|linetype <n>} {<line properties>}
+
+
+   The 'zerrorfill' plot style is similar to one variant of the 2D plot
+style *note filledcurves::.  It fills the area between two functions or
+data lines that are sampled at the same x and y points.  It requires 4
+or 5 input columns:
+
+          4 columns:  x  y  z  zdelta
+          5 columns:  x  y  z  zlow  zhigh
+
+
+   The area between zlow and zhigh is filled and then a line is drawn
+through the z values.  By default both the line and the fill area use
+the same color, but you can change this in the splot command.  The fill
+area properties are also affected by the global fill style; see 'set
+style fill'.
+
+   If there are multiple curves in the splot command each new curve may
+occlude all previous curves.  To get proper depth sorting so that curves
+can only be occluded by curves closer to the viewer, it is best to order
+the curves from back to front.  Alternatively you can use 'set pm3d
+depthorder base' to sort them automatically, but unfortunately this
+causes all the filled areas to be drawn after all of the corresponding
+lines of z values.  In order to see both the lines and the depth-sorted
+fill areas you probably will need to make the fill areas partially
+transparent.
+
+   The fill area in the first two examples below is the same.
+
+          splot 'data' using 1:2:3:4 with zerrorfill fillcolor "grey" lt black
+          splot 'data' using 1:2:3:($3-$4):($3+$4) with zerrorfill
+          splot '+' using 1:(const):(func1($1)):(func2($1)) with zerrorfill
+          splot for [k=1:5] datafile[k] with zerrorfill lt black fc lt (k+1)
+
+
+   This plot style can also be used to create fence plots.  See
+'fenceplots'.  See also 'waterfallplots'.
+
+
+File: gnuplot.info,  Node: Animation,  Prev: Zerrorfill,  Up: Plotting_styles
+
+2.47 Animation
+==============
+
+Any of gnuplot's interactive terminals (qt win wxt x11 aqua) can be used
+to display an animation by plotting successive frames from the command
+line or from a script.
+
+   Several non-mousing terminals also support some form of animation.
+See 'term sixelgd', 'term kittycairo'.
+
+   Two terminals can save an animation to a file for later playback
+locally or by embedding it a web page.  See 'term gif animate', 'term
+webp'.
+
+   Example:
+
+          unset border; unset tics; unset key; set view equal xyz
+          set pm3d border linecolor "black"
+
+
+          set term webp animate delay 50
+          set output 'spinning_d20.webp'
+          do for [ang=1:360:2] {
+              set view 60, ang
+              splot 'icosahedron.dat' with polygons fc "gold"
+          }
+          unset output
+
+
+
+File: gnuplot.info,  Node: Commands,  Next: Terminal_types,  Prev: Plotting_styles,  Up: Top
+
+3 Commands
+**********
+
+This section lists the commands acceptable to 'gnuplot' in alphabetical
+order.  Printed versions of this document contain all commands; the text
+available interactively may not be complete.  Indeed, on some systems
+there may be no commands at all listed under this heading.
+
+   Note that in most cases unambiguous abbreviations for command names
+and their options are permissible, i.e., "'p f(x) w li'" instead of
+"'plot f(x) with lines'".
+
+   In the syntax descriptions, braces ({}) denote optional arguments and
+a vertical bar (|) separates mutually exclusive choices.
+
+* Menu:
+
+* Break::
+* cd::
+* call::
+* clear::
+* Continue::
+* Do::
+* evaluate::
+* exit::
+* fit::
+* function_blocks::
+* help::
+* history::
+* if::
+* for::
+* import::
+* load::
+* local::
+* lower::
+* pause::
+* plot::
+* print::
+* printerr::
+* pwd::
+* quit::
+* raise::
+* refresh::
+* remultiplot::
+* replot::
+* reread::
+* reset::
+* return::
+* save::
+* set-show::
+* shell::
+* show::
+* splot::
+* stats_(Statistical_Summary)::
+* system_::
+* test::
+* toggle::
+* undefine::
+* unset::
+* update::
+* vclear::
+* vfill::
+* warn::
+* While::
+
+
+File: gnuplot.info,  Node: Break,  Next: cd,  Prev: Commands,  Up: Commands
+
+3.1 Break
+=========
+
+The 'break' command is only meaningful inside the bracketed iteration
+clause of a 'do' or 'while' statement.  It causes the remaining
+statements inside the bracketed clause to be skipped and iteration is
+terminated.  Execution resumes at the statement following the closing
+bracket.  See also 'continue'.
+
+
+File: gnuplot.info,  Node: cd,  Next: call,  Prev: Break,  Up: Commands
+
+3.2 cd
+======
+
+The 'cd' command changes the working directory.
+
+   Syntax:
+           cd '<directory-name>'
+
+
+   The directory name must be enclosed in quotes.
+
+   Examples:
+           cd 'subdir'
+           cd ".."
+
+
+   It is recommended that Windows users use single-quotes, because
+backslash [\] has special significance inside double-quotes and has to
+be escaped.  For example,
+           cd "c:\newdata"
+
+   fails, but
+           cd 'c:\newdata'
+           cd "c:\\newdata"
+
+   work as expected.
+
+
+File: gnuplot.info,  Node: call,  Next: clear,  Prev: cd,  Up: Commands
+
+3.3 call
+========
+
+The *note call:: command is identical to the 'load' command with one
+exception: the name of the file being loaded may be followed by up to
+nine parameters.
+
+          call "inputfile" <param-1> <param-2> <param-3> ... <param-9>
+
+
+   Gnuplot now provides a set of string variables ARG0, ARG1, ..., ARG9
+and an integer variable ARGC. When a *note call:: command is executed
+ARG0 is set to the name of the input file, ARGC is set to the number of
+parameters present, and ARG1 to ARG9 are loaded from the parameters that
+follow it on the command line.  Any existing contents of the ARG
+variables are saved and restored across a *note call:: command.
+
+   Because the parameters ARG1 ...  ARG9 are stored in ordinary string
+variables they may be dereferenced by macro expansion.  However in many
+cases it is more natural to use them as you would any other variable.
+
+   In parallel with the string representation of parameters ARG1 ...
+ARG9, the parameters themselves are stored in an array ARGV[9].  See
+'ARGV'.
+
+   DEPRECATED: Versions prior to 5.0 performed macro-like substitution
+of the special tokens $0, $1, ...  $9 with the literal contents of
+<param-1> ...  That older mechanism is no longer supported.
+
+   EXPERIMENTAL: Function blocks (new in this version) provide a more
+flexible alternative to *note call::.  See 'function blocks'.
+
+* Menu:
+
+* ARGV[_]::
+* Example::
+
+
+File: gnuplot.info,  Node: ARGV[_],  Next: Example,  Prev: call,  Up: call
+
+3.3.1 ARGV[ ]
+-------------
+
+When a gnuplot script is entered via the *note call:: command any
+parameters passed by the caller are available via two mechanisms.  Each
+parameter is stored as a string in variables ARG1, ARG2, ...  ARG9.
+Each parameter is also stored as one element of the array ARGV[9].
+Numerical values are stored as complex variables.  All other values are
+stored as strings.  ARGC holds the number of parameters.  Thus after a
+call
+
+          call 'routine_1.gp'  1 pi "title"
+
+
+   The three arguments are available inside routine_1.gp as follows
+
+          ARGC = 3
+          ARG1 = "1"         ARGV[1] = 1.0
+          ARG2 = "3.14159"   ARGV[2] = 3.14159265358979...
+          ARG3 = "title"     ARGV[3] = "title"
+
+
+   In this example ARGV[1] and ARGV[2] have the full precision of a
+floating point variable.  ARG2 lost precision in being stored as a
+string using format "%g".
+
+   ARGC and a corresponding array ARGV[ARGC] are also available to code
+inside a function block call.  However invocation of a function block
+does not create string variables ARG1,...  .
+
+
+File: gnuplot.info,  Node: Example,  Prev: ARGV[_],  Up: call
+
+3.3.2 Example
+-------------
+
+          Call site
+              MYFILE = "script1.gp"
+              FUNC = "sin(x)"
+              call MYFILE FUNC 1.23 "This is a plot title"
+          Upon entry to the called script
+              ARG0 holds "script1.gp"
+              ARG1 holds the string "sin(x)"
+              ARG2 holds the string "1.23"
+              ARG3 holds the string "This is a plot title"
+              ARGC is 3
+          The script itself can now execute
+              plot @ARG1 with lines title ARG3
+              print ARG2 * 4.56, @ARG2 * 4.56
+              print "This plot produced by script ", ARG0
+
+
+   Notice that because ARG1 is a string it must be dereferenced as a
+macro, but ARG2 may be dereferenced either as a macro (yielding a
+numerical constant) or a variable (yielding that same numerical value
+after auto-promotion of the string "1.23" to a real).
+
+   The same result could be obtained directly from a shell script by
+invoking gnuplot with the '-c' command line option:
+
+          gnuplot -persist -c "script1.gp" "sin(x)" 1.23 "This is a plot title"
+
+
+
+File: gnuplot.info,  Node: clear,  Next: Continue,  Prev: call,  Up: Commands
+
+3.4 clear
+=========
+
+The *note clear:: command erases the current screen or output device as
+specified by *note terminal:: and *note output::.  This usually
+generates a formfeed on hardcopy devices.
+
+   For some terminals *note clear:: erases only the portion of the
+plotting surface defined by *note size::, so for these it can be used in
+conjunction with *note multiplot:: to create an inset.
+
+   Example:
+           set multiplot
+           plot sin(x)
+           set origin 0.5,0.5
+           set size 0.4,0.4
+           clear
+           plot cos(x)
+           unset multiplot
+
+
+   Please see *note multiplot::, *note size::, and *note origin:: for
+details.
+
+
+File: gnuplot.info,  Node: Continue,  Next: Do,  Prev: clear,  Up: Commands
+
+3.5 Continue
+============
+
+The 'continue' command is only meaningful inside the bracketed iteration
+clause of a 'do' or 'while' statement.  It causes the remaining
+statements inside the bracketed clause to be skipped.  Execution resumes
+at the start of the next iteration (if any remain in the loop
+condition).  See also 'break'.
+
+
+File: gnuplot.info,  Node: Do,  Next: evaluate,  Prev: Continue,  Up: Commands
+
+3.6 Do
+======
+
+Syntax:
+           do for <iteration-spec> {
+                <commands>
+                <commands>
+           }
+
+   Execute a sequence of commands multiple times.  The commands must be
+enclosed in curly brackets, and the opening "{" must be on the same line
+as the 'do' keyword.  This command cannot be used with old-style
+(un-bracketed) if/else statements.  See *note if::.  For examples of
+iteration specifiers, see *note iteration::.  Example:
+           set multiplot layout 2,2
+           do for [name in "A B C D"] {
+               filename = name . ".dat"
+               set title sprintf("Condition %s",name)
+               plot filename title name
+           }
+           unset multiplot
+
+   See also 'while', 'continue', 'break'.
+
+
+File: gnuplot.info,  Node: evaluate,  Next: exit,  Prev: Do,  Up: Commands
+
+3.7 evaluate
+============
+
+The *note evaluate:: command executes gnuplot commands contained in a
+string or in a function block.  Newline characters are not allowed
+within the string.
+
+          evaluate "commands in a string constant"
+          evaluate string_valued_function( ... arguments ... )
+          evaluate $functionblock( ... arguments ... )
+
+
+   This is especially useful for a repetition of similar commands.
+
+   Example:
+           set_label(x, y, text) \
+             = sprintf("set label '%s' at %f, %f point pt 5", text, x, y)
+           eval set_label(1., 1., 'one/one')
+           eval set_label(2., 1., 'two/one')
+           eval set_label(1., 2., 'one/two')
+
+
+   Please see 'function blocks' and *note macros:: for other mechanisms
+that construct or execute strings containing gnuplot commands.
+
+
+File: gnuplot.info,  Node: exit,  Next: fit,  Prev: evaluate,  Up: Commands
+
+3.8 exit
+========
+
+          exit
+          exit message "error message text"
+          exit status <integer error code>
+
+
+   The commands *note exit:: and *note quit::, as well as the
+END-OF-FILE character (usually Ctrl-D) terminate input from the current
+input stream: terminal session, pipe, or file input (pipe).  If input
+streams are nested (inherited 'load' scripts), then reading will
+continue in the parent stream.  When the top level stream is closed, the
+program itself will exit.
+
+   The command 'exit gnuplot' will immediately and unconditionally cause
+gnuplot to exit even if the input stream is multiply nested.  In this
+case any open output files may not be completed cleanly.  Example of
+use:
+
+           bind "ctrl-x" "unset output; exit gnuplot"
+
+
+   The command 'exit error "error message"' simulates a program error.
+In interactive mode it prints the error message and returns to the
+command line, breaking out of all nested loops or calls.  In
+non-interactive mode the program will exit.
+
+   When gnuplot exits to the controlling shell, the return value is not
+usually informative.  This variant of the command allows you to return a
+specific value.
+
+          exit status <value>
+
+
+   See help for 'batch/interactive' for more details.
+
+
+File: gnuplot.info,  Node: fit,  Next: function_blocks,  Prev: exit,  Up: Commands
+
+3.9 fit
+=======
+
+The *note fit:: command fits a user-supplied real-valued expression to a
+set of data points, using the nonlinear least-squares
+Marquardt-Levenberg algorithm.  There can be up to 12 independent
+variables, there is always 1 dependent variable, and any number of
+parameters can be fitted.  Optionally, error estimates can be input for
+weighting the data points.
+
+   The basic use of *note fit:: is best explained by a simple example
+where a set of measured x and y values read from a file are used to be
+modeled by a function y = f(x).
+
+           f(x) = a + b*x + c*x**2
+           fit f(x) 'measured.dat' using 1:2 via a,b,c
+           plot 'measured.dat' u 1:2, f(x)
+
+
+   Syntax:
+           fit {<ranges>} <expression>
+               '<datafile>' {datafile-modifiers}
+               {{unitweights} | {y|xy|z}error | errors <var1>{,<var2>,...}}
+               via '<parameter file>' | <var1>{,<var2>,...}
+
+
+   Ranges may be specified to filter the data used in fitting.
+Out-of-range data points are ignored.  The syntax is
+           [{dummy_variable=}{<min>}{:<max>}],
+
+   analogous to 'plot'; see *note ranges::.
+
+   <expression> can be any valid 'gnuplot' expression, although the most
+common is a previously user-defined function of the form f(x) or f(x,y).
+It must be real-valued.  The names of the independent variables are set
+by the *note dummy:: command, or in the <ranges> part of the command
+(see below); by default, the first two are called x and y.  Furthermore,
+the expression should depend on one or more variables whose value is to
+be determined by the fitting procedure.
+
+   <datafile> is treated as in the 'plot' command.  All the *note
+datafile:: modifiers ('using', *note every::,...)  except *note smooth::
+are applicable to *note fit::.  See *note datafile::.
+
+   The datafile contents can be interpreted flexibly by providing a
+'using' qualifier as with plot commands.  For example to generate the
+independent variable x as the sum of columns 2 and 3, while taking z
+from column 6 and requesting equal weights:
+
+           fit ... using ($2+$3):6
+
+
+   In the absence of a 'using' specification, the fit implicitly assumes
+there is only a single independent variable.  If the file itself, or the
+using specification, contains only a single column of data, the line
+number is taken as the independent variable.  If a 'using' specification
+is given, there can be up to 12 independent variables (and more if
+specially configured at compile time).
+
+   The 'unitweights' option, which is the default, causes all data
+points to be weighted equally.  This can be changed by using the
+'errors' keyword to read error estimates of one or more of the variables
+from the data file.  These error estimates are interpreted as the
+standard deviation s of the corresponding variable value and used to
+compute a weight for the datum as 1/s**2.
+
+   In case of error estimates of the independent variables, these
+weights are further multiplied by fitting function derivatives according
+to the "effective variance method" (Jay Orear, Am.  J. Phys., Vol.  50,
+1982).
+
+   The 'errors' keyword is to be followed by a comma-separated list of
+one or more variable names for which errors are to be input; the
+dependent variable z must always be among them, while independent
+variables are optional.  For each variable in this list, an additional
+column will be read from the file, containing that variable's error
+estimate.  Again, flexible interpretation is possible by providing the
+'using' qualifier.  Note that the number of independent variables is
+thus implicitly given by the total number of columns in the 'using'
+qualifier, minus 1 (for the dependent variable), minus the number of
+variables in the 'errors' qualifier.
+
+   As an example, if one has 2 independent variables, and errors for the
+first independent variable and the dependent variable, one uses the
+'errors x,z' qualifier, and a 'using' qualifier with 5 columns, which
+are interpreted as x:y:z:sx:sz (where x and y are the independent
+variables, z the dependent variable, and sx and sz the standard
+deviations of x and z).
+
+   A few shorthands for the 'errors' qualifier are available: 'yerrors'
+(for fits with 1 column of independent variable), and 'zerrors' (for the
+general case) are all equivalent to 'errors z', indicating that there is
+a single extra column with errors of the dependent variable.
+
+   'xyerrors', for the case of 1 independent variable, indicates that
+there are two extra columns, with errors of both the independent and the
+dependent variable.  In this case the errors on x and y are treated by
+Orear's effective variance method.
+
+   Note that 'yerror' and 'xyerror' are similar in both form and
+interpretation to the *note yerrorlines:: and *note xyerrorlines:: 2D
+plot styles.
+
+   With the command 'set fit v4' the fit command syntax is compatible
+with 'gnuplot' version 4.  In this case there must be two more 'using'
+qualifiers (z and s) than there are independent variables, unless there
+is only one variable.  'gnuplot' then uses the following formats,
+depending on the number of columns given in the 'using' specification:
+
+           z                           # 1 independent variable (line number)
+           x:z                         # 1 independent variable (1st column)
+           x:z:s                       # 1 independent variable (3 columns total)
+           x:y:z:s                     # 2 independent variables (4 columns total)
+           x1:x2:x3:z:s                # 3 independent variables (5 columns total)
+           x1:x2:x3:...:xN:z:s         # N independent variables (N+2 columns total)
+
+
+   Please beware that this means that you have to supply z-errors s in a
+fit with two or more independent variables.  If you want unit weights
+you need to supply them explicitly by using e.g.  then format x:y:z:(1).
+
+   The dummy variable names may be changed when specifying a range as
+noted above.  The first range corresponds to the first 'using' spec, and
+so on.  A range may also be given for z (the dependent variable), in
+which case data points for which f(x,...)  is out of the z range will
+not contribute to the residual being minimized.
+
+   Multiple datasets may be simultaneously fit with functions of one
+independent variable by making y a 'pseudo-variable', e.g., the dataline
+number, and fitting as two independent variables.  See *note
+multi-branch::.
+
+   The 'via' qualifier specifies which parameters are to be optimized,
+either directly, or by referencing a parameter file.
+
+   Examples:
+           f(x) = a*x**2 + b*x + c
+           g(x,y) = a*x**2 + b*y**2 + c*x*y
+           set fit limit 1e-6
+           fit f(x) 'measured.dat' via 'start.par'
+           fit f(x) 'measured.dat' using 3:($7-5) via 'start.par'
+           fit f(x) './data/trash.dat' using 1:2:3 yerror via a, b, c
+           fit g(x,y) 'surface.dat' using 1:2:3 via a, b, c
+           fit a0 + a1*x/(1 + a2*x/(1 + a3*x)) 'measured.dat' via a0,a1,a2,a3
+           fit a*x + b*y 'surface.dat' using 1:2:3 via a,b
+           fit [*:*][yaks=*:*] a*x+b*yaks 'surface.dat' u 1:2:3 via a,b
+
+
+           fit [][][t=*:*] a*x + b*y + c*t 'foo.dat' using 1:2:3:4 via a,b,c
+
+
+           set dummy x1, x2, x3, x4, x5
+           h(x1,x2,x3,x4,s5) = a*x1 + b*x2 + c*x3 + d*x4 + e*x5
+           fit h(x1,x2,x3,x4,x5) 'foo.dat' using 1:2:3:4:5:6 via a,b,c,d,e
+
+
+   After each iteration step, detailed information about the current
+state of the fit is written to the display.  The same information about
+the initial and final states is written to a log file, "fit.log".  This
+file is always appended to, so as to not lose any previous fit history;
+it should be deleted or renamed as desired.  By using the command 'set
+fit logfile', the name of the log file can be changed.
+
+   If activated by using 'set fit errorvariables', the error for each
+fitted parameter will be stored in a variable named like the parameter,
+but with "_err" appended.  Thus the errors can be used as input for
+further computations.
+
+   If 'set fit prescale' is activated, fit parameters are prescaled by
+their initial values.  This helps the Marquardt-Levenberg routine
+converge more quickly and reliably in cases where parameters differ in
+size by several orders of magnitude.
+
+   The fit may be interrupted by pressing Ctrl-C (Ctrl-Break in
+wgnuplot).  After the current iteration completes, you have the option
+to (1) stop the fit and accept the current parameter values, (2)
+continue the fit, (3) execute a 'gnuplot' command as specified by 'set
+fit script' or the environment variable 'FIT_SCRIPT'. The default is
+*note replot::, so if you had previously plotted both the data and the
+fitting function in one graph, you can display the current state of the
+fit.
+
+   Once *note fit:: has finished, the *note fit:: command may be used to
+store final values in a file for subsequent use as a parameter file.
+See *note fit:: for details.
+
+* Menu:
+
+* adjustable_parameters::
+* short_introduction::
+* error_estimates::
+* control::
+* error_recovery::
+* multi-branch::
+* starting_values::
+* time_data::
+* tips::
+
+
+File: gnuplot.info,  Node: adjustable_parameters,  Next: short_introduction,  Prev: fit,  Up: fit
+
+3.9.1 adjustable parameters
+---------------------------
+
+There are two ways that 'via' can specify the parameters to be adjusted,
+either directly on the command line or indirectly, by referencing a
+parameter file.  The two use different means to set initial values.
+
+   Adjustable parameters can be specified by a comma-separated list of
+variable names after the 'via' keyword.  Any variable that is not
+already defined is created with an initial value of 1.0.  However, the
+fit is more likely to converge rapidly if the variables have been
+previously declared with more appropriate starting values.
+
+   In a parameter file, each parameter to be varied and a corresponding
+initial value are specified, one per line, in the form
+           varname = value
+
+
+   Comments, marked by '#', and blank lines are permissible.  The
+special form
+           varname = value       # FIXED
+
+
+   means that the variable is treated as a 'fixed parameter',
+initialized by the parameter file, but not adjusted by *note fit::.  For
+clarity, it may be useful to designate variables as fixed parameters so
+that their values are reported by *note fit::.  The keyword '# FIXED'
+has to appear in exactly this form.
+
+
+File: gnuplot.info,  Node: short_introduction,  Next: error_estimates,  Prev: adjustable_parameters,  Up: fit
+
+3.9.2 short introduction
+------------------------
+
+*note fit:: is used to find a set of parameters that 'best' fits your
+data to your user-defined function.  The fit is judged on the basis of
+the sum of the squared differences or 'residuals' (SSR) between the
+input data points and the function values, evaluated at the same places.
+This quantity is often called 'chisquare' (i.e., the Greek letter chi,
+to the power of 2).  The algorithm attempts to minimize SSR, or more
+precisely the weighted sum of squared residuals (WSSR), for which the
+residuals are weighted by the input data errors before being squared;
+see 'fit error_estimates' for details.
+
+   That's why it is called 'least-squares fitting'.  Let's look at an
+example to see what is meant by 'non-linear', but first we had better go
+over some terms.  Here it is convenient to use z as the dependent
+variable for user-defined functions of either one independent variable,
+z=f(x), or two independent variables, z=f(x,y).  A parameter is a
+user-defined variable that *note fit:: will adjust, i.e., an unknown
+quantity in the function declaration.  Linearity/non-linearity refers to
+the relationship of the dependent variable, z, to the parameters which
+*note fit:: is adjusting, not of z to the independent variables, x
+and/or y.  (To be technical, the second {and higher} derivatives of the
+fitting function with respect to the parameters are zero for a linear
+least-squares problem).
+
+   For linear least-squares the user-defined function will be a sum of
+simple functions, not involving any parameters, each multiplied by one
+parameter.  Nonlinear least-squares handles more complicated functions
+in which parameters can be used in a large number of ways.  An example
+that illustrates the difference between linear and nonlinear
+least-squares is the Fourier series.  One member may be written as
+          z=a*sin(c*x) + b*cos(c*x).
+
+   If a and b are the unknown parameters and c is constant, then
+estimating values of the parameters is a linear least-squares problem.
+However, if c is an unknown parameter, the problem is nonlinear.
+
+   In the linear case, parameter values can be determined by
+comparatively simple linear algebra, in one direct step.  However the
+linear special case is also solved along with more general nonlinear
+problems by the iterative procedure that 'gnuplot' uses.  *note fit::
+attempts to find the minimum by doing a search.  Each step (iteration)
+calculates WSSR with a new set of parameter values.  The
+Marquardt-Levenberg algorithm selects the parameter values for the next
+iteration.  The process continues until a preset criterion is met,
+either (1) the fit has "converged" (the relative change in WSSR is less
+than a certain limit, see 'set fit limit'), or (2) it reaches a preset
+iteration count limit (see 'set fit maxiter').  The fit may also be
+interrupted and subsequently halted from the keyboard (see *note fit::).
+The user variable FIT_CONVERGED contains 1 if the previous fit command
+terminated due to convergence; it contains 0 if the previous fit
+terminated for any other reason.  FIT_NITER contains the number of
+iterations that were done during the last fit.
+
+   Often the function to be fitted will be based on a model (or theory)
+that attempts to describe or predict the behaviour of the data.  Then
+*note fit:: can be used to find values for the free parameters of the
+model, to determine how well the data fits the model, and to estimate an
+error range for each parameter.  See 'fit error_estimates'.
+
+   Alternatively, in curve-fitting, functions are selected independent
+of a model (on the basis of experience as to which are likely to
+describe the trend of the data with the desired resolution and a minimum
+number of parameters*functions.)  The *note fit:: solution then provides
+an analytic representation of the curve.
+
+   However, if all you really want is a smooth curve through your data
+points, the *note smooth:: option to 'plot' may be what you've been
+looking for rather than *note fit::.
+
+
+File: gnuplot.info,  Node: error_estimates,  Next: control,  Prev: short_introduction,  Up: fit
+
+3.9.3 error estimates
+---------------------
+
+In *note fit::, the term "error" is used in two different contexts, data
+error estimates and parameter error estimates.
+
+   Data error estimates are used to calculate the relative weight of
+each data point when determining the weighted sum of squared residuals,
+WSSR or chisquare.  They can affect the parameter estimates, since they
+determine how much influence the deviation of each data point from the
+fitted function has on the final values.  Some of the *note fit:: output
+information, including the parameter error estimates, is more meaningful
+if accurate data error estimates have been provided.
+
+   The 'statistical overview' describes some of the *note fit:: output
+and gives some background for the 'practical guidelines'.
+
+* Menu:
+
+* statistical_overview::
+* practical_guidelines::
+
+
+File: gnuplot.info,  Node: statistical_overview,  Next: practical_guidelines,  Prev: error_estimates,  Up: error_estimates
+
+3.9.3.1 statistical overview
+............................
+
+The theory of non-linear least-squares is generally described in terms
+of a normal distribution of errors, that is, the input data is assumed
+to be a sample from a population having a given mean and a Gaussian
+(normal) distribution about the mean with a given standard deviation.
+For a sample of sufficiently large size, and knowing the population
+standard deviation, one can use the statistics of the chisquare
+distribution to describe a "goodness of fit" by looking at the variable
+often called "chisquare".  Here, it is sufficient to say that a reduced
+chisquare (chisquare/degrees of freedom, where degrees of freedom is the
+number of datapoints less the number of parameters being fitted) of 1.0
+is an indication that the weighted sum of squared deviations between the
+fitted function and the data points is the same as that expected for a
+random sample from a population characterized by the function with the
+current value of the parameters and the given standard deviations.
+
+   If the standard deviation for the population is not constant, as in
+counting statistics where variance = counts, then each point should be
+individually weighted when comparing the observed sum of deviations and
+the expected sum of deviations.
+
+   At the conclusion *note fit:: reports 'stdfit', the standard
+deviation of the fit, which is the rms of the residuals, and the
+variance of the residuals, also called 'reduced chisquare' when the data
+points are weighted.  The number of degrees of freedom (the number of
+data points minus the number of fitted parameters) is used in these
+estimates because the parameters used in calculating the residuals of
+the datapoints were obtained from the same data.  If the data points
+have weights, 'gnuplot' calculates the so-called p-value, i.e.  one
+minus the cumulative distribution function of the chisquare-distribution
+for the number of degrees of freedom and the resulting chisquare, see
+'fit practical_guidelines'.  These values are exported to the variables
+           FIT_NDF = Number of degrees of freedom
+           FIT_WSSR = Weighted sum-of-squares residual
+           FIT_STDFIT = sqrt(WSSR/NDF)
+           FIT_P = p-value
+
+
+   To estimate confidence levels for the parameters, one can use the
+minimum chisquare obtained from the fit and chisquare statistics to
+determine the value of chisquare corresponding to the desired confidence
+level, but considerably more calculation is required to determine the
+combinations of parameters which produce such values.
+
+   Rather than determine confidence intervals, *note fit:: reports
+parameter error estimates which are readily obtained from the
+variance-covariance matrix after the final iteration.  By convention,
+these estimates are called "standard errors" or "asymptotic standard
+errors", since they are calculated in the same way as the standard
+errors (standard deviation of each parameter) of a linear least-squares
+problem, even though the statistical conditions for designating the
+quantity calculated to be a standard deviation are not generally valid
+for a nonlinear least-squares problem.  The asymptotic standard errors
+are generally over-optimistic and should not be used for determining
+confidence levels, but are useful for qualitative purposes.
+
+   The final solution also produces a correlation matrix indicating
+correlation of parameters in the region of the solution; The main
+diagonal elements, autocorrelation, are always 1; if all parameters were
+independent, the off-diagonal elements would be nearly 0.  Two variables
+which completely compensate each other would have an off-diagonal
+element of unit magnitude, with a sign depending on whether the relation
+is proportional or inversely proportional.  The smaller the magnitudes
+of the off-diagonal elements, the closer the estimates of the standard
+deviation of each parameter would be to the asymptotic standard error.
+
+
+File: gnuplot.info,  Node: practical_guidelines,  Prev: statistical_overview,  Up: error_estimates
+
+3.9.3.2 practical guidelines
+............................
+
+If you have a basis for assigning weights to each data point, doing so
+lets you make use of additional knowledge about your measurements, e.g.,
+take into account that some points may be more reliable than others.
+That may affect the final values of the parameters.
+
+   Weighting the data provides a basis for interpreting the additional
+*note fit:: output after the last iteration.  Even if you weight each
+point equally, estimating an average standard deviation rather than
+using a weight of 1 makes WSSR a dimensionless variable, as chisquare is
+by definition.
+
+   Each fit iteration will display information which can be used to
+evaluate the progress of the fit.  (An '*' indicates that it did not
+find a smaller WSSR and is trying again.)  The 'sum of squares of
+residuals', also called 'chisquare', is the WSSR between the data and
+your fitted function; *note fit:: has minimized that.  At this stage,
+with weighted data, chisquare is expected to approach the number of
+degrees of freedom (data points minus parameters).  The WSSR can be used
+to calculate the reduced chisquare (WSSR/ndf) or stdfit, the standard
+deviation of the fit, sqrt(WSSR/ndf).  Both of these are reported for
+the final WSSR.
+
+   If the data are unweighted, stdfit is the rms value of the deviation
+of the data from the fitted function, in user units.
+
+   If you supplied valid data errors, the number of data points is large
+enough, and the model is correct, the reduced chisquare should be about
+unity.  (For details, look up the 'chi-squared distribution' in your
+favorite statistics reference.)  If so, there are additional tests,
+beyond the scope of this overview, for determining how well the model
+fits the data.
+
+   A reduced chisquare much larger than 1.0 may be due to incorrect data
+error estimates, data errors not normally distributed, systematic
+measurement errors, 'outliers', or an incorrect model function.  A plot
+of the residuals, e.g., 'plot 'datafile' using 1:($2-f($1))', may help
+to show any systematic trends.  Plotting both the data points and the
+function may help to suggest another model.
+
+   Similarly, a reduced chisquare less than 1.0 indicates WSSR is less
+than that expected for a random sample from the function with normally
+distributed errors.  The data error estimates may be too large, the
+statistical assumptions may not be justified, or the model function may
+be too general, fitting fluctuations in a particular sample in addition
+to the underlying trends.  In the latter case, a simpler function may be
+more appropriate.
+
+   The p-value of the fit is one minus the cumulative distribution
+function of the chisquare-distribution for the number of degrees of
+freedom and the resulting chisquare.  This can serve as a measure of the
+goodness-of-fit.  The range of the p-value is between zero and one.  A
+very small or large p-value indicates that the model does not describe
+the data and its errors well.  As described above, this might indicate a
+problem with the data, its errors or the model, or a combination
+thereof.  A small p-value might indicate that the errors have been
+underestimated and the errors of the final parameters should thus be
+scaled.  See also 'set fit errorscaling'.
+
+   You'll have to get used to both *note fit:: and the kind of problems
+you apply it to before you can relate the standard errors to some more
+practical estimates of parameter uncertainties or evaluate the
+significance of the correlation matrix.
+
+   Note that *note fit::, in common with most nonlinear least-squares
+implementations, minimizes the weighted sum of squared distances
+(y-f(x))**2.  It does not provide any means to account for "errors" in
+the values of x, only in y.  Also, any "outliers" (data points outside
+the normal distribution of the model) will have an exaggerated effect on
+the solution.
+
+
+File: gnuplot.info,  Node: control,  Next: error_recovery,  Prev: error_estimates,  Up: fit
+
+3.9.4 control
+-------------
+
+There are two environment variables that can be defined to affect *note
+fit::.  The environment variables must be defined before 'gnuplot' is
+executed; how to do so depends on your operating system.
+
+           FIT_LOG
+
+   changes the name (and/or path) of the file to which the fit log will
+be written.  The default is to write "fit.log" in the current working
+directory.  This can be overwritten at run time using the command 'set
+fit logfile'.
+
+           FIT_SCRIPT
+
+   specifies a command that may be executed after an user interrupt.
+The default is *note replot::, but a 'plot' or 'load' command may be
+useful to display a plot customized to highlight the progress of the
+fit.  This can be changed at run time using 'set fit script'.
+
+   For many other run time adjustments to way fit works, see *note
+fit::.
+
+
+File: gnuplot.info,  Node: error_recovery,  Next: multi-branch,  Prev: control,  Up: fit
+
+3.9.5 error recovery
+--------------------
+
+Starting with gnuplot version 6, the *note fit:: command always returns
+to the next command input line regardless of the success or failure of
+fitting.  This allows scripted recovery from fit errors.  The variable
+FIT_ERROR is set to 0 on success, non-zero on error.  This example plots
+however many of five data sets can be successfully fit.  Failure for
+data set 2 would not prevent fitting data sets 3 through 5.
+
+          do for [i=1:5] {
+              DATA = sprintf("Data_%05d.dat", i)
+              fit f(x) DATA via a,b,c
+              if (FIT_ERROR || !FIT_CONVERGED) {
+                  print "Fit failed for ", DATA
+                  continue
+              }
+              set output sprintf("dataset_%05.png", i)
+              plot DATA, f(x)
+              unset output
+          }
+
+
+
+File: gnuplot.info,  Node: multi-branch,  Next: starting_values,  Prev: error_recovery,  Up: fit
+
+3.9.6 multi-branch
+------------------
+
+In multi-branch fitting, multiple data sets can be simultaneously fit
+with functions of one independent variable having common parameters by
+minimizing the total WSSR. The function and parameters (branch) for each
+data set are selected by using a 'pseudo-variable', e.g., either the
+dataline number (a 'column' index of -1) or the datafile index (-2), as
+the second independent variable.
+
+   Example: Given two exponential decays of the form, z=f(x), each
+describing a different data set but having a common decay time, estimate
+the values of the parameters.  If the datafile has the format x:z:s,
+then
+          f(x,y) = (y==0) ? a*exp(-x/tau) : b*exp(-x/tau)
+          fit f(x,y) 'datafile' using  1:-2:2:3  via a, b, tau
+
+
+   For a more complicated example, see the file "hexa.fnc" used by the
+"fit.dem" demo.
+
+   Appropriate weighting may be required since unit weights may cause
+one branch to predominate if there is a difference in the scale of the
+dependent variable.  Fitting each branch separately, using the
+multi-branch solution as initial values, may give an indication as to
+the relative effect of each branch on the joint solution.
+
+
+File: gnuplot.info,  Node: starting_values,  Next: time_data,  Prev: multi-branch,  Up: fit
+
+3.9.7 starting values
+---------------------
+
+Nonlinear fitting is not guaranteed to converge to the global optimum
+(the solution with the smallest sum of squared residuals, SSR), and can
+get stuck at a local minimum.  The routine has no way to determine that;
+it is up to you to judge whether this has happened.
+
+   *note fit:: may, and often will get "lost" if started far from a
+solution, where SSR is large and changing slowly as the parameters are
+varied, or it may reach a numerically unstable region (e.g., too large a
+number causing a floating point overflow) which results in an "undefined
+value" message or 'gnuplot' halting.
+
+   To improve the chances of finding the global optimum, you should set
+the starting values at least roughly in the vicinity of the solution,
+e.g., within an order of magnitude, if possible.  The closer your
+starting values are to the solution, the less chance of stopping at a
+false minimum.  One way to find starting values is to plot data and the
+fitting function on the same graph and change parameter values and *note
+replot:: until reasonable similarity is reached.  The same plot is also
+useful to check whether the fit found a false minimum.
+
+   Of course finding a nice-looking fit does not prove there is no
+"better" fit (in either a statistical sense, characterized by an
+improved goodness-of-fit criterion, or a physical sense, with a solution
+more consistent with the model.)  Depending on the problem, it may be
+desirable to *note fit:: with various sets of starting values, covering
+a reasonable range for each parameter.
+
+
+File: gnuplot.info,  Node: time_data,  Next: tips,  Prev: starting_values,  Up: fit
+
+3.9.8 time data
+---------------
+
+In fitting time data it is important to remember that gnuplot represents
+time as seconds since 1 January 1970.  For example if you wanted to fit
+a quadratic model for the time dependence of something measured over the
+course of one day in 2023, you might expect that it could be done using
+          T(x) = a + b*x + c*x*x
+          set xdata time
+          fit T(x) 'hits.dat' using 1:3 via a,b,c
+
+
+   This will probably fail, because internally the x values
+corresponding to that one day will have a range something like
+[1.67746e+09 : 1.67754e+09].  The fractional change in x across the
+measured data will be only about 1.e-05 and to guarantee convergence you
+would probably need many decimal places of accuracy in the initial
+parameter estimates.
+
+   One solution is to recast the problem as change in time since the
+start of measurement.
+          set xdata time       # data format "27-02-2023 12:00:00 measurement"
+          timefmt  = "%d-%m-%Y %H:%M:%S"
+          set timefmt timefmt
+          t0 = strptime( timefmt, "27-02-2023 00:00:00" )
+          fit T(x) 'temperature.dat' using ($1-t0):3 via a,b,c
+
+
+   This shifts the range of the data to [0 : 86400], which is more
+tractable.  Another possibility in this case is to ignore the date in
+column 1 and use relative time formats (tH/tM/tS) applied to column 2.
+          set timefmt "%tH:%tM:%tS"
+          fit T(x) 'temperature.dat' using 2:3 via a,b,c
+
+
+
+File: gnuplot.info,  Node: tips,  Prev: time_data,  Up: fit
+
+3.9.9 tips
+----------
+
+Here are some tips to keep in mind to get the most out of *note fit::.
+They're not very organized, so you'll have to read them several times
+until their essence has sunk in.
+
+   The two forms of the 'via' argument to *note fit:: serve two largely
+distinct purposes.  The 'via "file"' form is best used for (possibly
+unattended) batch operation, where you supply the starting parameter
+values in a file.
+
+   The 'via var1, var2, ...'  form is best used interactively, where the
+command history mechanism may be used to edit the list of parameters to
+be fitted or to supply new startup values for the next try.  This is
+particularly useful for hard problems, where a direct fit to all
+parameters at once won't work without good starting values.  To find
+such, you can iterate several times, fitting only some of the
+parameters, until the values are close enough to the goal that the final
+fit to all parameters at once will work.
+
+   Make sure that there is no mutual dependency among parameters of the
+function you are fitting.  For example, don't try to fit a*exp(x+b),
+because a*exp(x+b)=a*exp(b)*exp(x).  Instead, fit either a*exp(x) or
+exp(x+b).
+
+   A technical issue: The larger the ratio of the largest and the
+smallest absolute parameter values, the slower the fit will converge.
+If the ratio is close to or above the inverse of the machine floating
+point precision, it may take next to forever to converge, or refuse to
+converge at all.  You will either have to adapt your function to avoid
+this, e.g., replace 'parameter' by '1e9*parameter' in the function
+definition, and divide the starting value by 1e9 or use 'set fit
+prescale' which does this internally according to the parameter starting
+values.
+
+   If you can write your function as a linear combination of simple
+functions weighted by the parameters to be fitted, by all means do so.
+That helps a lot, because the problem is no longer nonlinear and should
+converge with only a small number of iterations, perhaps just one.
+
+   Some prescriptions for analysing data, given in practical
+experimentation courses, may have you first fit some functions to your
+data, perhaps in a multi-step process of accounting for several aspects
+of the underlying theory one by one, and then extract the information
+you really wanted from the fitting parameters of those functions.  With
+*note fit::, this may often be done in one step by writing the model
+function directly in terms of the desired parameters.  Transforming data
+can also quite often be avoided, though sometimes at the cost of a more
+difficult fit problem.  If you think this contradicts the previous
+paragraph about simplifying the fit function, you are correct.
+
+   A "singular matrix" message indicates that this implementation of the
+Marquardt-Levenberg algorithm can't calculate parameter values for the
+next iteration.  Try different starting values, writing the function in
+another form, or a simpler function.
+
+   Finally, a nice quote from the manual of another fitting package
+(fudgit), that kind of summarizes all these issues: "Nonlinear fitting
+is an art!"
+
+
+File: gnuplot.info,  Node: function_blocks,  Next: help,  Prev: fit,  Up: Commands
+
+3.10 function blocks
+====================
+
+The 'function' command signals the definition of a here-document
+containing a named block of gnuplot code that can be called as a
+function.  As with data blocks, the name of a function block must begin
+with a '$'.  Up to nine named parameters may be specified as part of the
+definition.  These names may be used inside the function block as local
+variables.  See 'local' and 'scope'.
+
+   Once the function block is defined, you can invoke it by name
+anywhere that a normal function could be used.  If the return value is
+not relevant, the function block may be invoked by an "evaluate" command
+rather than as part of an assignment expression.
+
+   Example:
+          function $sinc(arg) << EOF
+              if (arg == 0) { return 1.0 }
+              return sin(arg) / arg
+          EOF
+
+
+          gnuplot> plot $sinc(x) with lines title "sinc(x) as a function block"
+
+
+   It is not necessary to specify a list of named arguments to a
+function block at the time it is declared.  The number and values of
+arguments to the function passed from the command line can be be
+accessed from inside the function block as an integer variable ARGC and
+a corresponding array ARGV[ARGC]. See 'ARGV'. This allows defining a
+function block that can operate on a variable number of arguments.
+Unlike loading a file via a *note call:: statement, arguments are not
+repackaged as string variables (e.g.  ARG1).
+
+   Example:
+          function $max << EOF
+              local max = real("-Inf")
+              if (ARGC == 0) { return NaN }
+              do for [i=1:ARGC] {
+                  if (max < ARGV[i]) {
+                      max = ARGV[i]
+                  }
+              }
+              return max
+          EOF
+          gnuplot> foo = $max( f(A), 2.0, C, Array[3] )
+          gnuplot> baz = $max( foo, 100. )
+
+
+   The primary motivation for function block support is to allow
+definition of complicated functions directly in gnuplot.  Execution is
+of course slower than if the same function were coded in C or Fortran,
+but this is acceptable for many purposes.  If execution speed matters
+then the function can be implemented later as a plugin instead (see
+'plugins').
+
+   A second use for function blocks is to allow execution of gnuplot
+commands in a context they otherwise could not appear.  Suppose for
+example you want to plot data from two csv files, but one file uses
+comma-separated fields while the other uses semicolon-separated fields.
+Normally this property would have been set by a previous *note
+datafile:: command and would have to match all files used by the plot
+command.  However we can define a function block to invoke as a
+definition immediately before each file is referenced in the plot.
+
+          function $set_csv(char) << EOF
+              set datafile separator char
+          EOF
+          plot tmp=$set_csv(",") FILE1, tmp=$set_csv(";") FILE2
+
+
+   Limitations:
+   * Data blocks and function blocks cannot be defined inside a function
+     block.
+   * Pseudofile '-' cannot be used to read data inside a function block.
+   * These commands cannot be executed inside a function block:
+            *note reset::, *note shell::, `!<shell command>`.
+
+   * A 'plot', *note replot::, 'splot', *note refresh::, 'stats', *note
+     vfill::, or *note fit:: command is accepted in a function block
+     only if none of those commands is already in progress.  E.g.  you
+     cannot use 'stats' in a function block called by a 'plot' command,
+     you cannot invoke 'plot' from inside a *note fit:: command, etc.
+
+   A non-trivial example of using function blocks to implement and plot
+a 15-term Lanczos approximation for the complex lngamma function is
+provided in the demo collection as function_block.dem
+(http://www.gnuplot.info/demo_6.0/function_block.html) The function
+block implementation is slower by a factor of roughly 25 compared to the
+built-in lnGamma function using the same algorithm coded directly in C.
+Nevertheless it is still fast enough for 3D interactive rotation.
+
+   Use of function blocks is EXPERIMENTAL. Details may change before
+inclusion in a release version.
+
+
+File: gnuplot.info,  Node: help,  Next: history,  Prev: function_blocks,  Up: Commands
+
+3.11 help
+=========
+
+The *note help:: command displays built-in help.  To specify information
+on a particular topic use the syntax:
+
+           help {<topic>}
+
+
+   If <topic> is not specified, a short message is printed about
+'gnuplot'.  After help for the requested topic is given, a menu of
+subtopics is given; help for a subtopic may be requested by typing its
+name, extending the help request.  After that subtopic has been printed,
+the request may be extended again or you may go back one level to the
+previous topic.  Eventually, the 'gnuplot' command line will return.
+
+   If a question mark (?)  is given as the topic, the list of topics
+currently available is printed on the screen.
+
+
+File: gnuplot.info,  Node: history,  Next: if,  Prev: help,  Up: Commands
+
+3.12 history
+============
+
+The *note history:: command prints or saves previous commands in the
+history list, or reexecutes a previous entry in the list.  To modify the
+behavior of this command or the location of the saved history file, see
+*note history::.
+
+   Input lines with *note history:: as their first command are not
+stored in the command history.
+
+   Examples:
+
+           history               # show the complete history
+           history 5             # show last 5 entries in the history
+           history quiet 5       # show last 5 entries without entry numbers
+           history "hist.gp"     # write the complete history to file hist.gp
+           history "hist.gp" append # append the complete history to file hist.gp
+           history 10 "hist.gp"  # write last 10 commands to file hist.gp
+           history 10 "|head -5 >>diary.gp" # write 5 history commands using pipe
+           history ?load         # show all history entries starting with "load"
+           history ?"set c"      # like above, several words enclosed in quotes
+           hist !"set xr"        # like above, several words enclosed in quotes
+           hist !55              # reexecute the command at history entry 55
+
+
+
+File: gnuplot.info,  Node: if,  Next: for,  Prev: history,  Up: Commands
+
+3.13 if
+=======
+
+Syntax:
+           if (<condition>) { <commands>;
+                  <commands>
+                  <commands>
+           } else if (<condition>) {
+                  <commands>
+           } else {
+                  <commands>
+           }
+
+
+   This version of gnuplot supports block-structured if/else statements.
+If the keyword *note if:: or 'else' is immediately followed by an
+opening "{", then conditional execution applies to all statements,
+possibly on multiple input lines, until a matching "}" terminates the
+block.  If commands may be nested.
+
+   Prior to gnuplot version 5 the scope of if/else commands was limited
+to a single input line.  Now a multi-line clause may be enclosed in
+curly brackets.  The old syntax is still honored but cannot be used
+inside a bracketed clause.
+
+   Old syntax:
+           if (<condition>) <command-line> [; else if (<condition>) ...; else ...]
+
+   If no opening "{" follows the *note if:: keyword, the command(s) in
+<command-line> will be executed if <condition> is true (non-zero) or
+skipped if <condition> is false (zero).  Either case will consume
+commands on the input line until the end of the line or an occurrence of
+'else'.  Note that use of ';' to allow multiple commands on the same
+line will _not_ end the conditionalized commands.
+
+
+File: gnuplot.info,  Node: for,  Next: import,  Prev: if,  Up: Commands
+
+3.14 for
+========
+
+The 'plot', 'splot', 'set' and *note unset:: commands may optionally
+contain an iteration clause.  This has the effect of executing the basic
+command multiple times, each time re-evaluating any expressions that
+make use of the iteration control variable.  Iteration of arbitrary
+command sequences can be requested using the 'do' command.  Two forms of
+iteration clause are currently supported:
+
+           for [intvar = start:end{:increment}]
+           for [stringvar in "A B C D"]
+
+
+   Examples:
+
+           plot for [filename in "A.dat B.dat C.dat"] filename using 1:2 with lines
+           plot for [basename in "A B C"] basename.".dat" using 1:2 with lines
+           set for [i = 1:10] style line i lc rgb "blue"
+           unset for [tag = 100:200] label tag
+
+
+   Nested iteration is supported:
+
+           set for [i=1:9] for [j=1:9] label i*10+j sprintf("%d",i*10+j) at i,j
+
+
+   See additional documentation for *note iteration::, 'do'.
+
+
+File: gnuplot.info,  Node: import,  Next: load,  Prev: for,  Up: Commands
+
+3.15 import
+===========
+
+The *note import:: command associates a user-defined function name with
+a function exported by an external shared object.  This constitutes a
+plugin mechanism that extends the set of functions available in gnuplot.
+
+   Syntax:
+           import func(x[,y,z,...]) from "sharedobj[:symbol]"
+
+
+   Examples:
+           # make the function myfun, exported by "mylib.so" or "mylib.dll"
+           # available for plotting or numerical calculation in gnuplot
+           import myfun(x) from "mylib"
+           import myfun(x) from "mylib:myfun"    # same as above
+
+
+           # make the function theirfun, defined in "theirlib.so" or "theirlib.dll"
+           # available under a different name
+           import myfun(x,y,z) from "theirlib:theirfun"
+
+
+   The program extends the name given for the shared object by either
+".so" or ".dll" depending on the operating system, and searches for it
+first as a full path name and then as a path relative to the current
+directory.  The operating system itself may also search any directories
+in LD_LIBRARY_PATH or DYLD_LIBRARY_PATH. See 'plugins'.
+
+
+File: gnuplot.info,  Node: load,  Next: local,  Prev: import,  Up: Commands
+
+3.16 load
+=========
+
+The 'load' command executes each line of the specified input file as if
+it had been typed in interactively.  Files created by the *note save::
+command can later be 'load'ed.  Any text file containing valid gnuplot
+commands can be executed by a 'load' command.  Files being loaded may
+themselves contain 'load' or *note call:: commands.  To pass arguments
+to a loaded file, see *note call::.
+
+   Syntax:
+           load "<input-file>"
+           load $datablock
+
+
+   The name of the input file must be enclosed in quotes.
+
+   The special filename "-" may be used to 'load' commands from standard
+input.  This allows a 'gnuplot' command file to accept some commands
+from standard input.  Please see help for 'batch/interactive' for more
+details.
+
+   On systems that support a popen function, the load file can be read
+from a pipe by starting the file name with a '<'.
+
+   Examples:
+           load 'work.gnu'
+           load "func.dat"
+           load "< loadfile_generator.sh"
+
+
+   The 'load' command is performed implicitly on any file names given as
+arguments to 'gnuplot'.  These are loaded in the order specified, and
+then 'gnuplot' exits.
+
+   EXPERIMENTAL: It is also possible to execute commands from lines of
+text stored internally.  See 'function blocks'.  A function block may be
+defined in-line or in an external file.  Once the function block has
+been defined the commands may be executed repeatedly using *note
+evaluate:: on the internal copy rather than reloading the file.
+
+
+File: gnuplot.info,  Node: local,  Next: lower,  Prev: load,  Up: Commands
+
+3.17 local
+==========
+
+Syntax:
+          local foo = <expression>
+          local array foo[size]
+
+
+   The 'local' keyword introduces declaration of a variable whose scope
+is limited to the execution of the code block in which it is declared.
+Declaration is optional, but without it all variables are global.  If
+the name of a local variable duplicates the name of a global variable,
+the global variable is shadowed until exit from the local scope.  See
+'scope'.
+
+   Local declarations may be used to prevent a global variable from
+being unintentionally overwritten by a *note call:: or 'load' statement.
+They are particularly useful inside a function block.  The 'local'
+command is also valid inside the code block in curly brackets following
+an *note if::, 'else', 'do for', or 'while' statement.
+
+   Example: Suppose you want to write a script "plot_all_data.gp"
+containing commands that plot a bunch of data sets.  You want to call
+this convenience script from the command line or from other scripts
+without worrying that it trashes any variables with names "file" or
+"files" or "dataset" or "outfile".  The variable "file" is inherently
+local because it is an iteration variable (see 'scope') but the other
+three names need keyword 'local' to protect them.
+
+   plot_all_data.gp:
+          local files = system("ls -1 *.dat")
+          do for [file in files] {
+             local dataset = file[1:strstrt(file,".dat")-1]
+             local outfile = dataset . ".png"
+             set output outfile
+             plot file with lines title dataset
+          }
+          unset output
+
+
+
+File: gnuplot.info,  Node: lower,  Next: pause,  Prev: local,  Up: Commands
+
+3.18 lower
+==========
+
+See *note raise::.
+
+
+File: gnuplot.info,  Node: pause,  Next: plot,  Prev: lower,  Up: Commands
+
+3.19 pause
+==========
+
+The 'pause' command displays any text associated with the command and
+then waits a specified amount of time or until the carriage return is
+pressed.  'pause' is especially useful in conjunction with 'load' files.
+
+   Syntax:
+           pause <time> {"<string>"}
+           pause mouse {<endcondition>}{, <endcondition>} {"<string>"}
+           pause mouse close
+
+
+   <time> may be any constant or floating-point expression.  'pause -1'
+will wait until a carriage return is hit, zero (0) won't pause at all,
+and a positive number will wait the specified number of seconds.
+
+   If the current terminal supports 'mousing', then 'pause mouse' will
+terminate on either a mouse click or on ctrl-C. For all other terminals,
+or if mousing is not active, 'pause mouse' is equivalent to 'pause -1'.
+
+   If one or more end conditions are given after 'pause mouse', then any
+one of the conditions will terminate the pause.  The possible end
+conditions are 'keypress', 'button1', 'button2', 'button3', 'close', and
+'any'.  If the pause terminates on a keypress, then the ascii value of
+the key pressed is returned in MOUSE_KEY. The character itself is
+returned as a one character string in MOUSE_CHAR. Hotkeys (bind command)
+are disabled if keypress is one of the end conditions.  Zooming is
+disabled if button3 is one of the end conditions.
+
+   In all cases the coordinates of the mouse are returned in variables
+MOUSE_X, MOUSE_Y, MOUSE_X2, MOUSE_Y2.  See 'mouse variables'.
+
+   Note: Since 'pause' communicates with the operating system rather
+than the graphics, it may behave differently with different device
+drivers (depending upon how text and graphics are mixed).
+
+   Examples:
+           pause -1    # Wait until a carriage return is hit
+           pause 3     # Wait three seconds
+           pause -1  "Hit return to continue"
+           pause 10  "Isn't this pretty?  It's a cubic spline."
+           pause mouse "Click any mouse button on selected data point"
+           pause mouse keypress "Type a letter from A-F in the active window"
+           pause mouse button1,keypress
+           pause mouse any "Any key or button will terminate"
+
+
+   The variant "pause mouse key" will resume after any keypress in the
+active plot window.  If you want to wait for a particular key to be
+pressed, you can use a loop such as:
+
+           print "I will resume after you hit the Tab key in the plot window"
+           plot <something>
+           pause mouse key
+           while (MOUSE_KEY != 9) {
+               pause mouse key
+           }
+
+
+* Menu:
+
+* pause_mouse_close::
+* pseudo-mousing_during_pause::
+
+
+File: gnuplot.info,  Node: pause_mouse_close,  Next: pseudo-mousing_during_pause,  Prev: pause,  Up: pause
+
+3.19.1 pause mouse close
+------------------------
+
+The command 'pause mouse close' is a specific example of pausing to wait
+for an external event.  In this case the program waits for a "close"
+event from the plot window.  Exactly how to generate such an event
+varies with your desktop environment and configuration, but usually you
+can close the plot window by clicking on some widget on the window
+border or by typing a hot-key sequence such as <alt><F4> or <ctrl>q.  If
+you are unsure whether a suitable widget or hot-key is available to the
+user, you may also want to define a hot-key sequence using gnuplot's own
+mechanism.  See 'bind'.
+
+   The command sequence below may be useful when running gnuplot from a
+script rather than from the command line.
+
+          plot <...whatever...>
+          bind all "alt-End" "exit gnuplot"
+          pause mouse close
+
+
+
+File: gnuplot.info,  Node: pseudo-mousing_during_pause,  Prev: pause_mouse_close,  Up: pause
+
+3.19.2 pseudo-mousing during pause
+----------------------------------
+
+Some terminals use the same window for text entry and graphical display,
+including terminal types 'dumb', 'sixel', 'kitty', and 'domterm'.  These
+terminals do not currently support mousing per se, but during a 'pause
+mouse' command they interpret keystrokes in the same way that a mousing
+terminal would.  E.g.  left/right/up/down arrow keys change the view
+angle of 3D plots and perform incremental pan/zoom for 2D plots, 'l'
+toggles log-scale axes, 'a' autoscales the current plot, 'h' displays a
+list of key bindings.  A carriage return terminates the 'pause' and
+restores normal command line processing.
+
+
+File: gnuplot.info,  Node: plot,  Next: print,  Prev: pause,  Up: Commands
+
+3.20 plot
+=========
+
+'plot' and 'splot' are the primary commands for drawing plots with
+'gnuplot'.  They offer many different graphical representations for
+functions and data.  'plot' is used to draw 2D functions and data.
+'splot' draws 2D projections of 3D surfaces and data.
+
+   Syntax:
+           plot {<ranges>} <plot-element> {, <plot-element>, <plot-element>}
+
+
+   Each plot element consists of a definition, a function, or a data
+source together with optional properties or modifiers:
+           plot-element:
+                {<iteration>}
+                <definition> | {sampling-range} <function> | <data source>
+                             | keyentry
+                {axes <axes>} {<title-spec>}
+                {with <style>}
+
+
+   The graphical representation of each plot element is determined by
+the keyword 'with', e.g.  'with lines' or *note boxplot::.  See
+'plotting styles'.
+
+   The data to be plotted is either generated by a function (two
+functions if in parametric mode), read from a data file, read from a
+named data block that was defined previously, or extracted from an
+array.  Multiple datafiles, data blocks, arrays, and/or functions may be
+plotted in a single plot command separated by commas.
+
+   Many additional keywords are specific to data plots.  See *note
+datafile::.  Also see 'data', 'inline data', *note functions::.
+
+   A plot-element that contains the definition of a function or variable
+does not create any visible output, see third example below.
+
+   Examples:
+           plot sin(x)
+           plot sin(x), cos(x)
+           plot f(x) = sin(x*a), a = .2, f(x), a = .4, f(x)
+           plot "datafile.1" with lines, "datafile.2" with points
+           plot [t=1:10] [-pi:pi*2] tan(t), \
+                "data.1" using (tan($2)):($3/$4) smooth csplines \
+                         axes x1y2 notitle with lines 5
+           plot for [datafile in "spinach.dat broccoli.dat"] datafile
+
+
+   See also 'show plot'.
+
+* Menu:
+
+* axes::
+* binary::
+* data::
+* functions::
+* parametric::
+* ranges::
+* sampling::
+* for_loops_in_plot_command::
+* title::
+* with::
+
+
+File: gnuplot.info,  Node: axes,  Next: binary,  Prev: plot,  Up: plot
+
+3.20.1 axes
+-----------
+
+There are four possible sets of axes available; the keyword <axes> is
+used to select the axes for which a particular line should be scaled.
+'x1y1' refers to the axes on the bottom and left; 'x2y2' to those on the
+top and right; 'x1y2' to those on the bottom and right; and 'x2y1' to
+those on the top and left.  Ranges specified on the 'plot' command apply
+only to the first set of axes (bottom left).
+
+
+File: gnuplot.info,  Node: binary,  Next: data,  Prev: axes,  Up: plot
+
+3.20.2 binary
+-------------
+
+BINARY DATA FILES:
+
+   It is necessary to provide the keyword *note binary:: after the
+filename.  Adequate details of the file format must be given on the
+command line or extracted from the file itself for a supported binary
+*note filetype::.  In particular, there are two structures for binary
+files, binary matrix format and binary general format.
+
+   The *note matrix:: format contains a two dimensional array of 32 bit
+IEEE float values plus an additional column and row of coordinate
+values.  In the 'using' specifier of a plot command, column 1 refers to
+the matrix row coordinate, column 2 refers to the matrix column
+coordinate, and column 3 refers to the value stored in the array at
+those coordinates.
+
+   The *note general:: format contains an arbitrary number of columns
+for which information must be specified at the command line.  For
+example, 'array', *note record::, 'format' and 'using' can indicate the
+size, format and dimension of data.  There are a variety of useful
+commands for skipping file headers and changing endianess.  There are a
+set of commands for positioning and translating data since often
+coordinates are not part of the file when uniform sampling is inherent
+in the data.  Unlike reading from a text or matrix binary file, general
+binary does not treat the generated columns as 1, 2 or 3 in the 'using'
+list.  Instead column 1 refers to column 1 of the file, or as specified
+in the 'format' list.
+
+   There are global default settings for the various binary options
+which may be set using the same syntax as the options when used as part
+of the '(s)plot <filename> binary ...'  command.  This syntax is 'set
+datafile binary ...'.  The general rule is that common command-line
+specified parameters override file-extracted parameters which override
+default parameters.
+
+   *note matrix:: is the default binary format when no keywords specific
+to *note general:: are given, i.e., 'array', *note record::, 'format',
+*note filetype::.
+
+   General binary data can be entered at the command line via the
+special file name '-'.  However, this is intended for use through a pipe
+where programs can exchange binary data, not for keyboards.  There is no
+"end of record" character for binary data.  Gnuplot continues reading
+from a pipe until it has read the number of points declared in the
+'array' qualifier.  See *note matrix:: or *note general:: for more
+details.
+
+   The *note index:: keyword is not supported, since the file format
+allows only one surface per file.  The *note every:: and 'using'
+specifiers are supported.  'using' operates as if the data were read in
+the above triplet form.  Binary File Splot Demo.
+(http://www.gnuplot.info/demo/binary.html)
+
+* Menu:
+
+* general::
+* array::
+* record::
+* skip::
+* format::
+* blank::
+* endian::
+* filetype::
+* keywords::
+
+
+File: gnuplot.info,  Node: general,  Next: array,  Prev: binary,  Up: binary
+
+3.20.2.1 general
+................
+
+The *note binary:: keyword appearing alone indicates a binary data file
+that contains both coordinate information describing a non-uniform grid
+and the value of each grid point (see *note matrix::).  Binary data in
+any other format requires additional keywords to describe the layout of
+the data.  Unfortunately the syntax of these required additional
+keywords is convoluted.  Nevertheless the general binary mode is
+particularly useful for application programs sending large amounts of
+data to gnuplot.
+
+   Syntax:
+           plot '<file_name>' {binary <binary list>} ...
+           splot '<file_name>' {binary <binary list>} ...
+
+
+   General binary format is activated by keywords in <binary list>
+pertaining to information about file structure, i.e., 'array', *note
+record::, 'format' or *note filetype::.  Otherwise, non-uniform matrix
+binary format is assumed.  (See *note matrix:: for more details.)
+
+   Gnuplot knows how to read a few standard binary file types that are
+fully self-describing, e.g.  PNG images.  Type *note binary:: at the
+command line for a list.  Apart from these, you can think of binary data
+files as conceptually the same as text data.  Each point has columns of
+information which are selected via the 'using' specification.  If no
+'format' string is specified, gnuplot will read in a number of binary
+values equal to the largest column given in the '<using list>'.  For
+example, 'using 1:3' will result in three columns being read, of which
+the second will be ignored.  Certain plot types have an associated
+default using specification.  For example, 'with image' has a default of
+'using 1', while *note rgbimage:: has a default of 'using 1:2:3'.
+
+
+File: gnuplot.info,  Node: array,  Next: record,  Prev: general,  Up: binary
+
+3.20.2.2 array
+..............
+
+Describes the sampling array dimensions associated with the binary file.
+The coordinates will be generated by gnuplot.  A number must be
+specified for each dimension of the array.  For example, 'array=(10,20)'
+means the underlying sampling structure is two-dimensional with 10
+points along the first (x) dimension and 20 points along the second (y)
+dimension.  A negative number indicates that data should be read until
+the end of file.  If there is only one dimension, the parentheses may be
+omitted.  A colon can be used to separate the dimensions for multiple
+records.  For example, 'array=25:35' indicates there are two
+one-dimensional records in the file.
+
+
+File: gnuplot.info,  Node: record,  Next: skip,  Prev: array,  Up: binary
+
+3.20.2.3 record
+...............
+
+The *note record:: keyword provides array dimensions describing how data
+in a binary file are to be arranged into an array.  A number must be
+specified for each dimension of the array.  For example,
+'record=(10,20)' means the underlying structure is two-dimensional with
+10 points along the first (x) dimension and 20 points along the second
+(y) dimension.  A negative number indicates that data should be read
+until the end of file.
+
+   If there is only one dimension, the parentheses may be omitted.  A
+colon can be used to separate the dimensions for multiple records.  E.g.
+'record=25:35' describes a file containing two one-dimensional records.
+
+   This keyword serves the same function as 'array' and has the same
+syntax.  However, 'array' causes gnuplot to generate coordinate
+information while *note record:: does not.  Use *note record:: when the
+coordinates are to be read from columns of the binary data file records.
+
+
+File: gnuplot.info,  Node: skip,  Next: format,  Prev: record,  Up: binary
+
+3.20.2.4 skip
+.............
+
+This keyword allows you to skip sections of a binary file.  For
+instance, if the file contains a 1024 byte header before the start of
+the data region you would probably want to use
+           plot '<file_name>' binary skip=1024 ...
+
+   If there are multiple records in the file, you may specify a leading
+offset for each.  For example, to skip 512 bytes before the 1st record
+and 256 bytes before the second and third records
+           plot '<file_name> binary record=356:356:356 skip=512:256:256 ...
+
+
+
+File: gnuplot.info,  Node: format,  Next: blank,  Prev: skip,  Up: binary
+
+3.20.2.5 format
+...............
+
+The default binary format is a float.  For more flexibility, the format
+can include details about variable sizes.  For example,
+'format="%uchar%int%float"' associates an unsigned character with the
+first using column, an int with the second column and a float with the
+third column.  If the number of size specifications is less than the
+greatest column number, the size is implicitly taken to be similar to
+the last given variable size.
+
+   Furthermore, similar to the 'using' specification, the format can
+include discarded columns via the '*' character and have implicit
+repetition via a numerical repeat-field.  For example,
+'format="%*2int%3float"' causes gnuplot to discard two ints before
+reading three floats.  To list variable sizes, type 'show datafile
+binary datasizes'.  There are a group of names that are machine
+dependent along with their sizes in bytes for the particular
+compilation.  There is also a group of names which attempt to be machine
+independent.
+
+
+File: gnuplot.info,  Node: blank,  Next: endian,  Prev: format,  Up: binary
+
+3.20.2.6 blank
+..............
+
+Some plot styles expect a blank line to separate groups of data points
+read from a text input file.  For instance the vertices of one polygon
+in an input text data stream are separated from those of the next
+polygon by a blank line.  Since there are no actual blank lines in a
+binary file, this option allows a special record in a general binary
+file to be interpreted as if it were a blank line.  The only option
+currently supported is 'blank=NaN', which means that a value of NaN in
+the first field of a record causes the entire record to be treated as if
+it were a blank line.
+
+   Example:
+          plot DATA binary format="%2float" blank=NAN using 1:2 with polygons
+
+
+
+File: gnuplot.info,  Node: endian,  Next: filetype,  Prev: blank,  Up: binary
+
+3.20.2.7 endian
+...............
+
+Often the endianess of binary data in the file does not agree with the
+endianess used by the platform on which gnuplot is running.  Several
+words can direct gnuplot how to arrange bytes.  For example
+'endian=little' means treat the binary file as having byte significance
+from least to greatest.  The options are
+
+                   little:  least significant to greatest significance
+                      big:  greatest significance to least significance
+                  default:  assume file endianess is the same as compiler
+              swap (swab):  Interchange the significance.  (If things
+                            don't look right, try this.)
+
+
+   Gnuplot can support "middle" ("pdp") endian if it is compiled with
+that option.
+
+
+File: gnuplot.info,  Node: filetype,  Next: keywords,  Prev: endian,  Up: binary
+
+3.20.2.8 filetype
+.................
+
+For some standard binary file formats gnuplot can extract all the
+necessary information from the file in question.  As an example,
+"format=edf" will read ESRF Header File format files.  For a list of the
+currently supported file formats, type 'show datafile binary filetypes'.
+
+   There is a special file type called 'auto' for which gnuplot will
+check if the binary file's extension is a quasi-standard extension for a
+supported format.
+
+   Command line keywords may be used to override settings extracted from
+the file.  The settings from the file override any defaults.  See *note
+binary::.
+
+-- AVS --
+
+   'avs' is one of the automatically recognized binary file types for
+images.  AVS is an extremely simple format, suitable mostly for
+streaming between applications.  It consists of 2 longs (xwidth, ywidth)
+followed by a stream of pixels, each with four bytes of information
+alpha/red/green/blue.
+
+-- EDF --
+
+   'edf' is one of the automatically recognized binary file types for
+images.  EDF stands for ESRF Data Format, and it supports both edf and
+ehf formats (the latter means ESRF Header Format).  More information on
+specifications can be found at
+
+       http://www.edfplus.info/specs
+
+
+-- PNG --
+
+   If gnuplot was configured to use the libgd library for png/gif/jpeg
+output, then it can also be used to read these same image types as
+binary files.  You can use an explicit command
+           plot 'file.png' binary filetype=png
+
+   Or the file type will be recognized automatically from the extension
+if you have previously requested
+           set datafile binary filetype=auto
+
+
+
+File: gnuplot.info,  Node: keywords,  Prev: filetype,  Up: binary
+
+3.20.2.9 keywords
+.................
+
+The following keywords apply only when generating coordinates from
+binary data files.  That is, the control mapping the individual elements
+of a binary array, matrix, or image to specific x/y/z positions.
+
+-- SCAN --
+
+   A great deal of confusion can arise concerning the relationship
+between how gnuplot scans a binary file and the dimensions seen on the
+plot.  To lessen the confusion, conceptually think of gnuplot _always_
+scanning the binary file point/line/plane or fast/medium/slow.  Then
+this keyword is used to tell gnuplot how to map this scanning convention
+to the Cartesian convention shown in plots, i.e., x/y/z.  The qualifier
+for scan is a two or three letter code representing where point is
+assigned (first letter), line is assigned (second letter), and plane is
+assigned (third letter).  For example, 'scan=yx' means the fastest,
+point-by-point, increment should be mapped along the Cartesian y
+dimension and the middle, line-by-line, increment should be mapped along
+the x dimension.
+
+   When the plotting mode is 'plot', the qualifier code can include the
+two letters x and y.  For 'splot', it can include the three letters x, y
+and z.
+
+   There is nothing restricting the inherent mapping from
+point/line/plane to apply only to Cartesian coordinates.  For this
+reason there are cylindrical coordinate synonyms for the qualifier codes
+where t (theta), r and z are analogous to the x, y and z of Cartesian
+coordinates.
+
+-- TRANSPOSE --
+
+   Shorthand notation for 'scan=yx' or 'scan=yxz'.  I.e.  it affects the
+assignment of pixels to scan lines during input.  To instead transpose
+an image when it is displayed try
+          plot 'imagefile' binary filetype=auto flipx rotate=90deg with rgbimage
+
+
+-- DX, DY, DZ --
+
+   When gnuplot generates coordinates, it uses the spacing described by
+these keywords.  For example 'dx=10 dy=20' would mean space samples
+along the x dimension by 10 and space samples along the y dimension by
+20.  'dy' cannot appear if 'dx' does not appear.  Similarly, 'dz' cannot
+appear if 'dy' does not appear.  If the underlying dimensions are
+greater than the keywords specified, the spacing of the highest
+dimension given is extended to the other dimensions.  For example, if an
+image is being read from a file and only 'dx=3.5' is given gnuplot uses
+a delta x and delta y of 3.5.
+
+   The following keywords also apply only when generating coordinates.
+However they may also be used with matrix binary files.
+
+-- FLIPX, FLIPY, FLIPZ --
+
+   Sometimes the scanning directions in a binary datafile are not
+consistent with that assumed by gnuplot.  These keywords can flip the
+scanning direction along dimensions x, y, z.
+
+-- ORIGIN	--
+
+   When gnuplot generates coordinates based upon transposition and flip,
+it attempts to always position the lower left point in the array at the
+origin, i.e., the data lies in the first quadrant of a Cartesian system
+after transpose and flip.
+
+   To position the array somewhere else on the graph, the *note origin::
+keyword directs gnuplot to position the lower left point of the array at
+a point specified by a tuple.  The tuple should be a double for 'plot'
+and a triple for 'splot'.  For example, 'origin=(100,100):(100,200)' is
+for two records in the file and intended for plotting in two dimensions.
+A second example, 'origin=(0,0,3.5)', is for plotting in three
+dimensions.
+
+-- CENTER --
+
+   Similar to *note origin::, this keyword will position the array such
+that its center lies at the point given by the tuple.  For example,
+'center=(0,0)'.  Center does not apply when the size of the array is
+'Inf'.
+
+-- ROTATE --
+
+   The transpose and flip commands provide some flexibility in
+generating and orienting coordinates.  However, for full degrees of
+freedom, it is possible to apply a rotational vector described by a
+rotational angle in two dimensions.
+
+   The 'rotate' keyword applies to the two-dimensional plane, whether it
+be 'plot' or 'splot'.  The rotation is done with respect to the positive
+angle of the Cartesian plane.
+
+   The angle can be expressed in radians, radians as a multiple of pi,
+or degrees.  For example, 'rotate=1.5708', 'rotate=0.5pi' and
+'rotate=90deg' are equivalent.
+
+   If *note origin:: is specified, the rotation is done about the lower
+left sample point before translation.  Otherwise, the rotation is done
+about the array 'center'.
+
+-- PERPENDICULAR --
+
+   For 'splot', the concept of a rotational vector is implemented by a
+triple representing the vector to be oriented normal to the
+two-dimensional x-y plane.  Naturally, the default is (0,0,1).  Thus
+specifying both rotate and perpendicular together can orient data myriad
+ways in three-space.
+
+   The two-dimensional rotation is done first, followed by the
+three-dimensional rotation.  That is, if R' is the rotational 2 x 2
+matrix described by an angle, and P is the 3 x 3 matrix projecting
+(0,0,1) to (xp,yp,zp), let R be constructed from R' at the upper left
+sub-matrix, 1 at element 3,3 and zeros elsewhere.  Then the matrix
+formula for translating data is v' = P R v, where v is the 3 x 1 vector
+of data extracted from the data file.  In cases where the data of the
+file is inherently not three-dimensional, logical rules are used to
+place the data in three-space.  (E.g., usually setting the z-dimension
+value to zero and placing 2D data in the x-y plane.)
+
+
+File: gnuplot.info,  Node: data,  Next: functions,  Prev: binary,  Up: plot
+
+3.20.3 data
+-----------
+
+Data provided in a file can be plotted by giving the name of the file
+(enclosed in single or double quotes) on the 'plot' command line.  Data
+may also come from an input stream that is not a file.  See *note
+special-filenames::, *note piped-data::, 'datablocks'.
+
+   Syntax:
+           plot '<file_name>' {binary <binary list>}
+                              {{nonuniform|sparse} matrix}
+                              {index <index list> | index "<name>"}
+                              {every <every list>}
+                              {skip <number-of-lines>}
+                              {using <using list>}
+                              {convexhull} {concavehull}
+                              {smooth <option>}
+                              {bins <options>}
+                              {mask}
+                              {volatile} {zsort} {noautoscale}
+
+
+   The modifiers *note binary::, *note index::, *note every::, *note
+skip::, 'using', *note smooth::, 'bins', 'mask', 'convexhull',
+'concavehull', and 'zsort' are discussed separately.  In brief
+   * 'skip N' tells the program to ignore N lines at the start of the
+     input file
+   * *note binary:: indicates that the file contains binary data rather
+     than text
+   * *note index:: selects which data sets in a multi-data-set file are
+     to be plotted
+   * *note every:: specifies which points within a single data set are
+     to be plotted
+   * 'using' specifies which columns in the file are to be used in which
+     order
+   * *note smooth:: performs simple filtering, interpolation, or
+     curve-fitting of the data prior to plotting
+   * 'convexhull' either alone or in combination with *note smooth::
+     replaces the points in the input data set with a new set of points
+     that constitute the vertices of a bounding polygon.
+   * 'bins' sorts individual input points into equal-sized intervals
+     along x and plots a single accumulated value per interval
+   * 'mask' filters the data through a previously defined mask to plot
+     only a selected subset of pixels in an image or a selected region
+     of a pm3d surface.
+   * *note volatile:: indicates that the content of the file may not be
+     available to reread later and therefore it should be retained
+     internally for re-use.
+
+   'splot' has a similar syntax but does not support 'bins' and supports
+only a few *note smooth:: options.
+
+   The 'noautoscale' keyword means that the points making up this plot
+will be ignored when automatically determining axis range limits.
+
+   TEXT DATA FILES:
+
+   Each non-empty line in a data file describes one data point, except
+that records beginning with '#' will be treated as comments and ignored.
+
+   Depending on the plot style and options selected, from one to eight
+values are read from each line and associated with a single data point.
+See 'using'.
+
+   The individual records on a single line of data must be separated by
+white space (one or more blanks or tabs) or a special field separator
+character which is specified by the *note datafile:: command.  A single
+field may itself contain white space characters if the entire field is
+enclosed in a pair of double quotes, or if a field separator other than
+white space is in effect.  Whitespace inside a pair of double quotes is
+ignored when counting columns, so the following datafile line has three
+columns:
+           1.0 "second column" 3.0
+
+
+   Data may be written in exponential format with the exponent preceded
+by the letter e or E. The fortran exponential specifiers d, D, q, and Q
+may also be used if the command 'set datafile fortran' is in effect.
+
+   Blank records in a data file are significant.  Single blank records
+designate discontinuities in a 'plot'; no line will join points
+separated by a blank records (if they are plotted with a line style).
+Two blank records in a row indicate a break between separate data sets.
+See *note index::.
+
+   If autoscaling has been enabled (*note autoscale::), the axes are
+automatically extended to include all datapoints, with a whole number of
+tic marks if tics are being drawn.  This has two consequences: i) For
+'splot', the corner of the surface may not coincide with the corner of
+the base.  In this case, no vertical line is drawn.  ii) When plotting
+data with the same x range on a dual-axis graph, the x coordinates may
+not coincide if the x2tics are not being drawn.  This is because the x
+axis has been autoextended to a whole number of tics, but the x2 axis
+has not.  The following example illustrates the problem:
+
+           reset; plot '-', '-' axes x2y1
+           1 1
+           19 19
+           e
+           1 1
+           19 19
+           e
+
+
+   To avoid this, you can use the *note noextend:: modifier of the *note
+autoscale:: or 'set [axis]range' commands.  This turns off extension of
+the axis range to include the next tic mark.
+
+   Label coordinates and text can also be read from a data file (see
+*note labels::).
+
+* Menu:
+
+* columnheaders::
+* csv_files::
+* every::
+* example_datafile::
+* filters::
+* index::
+* skip_::
+* smooth::
+* special-filenames::
+* piped-data::
+* using::
+* volatile::
+
+
+File: gnuplot.info,  Node: columnheaders,  Next: csv_files,  Prev: data,  Up: data
+
+3.20.3.1 columnheaders
+......................
+
+Extra lines at the start of a data file may be explicitly ignored using
+the *note skip:: keyword in the plot command.  A single additional line
+containing text column headers may be present.  It is skipped
+automatically if the plot command refers explicitly to column headers,
+e.g.  by using them for titles.  Otherwise you may need to skip it
+explicitly either by adding one to the skip count or by setting the
+attribute *note columnheaders::.  See *note skip::, 'columnhead',
+'autotitle columnheader', *note datafile::.
+
+
+File: gnuplot.info,  Node: csv_files,  Next: every,  Prev: columnheaders,  Up: data
+
+3.20.3.2 csv files
+..................
+
+Syntax:
+          set datafile separator {whitespace | tab | comma | "chars"}
+
+
+   "csv" is short for "comma-separated values".  The term "csv file" is
+loosely applied to files in which data fields are delimited by a
+specific character, not necessarily a comma.  To read data from a csv
+file you must tell gnuplot what the field-delimiting character is.  For
+instance to read from a file using semicolon as a field delimiter:
+
+          set datafile separator ";"
+
+
+   See 'set datafile separator'.  This applies only to files used for
+input.  To create a csv file on output, use the corresponding
+'separator' option to *note table::.
+
+
+File: gnuplot.info,  Node: every,  Next: example_datafile,  Prev: csv_files,  Up: data
+
+3.20.3.3 every
+..............
+
+The *note every:: keyword allows a periodic sampling of a data set to be
+plotted.
+
+   For ordinary files a "point" single record (line); a "block" of data
+is a set of consecutive records with blank lines before and after the
+block.
+
+   For matrix data a "block" and "point" correspond to "row" and
+"column".  See *note every::.
+
+   Syntax:
+           plot 'file' every {<point_incr>}
+                               {:{<block_incr>}
+                                 {:{<start_point>}
+                                   {:{<start_block>}
+                                     {:{<end_point>}
+                                       {:<end_block>}}}}}
+
+
+   The data points to be plotted are selected according to a loop from
+<'start_point'> to <'end_point'> with increment <'point_incr'> and the
+blocks according to a loop from <'start_block'> to <'end_block'> with
+increment <'block_incr'>.
+
+   The first datum in each block is numbered '0', as is the first block
+in the file.
+
+   Note that records containing unplottable information are counted.
+
+   Any of the numbers can be omitted; the increments default to unity,
+the start values to the first point or block, and the end values to the
+last point or block.  ':' at the end of the *note every:: option is not
+permitted.  If *note every:: is not specified, all points in all lines
+are plotted.
+
+   Examples:
+           every :::3::3    # selects just the fourth block ('0' is first)
+           every :::::9     # selects the first 10 blocks
+           every 2:2        # selects every other point in every other block
+           every ::5::15    # selects points 5 through 15 in each block
+
+
+   See simple plot demos (simple.dem)
+(http://www.gnuplot.info/demo/simple.html) , Non-parametric splot demos
+(http://www.gnuplot.info/demo/surface1.html) , and Parametric splot
+demos (http://www.gnuplot.info/demo/surface2.html) .
+
+
+File: gnuplot.info,  Node: example_datafile,  Next: filters,  Prev: every,  Up: data
+
+3.20.3.4 example datafile
+.........................
+
+This example plots the data in the file "population.dat" and a
+theoretical curve:
+
+           pop(x) = 103*exp((1965-x)/10)
+           set xrange [1960:1990]
+           plot 'population.dat', pop(x)
+
+
+   The file "population.dat" might contain:
+
+           # Gnu population in Antarctica since 1965
+              1965   103
+              1970   55
+              1975   34
+              1980   24
+              1985   10
+
+
+   Binary examples:
+
+           # Selects two float values (second one implicit) with a float value
+           # discarded between them for an indefinite length of 1D data.
+           plot '<file_name>' binary format="%float%*float" using 1:2 with lines
+
+
+           # The data file header contains all details necessary for creating
+           # coordinates from an EDF file.
+           plot '<file_name>' binary filetype=edf with image
+           plot '<file_name>.edf' binary filetype=auto with image
+
+
+           # Selects three unsigned characters for components of a raw RGB image
+           # and flips the y-dimension so that typical image orientation (start
+           # at top left corner) translates to the Cartesian plane.  Pixel
+           # spacing is given and there are two images in the file.  One of them
+           # is translated via origin.
+           plot '<file_name>' binary array=(512,1024):(1024,512) format='%uchar' \
+                dx=2:1 dy=1:2 origin=(0,0):(1024,1024) flipy u 1:2:3 w rgbimage
+
+
+           # Four separate records in which the coordinates are part of the
+           # data file.  The file was created with a endianess different from
+           # the system on which gnuplot is running.
+           splot '<file_name>' binary record=30:30:29:26 endian=swap u 1:2:3
+
+
+           # Same input file, but this time we skip the 1st and 3rd records
+           splot '<file_name>' binary record=30:26 skip=360:348 endian=swap u 1:2:3
+
+
+   See also *note matrix::.
+
+
+File: gnuplot.info,  Node: filters,  Next: index,  Prev: example_datafile,  Up: data
+
+3.20.3.5 filters
+................
+
+Filter operations are applied immediately after reading input data,
+before applying any smoothing or style-specific processing options.  In
+general the purpose of a filter is to replace the original full set of
+input points with a selected subset of points, possibly modified,
+regrouped, or reordered, The filters currently supported are 'bins',
+'convexhull', 'concavehull', 'mask', 'sharpen', and 'zsort'.
+
+-- BINS --
+
+   Syntax:
+          plot 'DATA' using <XCOL> {:<YCOL>} bins{=<NBINS>}
+               {binrange [<LOW>:<HIGH>]} {binwidth=<width>}
+               {binvalue={sum|avg}}
+
+
+   The 'bins' option to a 'plot' command first assigns the original data
+to equal width bins on x and then plots a single value per bin.  The
+default number of bins is controlled by *note samples::, but this can be
+changed by giving an explicit number of bins in the command.
+
+   If no binrange is given, the range is taken from the extremes of the
+x values found in 'DATA'.
+
+   Given the range and the number of bins, bin width is calculated
+automatically and points are assigned to bins 0 to NBINS-1
+          BINWIDTH = (HIGH - LOW) / (NBINS-1)
+          xmin = LOW - BINWIDTH/2
+          xmax = HIGH + BINWIDTH/2
+          first bin holds points with (xmin <= x < xmin + BINWIDTH)
+          last bin holds points with (xmax-BINWIDTH <= x < xman)
+          each point is assigned to bin i = floor(NBINS * (x-xmin)/(xmax-xmin))
+
+
+   Alternatively you can provide a fixed bin width, in which case nbins
+is calculated as the smallest number of bins that will span the range.
+
+   On output bins are plotted or tabulated by midpoint.  E.g.  if the
+program calculates bin width as shown above, the x coordinate output for
+the first bin is x=LOW (not x=xmin).
+
+   If only a single column is given in the using clause then each data
+point contributes a count of 1 to the accumulation of total counts in
+the bin for that x coordinate value.  If a second column is given then
+the value in that column is added to the accumulation for the bin.  Thus
+the following two plot commands are equivalent:
+          plot 'DATA" using N bins=20
+          set samples 20
+          plot 'DATA' using (column(N)):(1)
+
+
+   By default the y value plotted for each bin is the sum of the y
+values over all points in that bin.  This corresponds to option
+'binvalue=sum'.  The alternative 'binvalue=avg' plots the mean y value
+for points in that bin.
+
+   For related processing options see 'smooth frequency' and 'smooth
+kdensity'.
+
+-- CONVEXHULL --
+
+   Convexhull is not a plot style.  It can appear either alone as a
+filter keyword or in combination with 'smooth path' and/or 'expand
+<increment>'.
+
+          plot FOO using x:y convexhull
+          plot FOO using x:y convexhull smooth path
+          plot FOO using x:y convexhull expand <increment> {smooth path}
+
+
+   The points in FOO are replaced by a subset of the original points
+that constitute the unique bounding convex polygon, the convex hull.
+The vertices of this polygon are output in clockwise order to form a
+closed curve.  The first and last points of the generated curve are
+equal, making it suitable for plotting with styles 'lines', *note
+polygons::, or *note filledcurves::.  The convex hull may also be useful
+as a mask to selectively render the region of an image or a pm3d surface
+that contains all the original data points.  See *note masking::.
+
+   If the keyword *note smooth:: is present, the vertices are then used
+as guide points to generate a smooth closed curve (see 'smooth path').
+By default this smoothed curve runs through the bounding points.
+
+   The optional 'expand' keyword and increment shift the edge segments
+of the hull away from the interior by an incremental distance.  The
+displaced segments are then connected using miter joins; this means that
+each vertex of the original hull is replaced by two vertices, since
+there is now a gap between the to adjoining edges.
+
+-- CONCAVEHULL --
+
+   Present only if your copy of gnuplot was configured
+-enable-chi-shapes.
+
+   Concavehull is not a plot style.  It is a filter that finds a
+bounding polygon, a "hull", of the input data points and replaces the
+original points with an ordered subset of points that lie along the
+perimeter of this polygon.  Unlike the convex hull, which is uniquely
+defined for any set of points, more than one concave hull is possible.
+Various schemes for selecting a concave hull exist; gnuplot generates
+hulls that are χ-shapes as defined by Duckham et al.  (2008) Patttern
+Recognition 41:3224-3236.
+
+   For a given set of points, a χ-shape is generated by iterative
+removal of triangles from the Delaunay triangulation.  Each iteration
+removes a single triangle subject to the criteria: (1) A triangle is
+only eligible for removal if this would not reduce the connectivity of
+the bounded shape to contact at a single point; (2) one edge of the
+triangle is the longest segment of the current perimeter; (3) this edge
+is longer than a pre-selected characteristic length parameter that fully
+determines the χ-shape.  In gnuplot this characteristic length parameter
+is taken from user variable 'chi_length'.  Iteration stops when there
+are no remaining eligible triangles.  If 'chi_length' is large, no
+triangles are removed and the χ-shape is the original perimeter, i.e.
+the convex hull.  As 'chi_length' is reduced, more and more triangles
+are removed and the resulting shape becomes increasingly less convex.
+Too-small values of 'chi_length' are undesirable.
+
+   Appropriate choice of 'chi_length' depends strongly on the density
+and distribution of the input data points.  If no value for 'chi_length'
+has been set by the user, gnuplot will choose one automatically but
+there is no guarantee that this value is suitable for your data.  For
+the data used in the figures shown here gnuplot would choose
+chi_length=22.6 by default, which is 0.6 of the length of the longest
+edge in the convex hull.  You can change the fraction of the longest
+edge used as a default with the command 'set chi_shape fraction <value>'
+
+   The value of 'chi_length' used in the current plot, whether provided
+by the user or chosen by the program, is saved to variable
+GPVAL_CHI_LENGTH.
+
+   The optional 'expand' keyword and increment shift each edge segment
+of the hull away from the interior by a fixed distance.  This creates a
+new set of points describing a closed curve that lies outside all of the
+original points.  It can be combined with 'smooth path'.
+
+-- MASK --
+
+          plot FOO using 1:2:3 mask with {pm3d|image}
+
+
+   Once a mask has been defined, you can use it as a filter to select a
+subset of points from an image or pm3d plot.  See *note masking::.
+
+-- SHARPEN --
+
+   The 'sharpen' filter applies only to function plots.  It looks for
+extrema in the function being plotted, which may not lie exactly at any
+of the x values sampled to generate the component line segments making
+up the graph.  The true local extrema are found by bisection and added
+to the set of sampled points.  This reduces but does not entirely
+eliminate truncation of sharp peaks due to coarse sampling.
+
+   Example:
+          set samples 150
+          set xrange [-8:8]
+          plot abs(sqrt(sin(x))) sharpen
+
+
+   Without the "sharpen" keyword, the resulting graph shows a continuous
+curve with minima at intervals of pi that should reach zero but are
+artefactually truncated to apparent minimal y values between 0.02 and
+0.20.  Adding the "sharpen" keyword produces instead a correct
+representation of the function with periodic sharp minima that reach
+y=0.  D sharpen 1
+
+-- ZSORT --
+
+          plot FOO using x:y:z:color zsort with points lc palette
+
+
+   Input data is sorted immediately after input, prior to applying any
+smoothing options.  Note that some smoothing options will re-sort the
+data, in which case 'zsort' has no effect on the plot.  If z is not
+auto-scaled, points with z value out of range are flagged but not
+deleted.
+
+   The intended use is to filter presentation of 2D scatter plots with a
+huge number of points so that the distribution of high-scoring points
+remains evident.  Sorting the points on z guarantees that points with a
+high z-value will not be obscured by points with lower z-values.
+
+
+File: gnuplot.info,  Node: index,  Next: skip_,  Prev: filters,  Up: data
+
+3.20.3.6 index
+..............
+
+The *note index:: keyword allows you to select specific data sets in a
+multi-data-set file for plotting.  For array indexing please see *note
+arrays::.
+
+   Syntax:
+           plot 'file' index { <m>{:<n>{:<p>}} | "<name>" }
+
+
+   Data sets are separated by pairs of blank records.  'index <m>'
+selects only set <m>; 'index <m>:<n>' selects sets in the range <m> to
+<n>; and 'index <m>:<n>:<p>' selects indices <m>, <m>+<p>, <m>+2<p>,
+etc., but stopping at <n>.  Following C indexing, the index 0 is
+assigned to the first data set in the file.  Specifying too large an
+index results in an error message.  If <p> is specified but <n> is left
+blank then every <p>-th dataset is read until the end of the file.  If
+*note index:: is not specified, the entire file is plotted as a single
+data set.
+
+   Example:
+           plot 'file' index 4:5
+
+
+   For each point in the file, the index value of the data set it
+appears in is available via the pseudo-column 'column(-2)'.  This leads
+to an alternative way of distinguishing individual data sets within a
+file as shown below.  This is more awkward than the *note index::
+command if all you are doing is selecting one data set for plotting, but
+is very useful if you want to assign different properties to each data
+set.  See 'pseudocolumns', 'lc variable'.
+
+   Example:
+           plot 'file' using 1:(column(-2)==4 ? $2 : NaN)        # very awkward
+           plot 'file' using 1:2:(column(-2)) linecolor variable # very useful!
+
+
+   'index '<name>'' selects the data set with name '<name>'.  Names are
+assigned to data sets in comment lines.  The comment character and
+leading white space are removed from the comment line.  If the resulting
+line starts with <name>, the following data set is now named <name> and
+can be selected.
+
+   Example:
+           plot 'file' index 'Population'
+
+
+   Please note that every comment that starts with <name> will name the
+following data set.  To avoid problems it may be useful to choose a
+naming scheme like '== Population ==' or '[Population]'.
+
+   splot with indices demo.
+(http://www.gnuplot.info/demo/multimsh.html)</p>
+
+
+File: gnuplot.info,  Node: skip_,  Next: smooth,  Prev: index,  Up: data
+
+3.20.3.7 skip
+.............
+
+The *note skip:: keyword tells the program to skip lines at the start of
+a text (i.e.  not binary) data file.  The lines that are skipped do not
+count toward the line count used in processing the *note every::
+keyword.  Note that 'skip N' skips lines only at the start of the file,
+whereas 'every ::N' skips lines at the start of every block of data in
+the file.  See also *note skip:: for a similar option that applies to
+binary data files.
+
+
+File: gnuplot.info,  Node: smooth,  Next: special-filenames,  Prev: skip_,  Up: data
+
+3.20.3.8 smooth
+...............
+
+'gnuplot' includes a few routines for interpolation and other operations
+applied to data as it is input; these are grouped under the *note
+smooth:: option.  More sophisticated data processing may be performed by
+preprocessing the data externally or by using *note fit:: with an
+appropriate model.  See also the discussion of *note filters::.
+
+   Syntax:
+           smooth {unique | frequency | fnormal | cumulative | cnormal
+                  | csplines | acsplines | mcsplines  bezier | sbezier
+                  | path
+                  | kdensity {bandwidth} {period}
+                  | unwrap}
+
+
+   The 'unique', 'frequency', 'fnormal', 'cumulative' and 'cnormal'
+options sort the data on x and then plot some aspect of the distribution
+of x values.
+
+   The spline and Bezier options determine coefficients describing a
+continuous curve between the endpoints of the data.  This curve is then
+plotted in the same manner as a function, that is, by finding its value
+at uniform intervals along the abscissa (see *note samples::) and
+connecting these points with straight line segments.  If the data set is
+interrupted by blank lines or undefined values a separate continuous
+curve is fit for each uninterrupted subset of the data.  Adjacent
+separately fit segments may be separated by a gap or discontinuity.
+
+   'unwrap' manipulates the data to avoid jumps of more than pi by
+adding or subtracting multiples of 2*pi.
+
+   If *note autoscale:: is in effect, axis ranges will be computed for
+the final curve rather than for the original data.
+
+   If *note autoscale:: is not in effect, and a spline curve is being
+generated, sampling of the spline fit is done across the intersection of
+the x range covered by the input data and the fixed abscissa range
+defined by *note xrange::.
+
+   If too few points are available to apply the requested smoothing
+operation an error message is produced.
+
+   The *note smooth:: options have no effect on function plots.  Only
+'smooth path' is possible in polar coordinate mode.
+
+   Smoothing in 3D plots (splot) is currently limited to generating a
+natural cubic spline to pass through a set of 3D points.  In the general
+case the splines are generated along a trajectory ('smooth path').  For
+a 2D projection of 3D data 'smooth csplines' acts as it does in 2D.
+Either keyword is accepted in an 'splot' command.
+
+          splot $DATA using 1:2:3 smooth path with lines
+
+
+-- ACSPLINES --
+
+   The 'smooth acsplines' option approximates the data with a natural
+smoothing spline.  After the data are made monotonic in x (see 'smooth
+unique'), a curve is piecewise constructed from segments of cubic
+polynomials whose coefficients are found by fitting to the individual
+data points weighted by the value, if any, given in the third column of
+the using spec.  The default is equivalent to
+           plot 'data-file' using 1:2:(1.0) smooth acsplines
+
+
+   Qualitatively, the absolute magnitude of the weights determines the
+number of segments used to construct the curve.  If the weights are
+large, the effect of each datum is large and the curve approaches that
+produced by connecting consecutive points with natural cubic splines.
+If the weights are small, the curve is composed of fewer segments and
+thus is smoother; the limiting case is the single segment produced by a
+weighted linear least squares fit to all the data.  The smoothing weight
+can be expressed in terms of errors as a statistical weight for a point
+divided by a "smoothing factor" for the curve so that (standard) errors
+in the file can be used as smoothing weights.
+
+   Example:
+           sw(x,S)=1/(x*x*S)
+           plot 'data_file' using 1:2:(sw($3,100)) smooth acsplines
+           splot 'data_file' using 1:2:3:(sw($4,100)) smooth acsplines
+
+
+   'splot ...  smooth acsplines with lines' fits splines to the x, y,
+and z coordinates of successive data points.  Unlike the 2D case, the
+points are not sorted first so it is possible to fit splines to a
+trajectory containing loops.  Caution: In the general 3D case there are
+many more spline terms fitted, so the weight value must be larger to
+achieve a comparable effect.  Also note that fractional path length is
+used as the implicit control variable and therefore the intervals being
+weighted do not match the projections onto a single axis.
+
+-- BEZIER --
+
+   The 'smooth bezier' option approximates the data with a Bezier curve
+of degree n (the number of data points) that connects the endpoints.
+
+-- BINS --
+
+   'smooth bins' is the same as 'bins'.  See 'bins'.
+
+-- CSPLINES --
+
+   The 'smooth csplines' option connects consecutive points by natural
+cubic splines after rendering the data monotonic on x (see 'smooth
+unique').  The smoothed curve always passes through the data points, so
+closely-spaced points may generate local bumps and excursions in the
+smoothed curve.
+
+   'splot ...  smooth csplines with lines' fits splines to the x, y, and
+z coordinates of successive data points.  Unlike 2D csplines, the points
+are not sorted first so it is possible to fit splines to a trajectory
+containing loops.  In the general case three separate sets of spline
+coefficients are generated, each treating one coordinate x, y, or z as a
+function of a shared implicit trajectory path parameter.  This is
+equivalent to the 2D 'plot ...  smooth path' option.
+
+   In the special case that the curve lies in the xz, yz, or xy plane
+then only a single set of spline coefficients is generated.  This allows
+you to generate a stack of smoothed curves in 3D where each one
+replicates the spline fit you would have obtained from a 2D plot of the
+coordinates in projection.
+
+-- MCSPLINES --
+
+   The 'smooth mcsplines' option connects consecutive points by cubic
+splines constrained such that the smoothed function preserves the
+monotonicity and convexity of the original data points.  This reduces
+the effect of outliers.  FN Fritsch & RE Carlson (1980) "Monotone
+Piecewise Cubic Interpolation", SIAM Journal on Numerical Analysis 17:
+238–246.
+
+-- PATH --
+
+   The 'smooth path' option generates cubic splines to fit points in the
+order they are presented in the input data; i.e.  they are not first
+sorted on x.  This generates a smooth spline through a closed curve or
+along a trajectory that contains loops.  This smoothing mode is
+supported for both 2D and 3D plot commands.  A separate curve is created
+for each set of points in the input file, where a blank line separates
+the sets.  Plotting 'smooth path with filledcurves closed' will
+guarantee that each set of points creates a closed curve.  Plotting
+'smooth path with lines' will generate a closed curve if the first and
+last points in the set overlap, otherwise it will create an open-ended
+smooth path.  See smooth_path.dem
+(http://www.gnuplot.info/demo_6.0/smooth_path.html)
+
+-- SBEZIER --
+
+   The 'smooth sbezier' option first renders the data monotonic
+('unique') and then applies the 'bezier' algorithm.
+
+-- UNIQUE --
+
+   The 'smooth unique' option makes the data monotonic in x; points with
+the same x-value are replaced by a single point having the average
+y-value.  The resulting points are then connected by straight line
+segments.
+
+-- UNWRAP --
+
+   The 'smooth unwrap' option modifies the input data so that any two
+successive points will not differ by more than pi; a point whose y value
+is outside this range will be incremented or decremented by multiples of
+2pi until it falls within pi of the previous point.  This operation is
+useful for making wrapped phase measurements continuous over time.
+
+-- FREQUENCY --
+
+   The 'smooth frequency' option makes the data monotonic in x; points
+with the same x-value are replaced by a single point having the summed
+y-values.  To plot a histogram of the number of data values in equal
+size bins, set the y-value to 1.0 so that the sum is a count of
+occurrences in that bin.  This is done implicitly if only a single
+column is provided.  Example:
+          binwidth = <something>  # set width of x values in each bin
+          bin(val) = binwidth * floor(val/binwidth)
+          plot "datafile" using (bin(column(1))):(1.0) smooth frequency
+          plot "datafile" using (bin(column(1))) smooth frequency  # same result
+
+   See also smooth.dem (http://www.gnuplot.info/demo/smooth.html)
+
+-- FNORMAL --
+
+   The 'smooth fnormal' option work just like the 'frequency' option,
+but produces a normalized histogram.  It makes the data monotonic in x
+and normalises the y-values so they all sum to 1.  Points with the same
+x-value are replaced by a single point containing the sumed y-values.
+To plot a histogram of the number of data values in equal size bins, set
+the y-value to 1.0 so that the sum is a count of occurrences in that
+bin.  This is done implicitly if only a single column is provided.  See
+also smooth.dem (http://www.gnuplot.info/demo/smooth.html)
+
+-- CUMULATIVE --
+
+   The 'smooth cumulative' option makes the data monotonic in x; points
+with the same x-value are replaced by a single point containing the
+cumulative sum of y-values of all data points with lower x-values (i.e.
+to the left of the current data point).  This can be used to obtain a
+cumulative distribution function from data.  See also smooth.dem
+(http://www.gnuplot.info/demo/smooth.html)
+
+-- CNORMAL --
+
+   The 'smooth cnormal' option makes the data monotonic in x and
+normalises the y-values onto the range [0:1].  Points with the same
+x-value are replaced by a single point containing the cumulative sum of
+y-values of all data points with lower x-values (i.e.  to the left of
+the current data point) divided by the total sum of all y-values.  This
+can be used to obtain a normalised cumulative distribution function from
+data (useful when comparing sets of samples with differing numbers of
+members).  See also smooth.dem
+(http://www.gnuplot.info/demo/smooth.html)
+
+-- KDENSITY --
+
+   The 'smooth kdensity' option generates and plots a kernel density
+estimate using Gaussian kernels for the distribution from which a set of
+values was drawn.  Values are taken from the first data column, optional
+weights are taken from the second column.  A Gaussian is placed at the
+location of each point and the sum of all these Gaussians is plotted as
+a function.  To obtain a normalized histogram, each weight should be
+1/number-of-points.
+
+   Bandwidth: By default gnuplot calculates and uses the bandwidth which
+would be optimal for normally distributed data values.
+          default_bandwidth = sigma * (4/3N) ** (0.2)
+
+   This will usually be a very conservative, i.e.  broad bandwidth.
+Alternatively, you can provide an explicit bandwidth.
+          plot $DATA smooth kdensity bandwidth <value> with boxes
+
+   The bandwidth used in the previous plot is stored in
+GPVAL_KDENSITY_BANDWIDTH.
+
+   Period: For periodic data individual Gaussian components should be
+treated as repeating at intervals of one period.  One example is data
+measured as a function of angle, where the period is 2pi.  Another
+example is data indexed by day-of-year and measured over multiple years,
+where the period is 365.  In such cases the period should be provided in
+the plot command:
+          plot $ANGULAR_DAT smooth kdensity period 2*pi with lines
+
+
+
+File: gnuplot.info,  Node: special-filenames,  Next: piped-data,  Prev: smooth,  Up: data
+
+3.20.3.9 special-filenames
+..........................
+
+There are a few filenames that have a special meaning: ", '-', '+' and
+'++'.
+
+   The empty filename " tells gnuplot to re-use the previous input file
+in the same plot command.  So to plot two columns from the same input
+file:
+
+           plot 'filename' using 1:2, '' using 1:3
+
+
+   The filename can also be reused over subsequent plot commands,
+however *note save:: then only records the name in a comment.
+
+   The special filenames '+' and '++' are a mechanism to allow the full
+range of 'using' specifiers and plot styles with inline functions.
+Normally a function plot can only have a single y (or z) value
+associated with each sampled point.  The pseudo-file '+' treats the
+sampled points as column 1, and allows additional column values to be
+specified via a 'using' specification, just as for a true input file.
+The number of samples is controlled via *note samples:: or by giving an
+explicit sampling interval in the range specifier.  Samples are
+generated over the range given by *note trange:: if it has been set,
+otherwise over the full range of *note xrange::.
+
+   Note: The use of trange is a change from some earlier gnuplot
+versions.  It allows the sampling range to differ from the x axis range.
+
+           plot '+' using ($1):(sin($1)):(sin($1)**2) with filledcurves
+
+
+   An independent sampling range can be provided immediately before the
+'+'.  As in normal function plots, a name can be assigned to the
+independent variable.  If given for the first plot element, the sampling
+range specifier has to be preceded by the 'sample' keyword (see also
+*note sampling::).
+
+           plot sample [beta=0:2*pi] '+' using (sin(beta)):(cos(beta)) with lines
+
+
+   Here is an example where the sampling interval (1.5) is given as part
+of the sampling range.  Samples will be generated at -3, -1.5, 0, 1.5,
+..., 24.
+
+           plot $MYDATA, [t=-3:25:1.5] '+' using (t):(f(t))
+
+
+   The pseudo-file '++' returns 2 columns of data forming a regular grid
+of [u,v] coordinates with the number of points along u controlled by
+*note samples:: and the number of points along v controlled by *note
+isosamples::.  You must set urange and vrange before plotting '++'.
+However the x and y ranges can be autoscaled or can be explicitly set to
+different values than urange and vrange.  Examples:
+
+           splot '++' using 1:2:(sin($1)*sin($2)) with pm3d
+           plot '++' using 1:2:(sin($1)*sin($2)) with image
+
+
+   The special filename ''-'' specifies that the data are inline; i.e.,
+they follow the command.  Only the data follow the command; 'plot'
+options like filters, titles, and line styles remain on the 'plot'
+command line.  This is similar to << in unix shell script.  The data are
+entered as though they were being read from a file, one data point per
+record.  The letter "e" at the start of the first column terminates data
+entry.
+
+   ''-'' is intended for situations where it is useful to have data and
+commands together, e.g.  when both are piped to 'gnuplot' from another
+application.  Some of the demos, for example, might use this feature.
+While 'plot' options such as *note index:: and *note every:: are
+recognized, their use forces you to enter data that won't be used.  For
+all but the simplest cases it is probably easier to first define a
+datablock and then read from it rather than from ''-''.  See
+'datablocks'.
+
+   If you use ''-'' with *note replot::, you may need to enter the data
+more than once.  See *note replot::, *note refresh::.  Here again it may
+be better to use a datablock.
+
+   A blank filename (") specifies that the previous filename should be
+reused.  This can be useful with things like
+
+           plot 'a/very/long/filename' using 1:2, '' using 1:3, '' using 1:4
+
+
+   If you use both ''-'' and '"' on the same 'plot' command, you'll need
+to provide two sets of inline data.  It will not reuse the first one.
+
+
+File: gnuplot.info,  Node: piped-data,  Next: using,  Prev: special-filenames,  Up: data
+
+3.20.3.10 piped-data
+....................
+
+On systems with a popen function, the datafile can be piped through a
+shell command by starting the file name with a '<'.  For example,
+
+           pop(x) = 103*exp(-x/10)
+           plot "< awk '{print $1-1965, $2}' population.dat", pop(x)
+
+
+   would plot the same information as the first population example but
+with years since 1965 as the x axis.  If you want to execute this
+example, you have to delete all comments from the data file above or
+substitute the following command for the first part of the command above
+(the part up to the comma):
+
+           plot "< awk '$0 !~ /^#/ {print $1-1965, $2}' population.dat"
+
+
+   While this approach is most flexible, it is possible to achieve
+simple filtering with the 'using' keyword.
+
+   On systems with an fdopen() function, data can be read from an
+arbitrary file descriptor attached to either a file or pipe.  To read
+from file descriptor 'n' use ''<&n''.  This allows you to easily pipe in
+several data files in a single call from a POSIX shell:
+
+           $ gnuplot -p -e "plot '<&3', '<&4'" 3<data-3 4<data-4
+           $ ./gnuplot 5< <(myprogram -with -options)
+           gnuplot> plot '<&5'
+
+
+
+File: gnuplot.info,  Node: using,  Next: volatile,  Prev: piped-data,  Up: data
+
+3.20.3.11 using
+...............
+
+The most common datafile modifier is 'using'.  It tells the program
+which columns of data in the input file are to be plotted.
+
+   Syntax:
+           plot 'file' using <entry> {:<entry> {:<entry> ...}} {'format'}
+
+
+   Each <entry> may be a simple column number that selects the value
+from one field of the input file, a string that matches a column label
+in the first line of a data set, an expression enclosed in parentheses,
+or a special function not enclosed in parentheses such as xticlabels(2).
+
+   If the entry is an expression in parentheses, then the function
+column(N) may be used to indicate the value in column N. That is,
+column(1) refers to the first item read, column(2) to the second, and so
+on.  The special symbols $1, $2, ...  are shorthand for column(1),
+column(2) ...
+
+   The special symbol $# evaluates to the total number of columns in the
+current line of input, so column($#) or stringcolumn($#) always returns
+the content of the final column even if the number of columns is unknown
+or different lines in the file contain different numbers of columns.
+
+   The function 'valid(N)' tests whether column N contains a valid
+number.  It returns 0 if the column value is missing, uninterpretable,
+or NaN.
+
+   If each column of data in the input file contains a label in the
+first row rather than a data value, this label can be used to identify
+the column on input and/or in the plot legend.  The column() function
+can be used to select an input column by label rather than by column
+number.  For example, if the data file contains
+           Height    Weight    Age
+           val1      val1      val1
+           ...       ...       ...
+
+   then the following plot commands are all equivalent
+           plot 'datafile' using 3:1, '' using 3:2
+           plot 'datafile' using (column("Age")):(column(1)), \
+                        '' using (column("Age")):(column(2))
+           plot 'datafile' using "Age":"Height", '' using "Age":"Weight"
+
+
+   The full string must match.  Comparison is case-sensitive.  To use
+column labels in the plot legend, use 'set key autotitle columnhead' or
+use function 'columnhead(N)' when specifying an individual title.
+
+   In addition to the actual columns 1...N in the input data file,
+gnuplot presents data from several "pseudo-columns" that hold
+bookkeeping information.  E.g.  $0 or column(0) returns the sequence
+number of this data record within a dataset.  Please see
+'pseudocolumns'.
+
+   An empty <entry> will default to its order in the list of entries.
+For example, 'using ::4' is interpreted as 'using 1:2:4'.
+
+   If the 'using' list has only a single entry, that <entry> will be
+used for y and the data point number (pseudo-column $0) is used for x;
+for example, "'plot 'file' using 1'" is identical to "'plot 'file' using
+0:1'".  If the 'using' list has two entries, these will be used for x
+and y.  See *note style:: and *note fit:: for details about plotting
+styles that make use of data from additional columns of input.
+
+-- FORMAT --
+
+   If a format is specified, it is used to read in each datafile record
+using the C library 'scanf' function.  Otherwise the record is
+interpreted as consisting of columns (fields) of data separated by
+whitespace (spaces and/or tabs), but see 'datafile separator'.
+
+   'scanf' itself accepts several numerical specifications but 'gnuplot'
+requires all inputs to be double-precision floating-point variables, so
+"%lf" is essentially the only permissible specifier.  The format string
+must contain at least one such input specifier and no more than seven of
+them.  'scanf' expects to see white space - a blank, tab ("\t"), newline
+("\n"), or formfeed ("\f") - between numbers; anything else in the input
+stream must be explicitly skipped.
+
+   Note that the use of "\t", "\n", or "\f" requires use of
+double-quotes rather than single-quotes.
+
+-- USING_EXAMPLES --
+
+   This creates a plot of the sum of the 2nd and 3rd data against the
+first: The format string specifies comma- rather than space-separated
+columns.  The same result could be achieved by specifying 'set datafile
+separator comma'.
+           plot 'file' using 1:($2+$3) '%lf,%lf,%lf'
+
+
+   In this example the data are read from the file "MyData" using a more
+complicated format:
+           plot 'MyData' using "%*lf%lf%*20[^\n]%lf"
+
+
+   The meaning of this format is:
+
+           %*lf        ignore a number
+           %lf         read a double-precision number (x by default)
+           %*20[^\n]   ignore 20 non-newline characters
+           %lf         read a double-precision number (y by default)
+
+
+   One trick is to use the ternary '?:' operator to filter data:
+
+           plot 'file' using 1:($3>10 ? $2 : 1/0)
+
+
+   which plots the datum in column two against that in column one
+provided the datum in column three exceeds ten.  '1/0' is undefined;
+'gnuplot' quietly ignores undefined points, so unsuitable points are
+suppressed.  Or you can use the pre-defined variable NaN to achieve the
+same result.
+
+   In fact, you can use a constant expression for the column number,
+provided it doesn't start with an opening parenthesis; constructs like
+'using 0+(complicated expression)' can be used.  The crucial point is
+that the expression is evaluated once if it doesn't start with a left
+parenthesis, or once for each data point read if it does.
+
+   If timeseries data are being used, the time can span multiple
+columns.  The starting column should be specified.  Note that the spaces
+within the time must be included when calculating starting columns for
+other data.  E.g., if the first element on a line is a time with an
+embedded space, the y value should be specified as column three.
+
+   It should be noted that (a) 'plot 'file'', (b) 'plot 'file' using
+1:2', and (c) 'plot 'file' using ($1):($2)' can be subtly different.
+See 'missing'.
+
+   It is often possible to plot a file with lots of lines of garbage at
+the top simply by specifying
+
+           plot 'file' using 1:2
+
+
+   However, if you want to leave text in your data files, it is safer to
+put the comment character (#) in the first column of the text lines.
+
+-- PSEUDOCOLUMNS --
+
+   Expressions in the 'using' clause of a plot statement can refer to
+additional bookkeeping values in addition to the actual data values
+contained in the input file.  These are contained in "pseudocolumns".
+           column(0)   The sequential order of each point within a data set.
+                       The counter starts at 0, increments on each non-blank,
+                       non-comment line, and is reset by two sequential blank
+                       records. For data in non-uniform matrix format, column(0)
+                       is the linear order of each matrix element.
+                       The shorthand form $0 is available.
+           column(-1)  This counter starts at 0, increments on a single blank line,
+                       and is reset by two sequential blank lines.
+                       This corresponds to the data line in array or grid data.
+                       It can also be used to distinguish separate line segments
+                       or polygons within a data set.
+           column(-2)  Starts at 0 and increments on two sequential blank lines.
+                       This is the index number of the current data set within a
+                       file that contains multiple data sets.  See *note index::.
+           column($#)  The special symbol $# evaluates to the total number of
+                       columns available, so column($#) refers to the last
+                       (rightmost) field in the current input line.
+                       column($# - 1) would refer to the last-but-one column, etc.
+
+
+-- ARRAYS --
+
+   When the data source being plotted is an array or array-valued
+function, the "columns" in a 'using' specification are interpreted as
+below.  See *note arrays:: for more detail.
+           column 1   the array index
+           column 2   the real component of a numerical array entry
+                      or the string value of a string array entry
+           column 3   the imaginary part of a numerical array entry
+
+
+-- KEY --
+
+   The layout of certain plot styles (column-stacked histograms, spider
+plots) is such that it would make no sense to generate plot titles from
+a data column header.  Also it would make no sense to generate axis tic
+labels from the content of a data column (e.g.  'using
+2:3:xticlabels(1)').  These plots styles instead use the form 'using
+2:3:key(1)' to generate plot titles for the key from the text content of
+a data column, usually a first column of row headers.  See the example
+given for *note spiderplot::.
+
+-- XTICLABELS --
+
+   Axis tick labels can be generated via a string function, usually
+taking a data column as an argument.  The simplest form uses the data
+column itself as a string.  That is, xticlabels(N) is shorthand for
+xticlabels(stringcolumn(N)). This example uses the contents of column 3
+as x-axis tick labels.
+
+           plot 'datafile' using <xcol>:<ycol>:xticlabels(3) with <plotstyle>
+
+
+   Axis tick labels may be generated for any of the plot axes: x x2 y y2
+z.  The 'ticlabels(<labelcol>)' specifiers must come after all of the
+data coordinate specifiers in the 'using' portion of the command.  For
+each data point which has a valid set of X,Y[,Z] coordinates, the string
+value given to xticlabels() is added to the list of xtic labels at the
+same X coordinate as the point it belongs to.  'xticlabels()' may be
+shortened to 'xtic()' and so on.
+
+   Example:
+
+           splot "data" using 2:4:6:xtic(1):ytic(3):ztic(6)
+
+
+   In this example the x and y axis tic labels are taken from different
+columns than the x and y coordinate values.  The z axis tics, however,
+are generated from the z coordinate of the corresponding point.
+
+   Example:
+
+           plot "data" using 1:2:xtic( $3 > 10. ? "A" : "B" )
+
+
+   This example shows the use of a string-valued function to generate
+x-axis tick labels.  Each point in the data file generates a tick mark
+on x labeled either "A" or "B" depending on the value in column 3.
+
+-- X2TICLABELS --
+
+   See 'plot using xticlabels'.
+
+-- YTICLABELS --
+
+   See 'plot using xticlabels'.
+
+-- Y2TICLABELS --
+
+   See 'plot using xticlabels'.
+
+-- ZTICLABELS --
+
+   See 'plot using xticlabels'.
+
+
+File: gnuplot.info,  Node: volatile,  Prev: using,  Up: data
+
+3.20.3.12 volatile
+..................
+
+The *note volatile:: keyword in a plot command indicates that the data
+previously read from the input stream or file may not be available for
+re-reading.  This tells the program to use *note refresh:: rather than
+*note replot:: commands whenever possible.  See *note refresh::.
+
+
+File: gnuplot.info,  Node: functions,  Next: parametric,  Prev: data,  Up: plot
+
+3.20.4 functions
+----------------
+
+Built-in or user-defined functions can be displayed by the 'plot' and
+'splot' commands in addition to, or instead of, data read from a file.
+The requested function is evaluated by sampling at regular intervals
+spanning the independent axis range[s].  See *note samples:: and *note
+isosamples::.  Example:
+           approx(ang) = ang - ang**3 / (3*2)
+           plot sin(x) title "sin(x)", approx(x) title "approximation"
+
+
+   To set a default plot style for functions, see 'set style function'.
+For information on built-in functions, see *note functions::.  For
+information on defining your own functions, see 'user-defined'.
+
+
+File: gnuplot.info,  Node: parametric,  Next: ranges,  Prev: functions,  Up: plot
+
+3.20.5 parametric
+-----------------
+
+When in parametric mode (*note parametric::) mathematical expressions
+must be given in pairs for 'plot' and in triplets for 'splot'.
+
+   Examples:
+           plot sin(t),t**2
+           splot cos(u)*cos(v),cos(u)*sin(v),sin(u)
+
+
+   Data files are plotted as before, except any preceding parametric
+function must be fully specified before a data file is given as a plot.
+In other words, the x parametric function ('sin(t)' above) and the y
+parametric function ('t**2' above) must not be interrupted with any
+modifiers or data functions; doing so will generate a syntax error
+stating that the parametric function is not fully specified.
+
+   Other modifiers, such as 'with' and *note title::, may be specified
+only after the parametric function has been completed:
+
+           plot sin(t),t**2 title 'Parametric example' with linespoints
+
+
+   See also Parametric Mode Demos.
+(http://www.gnuplot.info/demo/param.html)
+
+
+File: gnuplot.info,  Node: ranges,  Next: sampling,  Prev: parametric,  Up: plot
+
+3.20.6 ranges
+-------------
+
+This section describes only the optional axis ranges that may appear as
+the very first items in a 'plot' or 'splot' command.  If present, these
+ranges override any range limits established by a previous 'set range'
+statement.  For optional ranges elsewhere in a 'plot' command that limit
+sampling of an individual plot component, see *note sampling::.
+
+   Syntax:
+           [{<dummy-var>=}{{<min>}:{<max>}}]
+           [{{<min>}:{<max>}}]
+
+
+   The first form applies to the independent variable (*note xrange:: or
+*note trange::, if in parametric mode).  The second form applies to
+dependent variables.  <dummy-var> optionally establishes a new name for
+the independent variable.  (The default name may be changed with *note
+dummy::.)
+
+   In non-parametric mode, ranges must be given in the order
+           plot [<xrange>][<yrange>][<x2range>][<y2range>] ...
+
+
+   In parametric mode, ranges must be given in the order
+           plot [<trange>][<xrange>][<yrange>][<x2range>][<y2range>] ...
+
+   The following 'plot' command shows setting *note trange:: to
+[-pi:pi], *note xrange:: to [-1.3:1.3] and *note yrange:: to [-1:1] for
+the duration of the graph:
+
+           plot [-pi:pi] [-1.3:1.3] [-1:1] sin(t),t**2
+
+
+   '*' can be used to allow autoscaling of either of min and max.  Use
+an empty range '[]' as a placeholder if necessary.
+
+   Ranges specified on the 'plot' or 'splot' command line affect only
+that one graph; use the *note xrange::, *note yrange::, etc., commands
+to change the default ranges for future graphs.
+
+   The use of on-the-fly range specifiers in a plot command may not
+yield the expected result for linked axes (see *note link::).
+
+   For time data you must provide the range in quotes, using the same
+format used to read time from the datafile.  See *note timefmt::.
+
+   Examples:
+
+   This uses the current ranges:
+           plot cos(x)
+
+
+   This sets the x range only:
+           plot [-10:30] sin(pi*x)/(pi*x)
+
+
+   This is the same, but uses t as the dummy-variable:
+           plot [t = -10 :30]  sin(pi*t)/(pi*t)
+
+
+   This sets both the x and y ranges:
+           plot [-pi:pi] [-3:3]  tan(x), 1/x
+
+
+   This sets only the y range:
+           plot [ ] [-2:sin(5)*-8] sin(x)**besj0(x)
+
+
+   This sets xmax and ymin only:
+           plot [:200] [-pi:]  $mydata using 1:2
+
+
+   This sets the x range for a timeseries:
+           set timefmt "%d/%m/%y %H:%M"
+           plot ["1/6/93 12:00":"5/6/93 12:00"] 'timedata.dat'
+
+
+
+File: gnuplot.info,  Node: sampling,  Next: for_loops_in_plot_command,  Prev: ranges,  Up: plot
+
+3.20.7 sampling
+---------------
+
+* Menu:
+
+* 1D_sampling_(x_or_t_axis)::
+* 2D_sampling_(u_and_v_axes)::
+
+
+File: gnuplot.info,  Node: 1D_sampling_(x_or_t_axis),  Next: 2D_sampling_(u_and_v_axes),  Prev: sampling,  Up: sampling
+
+3.20.7.1 1D sampling (x or t axis)
+..................................
+
+By default, computed functions are sampled over the entire range of the
+plot as set by a prior *note xrange:: command, by an x-axis range
+specifier at the very start of the plot command, or by autoscaling the
+xrange to span data seen in all the elements of this plot.  Points
+generated by the pseudo-file "+" are sampled over the current range of
+the t axis, which may or may not be the same as the range of the x axis.
+
+   Individual plot components can be assigned a more restricted sampling
+range.
+
+   Examples:
+
+   This establishes a total range on x running from 0 to 1000 and then
+plots data from a file and two functions each spanning a portion of the
+total range:
+           set xrange [0:1000]
+           plot 'datafile', [0:200] func1(x), [200:500] func2(x)
+
+
+   This is similar except that the total range is established by the
+contents of the data file.  In this case the sampled functions may or
+may not be entirely contained in the plot:
+           set autoscale x
+           plot 'datafile', [0:200] func1(x), [200:500] func2(x)
+
+
+   The plot command below is ambiguous.  The initial range [0:10] will
+be interpreted as applying to the entire plot, overriding the previous
+xrange command, rather than applying solely to the sampling of the first
+function as was probably the intent:
+           set xrange [0:50]
+           plot [0:10] f(x), [10:20] g(x), [20:30] h(x)
+
+
+   To remove the ambiguity in the previous example, insert the keyword
+'sample' to indicate that [0:10] is a sampling range applied to a single
+plot component rather than a global x-axis range that would apply to the
+entire plot.
+           plot sample [0:10] f(x), [10:20] g(x), [20:30] h(x)
+
+
+   This example shows one way of tracing out a helix in a 3D plot
+           set xrange [-2:2]; set yrange [-2:2]
+           splot sample [h=1:10] '+' using (cos(h)):(sin(h)):(h)
+
+
+
+File: gnuplot.info,  Node: 2D_sampling_(u_and_v_axes),  Prev: 1D_sampling_(x_or_t_axis),  Up: sampling
+
+3.20.7.2 2D sampling (u and v axes)
+...................................
+
+Computed functions or data generated for the pseudo-file '++' use
+samples generated along the u and v axes.  See 'special-filenames ++'.
+2D sampling can be used in either 'plot' or 'splot' commands.
+
+   Example of 2D sampling in a 2D 'plot' command.  These commands
+generated the plot shown for plotstyle *note vectors::.  See *note
+vectors::.
+          set urange [ -2.0 : 2.0 ]
+          set vrange [ -2.0 : 2.0 ]
+          plot '++' using ($1):($2):($2*0.4):(-$1*0.4) with vectors
+
+
+   Example of 2D sampling in a 3D 'splot' command.  These commands are
+similar to the ones used in 'sampling.dem'.  Note that the two surfaces
+are sampled over u and v ranges smaller than the full x and y ranges of
+the resulting plot.
+          set title "3D sampling range distinct from plot x/y range"
+          set xrange [1:100]
+          set yrange [1:100]
+          splot sample [u=30:70][v=0:50] '++' using 1:2:(u*v) lt 3, \
+                [u=40:80][v=30:60] '++' using (u):(v):(u*sqrt(v)) lt 4
+
+
+   The range specifiers for sampling on u and v can include an explicit
+sampling interval to control the number and spacing of samples:
+          splot sample [u=30:70:1][v=0:50:5] '++' using 1:2:(func($1,$2))
+
+
+
+File: gnuplot.info,  Node: for_loops_in_plot_command,  Next: title,  Prev: sampling,  Up: plot
+
+3.20.8 for loops in plot command
+--------------------------------
+
+If many similar files or functions are to be plotted together, it may be
+convenient to do so by iterating over a shared plot command.
+
+   Syntax:
+           plot for [<variable> = <start> : <end> {:<increment>}]
+           plot for [<variable> in "string of words"]
+
+
+   The scope of an iteration ends at the next comma or the end of the
+command, whichever comes first.  An exception to this is that
+definitions are grouped with the following plot item even if there is an
+intervening comma.  Note that iteration does not work for plots in
+parametric mode.
+
+   Example:
+           plot for [j=1:3] sin(j*x)
+
+
+   Example:
+           plot for [dataset in "apples bananas"] dataset."dat" title dataset
+
+
+   In this example iteration is used both to generate a file name and a
+corresponding title.
+
+   Example:
+           file(n) = sprintf("dataset_%d.dat",n)
+           splot for [i=1:10] file(i) title sprintf("dataset %d",i)
+
+
+   This example defines a string-valued function that generates file
+names, and plots ten such files together.  The iteration variable ('i'
+in this example) is treated as an integer, and may be used more than
+once.
+
+   Example:
+           set key left
+           plot for [n=1:4] x**n sprintf("%d",n)
+
+
+   This example plots a family of functions.
+
+   Example:
+           list = "apple banana cabbage daikon eggplant"
+           item(n) = word(list,n)
+           plot for [i=1:words(list)] item[i].".dat" title item(i)
+           list = "new stuff"
+           replot
+
+
+   This example steps through a list and plots once per item.  Because
+the items are retrieved dynamically, you can change the list and then
+replot.
+
+   Example:
+           list = "apple banana cabbage daikon eggplant"
+           plot for [i in list] i.".dat" title i
+           list = "new stuff"
+           replot
+
+
+   This example does exactly the same thing as the previous example, but
+uses the string iterator form of the command rather than an integer
+iterator.
+
+   If an iteration is to continue until all available data is consumed,
+use the symbol * instead of an integer <end>.  This can be used to
+process all columns in a line, all datasets (separated by 2 blank lines)
+in a file, or all files matching a template.
+
+   Examples:
+           plot for [file in "A.dat B.dat"] for [column=2:*] file using 1:column
+           splot for [i=0:*] 'datafile' index i using 1:2:3 with lines
+           plot for [i=1:*] file=sprintf("File_%03d.dat",i) file using 2 title file
+
+
+   Caveat: You can nest iterations where one is open-ended, as in the
+first example above.  However nesting an open-ended iteration inside
+another open-ended iteration is probably not useful, since both will
+terminate at the same time when no data is found.  The program will
+issue a warning if this happens.
+
+
+File: gnuplot.info,  Node: title,  Next: with,  Prev: for_loops_in_plot_command,  Up: plot
+
+3.20.9 title
+------------
+
+By default each plot is listed in the key by the corresponding function
+or file name.  You can give an explicit plot title instead using the
+*note title:: option.
+
+   Syntax:
+           title <text> | notitle [<ignored text>]
+           title columnheader | title columnheader(N)
+                 {at {beginning|end}} {{no}enhanced}
+
+
+   where <text> is a quoted string or an expression that evaluates to a
+string.  The quotes will not be shown in the key.
+
+   There is also an option that will interpret the first entry in a
+column of input data (i.e.  the column header) as a text field, and use
+it as the key title.  See 'datastrings'.  This can be made the default
+by specifying 'set key autotitle columnhead'.
+
+   The line title and sample can be omitted from the key by using the
+keyword 'notitle'.  A null title ('title "') is equivalent to 'notitle'.
+If only the sample is wanted, use one or more blanks ('title ' '').  If
+'notitle' is followed by a string this string is ignored.
+
+   If 'key autotitles' is set (which is the default) and neither *note
+title:: nor 'notitle' are specified the line title is the function name
+or the file name as it appears on the 'plot' command.  If it is a file
+name, any datafile modifiers specified will be included in the default
+title.
+
+   The layout of the key itself (position, title justification, etc.)
+can be controlled using 'set key'.
+
+   The 'at' keyword allows you to place the plot title somewhere outside
+the auto-generated key box.  The title can be placed immediately before
+or after the line in the graph itself by using 'at {beginning|end}'.
+This option may be useful when plotting 'with lines' but makes little
+sense for most other styles.
+
+   To place the plot title at an arbitrary location on the page, use the
+form 'at <x-position>,<y-position>'.  By default the position is
+interpreted in screen coordinates; e.g.  'at 0.5, 0.5' is always the
+middle of the screen regardless of plot axis scales or borders.  The
+format of titles placed in this way is still affected by key options.
+See 'set key'.
+
+   Examples:
+
+   This plots y=x with the title 'x':
+           plot x
+
+
+   This plots x squared with title "x^2" and file "data.1" with title
+"measured data":
+           plot x**2 title "x^2", 'data.1' t "measured data"
+
+
+   Plot multiple columns of data, each of which contains its own title
+on the first line of the file.  Place the titles after the corresponding
+lines rather than in a separate key:
+           unset key
+           set offset 0, graph 0.1
+           plot for [i=1:4] 'data' using i with lines title columnhead at end
+
+
+   Create a single key area for two separate plots:
+           set key Left reverse
+           set multiplot layout 2,2
+           plot sin(x) with points pt 6 title "Left plot is sin(x)" at 0.5, 0.30
+           plot cos(x) with points pt 7 title "Right plot is cos(x)" at 0.5, 0.27
+           unset multiplot
+
+
+
+File: gnuplot.info,  Node: with,  Prev: title,  Up: plot
+
+3.20.10 with
+------------
+
+Functions and data may be displayed in one of a large number of styles.
+The 'with' keyword provides the means of selection.
+
+   Syntax:
+           with <style> { {linestyle | ls <line_style>}
+                          | {{linetype  | lt <line_type>}
+                             {linewidth | lw <line_width>}
+                             {linecolor | lc <colorspec>}
+                             {pointtype | pt <point_type>}
+                             {pointsize | ps <point_size>}
+                             {arrowstyle | as <arrowstyle_index>}
+                             {fill | fs <fillstyle>} {fillcolor | fc <colorspec>}
+                             {nohidden3d} {nocontours} {nosurface}
+                             {palette}}
+                        }
+
+
+   where <style> is one of
+          lines        dots       steps     vectors      yerrorlines
+          points       impulses   fsteps    xerrorbar    xyerrorbars
+          linespoints  labels     histeps   xerrorlines  xyerrorlines
+          financebars  surface    arrows    yerrorbar    parallelaxes
+
+   or
+          boxes         boxplot        ellipses       histograms  rgbalpha
+          boxerrorbars  candlesticks   filledcurves   image       rgbimage
+          boxxyerror    circles        fillsteps      pm3d        polygons
+          isosurface    zerrorfill
+
+   or
+          table         mask
+
+
+   The first group of styles have associated line, point, and text
+properties.  The second group of styles also have fill properties.  See
+'fillstyle'.  Some styles have further sub-styles.  See 'plotting
+styles' for details of each.  Two special styles produce no immediate
+plot.  See *note table:: and 'with mask'.  The *note table:: style
+produces tabular output to a text file or data block.  A plot component
+whose style is 'with mask' defines a set of polygonal regions that can
+be used to mask subsequent plot elements.
+
+   A default style may be chosen by 'set style function' and 'set style
+data'.
+
+   By default, each function and data file will use a different line
+type and point type, up to the maximum number of available types.  All
+terminal drivers support at least six different point types, and re-use
+them, in order, if more are required.  To see the complete set of line
+and point types available for the current terminal, type 'test'.
+
+   If you wish to choose the line or point type for a single plot,
+<line_type> and <point_type> may be specified.  These are positive
+integer constants (or expressions) that specify the line type and point
+type to be used for the plot.  Use 'test' to display the types available
+for your terminal.
+
+   You may also scale the line width and point size for a plot by using
+<line_width> and <point_size>, which are specified relative to the
+default values for each terminal.  The pointsize may also be altered
+globally--see *note pointsize:: for details.  But note that both
+<point_size> as set here and as set by *note pointsize:: multiply the
+default point size; their effects are not cumulative.  That is, 'set
+pointsize 2; plot x with points ps 3' will use points three times the
+default size, not six.
+
+   It is also possible to specify 'pointsize variable' either as part of
+a line style or for an individual plot.  In this case one extra column
+of input is required, i.e.  3 columns for a 2D plot and 4 columns for a
+3D splot.  The size of each individual point is determined by
+multiplying the global pointsize by the value read from the data file.
+
+   If you have defined specific line type/width and point type/size
+combinations with 'set style line', one of these may be selected by
+setting <line_style> to the index of the desired style.
+
+   Both 2D and 3D plots ('plot' and 'splot' commands) can use colors
+from a smooth palette set previously with the command *note palette::.
+The color value corresponds to the z-value of the point itself or to a
+separate color coordinate provided in an optional additional 'using'
+column.  Color values may be treated either as a fraction of the palette
+range ('palette frac') or as a coordinate value mapped onto the colorbox
+range (*note palette:: or 'palette z').  See *note colorspec::, *note
+palette::, 'linetypes'.
+
+   The keyword 'nohidden3d' applies only to plots made with the 'splot'
+command.  Normally the global option *note hidden3d:: applies to all
+plots in the graph.  You can attach the 'nohidden3d' option to any
+individual plots that you want to exclude from the hidden3d processing.
+The individual elements other than surfaces (i.e.  lines, dots, labels,
+...)  of a plot marked 'nohidden3d' will all be drawn, even if they
+would normally be obscured by other plot elements.
+
+   Similarly, the keyword 'nocontours' will turn off contouring for an
+individual plot even if the global property 'set contour' is active.
+
+   Similarly, the keyword 'nosurface' will turn off the 3D surface for
+an individual plot even if the global property 'set surface' is active.
+
+   The keywords may be abbreviated as indicated.
+
+   Note that the 'linewidth', *note pointsize:: and *note palette::
+options are not supported by all terminals.
+
+   Examples:
+
+   This plots sin(x) with impulses:
+           plot sin(x) with impulses
+
+
+   This plots x with points, x**2 with the default:
+           plot x w points, x**2
+
+
+   This plots tan(x) with the default function style, file "data.1" with
+lines:
+           plot tan(x), 'data.1' with l
+
+
+   This plots "leastsq.dat" with impulses:
+           plot 'leastsq.dat' w i
+
+
+   This plots the data file "population" with boxes:
+           plot 'population' with boxes
+
+
+   This plots "exper.dat" with errorbars and lines connecting the points
+(errorbars require three or four columns):
+           plot 'exper.dat' w lines, 'exper.dat' notitle w errorbars
+
+
+   Another way to plot "exper.dat" with errorlines (errorbars require
+three or four columns):
+           plot 'exper.dat' w errorlines
+
+
+   This plots sin(x) and cos(x) with linespoints, using the same line
+type but different point types:
+           plot sin(x) with linesp lt 1 pt 3, cos(x) with linesp lt 1 pt 4
+
+
+   This plots file "data" with points of type 3 and twice usual size:
+           plot 'data' with points pointtype 3 pointsize 2
+
+
+   This plots file "data" with variable pointsize read from column 4
+           plot 'data' using 1:2:4 with points pt 5 pointsize variable
+
+
+   This plots two data sets with lines differing only by weight:
+           plot 'd1' t "good" w l lt 2 lw 3, 'd2' t "bad" w l lt 2 lw 1
+
+
+   This plots filled curve of x*x and a color stripe:
+           plot x*x with filledcurve closed, 40 with filledcurve y=10
+
+
+   This plots x*x and a color box:
+           plot x*x, (x>=-5 && x<=5 ? 40 : 1/0) with filledcurve y=10 lt 8
+
+
+   This plots a surface with color lines:
+           splot x*x-y*y with line palette
+
+
+   This plots two color surfaces at different altitudes:
+           splot x*x-y*y with pm3d, x*x+y*y with pm3d at t
+
+
+
+File: gnuplot.info,  Node: print,  Next: printerr,  Prev: plot,  Up: Commands
+
+3.21 print
+==========
+
+Syntax:
+           print <expression> {, <expression>, ...}
+
+
+   The 'print' command prints the value of one or more expressions.
+Output is to the screen unless it has been redirected using the 'set
+print' command.  See 'expressions'.  See also *note printerr::.
+
+   An <expression> may be any valid gnuplot expression, including
+numeric or string constants, a function returning a number or string, an
+array, or the name of a variable.  It is also possible to print a
+datablock.  The sprintf and gprintf functions can be used in conjunction
+with 'print' for additional flexibility in formatting the output.
+
+   You can use iteration within a print command to include multiple
+values on a single line of output.
+
+   Examples:
+          print 123 + 456
+          print sinh(pi/2)
+          print "rms of residuals (FIT_STDFIT) is ", FIT_STDFIT
+          print sprintf("rms of residuals is %.3f after fit", FIT_STDFIT)
+          print "Array A: ", A
+          print "Individual elements of array A: ", for [i=1:|A|] A[i]
+          print $DATA
+
+
+
+File: gnuplot.info,  Node: printerr,  Next: pwd,  Prev: print,  Up: Commands
+
+3.22 printerr
+=============
+
+*note printerr:: is the same as 'print' except that output is always
+sent to stderr even while redirection from a prior 'set print' command
+remains in effect.  Use the 'warn' command instead if you want the
+output to include the current filename (or function block name) and line
+number.
+
+
+File: gnuplot.info,  Node: pwd,  Next: quit,  Prev: printerr,  Up: Commands
+
+3.23 pwd
+========
+
+The *note pwd:: command prints the name of the working directory to the
+screen.
+
+   Note that if you wish to store the current directory into a string
+variable or use it in string expressions, then you can use variable
+GPVAL_PWD, see 'show variables all'.
+
+
+File: gnuplot.info,  Node: quit,  Next: raise,  Prev: pwd,  Up: Commands
+
+3.24 quit
+=========
+
+*note quit:: is a synonym for the *note exit:: command.  See *note
+exit::.
+
+
+File: gnuplot.info,  Node: raise,  Next: refresh,  Prev: quit,  Up: Commands
+
+3.25 raise
+==========
+
+Syntax:
+           raise {plot_window_id}
+           lower {plot_window_id}
+
+
+   The *note raise:: and *note lower:: commands function for only a few
+terminal types and may depend also on your window manager and display
+preference settings.
+           set term wxt 123     # create first plot window
+           plot $FOO
+           lower                # lower the only plot window that exists so far
+           set term wxt 456     # create 2nd plot window may occlude the first one
+           plot $BAZ
+           raise 123            # raise first plot window
+
+   These commands are known to be unreliable.
+
+
+File: gnuplot.info,  Node: refresh,  Next: remultiplot,  Prev: raise,  Up: Commands
+
+3.26 refresh
+============
+
+The *note refresh:: command is similar to *note replot::, with two major
+differences.  *note refresh:: reformats and redraws the current plot
+using the data already read in.  This means that you can use *note
+refresh:: for plots with inline data (pseudo-device '-') and for plots
+from datafiles whose contents are volatile.  You cannot use the *note
+refresh:: command to add new data to an existing plot.
+
+   Mousing operations, in particular zoom and unzoom, will use *note
+refresh:: rather than *note replot:: if appropriate.  Example:
+
+           plot 'datafile' volatile with lines, '-' with labels
+           100 200 "Special point"
+           e
+           # Various mousing operations go here
+           set title "Zoomed in view"
+           set term post
+           set output 'zoom.ps'
+           refresh
+
+
+
+File: gnuplot.info,  Node: remultiplot,  Next: replot,  Prev: refresh,  Up: Commands
+
+3.27 remultiplot
+================
+
+*note remultiplot:: replays a sequence of commands that were previously
+stored into the datablock named $GPVAL_LAST_MULTIPLOT during generation
+of the previous multiplot.  See 'new multiplots'.
+
+   EXPERIMENTAL: *note remultiplot:: is invoked implicitly from *note
+replot:: if the immediately preceding plot command was part of a
+completed multiplot.  *note remultiplot:: is also invoked by hot keys
+and mouse operations pan/zoom etc.  while a multiplot is displayed.
+
+
+File: gnuplot.info,  Node: replot,  Next: reread,  Prev: remultiplot,  Up: Commands
+
+3.28 replot
+===========
+
+The *note replot:: command without arguments repeats the last 'plot' or
+'splot' command.  This can be useful for viewing a plot with different
+'set' options, or when generating the same plot for several devices.
+
+   Arguments specified after a *note replot:: command will be added onto
+the last 'plot' or 'splot' command (with an implied ',' separator)
+before it is repeated.  *note replot:: accepts the same arguments as the
+'plot' and 'splot' commands except that ranges cannot be specified.
+Thus you can use *note replot:: to plot a function against the second
+axes if the previous command was 'plot' but not if it was 'splot'.
+
+   Note:
+
+           plot '-' ; ... ; replot
+
+
+   is not recommended, because it will require that you type in the data
+all over again.  In most cases you can use the *note refresh:: command
+instead, which will redraw the plot using the data previously read in.
+
+   See also 'command-line-editing' for ways to edit the last 'plot'
+('splot') command.
+
+   See also 'show plot' to show the whole current plotting command, and
+the possibility to copy it into the *note history::.
+
+   In previous gnuplot versions, a complete multiplot could not be
+redrawn.  The *note replot:: command reproduced only the final component
+plot of the full set.  In gnuplot version 6 the commands used to
+generate a multiplot are stored into a datablock $GPVAL_LAST_MULTIPLOT.
+They can be replayed to regenerate the entire multiplot using the new
+command *note remultiplot::.
+
+   EXPERIMENTAL (details may change in a subsequent gnuplot version): If
+the previously drawn plot was part of a multiplot, the *note replot::
+command is now automatically treated as *note remultiplot::.  Several
+caveats apply.  See 'new multiplots', *note remultiplot::.
+
+
+File: gnuplot.info,  Node: reread,  Next: reset,  Prev: replot,  Up: Commands
+
+3.29 reread
+===========
+
+[DEPRECATED in version 5.4]
+
+   This command is deprecated in favor of explicit iteration.  See
+'iterate'.  The *note reread:: command causes execution from the current
+'gnuplot' input file, as specified by a 'load' command, to immediately
+restart from the beginning of the file.  This essentially implements an
+endless loop of commands from the beginning of the file to the *note
+reread:: command.  *note reread:: has no effect when reading commands
+from stdin.
+
+
+File: gnuplot.info,  Node: reset,  Next: return,  Prev: reread,  Up: Commands
+
+3.30 reset
+==========
+
+          reset {bind | errors | session}
+
+
+   The *note reset:: command causes all graph-related options that can
+be set with the 'set' command to return to their default values.  This
+command can be used to restore the default settings after executing a
+loaded command file, or to return to a defined state after lots of
+settings have been changed.
+
+   The following are _not_ affected by *note reset:::
+          `set term` *note output:: *note loadpath:: `set linetype` *note fit::
+          *note encoding:: *note decimalsign:: *note locale:: *note psdir::
+          *note overflow:: *note multiplot::
+
+
+   Note that *note reset:: does not necessarily return settings to the
+state they were in at program entry, because the default values may have
+been altered by commands in the initialization files gnuplotrc,
+$HOME/.gnuplot, or $XDG_CONFIG_HOME/gnuplot/gnuplotrc.  However, these
+commands can be re-executed by using the variant command 'reset
+session'.
+
+   'reset session' deletes any user-defined variables and functions,
+restores default settings, and then re-executes the system-wide
+gnuplotrc initialization file and any private $HOME/.gnuplot or
+$XDG_CONFIG_HOME/gnuplot/gnuplotrc preferences file.  See
+'initialization'.
+
+   'reset errors' clears only the error state variables GPVAL_ERRNO and
+GPVAL_ERRMSG.
+
+   'reset bind' restores all hotkey bindings to their default state.
+
+
+File: gnuplot.info,  Node: return,  Next: save,  Prev: reset,  Up: Commands
+
+3.31 return
+===========
+
+Syntax:
+          return <expression>
+
+
+   The *note return:: command acts the same way as the *note exit:: and
+*note quit:: commands in that it terminates execution of the current
+code block or input stream.  The return value is meaningful only in the
+context of executing code in a function block.  See 'function blocks'.
+
+   Example:
+          function $myfun << EOF
+          local result = 0
+          if (error-condition) { return -1 }
+          ... body of function ...
+          return result
+          EOF
+
+
+
+File: gnuplot.info,  Node: save,  Next: set-show,  Prev: return,  Up: Commands
+
+3.32 save
+=========
+
+Syntax:
+           save  {functions | variables | terminal | set | fit | datablocks}
+                 '<filename>' {append}
+
+
+   If no option is specified, 'gnuplot' saves functions, user variables,
+'set' options and the most recent 'plot' or 'splot' command.  The
+current status of 'set term' and *note output:: is written as a comment.
+
+   Saved files are written in text format and may be read by the 'load'
+command.
+
+   *note terminal:: will write out just the *note terminal:: status,
+without the comment marker in front of it.  This is mainly useful for
+switching the *note terminal:: setting for a short while, and getting
+back to the previously set terminal, afterwards, by loading the saved
+*note terminal:: status.  Note that for a single gnuplot session you may
+rather use the other method of saving and restoring current terminal by
+the commands 'set term push' and 'set term pop', see 'set term'.
+
+   'save variables' writes all user variables but not datablocks and not
+internal variables GPVAL_* GPFUN_* MOUSE_* ARG*.
+
+   *note fit:: saves only the variables used in the most recent *note
+fit:: command.  The saved file may be used as a parameter file to
+initialize future fit commands using the 'via' keyword.
+
+   The filename must be enclosed in quotes.
+
+   The special filename "-" may be used to *note save:: commands to
+standard output.  On systems which support a popen function (Unix), the
+output of save can be piped through an external program by starting the
+file name with a '|'.  This provides a consistent interface to
+'gnuplot''s internal settings to programs which communicate with
+'gnuplot' through a pipe.  Please see help for 'batch/interactive' for
+more details.
+
+   Examples:
+           save 'work.gnu'
+           save functions 'func.dat'
+           save var 'state.dat'; save datablocks 'state.dat' append
+           save set 'options.dat'
+           save term 'myterm.gnu'
+           save '-'
+           save '|grep title >t.gp'
+
+
+
+File: gnuplot.info,  Node: set-show,  Next: shell,  Prev: save,  Up: Commands
+
+3.33 set-show
+=============
+
+The 'set' command can be used to set _lots_ of options.  No new graph is
+drawn, however, until a 'plot', 'splot', or *note replot:: command is
+given.
+
+   For most options the corresponding 'show' command reports the current
+setting.  A few 'show' commands like *note palette:: and *note
+colornames:: are documented separately.
+
+   Options changed using 'set' can be returned to the default state by
+giving the corresponding *note unset:: command.  See also the *note
+reset:: command, which returns all settable parameters to default
+values.
+
+   The 'set' and *note unset:: commands may optionally contain an
+iteration clause.  See 'plot for'.
+
+* Menu:
+
+* angles::
+* arrow::
+* autoscale::
+* bind_::
+* bmargin::
+* border::
+* boxwidth::
+* boxdepth::
+* chi_shapes::
+* color::
+* colormap::
+* colorsequence::
+* clabel::
+* clip::
+* cntrlabel::
+* cntrparam::
+* color_box::
+* colornames::
+* contour::
+* cornerpoles::
+* contourfill_::
+* dashtype_::
+* datafile::
+* decimalsign::
+* dgrid3d::
+* dummy::
+* encoding::
+* errorbars::
+* fit_::
+* fontpath::
+* format__::
+* grid::
+* hidden3d::
+* history_::
+* isosamples::
+* isosurface_::
+* isotropic::
+* jitter::
+* key_::
+* label::
+* linetype::
+* link::
+* lmargin::
+* loadpath::
+* locale::
+* logscale::
+* macros::
+* mapping::
+* margin::
+* micro::
+* minussign::
+* monochrome::
+* mouse::
+* mttics::
+* multiplot::
+* mx2tics::
+* mxtics::
+* my2tics::
+* mytics::
+* mztics::
+* nonlinear::
+* object::
+* offsets::
+* origin::
+* output::
+* overflow::
+* palette__::
+* parametric_::
+* paxis::
+* pixmap::
+* pm3d::
+* pointintervalbox::
+* pointsize::
+* polar::
+* print_::
+* psdir::
+* raxis::
+* rgbmax::
+* rlabel::
+* rmargin::
+* rrange::
+* rtics::
+* samples::
+* size::
+* spiderplot_::
+* style::
+* surface_::
+* table::
+* terminal::
+* termoption::
+* theta::
+* tics::
+* ticslevel::
+* ticscale::
+* timestamp::
+* timefmt::
+* title_::
+* tmargin::
+* trange::
+* ttics::
+* urange::
+* version::
+* vgrid::
+* view::
+* vrange::
+* vxrange::
+* vyrange::
+* vzrange::
+* walls::
+* watchpoints::
+* x2data::
+* x2dtics::
+* x2label::
+* x2mtics::
+* x2range::
+* x2tics::
+* x2zeroaxis::
+* xdata::
+* xdtics::
+* xlabel::
+* xmtics::
+* xrange::
+* xtics::
+* xyplane::
+* xzeroaxis::
+* y2data::
+* y2dtics::
+* y2label::
+* y2mtics::
+* y2range::
+* y2tics::
+* y2zeroaxis::
+* ydata::
+* ydtics::
+* ylabel::
+* ymtics::
+* yrange::
+* ytics::
+* yzeroaxis::
+* zdata::
+* zdtics::
+* zzeroaxis::
+* cbdata::
+* cbdtics::
+* zero::
+* zeroaxis::
+* zlabel::
+* zmtics::
+* zrange::
+* ztics::
+* cblabel::
+* cbmtics::
+* cbrange::
+* cbtics::
+
+
+File: gnuplot.info,  Node: angles,  Next: arrow,  Prev: set-show,  Up: set-show
+
+3.33.1 angles
+-------------
+
+By default, 'gnuplot' assumes the independent variable in polar graphs
+is in units of radians.  If 'set angles degrees' is specified before
+'set polar', then the default range is [0:360] and the independent
+variable has units of degrees.  This is particularly useful for plots of
+data files.  The angle setting also applies to 3D mapping as set via the
+*note mapping:: command.
+
+   Syntax:
+           set angles {degrees | radians}
+           show angles
+
+
+   The angle specified in 'set grid polar' is also read and displayed in
+the units specified by *note angles::.
+
+   *note angles:: also affects the arguments of the machine-defined
+functions sin(x), cos(x) and tan(x), and the outputs of asin(x),
+acos(x), atan(x), atan2(x), and arg(x).  It has no effect on the
+arguments of hyperbolic functions or Bessel functions.  However, the
+output arguments of inverse hyperbolic functions of complex arguments
+are affected; if these functions are used, 'set angles radians' must be
+in effect to maintain consistency between input and output arguments.
+
+           x={1.0,0.1}
+           set angles radians
+           y=sinh(x)
+           print y         #prints {1.16933, 0.154051}
+           print asinh(y)  #prints {1.0, 0.1}
+
+   but
+           set angles degrees
+           y=sinh(x)
+           print y         #prints {1.16933, 0.154051}
+           print asinh(y)  #prints {57.29578, 5.729578}
+
+   See also poldat.dem: polar plot using angles demo.
+(http://www.gnuplot.info/demo/poldat.html)
+
+
+File: gnuplot.info,  Node: arrow,  Next: autoscale,  Prev: angles,  Up: set-show
+
+3.33.2 arrow
+------------
+
+Arbitrary arrows can be placed on a plot using the 'set arrow' command.
+
+   Syntax:
+           set arrow {<tag>} from <position> to <position>
+           set arrow {<tag>} from <position> rto <position>
+           set arrow {<tag>} from <position> length <coord> angle <ang>
+           set arrow <tag> arrowstyle | as <arrow_style>
+           set arrow <tag> {nohead | head | backhead | heads}
+                           {size <headlength>,<headangle>{,<backangle>}} {fixed}
+                           {filled | empty | nofilled | noborder}
+                           {front | back}
+                           {linestyle | ls <line_style>}
+                           {linetype | lt <line_type>}
+                           {linewidth | lw <line_width>}
+                           {linecolor | lc <colorspec>}
+                           {dashtype | dt <dashtype>}
+
+
+           unset arrow {<tag>}
+           show arrow {<tag>}
+
+
+   <tag> is an integer that identifies the arrow.  If no tag is given,
+the lowest unused tag value is assigned automatically.  The tag can be
+used to delete or change a specific arrow.  To change any attribute of
+an existing arrow, use 'set arrow' with the appropriate tag and specify
+the attributes to be changed.
+
+   The position of the first end point of the arrow is always specified
+by "from".  The other end point can be specified using any of three
+different mechanisms.  The <position>s are specified by either x,y or
+x,y,z, and may be preceded by 'first', 'second', 'graph', 'screen', or
+'character' to select the coordinate system.  Unspecified coordinates
+default to 0.  See 'coordinates' for details.  A coordinate system
+specifier does not carry over from the first endpoint description the
+second.
+
+   1) "to <position>" specifies the absolute coordinates of the other
+end.
+
+   2) "rto <position>" specifies an offset to the "from" position.  For
+linear axes, 'graph' and 'screen' coordinates, the distance between the
+start and the end point corresponds to the given relative coordinate.
+For logarithmic axes, the relative given coordinate corresponds to the
+factor of the coordinate between start and end point.  Thus, a negative
+relative value or zero are not allowed for logarithmic axes.
+
+   3) "length <coordinate> angle <angle>" specifies the orientation of
+the arrow in the plane of the graph.  Again any of the coordinate
+systems can be used to specify the length.  The angle is always in
+degrees.
+
+   Other characteristics of the arrow can either be specified as a
+pre-defined arrow style or by providing them in 'set arrow' command.
+For a detailed explanation of arrow characteristics, see 'arrowstyle'.
+
+   Examples:
+
+   To set an arrow pointing from the origin to (1,2) with user-defined
+linestyle 5, use:
+           set arrow to 1,2 ls 5
+
+
+   To set an arrow from bottom left of plotting area to (-5,5,3), and
+tag the arrow number 3, use:
+           set arrow 3 from graph 0,0 to -5,5,3
+
+
+   To change the preceding arrow to end at 1,1,1, without an arrow head
+and double its width, use:
+           set arrow 3 to 1,1,1 nohead lw 2
+
+
+   To draw a vertical line from the bottom to the top of the graph at
+x=3, use:
+           set arrow from 3, graph 0 to 3, graph 1 nohead
+
+
+   To draw a vertical arrow with T-shape ends, use:
+           set arrow 3 from 0,-5 to 0,5 heads size screen 0.1,90
+
+
+   To draw an arrow relatively to the start point, where the relative
+distances are given in graph coordinates, use:
+           set arrow from 0,-5 rto graph 0.1,0.1
+
+
+   To draw an arrow with relative end point in logarithmic x axis, use:
+           set logscale x
+           set arrow from 100,-5 rto 10,10
+
+   This draws an arrow from 100,-5 to 1000,5.  For the logarithmic x
+axis, the relative coordinate 10 means "factor 10" while for the linear
+y axis, the relative coordinate 10 means "difference 10".
+
+   To delete arrow number 2, use:
+           unset arrow 2
+
+
+   To delete all arrows, use:
+           unset arrow
+
+
+   To show all arrows (in tag order), use:
+           show arrow
+
+
+   arrows demos.  (http://www.gnuplot.info/demo/arrowstyle.html)
+
+
+File: gnuplot.info,  Node: autoscale,  Next: bind_,  Prev: arrow,  Up: set-show
+
+3.33.3 autoscale
+----------------
+
+Autoscaling may be set individually on the x, y or z axis or globally on
+all axes.  The default is to autoscale all axes.  If you want to
+autoscale based on a subset of the plots in the figure, you can mark the
+ones to be omitted with the flag 'noautoscale' in the plot command.  See
+*note datafile::.
+
+   Syntax:
+           set autoscale {<axis>{|min|max|fixmin|fixmax|fix} | fix | keepfix}
+           set autoscale noextend
+           unset autoscale {<axis>}
+           show autoscale
+
+
+   where <axis> is 'x', 'y', 'z', 'cb', 'x2', 'y2', 'xy', or 'paxis
+<p>'.  Appending 'min' or 'max' to the axis name tells 'gnuplot' to
+autoscale only the minimum or maximum of that axis.
+
+   If no axis name is given, all axes are autoscaled.
+
+   Autoscaling the independent axes (x for 'plot' and x,y for 'splot')
+adjusts the axis range to match the data being plotted.  If the plot
+contains only functions (no input data), autoscaling these axes has no
+effect.
+
+   Autoscaling the dependent axis (y for a 'plot' and z for 'splot')
+adjusts the axis range to match the data or function being plotted.
+
+   Adjustment of the axis range includes extending it to the next tic
+mark; i.e.  unless the extreme data coordinate exactly matches a tic
+mark, there will be some blank space between the data and the plot
+border.  Addition of this extra space can be suppressed by *note
+noextend::.  It can be further increased by the command 'set offset'.
+Please see *note xrange:: and *note offsets:: for additional
+information.
+
+   The behavior of autoscaling remains consistent in parametric mode,
+(see *note parametric::).  However, there are more dependent variables
+and hence more control over x, y, and z axis scales.  In parametric
+mode, the independent or dummy variable is t for 'plot's and u,v for
+'splot's.  *note autoscale:: in parametric mode, then, controls all
+ranges (t, u, v, x, y, and z) and allows x, y, and z to be fully
+autoscaled.
+
+   When tics are displayed on second axes but no plot has been specified
+for those axes, x2range and y2range are inherited from xrange and
+yrange.  This is done _before_ applying offsets or autoextending the
+ranges to a whole number of tics, which can cause unexpected results.
+To prevent this you can explicitly link the secondary axis range to the
+primary axis range.  See *note link::.
+
+* Menu:
+
+* noextend::
+* examples::
+* polar_mode::
+
+
+File: gnuplot.info,  Node: noextend,  Next: examples,  Prev: autoscale,  Up: autoscale
+
+3.33.3.1 noextend
+.................
+
+          set autoscale noextend
+
+
+   By default autoscaling sets the axis range limits to the nearest tic
+label position that includes all the plot data.  Keywords 'fixmin',
+'fixmax', 'fix' or *note noextend:: tell gnuplot to disable extension of
+the axis range to the next tic mark position.  In this case the axis
+range limit exactly matches the coordinate of the most extreme data
+point.  *note noextend:: is a synonym for 'set autoscale fix'.  Range
+extension for a single axis can be disabled by appending the *note
+noextend:: keyword to the corresponding range command, e.g.
+          set yrange [0:*] noextend
+
+
+   'set autoscale keepfix' autoscales all axes while leaving the fix
+settings unchanged.
+
+
+File: gnuplot.info,  Node: examples,  Next: polar_mode,  Prev: noextend,  Up: autoscale
+
+3.33.3.2 examples
+.................
+
+Examples:
+
+   This sets autoscaling of the y axis (other axes are not affected):
+           set autoscale y
+
+
+   This sets autoscaling only for the minimum of the y axis (the maximum
+of the y axis and the other axes are not affected):
+           set autoscale ymin
+
+
+   This disables extension of the x2 axis tics to the next tic mark,
+thus keeping the exact range as found in the plotted data and functions:
+           set autoscale x2fixmin
+           set autoscale x2fixmax
+
+
+   This sets autoscaling of the x and y axes:
+           set autoscale xy
+
+
+   This sets autoscaling of the x, y, z, x2 and y2 axes:
+           set autoscale
+
+
+   This disables autoscaling of the x, y, z, x2 and y2 axes:
+           unset autoscale
+
+
+   This disables autoscaling of the z axis only:
+           unset autoscale z
+
+
+
+File: gnuplot.info,  Node: polar_mode,  Prev: examples,  Up: autoscale
+
+3.33.3.3 polar mode
+...................
+
+When in polar mode ('set polar'), the xrange and the yrange may be left
+in autoscale mode.  If *note rrange:: is used to limit the extent of the
+polar axis, then xrange and yrange will adjust to match this
+automatically.  However, explicit xrange and yrange commands can later
+be used to make further adjustments.  See *note rrange::.
+
+   See also polar demos.  (http://www.gnuplot.info/demo/poldat.html)
+
+
+File: gnuplot.info,  Node: bind_,  Next: bmargin,  Prev: autoscale,  Up: set-show
+
+3.33.4 bind
+-----------
+
+'show bind' shows the current state of all hotkey bindings.  See 'bind'.
+
+
+File: gnuplot.info,  Node: bmargin,  Next: border,  Prev: bind_,  Up: set-show
+
+3.33.5 bmargin
+--------------
+
+The command *note bmargin:: sets the size of the bottom margin.  Please
+see *note margin:: for details.
+
+
+File: gnuplot.info,  Node: border,  Next: boxwidth,  Prev: bmargin,  Up: set-show
+
+3.33.6 border
+-------------
+
+The *note border:: and *note border:: commands control the display of
+the graph borders for the 'plot' and 'splot' commands.  Note that the
+borders do not necessarily coincide with the axes; with 'plot' they
+often do, but with 'splot' they usually do not.
+
+   Syntax:
+           set border {<integer>}
+                      {front | back | behind}
+                      {linestyle | ls <line_style>}
+                      {linetype | lt <line_type>} {linewidth | lw <line_width>}
+                      {linecolor | lc <colorspec>} {dashtype | dt <dashtype>}
+                      {polar}
+           unset border
+           show border
+
+
+   With a 'splot' displayed in an arbitrary orientation, like 'set view
+56,103', the four corners of the x-y plane can be referred to as
+"front", "back", "left" and "right".  A similar set of four corners
+exist for the top surface, of course.  Thus the border connecting, say,
+the back and right corners of the x-y plane is the "bottom right back"
+border, and the border connecting the top and bottom front corners is
+the "front vertical".  (This nomenclature is defined solely to allow the
+reader to figure out the table that follows.)
+
+   The borders are encoded in a 12-bit integer: the four low bits
+control the border for 'plot' and the sides of the base for 'splot'; the
+next four bits control the verticals in 'splot'; the four high bits
+control the edges on top of an 'splot'.  The border settings is thus the
+sum of the appropriate entries from the following table:
+
+                 Bit     plot        splot
+                   1   bottom      bottom left front
+                   2   left        bottom left back
+                   4   top         bottom right front
+                   8   right       bottom right back
+                  16   no effect   left vertical
+                  32   no effect   back vertical
+                  64   no effect   right vertical
+                 128   no effect   front vertical
+                 256   no effect   top left back
+                 512   no effect   top right back
+                1024   no effect   top left front
+                2048   no effect   top right front
+                4096   polar       no effect
+
+
+   The default setting is 31, which is all four sides for 'plot', and
+base and z axis for 'splot'.
+
+   Separate from the four vertical lines in a 3D border, the 'splot'
+command by default draws a vertical line each corner of a surface to the
+base plane of the plot.  These verticals are not controlled by *note
+border::.  Instead use *note cornerpoles::.
+
+   In 2D plots the border is normally drawn on top of all plots elements
+('front').  If you want the border to be drawn behind the plot elements,
+use 'set border back'.
+
+   In hidden3d plots the lines making up the border are normally subject
+to the same hidden3d processing as the plot elements.  'set border
+behind' will override this default.
+
+   Using the optional <linestyle>, <linetype>, <linewidth>, <linecolor>,
+and <dashtype> specifiers, the way the border lines are drawn can be
+influenced (limited by what the current terminal driver supports).
+Besides the border itself, this line style is used for the tics,
+independent of whether they are plotted on the border or on the axes
+(see 'set xtics').
+
+   For 'plot', tics may be drawn on edges other than bottom and left by
+enabling the second axes - see 'set xtics' for details.
+
+   If a 'splot' draws only on the base, as is the case with "'unset
+surface; set contour base'", then the verticals and the top are not
+drawn even if they are specified.
+
+   The 'set grid' options 'back', 'front' and 'layerdefault' also
+control the order in which the border lines are drawn with respect to
+the output of the plotted data.
+
+   The 'polar' keyword enables a circular border for polar plots.
+
+   Examples:
+
+   Draw default borders:
+           set border
+
+
+   Draw only the left and bottom ('plot') or both front and back bottom
+left ('splot') borders:
+           set border 3
+
+
+   Draw a complete box around a 'splot':
+           set border 4095
+
+
+   Draw a topless box around a 'splot', omitting the front vertical:
+           set border 127+256+512 # or set border 1023-128
+
+
+   Draw only the top and right borders for a 'plot' and label them as
+axes:
+           unset xtics; unset ytics; set x2tics; set y2tics; set border 12
+
+
+
+File: gnuplot.info,  Node: boxwidth,  Next: boxdepth,  Prev: border,  Up: set-show
+
+3.33.7 boxwidth
+---------------
+
+The *note boxwidth:: command is used to set the default width of boxes
+in the *note boxes::, *note boxerrorbars::, *note boxplot::, *note
+candlesticks:: and *note histograms:: styles.
+
+   Syntax:
+           set boxwidth {<width>} {absolute|relative}
+           show boxwidth
+
+
+   By default, adjacent boxes are extended in width until they touch
+each other.  A different default width may be specified using the *note
+boxwidth:: command.  'Relative' widths are interpreted as being a
+fraction of this default width.
+
+   An explicit value for the boxwidth is interpreted as being a number
+of units along the current x axis ('absolute') unless the modifier
+'relative' is given.  If the x axis is a log-scale (see 'set log') then
+the value of boxwidth is truly "absolute" only at x=1; this physical
+width is maintained everywhere along the axis (i.e.  the boxes do not
+become narrower the value of x increases).  If the range spanned by a
+log scale x axis is far from x=1, some experimentation may be required
+to find a useful value of boxwidth.
+
+   The default is superseded by explicit width information taken from an
+extra data column in styles *note boxes:: or *note boxerrorbars::.  See
+*note boxes:: and *note boxerrorbars:: for more details.
+
+   To set the box width to automatic use the command
+           set boxwidth
+
+
+   To set the box width to half of the automatic size use
+           set boxwidth 0.5 relative
+
+
+   To set the box width to an absolute value of 2 use
+           set boxwidth 2 absolute
+
+
+
+File: gnuplot.info,  Node: boxdepth,  Next: chi_shapes,  Prev: boxwidth,  Up: set-show
+
+3.33.8 boxdepth
+---------------
+
+          set boxdepth {<y extent>} | square
+
+   The *note boxdepth:: command affects only 3D plots created by *note
+boxes::.  It sets the extent of each box along the y axis, i.e.  its
+thickness.  'set boxdepth square' will try to choose a y extent that
+gives the appearance of a square cross section independent of the axis
+scales on x and y.
+
+
+File: gnuplot.info,  Node: chi_shapes,  Next: color,  Prev: boxdepth,  Up: set-show
+
+3.33.9 chi_shapes
+-----------------
+
+          set chi_shapes fraction <value>
+          unset chi_shapes
+
+
+   The concave hull filter creates χ-shapes defined by a characteristic
+length chi_length.  If no chi_length variable has been set, it chooses a
+value equal to a fraction of the longest edge in the bounding polygon
+(the convex hull).  The fraction defaults to 0.6 but can be changed
+using this command.  Choosing a value of 1.0 will reduce the resulting
+hull to the convex hull.  Smaller values will produce increasingly
+concave hulls.  See 'concavehull'.  The *note chi_shapes:: command
+restores the fraction to 0.6 and undefines the chi_length variable.
+
+
+File: gnuplot.info,  Node: color,  Next: colormap,  Prev: chi_shapes,  Up: set-show
+
+3.33.10 color
+-------------
+
+Gnuplot assigns each element of a 'plot' or 'splot' command a new set of
+line properties taken from a predefined sequence.  The default is to
+distinguish successive lines by a change in color.  The alternative
+selected by *note monochrome:: uses a sequence of black lines
+distinguished by linewidth or dot/dash pattern.  The 'set color' command
+exits this alternative monochrome mode and restores the previous set of
+default color lines.  See *note monochrome::, 'set linetype', and *note
+colorsequence::.
+
+
+File: gnuplot.info,  Node: colormap,  Next: colorsequence,  Prev: color,  Up: set-show
+
+3.33.11 colormap
+----------------
+
+Syntax:
+
+          set colormap new <colormap-name>
+          set colormap <colormap-name> range [<min>:<max>]
+          show colormaps
+
+
+   'set colormap new <name>' creates a colormap array <name> and loads
+it from the current palette settings.  This saved colormap can be
+further manipulated as an array of 32-bit ARGB color values and used by
+name in subsequent plots.
+
+   Here is an example that creates a palette running from dark red to
+white, saves it to a colormap array named 'Reds', and makes all entries
+in the colormap partially transparent.  This named colormap is then used
+later to color a pm3d surface.  Note that the alpha channel value in a
+named colormap follows the convention for ARGB line properties; i.e 0 is
+opaque, 0xff is fully transparent.
+
+          set palette defined (0 "dark-red", 1 "white")
+          set colormap new Reds
+          do for [i=1:|Reds|] { Reds[i] = Reds[i] | 0x3F000000 }
+          splot func(x,y) with pm3d fillcolor palette Reds
+
+
+   The mapping of z values onto the colormap can be tuned by setting
+minimum and maximum z values that correspond to the end points.  For
+example
+
+          set colormap Reds range [0:10]
+
+
+   If no range is set, or if min and max are the same, then the mapping
+uses the current limits of cbrange.  See *note cbrange::.
+
+   A colormap can be used to gradient-fill a rectangular area.  See
+*note colormap::.
+
+
+File: gnuplot.info,  Node: colorsequence,  Next: clabel,  Prev: colormap,  Up: set-show
+
+3.33.12 colorsequence
+---------------------
+
+Syntax:
+          set colorsequence {default|classic|podo}
+
+
+   'set colorsequence default' selects a terminal-independent repeating
+sequence of eight colors.  See 'set linetype', 'colors'.
+
+   'set colorsequence classic' lets each separate terminal type provide
+its own sequence of line colors.  The number provided varies from 4 to
+more than 100, but most start with red/green/blue/magenta/cyan/yellow.
+This was the default behaviour prior to version 5.
+
+   'set colorsequence podo' selects eight colors drawn from a set
+recommended by Wong (2011) [Nature Methods 8:441] as being easily
+distinguished by color-blind viewers with either protanopia or
+deuteranopia.
+
+   In each case you can further customize the length of the sequence and
+the colors used.  See 'set linetype', 'colors'.
+
+
+File: gnuplot.info,  Node: clabel,  Next: clip,  Prev: colorsequence,  Up: set-show
+
+3.33.13 clabel
+--------------
+
+This command has been deprecated.  Use *note cntrlabel:: instead.  'set
+clabel "format"' is replaced by 'set cntrlabel format "format"'.  *note
+clabel:: is replaced by 'set cntrlabel onecolor'.
+
+
+File: gnuplot.info,  Node: clip,  Next: cntrlabel,  Prev: clabel,  Up: set-show
+
+3.33.14 clip
+------------
+
+Syntax:
+           set clip {points|one|two|radial}
+           unset clip {points|one|two|radial}
+           show clip
+
+
+   Default state:
+           unset clip points
+           set clip one
+           unset clip two
+           unset clip radial
+
+
+   Data points whose center lies inside the plot boundaries are normally
+drawn even if the finite size of the point symbol causes it to extend
+past a boundary line.  'set clip points' causes such points to be
+clipped (i.e.  not drawn) even though the point center is inside the
+boundaries of a 2D plot.  Data points whose center lies outside the plot
+boundaries are never drawn.
+
+   'unset clip' causes a line segment in a plot not to be drawn if
+either end of that segment lies outside the plot boundaries (i.e.
+xrange and yrange).
+
+   'set clip one' causes 'gnuplot' to draw the in-range portion of line
+segments with one endpoint in range and one endpoint out of range.  'set
+clip two' causes 'gnuplot' to draw the in-range portion of line segments
+with both endpoints out of range.  Line segments that lie entirely
+outside the plot boundaries are never drawn.
+
+   'set clip radial' affects plotting only in polar mode.  It clips
+lines against the radial bound established by 'set rrange [0:MAX]'. This
+criteria is applied in conjunction with 'set clip {one|two}'.  I.e.  the
+portion of a line between two points with R > RMAX that passes through
+the circle R = RMAX is drawn only if both 'clip two' and 'clip radial'
+are set.
+
+   Notes:
+
+   * 'set clip' affects only points and lines produced by plot styles
+'lines', *note linespoints::, 'points', 'arrows', and *note vectors::.
+
+   * Clipping of colored quadrangles drawn for pm3d surfaces and other
+solid objects is controlled *note clipping::.  The default is smooth
+clipping against the current zrange.
+
+   * Object clipping is controlled by the 'clip' or 'noclip' property of
+the individual object.
+
+   * In the current version of gnuplot, "plot with vectors" in polar
+mode does not test or clip against the maximum radius.
+
+
+File: gnuplot.info,  Node: cntrlabel,  Next: cntrparam,  Prev: clip,  Up: set-show
+
+3.33.15 cntrlabel
+-----------------
+
+Syntax:
+           set cntrlabel {format "format"} {font "font"}
+           set cntrlabel {start <int>} {interval <int>}
+           set cntrlabel onecolor
+
+
+   *note cntrlabel:: controls the labeling of contours, either in the
+key (default) or on the plot itself in the case of *note labels::.  In
+the latter case labels are placed along each contour line according to
+the 'pointinterval' or 'pointnumber' property of the label descriptor.
+By default a label is placed on the 5th line segment making up the
+contour line and repeated every 20th segment.  These defaults are
+equivalent to
+           set cntrlabel start 5 interval 20
+
+   They can be changed either via the *note cntrlabel:: command or by
+specifying the interval in the 'splot' command itself
+           set contours; splot $FOO with labels point pointinterval -1
+
+   Setting the interval to a negative value means that the label appear
+only once per contour line.  However if *note samples:: or *note
+isosamples:: is large then many contour lines may be created, each with
+a single label.
+
+   A contour label is placed in the plot key for each linetype used.  By
+default each contour level is given its own linetype, so a separate
+label appears for each.  The command 'set cntrlabel onecolor' causes all
+contours to be drawn using the same linetype, so only one label appears
+in the plot key.  This command replaces an older command *note clabel::.
+
+
+File: gnuplot.info,  Node: cntrparam,  Next: color_box,  Prev: cntrlabel,  Up: set-show
+
+3.33.16 cntrparam
+-----------------
+
+*note cntrparam:: controls the generation of contours and their
+smoothness for a contour plot.  'show contour' displays current settings
+of *note cntrparam:: as well as 'contour'.
+
+   Syntax:
+           set cntrparam { { linear
+                           | cubicspline
+                           | bspline
+                           | points <n>
+                           | order <n>
+                           | levels { <n>
+                                      | auto {<n>}
+                                      | discrete <z1> {,<z2>{,<z3>...}}
+                                      | incremental <start>, <incr> {,<end>}
+                                    }
+                             {{un}sorted}
+                             {firstlinetype N}
+                           }
+                         }
+           show contour
+
+
+   This command has two functions.  First, it sets the values of z for
+which contours are to be determined.  The number of contour levels <n>
+should be an integral constant expression.  <z1>, <z2> ...  are
+real-valued expressions.  Second, it controls the appearance of the
+individual contour lines.
+
+   Keywords controlling the smoothness of contour lines:
+
+   'linear', 'cubicspline', 'bspline'-- Controls type of approximation
+or interpolation.  If 'linear', then straight line segments connect
+points of equal z magnitude.  If 'cubicspline', then piecewise-linear
+contours are interpolated between the same equal z points to form
+somewhat smoother contours, but which may undulate.  If 'bspline', a
+guaranteed-smoother curve is drawn, which only approximates the position
+of the points of equal-z.
+
+   'points'-- Eventually all drawings are done with piecewise-linear
+strokes.  This number controls the number of line segments used to
+approximate the 'bspline' or 'cubicspline' curve.  Number of cubicspline
+or bspline segments (strokes) = 'points' * number of linear segments.
+
+   'order'-- Order of the bspline approximation to be used.  The bigger
+this order is, the smoother the resulting contour.  (Of course, higher
+order bspline curves will move further away from the original piecewise
+linear data.)  This option is relevant for 'bspline' mode only.  Allowed
+values are integers in the range from 2 (linear) to 10.
+
+   Keywords controlling the selection of contour levels:
+
+   'levels auto'-- This is the default.  <n> specifies a nominal number
+of levels; the actual number will be adjusted to give simple labels.  If
+the surface is bounded by zmin and zmax, contours will be generated at
+integer multiples of dz between zmin and zmax, where dz is 1, 2, or 5
+times some power of ten (like the step between two tic marks).
+
+   'levels discrete'-- Contours will be generated at z = <z1>, <z2> ...
+as specified; the number of discrete levels sets the number of contour
+levels.  In 'discrete' mode, any 'set cntrparam levels <n>' are ignored.
+
+   'levels incremental'-- Contours are generated at values of z
+beginning at <start> and increasing by <increment>, until the number of
+contours is reached.  <end> is used to determine the number of contour
+levels, which will be changed by any subsequent 'set cntrparam levels
+<n>'.  If the z axis is logarithmic, <increment> will be interpreted as
+a multiplicative factor, as it is for *note ztics::, and <end> should
+not be used.
+
+   Keywords controlling the assignment of linetype to contours:
+
+   By default the contours are generated in the reverse order specified
+('unsorted').  Thus 'set cntrparam levels increment 0, 10, 100' will
+create 11 contours levels starting with 100 and ending with 0.  Adding
+the keyword 'sorted' re-orders the contours by increasing numerical
+value, which in this case would mean the first contour is drawn at 0.
+
+   By default contours are drawn using successive linetypes starting
+with the next linetype after that used for the corresponding surface.
+Thus 'splot x*y lt 5' would use lt 6 for the first contour generated.
+If *note hidden3d:: mode is active then each surface uses two linetypes.
+In this case using default settings would cause the first contour to use
+the same linetype as the hidden surface, which is undesirable.  This can
+be avoided in either of two ways.  (1) Use 'set hidden3d offset N' to
+change the linetype used for the hidden surface.  A good choice would be
+'offset -1' since that will avoid all the contour linetypes.  (2) Use
+the 'set cntrparam firstlinetype N' option to specify a block of
+linetypes used for contour lines independent of whatever was used for
+the surface.  This is particularly useful if you want to customize the
+set of contour linetypes.  N <= 0 restores the default.
+
+   If the command *note cntrparam:: is given without any arguments
+specified all options are reset to the default:
+           set cntrparam order 4 points 5
+           set cntrparam levels auto 5 unsorted
+           set cntrparam firstlinetype 0
+
+
+* Menu:
+
+* Examples_::
+
+
+File: gnuplot.info,  Node: Examples_,  Prev: cntrparam,  Up: cntrparam
+
+3.33.16.1 Examples
+..................
+
+Examples:
+           set cntrparam bspline
+           set cntrparam points 7
+           set cntrparam order 10
+
+
+   To select levels automatically, 5 if the level increment criteria are
+met:
+           set cntrparam levels auto 5
+
+
+   To specify discrete levels at .1, .37, and .9:
+           set cntrparam levels discrete .1,1/exp(1),.9
+
+
+   To specify levels from 0 to 4 with increment 1:
+           set cntrparam levels incremental  0,1,4
+
+
+   To set the number of levels to 10 (changing an incremental end or
+possibly the number of auto levels):
+           set cntrparam levels 10
+
+
+   To set the start and increment while retaining the number of levels:
+           set cntrparam levels incremental 100,50
+
+
+   To define and use a customized block of contour linetypes
+           set linetype 100 lc "red" dt '....'
+           do for [L=101:199] {
+               if (L%10 == 0) {
+                   set linetype L lc "black" dt solid lw 2
+               } else {
+                   set linetype L lc "gray" dt solid lw 1
+               }
+           }
+           set cntrparam firstlinetype 100
+           set cntrparam sorted levels incremental 0, 1, 100
+
+
+   See also 'set contour' for control of where the contours are drawn,
+and *note cntrlabel:: for control of the format of the contour labels
+and linetypes.
+
+   See also contours demo (contours.dem)
+(http://www.gnuplot.info/demo/contours.html) and contours with user
+defined levels demo (discrete.dem).
+(http://www.gnuplot.info/demo/discrete.html) D contours 5 D discrete 3
+
+
+File: gnuplot.info,  Node: color_box,  Next: colornames,  Prev: cntrparam,  Up: set-show
+
+3.33.17 color box
+-----------------
+
+For plots that use palette coloring, in particular pm3d plots, the
+palette gradient is drawn in a color box next to the plot unless it is
+switched off by 'unset colorbox'.
+
+           set colorbox
+           set colorbox {
+                      { vertical | horizontal } {{no}invert}
+                      { default | bottom | user }
+                      { origin x, y }
+                      { size x, y }
+                      { front | back }
+                      { noborder | bdefault | border [line style] }
+                    }
+           show colorbox
+           unset colorbox
+
+
+   The orientation of the color gradient is set by 'vertical' or
+'horizontal'.
+
+   The color box position can be 'default' or 'bottom' or 'user'.  The
+'bottom' keyword is a convenience short cut equivalent to
+
+          set colorbox horizontal user origin screen 0.1, 0.07 size 0.8, 0.03.
+
+
+   If the colorbox is placed underneath the plot, as it is with
+'bottom', it may be useful to reserve additional space for it: 'set
+bmargin screen 0.2'.
+
+   'origin x, y' and 'size x, y' are used to tailor the exact placement
+in 'user' or 'bottom' positioning.  The x and y values are interpreted
+as screen coordinates by default, and this is the only legal option for
+3D plots.  2D plots, including splot with 'set view map', allow any
+coordinate system.
+
+   'back'/'front' control whether the color box is draw before or after
+the plot.
+
+   *note border:: turns the border on (this is the default).  'noborder'
+turns the border off.  If an positive integer argument is given after
+*note border::, it is used as a line style tag which is used for drawing
+the border, e.g.:
+         set style line 2604 linetype -1 linewidth .4
+         set colorbox border 2604
+
+   will use line style '2604', a thin line with the default border color
+(-1) for drawing the border.  'bdefault' (which is the default) will use
+the default border line style for drawing the border of the color box.
+
+   The axis of the color box is called 'cb' and it is controlled by
+means of the usual axes commands, i.e.  'set/unset/show' with *note
+cbrange::, '[m]cbtics', 'format cb', 'grid [m]cb', *note cblabel::, and
+perhaps even *note cbdata::, '[no]cbdtics', '[no]cbmtics'.
+
+   'set colorbox' without any parameter switches the position to
+default.  'unset colorbox' resets the default parameters for the
+colorbox and switches the colorbox off.
+
+   See also help for 'set pm3d', *note palette::, and 'set style line'.
+
+
+File: gnuplot.info,  Node: colornames,  Next: contour,  Prev: color_box,  Up: set-show
+
+3.33.18 colornames
+------------------
+
+Gnuplot knows a limited number of color names.  You can use these to
+define the color range spanned by a pm3d palette, to assign a named
+color to a particular linetype or linestyle, or to define a gradient for
+the current color palette.  Use the command *note colornames:: to list
+the known color names together with their RGB component definitions.
+Examples:
+           set style line 1 linecolor "sea-green"
+           set palette defined (0 "dark-red", 1 "white")
+           print sprintf("0x%06x", rgbcolor("dark-green"))
+                 0x006400
+
+
+
+File: gnuplot.info,  Node: contour,  Next: cornerpoles,  Prev: colornames,  Up: set-show
+
+3.33.19 contour
+---------------
+
+'set contour' enables placement of contour lines on 3D surfaces.  This
+option is available only for 'splot'.  It requires grid data, e.g.  a
+file in which all the points for a single y-isoline are listed, then all
+the points for the next y-isoline, and so on.  A single blank line
+(containing no characters other than blank spaces) separates one
+y-isoline from the next.  see 'grid_data' for more details.
+
+   If the data is not already gridded, *note dgrid3d:: can be used to
+first create and populate an appropriate grid.
+
+   Syntax:
+           set contour {base | surface | both}
+           unset contour
+           show contour
+
+
+   The three options specify where to draw the contours: 'base' draws
+the contours on the grid base where the x/ytics are placed, 'surface'
+draws the contours on the surfaces themselves, and 'both' draws the
+contours on both the base and the surface.  If no option is provided,
+the default is 'base'.
+
+   See also *note cntrparam:: for the parameters that affect the drawing
+of contours, and *note cntrlabel:: for control of labeling of the
+contours.
+
+   Note that this option places lines or labels without otherwise
+changing the appearance of the surface itself.  If you want to recolor
+the surface so that the areas bounded by contour lines are assigned
+distinct colors, use instead the contourfill plot style.  See *note
+contourfill::.
+
+   While 'set contour' is in effect, 'splot with <style>' will place the
+style elements (points, lines, impulses, labels, etc) along the contour
+lines.  'with pm3d' will produce a pm3d surface and also contour lines.
+If you want to mix other plot elements, say labels read from a file,
+with the contours generated while 'set contour' is active you must
+append the keyword 'nocontours' after that clause in the splot command.
+
+   The surface can be switched off (see 'unset surface') to give a
+contour-only graph.  A 2D projection of the contour lines and optional
+labels can be generated by
+
+          set view map
+          splot DATA with lines nosurface, DATA with labels
+
+
+   Older gnuplot versions used an alternative multi-step method to save
+the 3D contour lines into a file or datablock and then plot them using a
+2D plot command as shown below.
+
+           set contour
+           set table $datablock
+           splot DATA with lines nosurface
+           unset table
+           # contour lines are now in $datablock, one contour per index
+           plot for [level=0:*] $datablock index level with lines
+
+
+   See also *note datafile:: and demos for contours (contours.dem)
+(http://www.gnuplot.info/demo/contours.html) and user defined contour
+levels (discrete.dem).  (http://www.gnuplot.info/demo/discrete.html)
+
+
+File: gnuplot.info,  Node: cornerpoles,  Next: contourfill_,  Prev: contour,  Up: set-show
+
+3.33.20 cornerpoles
+-------------------
+
+By default splot draws a vertical line from each corner of a 3D surface
+to the base plane.  These vertical lines can be suppressed using *note
+cornerpoles::.
+
+
+File: gnuplot.info,  Node: contourfill_,  Next: dashtype_,  Prev: cornerpoles,  Up: set-show
+
+3.33.21 contourfill
+-------------------
+
+The 3D plot style *note contourfill:: slices a pm3d surface into
+sections delimited by a set of planes perpendicular to the z axis.  The
+command *note contourfill:: controls placement of these limiting planes
+and the colors assigned to the individual sections.
+
+   Syntax:
+          set contourfill auto N          # split zrange evenly into N slices
+          set contourfill ztics           # slice at each z axis major tick
+          set contourfill cbtics          # slice at each cb axis major tick
+          set contourfill {palette | firstlinetype N}
+
+
+   The default is *note palette::, which splits the current z range into
+five equal slices (6 bounding planes) and assigns each slice the palette
+mapped color of its midpoint z value.
+
+   The options *note ztics:: or *note cbtics:: place split zrange by
+slicing at major ticks along that axis.  For example to slice
+specifically at z=2.5, z=7 and z=10 you could use the commands below.
+          set ztics add ("floor" 2.5, "boundary X" 7, "ceiling" 10)
+          set contourfill ztics
+
+
+   If you do not want to use palette coloring for the sections, you can
+choose any arbitrary range of successive linetypes and assign them the
+desired color sequence.
+          set for [i=101:110] linetype i lc mycolor[i]
+          set contourfill firstlinetype 101
+
+   *note palette:: restores palette coloring.  D contourfill 3
+
+
+File: gnuplot.info,  Node: dashtype_,  Next: datafile,  Prev: contourfill_,  Up: set-show
+
+3.33.22 dashtype
+----------------
+
+The *note dashtype:: command allows you to define a dash pattern that
+can then be referred to by its index.  This is purely a convenience, as
+anywhere that would accept the dashtype by its numerical index would
+also accept an explicit dash pattern.  Example:
+          set dashtype 5 (2,4,2,6)   # define or redefine dashtype number 5
+          plot f1(x) dt 5            # plot using the new dashtype
+          plot f1(x) dt (2,4,2,6)    # exactly the same plot as above
+          set linetype 5 dt 5        # always use this dash pattern with linetype 5
+          set dashtype 66 "..-"      # define a new dashtype using a string
+
+   See also *note dashtype::.  D dashtypes 2
+
+
+File: gnuplot.info,  Node: datafile,  Next: decimalsign,  Prev: dashtype_,  Up: set-show
+
+3.33.23 datafile
+----------------
+
+The *note datafile:: command options control interpretation of fields
+read from input data files by the 'plot', 'splot', and *note fit::
+commands.  Several options are currently implemented.  The settings
+apply uniformly to all data files read by subsequent commands; however
+see 'functionblocks' for a way to work around this if it is necessary to
+simultaneously handles files with conflicting formats.
+
+* Menu:
+
+* set_datafile_columnheaders::
+* set_datafile_fortran::
+* set_datafile_nofpe_trap::
+* set_datafile_missing::
+* set_datafile_separator::
+* set_datafile_commentschars::
+* set_datafile_binary::
+
+
+File: gnuplot.info,  Node: set_datafile_columnheaders,  Next: set_datafile_fortran,  Prev: datafile,  Up: datafile
+
+3.33.23.1 set datafile columnheaders
+....................................
+
+The *note columnheaders:: command guarantees that the first row of input
+will be interpreted as column headers rather than as data values.  It
+affects all input data sources to plot, splot, fit, and stats commands.
+If this setting is disabled by *note columnheaders::, the same effect is
+triggered on a per-file basis if there is an explicit columnheader()
+function in a using specifier or plot title associated with that file.
+See also 'set key autotitle' and 'columnheader'.
+
+
+File: gnuplot.info,  Node: set_datafile_fortran,  Next: set_datafile_nofpe_trap,  Prev: set_datafile_columnheaders,  Up: datafile
+
+3.33.23.2 set datafile fortran
+..............................
+
+The 'set datafile fortran' command enables a special check for values in
+the input file expressed as Fortran D or Q constants.  This extra check
+slows down the input process, and should only be selected if you do in
+fact have datafiles containing Fortran D or Q constants.  The option can
+be disabled again using 'unset datafile fortran'.
+
+
+File: gnuplot.info,  Node: set_datafile_nofpe_trap,  Next: set_datafile_missing,  Prev: set_datafile_fortran,  Up: datafile
+
+3.33.23.3 set datafile nofpe_trap
+.................................
+
+The 'set datafile nofpe_trap' command tells gnuplot not to re-initialize
+a floating point exception handler before every expression evaluation
+used while reading data from an input file.  This can significantly
+speed data input from very large files at the risk of program
+termination if a floating-point exception is generated.
+
+
+File: gnuplot.info,  Node: set_datafile_missing,  Next: set_datafile_separator,  Prev: set_datafile_nofpe_trap,  Up: datafile
+
+3.33.23.4 set datafile missing
+..............................
+
+Syntax:
+           set datafile missing "<string>"
+           set datafile missing NaN
+           show datafile missing
+           unset datafile
+
+
+   The 'set datafile missing' command tells 'gnuplot' there is a special
+string used in input data files to denote a missing data entry.  There
+is no default character for 'missing'.  Gnuplot makes a distinction
+between missing data and invalid data (e.g.  "NaN", 1/0.).  For example
+invalid data causes a gap in a line drawn through sequential data
+points; missing data does not.
+
+   Non-numeric characters found in a numeric field will usually be
+interpreted as invalid rather than as a missing data point unless they
+happen to match the 'missing' string.
+
+   Conversely *note NaN:: causes all data or expressions evaluating to
+not-a-number (NaN) to be treated as missing data.  See the imageNaN
+demo.  (http://www.gnuplot.info/demo/imageNaN.html)
+
+   The program notices a missing value flag in column N when the using
+specifier in a plot command directly refers to the column as 'using N',
+'using ($N)', or 'using (function($N))'. In these cases the expression,
+e.g.  func($N), is not evaluated at all.
+
+   The current gnuplot version also notices direct references of the
+form (column(N)), and it notices during evaluation if the expression
+depends even indirectly on a column value flagged "missing".
+
+   In all these cases the program treats the entire input data line as
+if it were not present at all.  However if an expression depends on a
+data value that is truly missing (e.g.  an empty field in a csv file) it
+may not be caught by these checks.  If it evaluates to NaN it will be
+treated as invalid data rather than as a missing data point.  If you
+want to treat such invalid data the same as missing data, use the
+command *note NaN::.
+
+
+File: gnuplot.info,  Node: set_datafile_separator,  Next: set_datafile_commentschars,  Prev: set_datafile_missing,  Up: datafile
+
+3.33.23.5 set datafile separator
+................................
+
+The command 'set datafile separator' tells 'gnuplot' that data fields in
+subsequent input files are separated by a specific character rather than
+by whitespace.  The most common use is to read in csv (comma-separated
+value) files written by spreadsheet or database programs.  By default
+data fields are separated by whitespace.
+
+   Syntax:
+           set datafile separator {whitespace | tab | comma | "<chars>"}
+
+
+   Examples:
+           # Input file contains tab-separated fields
+           set datafile separator "\t"
+
+
+           # Input file contains comma-separated values fields
+           set datafile separator comma
+
+
+           # Input file contains fields separated by either * or |
+           set datafile separator "*|"
+
+
+
+File: gnuplot.info,  Node: set_datafile_commentschars,  Next: set_datafile_binary,  Prev: set_datafile_separator,  Up: datafile
+
+3.33.23.6 set datafile commentschars
+....................................
+
+The command 'set datafile commentschars' specifies what characters can
+be used in a data file to begin comment lines.  If the first non-blank
+character on a line is one of these characters then the rest of the data
+line is ignored.  Default value of the string is "#!"  on VMS and "#"
+otherwise.
+
+   Syntax:
+           set datafile commentschars {"<string>"}
+           show datafile commentschars
+           unset commentschars
+
+
+   Then, the following line in a data file is completely ignored
+         # 1 2 3 4
+
+   but the following
+         1 # 3 4
+
+   will be interpreted as garbage in the 2nd column followed by valid
+data in the 3rd and 4th columns.
+
+   Example:
+           set datafile commentschars "#!%"
+
+
+
+File: gnuplot.info,  Node: set_datafile_binary,  Prev: set_datafile_commentschars,  Up: datafile
+
+3.33.23.7 set datafile binary
+.............................
+
+The *note binary:: command is used to set the defaults when reading
+binary data files.  The syntax matches precisely that used for commands
+'plot' and 'splot'.  See *note matrix:: and *note general:: for details
+about the keywords that can be present in <binary list>.
+
+   Syntax:
+           set datafile binary <binary list>
+           show datafile binary
+           show datafile
+           unset datafile
+
+
+   Examples:
+           set datafile binary filetype=auto
+           set datafile binary array=(512,512) format="%uchar"
+
+
+           show datafile binary   # list current settings
+
+
+
+File: gnuplot.info,  Node: decimalsign,  Next: dgrid3d,  Prev: datafile,  Up: set-show
+
+3.33.24 decimalsign
+-------------------
+
+The *note decimalsign:: command selects a decimal sign for numbers
+printed into tic labels or 'set label' strings.
+
+   Syntax:
+           set decimalsign {<value> | locale {"<locale>"}}
+           unset decimalsign
+           show decimalsign
+
+
+   The argument <value> is a string to be used in place of the usual
+decimal point.  Typical choices include the period, '.', and the comma,
+',', but others may be useful, too.  If you omit the <value> argument,
+the decimal separator is not modified from the usual default, which is a
+period.  Unsetting decimalsign has the same effect as omitting <value>.
+
+   Example:
+
+   Correct typesetting in most European countries requires:
+           set decimalsign ','
+
+
+   Please note: If you set an explicit string, this affects only numbers
+that are printed using gnuplot's gprintf() formatting routine, including
+axis tics.  It does not affect the format expected for input data, and
+it does not affect numbers printed with the sprintf() formatting
+routine.  To change the behavior of both input and output formatting,
+instead use the form
+
+           set decimalsign locale
+
+
+   This instructs the program to use both input and output formats in
+accordance with the current setting of the LC_ALL, LC_NUMERIC, or LANG
+environmental variables.
+
+           set decimalsign locale "foo"
+
+
+   This instructs the program to format all input and output in
+accordance with locale "foo", which must be installed.  If locale "foo"
+is not found then an error message is printed and the decimal sign
+setting is unchanged.  On linux systems you can get a list of the
+locales installed on your machine by typing "locale -a".  A typical
+linux locale string is of the form "sl_SI.UTF-8".  A typical Windows
+locale string is of the form "Slovenian_Slovenia.1250" or "slovenian".
+Please note that interpretation of the locale settings is done by the C
+library at runtime.  Older C libraries may offer only partial support
+for locale settings such as the thousands grouping separator character.
+
+           set decimalsign locale; set decimalsign "."
+
+
+   This sets all input and output to use whatever decimal sign is
+correct for the current locale, but over-rides this with an explicit '.'
+in numbers formatted using gnuplot's internal gprintf() function.
+
+
+File: gnuplot.info,  Node: dgrid3d,  Next: dummy,  Prev: decimalsign,  Up: set-show
+
+3.33.25 dgrid3d
+---------------
+
+The *note dgrid3d:: command enables and sets parameters for mapping
+non-grid data onto a grid.  See 'splot grid_data' for details about the
+grid data structure.  Aside from its use in fitting 3D surfaces, this
+process can also be used to generate 2D heatmaps, where the 'z' value of
+each point contributes to a local weighted value.
+
+   Syntax:
+           set dgrid3d {<rows>} {,{<cols>}} splines
+           set dgrid3d {<rows>} {,{<cols>}} qnorm {<norm>}
+           set dgrid3d {<rows>} {,{<cols>}} {gauss | cauchy | exp | box | hann}
+                           {kdensity} {<dx>} {,<dy>}
+           unset dgrid3d
+           show dgrid3d
+
+
+   By default *note dgrid3d:: is disabled.  When enabled, 3D data points
+read from a file are treated as a scattered data set used to fit a
+gridded surface.  The grid dimensions are derived from the bounding box
+of the scattered data subdivided by the row/col_size parameters from the
+*note dgrid3d:: statement.  The grid is equally spaced in x (rows) and
+in y (columns); the z values are computed as weighted averages or spline
+interpolations of the scattered points' z values.  In other words, a
+regularly spaced grid is created and then a smooth approximation to the
+raw data is evaluated for each grid point.  This surface is then plotted
+in place of the raw data.
+
+   While dgrid3d mode is enabled, if you want to plot individual points
+or lines without using them to create a gridded surface you must append
+the keyword 'nogrid' to the corresponding splot command.
+
+   The number of columns defaults to the number of rows, which defaults
+to 10.
+
+   Several algorithms are available to calculate the approximation from
+the raw data.  Some of these algorithms can take additional parameters.
+These interpolations are such that the closer the data point is to a
+grid point, the more effect it has on that grid point.
+
+   The 'splines' algorithm calculates an interpolation based on thin
+plate splines.  It does not take additional parameters.
+
+   The 'qnorm' algorithm calculates a weighted average of the input data
+at each grid point.  Each data point is weighted by the inverse of its
+distance from the grid point raised to some power.  The power is
+specified as an optional integer parameter that defaults to 1.  This
+algorithm is the default.
+
+   Finally, several smoothing kernels are available to calculate
+weighted averages: z = Sum_i w(d_i) * z_i / Sum_i w(d_i), where z_i is
+the value of the i-th data point and d_i is the distance between the
+current grid point and the location of the i-th data point.  All kernels
+assign higher weights to data points that are close to the current grid
+point and lower weights to data points further away.
+
+   The following kernels are available:
+           gauss :     w(d) = exp(-d*d)
+           cauchy :    w(d) = 1/(1 + d*d)
+           exp :       w(d) = exp(-d)
+           box :       w(d) = 1                     if d<1
+                            = 0                     otherwise
+           hann :      w(d) = 0.5*(1+cos(pi*d))     if d<1
+                       w(d) = 0                     otherwise
+
+
+   When using one of these five smoothing kernels, up to two additional
+numerical parameters can be specified: dx and dy.  These are used to
+rescale the coordinate differences when calculating the distance: d_i =
+sqrt( ((x-x_i)/dx)**2 + ((y-y_i)/dy)**2 ), where x,y are the coordinates
+of the current grid point and x_i,y_i are the coordinates of the i-th
+data point.  The value of dy defaults to the value of dx, which defaults
+to 1.  The parameters dx and dy make it possible to control the radius
+over which data points contribute to a grid point IN THE UNITS OF THE
+DATA ITSELF.
+
+   The optional keyword 'kdensity', which must come after the name of
+the kernel, but before the optional scale parameters, modifies the
+algorithm so that the values calculated for the grid points are not
+divided by the sum of the weights ( z = Sum_i w(d_i) * z_i ).  If all
+z_i are constant, this effectively plots a bivariate kernel density
+estimate: a kernel function (one of the five defined above) is placed at
+each data point, the sum of these kernels is evaluated at every grid
+point, and this smooth surface is plotted instead of the original data.
+This is similar in principle to what the 'smooth kdensity' option does
+to 1D datasets.  See kdensity2d.dem and heatmap_points.dem for usage
+example.
+
+   The *note dgrid3d:: option is a simple scheme which replaces
+scattered data with weighted averages on a regular grid.  More
+sophisticated approaches to this problem exist and should be used to
+preprocess the data outside 'gnuplot' if this simple solution is found
+inadequate.
+
+   See also the online demos for dgrid3d
+(http://www.gnuplot.info/demo/dgrid3d.html) scatter
+(http://www.gnuplot.info/demo/scatter.html) and heatmap_points
+(http://www.gnuplot.info/demo/heatmap_points.html) D heatmap_points 1 D
+heatmap_points 2 D heatmap_points 3
+
+
+File: gnuplot.info,  Node: dummy,  Next: encoding,  Prev: dgrid3d,  Up: set-show
+
+3.33.26 dummy
+-------------
+
+The *note dummy:: command changes the default dummy variable names.
+
+   Syntax:
+           set dummy {<dummy-var>} {,<dummy-var>}
+           show dummy
+
+
+   By default, 'gnuplot' assumes that the independent, or "dummy",
+variable for the 'plot' command is "t" if in parametric or polar mode,
+or "x" otherwise.  Similarly the independent variables for the 'splot'
+command are "u" and "v" in parametric mode ('splot' cannot be used in
+polar mode), or "x" and "y" otherwise.
+
+   It may be more convenient to call a dummy variable by a more
+physically meaningful or conventional name.  For example, when plotting
+time functions:
+
+           set dummy t
+           plot sin(t), cos(t)
+
+
+   Examples:
+           set dummy u,v
+           set dummy ,s
+
+
+   The second example sets the second variable to s.  To reset the dummy
+variable names to their default values, use
+
+           unset dummy
+
+
+
+File: gnuplot.info,  Node: encoding,  Next: errorbars,  Prev: dummy,  Up: set-show
+
+3.33.27 encoding
+----------------
+
+The *note encoding:: command selects a character encoding.
+
+   Syntax:
+           set encoding {<value>}
+           set encoding locale
+           show encoding
+
+
+   Valid values are
+        default     - tells a terminal to use its default encoding
+        iso_8859_1  - the most common Western European encoding prior to UTF-8.
+                      Known in the PostScript world as 'ISO-Latin1'.
+        iso_8859_15 - a variant of iso_8859_1 that includes the Euro symbol
+        iso_8859_2  - used in Central and Eastern Europe
+        iso_8859_9  - used in Turkey (also known as Latin5)
+        koi8r       - popular Unix cyrillic encoding
+        koi8u       - Ukrainian Unix cyrillic encoding
+        cp437       - codepage for MS-DOS
+        cp850       - codepage for OS/2, Western Europe
+        cp852       - codepage for OS/2, Central and Eastern Europe
+        cp950       - MS version of Big5 (emf terminal only)
+        cp1250      - codepage for MS Windows, Central and Eastern Europe
+        cp1251      - codepage for 8-bit Russian, Serbian, Bulgarian, Macedonian
+        cp1252      - codepage for MS Windows, Western Europe
+        cp1254      - codepage for MS Windows, Turkish (superset of Latin5)
+        sjis        - shift-JIS Japanese encoding
+        utf8        - variable-length (multibyte) representation of Unicode
+                      entry point for each character
+
+
+   The command *note locale:: is different from the other options.  It
+attempts to determine the current locale from the runtime environment.
+On most systems this is controlled by the environmental variables
+LC_ALL, LC_CTYPE, or LANG. This mechanism is necessary, for example, to
+pass multibyte character encodings such as UTF-8 or EUC_JP to the wxt
+and pdf terminals.  This command does not affect the locale-specific
+representation of dates or numbers.  See also *note locale:: and *note
+decimalsign::.
+
+   Generally you should set the encoding before setting the terminal
+type, as it may affect the selection of fonts.
+
+
+File: gnuplot.info,  Node: errorbars,  Next: fit_,  Prev: encoding,  Up: set-show
+
+3.33.28 errorbars
+-----------------
+
+The *note errorbars:: command controls the tics at the ends of error
+bars, and also at the end of the whiskers belonging to a boxplot.
+
+   Syntax:
+           set errorbars {small | large | fullwidth | <size>} {front | back}
+                         {line-properties}
+           unset errorbars
+           show errorbars
+
+
+   'small' is a synonym for 0.0 (no crossbar), and 'large' for 1.0.  The
+default is 1.0 if no size is given.
+
+   The keyword 'fullwidth' is relevant only to boxplots and to
+histograms with errorbars.  It sets the width of the errorbar ends to be
+the same as the width of the associated box.  It does not change the
+width of the box itself.
+
+   The 'front' and 'back' keywords are relevant only to errorbars
+attached to filled rectangles (boxes, candlesticks, histograms).
+
+   Error bars are by default drawn using the same line properties as the
+border of the associated box.  You can change this by providing a
+separate set of line properties for the error bars.
+
+          set errorbars linecolor black linewidth 0.5 dashtype '.'
+
+
+
+File: gnuplot.info,  Node: fit_,  Next: fontpath,  Prev: errorbars,  Up: set-show
+
+3.33.29 fit
+-----------
+
+The *note fit:: command controls the options for the *note fit::
+command.
+
+   Syntax:
+           set fit {nolog | logfile {"<filename>"|default}}
+                   {{no}quiet|results|brief|verbose}
+                   {{no}errorvariables}
+                   {{no}covariancevariables}
+                   {{no}errorscaling}
+                   {{no}prescale}
+                   {maxiter <value>|default}
+                   {limit <epsilon>|default}
+                   {limit_abs <epsilon_abs>}
+                   {start-lambda <value>|default}
+                   {lambda-factor <value>|default}
+                   {script {"<command>"|default}}
+                   {v4 | v5}
+           unset fit
+           show fit
+
+
+   The 'logfile' option defines where the *note fit:: command writes its
+output.  The <filename> argument must be enclosed in single or double
+quotes.  If no filename is given or *note fit:: is used the log file is
+reset to its default value "fit.log" or the value of the environmental
+variable 'FIT_LOG'. If the given logfile name ends with a / or \, it is
+interpreted to be a directory name, and the actual filename will be
+"fit.log" in that directory.
+
+   By default the information written to the log file is also echoed to
+the terminal session.  'set fit quiet' turns off the echo, whereas
+'results' prints only final results.  'brief' gives one line summaries
+for every iteration of the fit in addition.  'verbose' yields detailed
+iteration reports as in version 4.
+
+   If the 'errorvariables' option is turned on, the error of each fitted
+parameter computed by *note fit:: will be copied to a user-defined
+variable whose name is formed by appending "_err" to the name of the
+parameter itself.  This is useful mainly to put the parameter and its
+error onto a plot of the data and the fitted function, for reference, as
+in:
+
+            set fit errorvariables
+            fit f(x) 'datafile' using 1:2 via a, b
+            print "error of a is:", a_err
+            set label 1 sprintf("a=%6.2f +/- %6.2f", a, a_err)
+            plot 'datafile' using 1:2, f(x)
+
+
+   If the 'errorscaling' option is specified, which is the default, the
+calculated parameter errors are scaled with the reduced chi square.
+This is equivalent to providing data errors equal to the calculated
+standard deviation of the fit (FIT_STDFIT) resulting in a reduced chi
+square of one.  With the 'noerrorscaling' option the estimated errors
+are the unscaled standard deviations of the fit parameters.  If no
+weights are specified for the data, parameter errors are always scaled.
+
+   If the 'prescale' option is turned on, parameters are prescaled by
+their initial values before being passed to the Marquardt-Levenberg
+routine.  This helps tremendously if there are parameters that differ in
+size by many orders of magnitude.  Fit parameters with an initial value
+of exactly zero are never prescaled.
+
+   The maximum number of iterations may be limited with the 'maxiter'
+option.  A value of 0 or 'default' means that there is no limit.
+
+   The 'limit' option can be used to change the default epsilon limit
+(1e-5) to detect convergence.  When the sum of squared residuals changes
+by a factor less than this number (epsilon), the fit is considered to
+have 'converged'.  The 'limit_abs' option imposes an additional absolute
+limit in the change of the sum of squared residuals and defaults to
+zero.
+
+   If you need even more control about the algorithm, and know the
+Marquardt-Levenberg algorithm well, the following options can be used to
+influence it.  The startup value of 'lambda' is normally calculated
+automatically from the ML-matrix, but if you want to, you may provide
+your own using the 'start_lambda' option.  Setting it to 'default' will
+re-enable the automatic selection.  The option 'lambda_factor' sets the
+factor by which 'lambda' is increased or decreased whenever the
+chi-squared target function increased or decreased significantly.
+Setting it to 'default' re-enables the default factor of 10.0.
+
+   The 'script' option may be used to specify a 'gnuplot' command to be
+executed when a fit is interrupted--see *note fit::.  This setting takes
+precedence over the default of *note replot:: and the environment
+variable 'FIT_SCRIPT'.
+
+   If the 'covariancevariables' option is turned on, the covariances
+between final parameters will be saved to user-defined variables.  The
+variable name for a certain parameter combination is formed by
+prepending "FIT_COV_" to the name of the first parameter and combining
+the two parameter names by "_".  For example given the parameters "a"
+and "b" the covariance variable is named "FIT_COV_a_b".
+
+   In version 5 the syntax of the fit command changed and it now
+defaults to unitweights if no 'error' keyword is given.  The 'v4' option
+restores the default behavior of gnuplot version 4, see also *note
+fit::.
+
+
+File: gnuplot.info,  Node: fontpath,  Next: format__,  Prev: fit_,  Up: set-show
+
+3.33.30 fontpath
+----------------
+
+Syntax:
+           set fontpath "/directory/where/my/fonts/live"
+           set term postscript fontfile <filename>
+
+
+   [DEPRECATED in version 5.4]
+
+   The *note fontpath:: directory is relevant only for embedding fonts
+in postscript output produced by the postscript terminal.  It has no
+effect on other gnuplot terminals.  If you are not embedding fonts you
+do not need this command, and even if you are embedding fonts you only
+need it for fonts that cannot be found via the other paths below.
+
+   Earlier versions of gnuplot tried to emulate a font manager by
+tracking multiple directory trees containing fonts.  This is now
+replaced by a search in the following places: (1) an absolute path given
+in the 'set term postscript fontfile' command (2) the current directory
+(3) any of the directories specified by *note loadpath:: (4) the
+directory specified by *note fontpath:: (5) the directory provided in
+environmental variable GNUPLOT_FONTPATH
+
+   Note: The search path for fonts specified by filename for the libgd
+terminals (png gif jpeg sixel) is controlled by environmental variable
+GDFONTPATH.
+
+
+File: gnuplot.info,  Node: format__,  Next: grid,  Prev: fontpath,  Up: set-show
+
+3.33.31 format
+--------------
+
+The format of the tic-mark labels can be set with the 'set format'
+command or with the 'set tics format' or individual 'set {axis}tics
+format' commands.  For information on using an explicit format for input
+data see 'using format'.
+
+   Syntax:
+           set format {<axes>} {"<format-string>"} {numeric|timedate|geographic}
+           show format
+
+
+   where <axes> is either 'x', 'y', 'xy', 'x2', 'y2', 'z', 'cb' or
+nothing (which applies the format to all axes).  The following two
+commands are equivalent:
+           set format y "%.2f"
+           set ytics format "%.2f"
+
+
+   The length of the string is restricted to 100 characters.  The
+default format is "% h", "$%h$" for LaTeX terminals.  Other formats such
+as "%.2f" or "%3.0em" are often desirable.  "set format" with no
+following string will restore the default.
+
+   If the empty string "" is given, tics will have no labels, although
+the tic mark will still be plotted.  To eliminate the tic marks, use
+'unset xtics' or 'set tics scale 0'.
+
+   Newline (\n) and enhanced text markup is accepted in the format
+string.  Use double-quotes rather than single-quotes in this case.  See
+also 'syntax'.  Characters not preceded by "%" are printed verbatim.
+Thus you can include spaces and labels in your format string, such as
+"%g m", which will put " m" after each number.  If you want "%" itself,
+double it: "%g %%".
+
+   See also 'set xtics' for more information about tic labels, and *note
+decimalsign:: for how to use non-default decimal separators in numbers
+printed this way.  See also electron demo (electron.dem).
+(http://www.gnuplot.info/demo/electron.html)
+
+* Menu:
+
+* gprintf_::
+* format_specifiers::
+* time/date_specifiers::
+
+
+File: gnuplot.info,  Node: gprintf_,  Next: format_specifiers,  Prev: format__,  Up: format__
+
+3.33.31.1 gprintf
+.................
+
+The string function gprintf("format",x) uses gnuplot's own format
+specifiers, as do the gnuplot commands 'set format', *note timestamp::,
+and others.  These format specifiers are not the same as those used by
+the standard C-language routine sprintf().  gprintf() accepts only a
+single variable to be formatted.  Gnuplot also provides an
+sprintf("format",x1,x2,...)  routine if you prefer.  For a list of
+gnuplot's format options, see 'format specifiers'.
+
+
+File: gnuplot.info,  Node: format_specifiers,  Next: time/date_specifiers,  Prev: gprintf_,  Up: format__
+
+3.33.31.2 format specifiers
+...........................
+
+The acceptable formats (if not in time/date mode) are:
+
+           Format       Explanation
+           %f           floating point notation
+           %e or %E     exponential notation; an "e" or "E" before the power
+           %g or %G     the shorter of %e (or %E) and %f
+           %h or %H     like %g with "x10^{%S}" or "*10^{%S}" instead of "e%S"
+           %x or %X     hex
+           %o or %O     octal
+           %t           mantissa to base 10
+           %l           mantissa to base of current logscale
+           %s           mantissa to base of current logscale; scientific power
+           %T           power to base 10
+           %L           power to base of current logscale
+           %S           scientific power
+           %c           character replacement for scientific power
+           %b           mantissa of ISO/IEC 80000 notation (ki, Mi, Gi, Ti, Pi, Ei, Zi, Yi)
+           %B           prefix of ISO/IEC 80000 notation (ki, Mi, Gi, Ti, Pi, Ei, Zi, Yi)
+           %P           multiple of pi
+
+
+   A 'scientific' power is one such that the exponent is a multiple of
+three.  Character replacement of scientific powers ('"%c"') has been
+implemented for powers in the range -18 to +18.  For numbers outside of
+this range the format reverts to exponential.
+
+   Other acceptable modifiers (which come after the "%" but before the
+format specifier) are "-", which left-justifies the number; "+", which
+forces all numbers to be explicitly signed; " " (a space), which makes
+positive numbers have a space in front of them where negative numbers
+have "-"; "#", which places a decimal point after floats that have only
+zeroes following the decimal point; a positive integer, which defines
+the field width; "0" (the digit, not the letter) immediately preceding
+the field width, which indicates that leading zeroes are to be used
+instead of leading blanks; and a decimal point followed by a
+non-negative integer, which defines the precision (the minimum number of
+digits of an integer, or the number of digits following the decimal
+point of a float).
+
+   Some systems may not support all of these modifiers but may also
+support others; in case of doubt, check the appropriate documentation
+and then experiment.
+
+   Examples:
+           set format y "%t"; set ytics (5,10)          # "5.0" and "1.0"
+           set format y "%s"; set ytics (500,1000)      # "500" and "1.0"
+           set format y "%+-12.3f"; set ytics(12345)    # "+12345.000  "
+           set format y "%.2t*10^%+03T"; set ytic(12345)# "1.23*10^+04"
+           set format y "%s*10^{%S}"; set ytic(12345)   # "12.345*10^{3}"
+           set format y "%s %cg"; set ytic(12345)       # "12.345 kg"
+           set format y "%.0P pi"; set ytic(6.283185)   # "2 pi"
+           set format y "%.0f%%"; set ytic(50)          # "50%"
+
+
+           set log y 2; set format y '%l'; set ytics (1,2,3)
+           #displays "1.0", "1.0" and "1.5" (since 3 is 1.5 * 2^1)
+
+
+   There are some problem cases that arise when numbers like 9.999 are
+printed with a format that requires both rounding and a power.
+
+   If the data type for the axis is time/date, the format string must
+contain valid codes for the 'strftime' function (outside of 'gnuplot',
+type "man strftime").  See *note timefmt:: for a list of the allowed
+input format codes.
+
+
+File: gnuplot.info,  Node: time/date_specifiers,  Prev: format_specifiers,  Up: format__
+
+3.33.31.3 time/date specifiers
+..............................
+
+There are two groups of time format specifiers: time/date and relative
+time.  These may be used to generate axis tic labels or to encode time
+in a string.  See 'set xtics time', *note strftime::, *note strptime::.
+
+   The time/date formats are
+
+           Format       Explanation
+           %a           short name of day of the week (ignored on input)
+           %A           full name of day of the week (ignored on input)
+           %b or %h     abbreviated name of the month
+           %B           full name of the month
+           %d           day of the month, 01--31
+           %D           shorthand for "%m/%d/%y" (only output)
+           %F           shorthand for "%Y-%m-%d" (only output)
+           %k           hour, 0--23 (one or two digits)
+           %H           hour, 00--23 (always two digits)
+           %l           hour, 1--12 (one or two digits)
+           %I           hour, 01--12 (always two digits)
+           %j           day of the year, 001--366
+           %m           month, 01--12
+           %M           minute, 00--60
+           %p           "am" or "pm"
+           %r           shorthand for "%I:%M:%S %p" (only output)
+           %R           shorthand for "%H:%M" (only output)
+           %s           number of seconds since the start of year 1970
+           %S           second, integer 00--60 on output, (double) on input
+           %T           shorthand for "%H:%M:%S" (only output)
+           %U           week of the year (CDC/MMWR "epi week") (ignored on input)
+           %w           day of the week, 0--6 (Sunday = 0) (ignored on input)
+           %W           week of the year (ISO 8601 week date) (ignored on input)
+           %y           year, 0-68 for 2000-2068, 69-99 for 1969-1999
+           %Y           year, 4-digit
+           %z           timezone, [+-]hh:mm
+           %Z           timezone name, ignored string
+
+
+   For more information on the %W format (ISO week of year) see
+'tm_week'.  The %U format (CDC/MMWR epidemiological week) is similar to
+%W except that it uses weeks that start on Sunday rather than Monday.
+Caveat: Both the %W and the %U formats were unreliable in gnuplot
+versions prior to 5.4.2.  See unit test "week_date.dem".
+
+   The relative time formats express the length of a time interval on
+either side of a zero time point.  The relative time formats are
+
+           Format       Explanation
+           %tD          +/- days relative to time=0
+           %tH          +/- hours relative to time=0 (does not wrap at 24)
+           %tM          +/- minutes relative to time=0
+           %tS          +/- seconds associated with previous tH or tM field
+
+
+   Numerical formats may be preceded by a "0" ("zero") to pad the field
+with leading zeroes, and preceded by a positive digit to define the
+minimum field width.  The %S, and %t formats also accept a precision
+specifier so that fractional hours/minutes/seconds can be written.
+
+-- EXAMPLES --
+
+   Examples of date format:
+
+   Suppose the x value in seconds corresponds a time slightly before
+midnight on 25 Dec 1976.  The text printed for a tic label at this
+position would be
+
+           set format x                 # defaults to "12/25/76 \n 23:11"
+           set format x "%A, %d %b %Y"  # "Saturday, 25 Dec 1976"
+           set format x "%r %D"         # "11:11:11 pm 12/25/76"
+           set xtics time format "%B"   # "December"
+
+
+   Examples of time format:
+
+   The date format specifiers encode a time in seconds as a clock time
+on a particular day.  So hours run only from 0-23, minutes from 0-59,
+and negative values correspond to dates prior to the epoch (1-Jan-1970).
+In order to report a time value in seconds as some number of
+hours/minutes/seconds relative to a time 0, use time formats %tH %tM
+%tS. To report a value of -3672.50 seconds
+
+           set format x                 # default date format "12/31/69 \n 22:58"
+           set format x "%tH:%tM:%tS"   # "-01:01:12"
+           set format x "%.2tH hours"   # "-1.02 hours"
+           set format x "%tM:%.2tS"     # "-61:12.50"
+
+
+
+File: gnuplot.info,  Node: grid,  Next: hidden3d,  Prev: format__,  Up: set-show
+
+3.33.32 grid
+------------
+
+The 'set grid' command allows grid lines to be drawn on the plot.
+
+   Syntax:
+           set grid {{no}{m}xtics} {{no}{m}ytics} {{no}{m}ztics}
+                    {{no}{m}x2tics} {{no}{m}y2tics} {{no}{m}rtics}
+                    {{no}{m}cbtics}
+                    {polar {<angle>}}
+                    {layerdefault | front | back}
+                    {{no}vertical}
+                    {<line-properties-major> {, <line-properties-minor>}}
+           unset grid
+           show grid
+
+
+   The grid can be enabled and disabled for the major and/or minor tic
+marks on any axis, and the linetype and linewidth can be specified for
+major and minor grid lines, also via a predefined linestyle, as far as
+the active terminal driver supports this (see 'set style line').
+
+   A polar grid can be drawn for 2D plots.  This is the default action
+of 'set grid' if the program is already in polar mode, but can be
+enabled explicitly by *note rtics:: whether or not the program is in
+polar mode.  Circles are drawn to intersect major and/or minor tics
+along the r axis, and radial lines are drawn with a spacing of <angle>.
+Tic marks around the perimeter are controlled by *note ttics::, but
+these do not produce radial grid lines.
+
+   The pertinent tics must be enabled before 'set grid' can draw them;
+'gnuplot' will quietly ignore instructions to draw grid lines at
+non-existent tics, but they will appear if the tics are subsequently
+enabled.
+
+   If no linetype is specified for the minor gridlines, the same
+linetype as the major gridlines is used.  The default polar angle is 30
+degrees.
+
+   If 'front' is given, the grid is drawn on top of the graphed data.
+If 'back' is given, the grid is drawn underneath the graphed data.
+Using 'front' will prevent the grid from being obscured by dense data.
+The default setup, 'layerdefault', is equivalent to 'back' for 2D plots.
+In 3D plots the default is to split up the grid and the graph box into
+two layers: one behind, the other in front of the plotted data and
+functions.  Since *note hidden3d:: mode does its own sorting, it ignores
+all grid drawing order options and passes the grid lines through the
+hidden line removal machinery instead.  These options actually affect
+not only the grid, but also the lines output by *note border:: and the
+various ticmarks (see 'set xtics').
+
+   In 3D plots grid lines at x- and y- axis tic positions are by default
+drawn only on the base plane parallel to z=0.  The 'vertical' keyword
+activates drawing grid lines in the xz and yz planes also, running from
+zmin to zmax.
+
+   Z grid lines are drawn on the bottom of the plot.  This looks better
+if a partial box is drawn around the plot--see *note border::.
+
+
+File: gnuplot.info,  Node: hidden3d,  Next: history_,  Prev: grid,  Up: set-show
+
+3.33.33 hidden3d
+----------------
+
+The *note hidden3d:: command enables hidden line removal for surface
+plotting (see 'splot').  Some optional features of the underlying
+algorithm can also be controlled using this command.
+
+   Syntax:
+           set hidden3d {defaults} |
+                        { {front|back}
+                          {{offset <offset>} | {nooffset}}
+                          {trianglepattern <bitpattern>}
+                          {{undefined <level>} | {noundefined}}
+                          {{no}altdiagonal}
+                          {{no}bentover} }
+           unset hidden3d
+           show hidden3d
+
+
+   In contrast to the usual display in gnuplot, hidden line removal
+actually treats the given function or data grids as real surfaces that
+can't be seen through, so plot elements behind the surface will be
+hidden by it.  For this to work, the surface needs to have 'grid
+structure' (see *note datafile:: about this), and it has to be drawn
+'with lines' or *note linespoints::.
+
+   When *note hidden3d:: is set, both the hidden portion of the surface
+and possibly its contours drawn on the base (see 'set contour') as well
+as the grid will be hidden.  Each surface has its hidden parts removed
+with respect to itself and to other surfaces, if more than one surface
+is plotted.  Contours drawn on the surface ('set contour surface') don't
+work.
+
+   *note hidden3d:: also affects 3D plotting styles 'points', *note
+labels::, *note vectors::, and *note impulses:: even if no surface is
+present in the graph.  Unobscured portions of each vector are drawn as
+line segments (no arrowheads).  Individual plots within the graph may be
+explicitly excluded from this processing by appending the extra option
+'nohidden3d' to the 'with' specifier.
+
+   Hidden3d does not affect solid surfaces drawn using the pm3d mode.
+To achieve a similar effect purely for pm3d surfaces, use instead 'set
+pm3d depthorder'.  To mix pm3d surfaces with normal *note hidden3d::
+processing, use the option 'set hidden3d front' to force all elements
+included in hidden3d processing to be drawn after any remaining plot
+elements, including the pm3d surface.
+
+   Functions are evaluated at isoline intersections.  The algorithm
+interpolates linearly between function points or data points when
+determining the visible line segments.  This means that the appearance
+of a function may be different when plotted with *note hidden3d:: than
+when plotted with 'nohidden3d' because in the latter case functions are
+evaluated at each sample.  Please see *note samples:: and *note
+isosamples:: for discussion of the difference.
+
+   The algorithm used to remove the hidden parts of the surfaces has
+some additional features controllable by this command.  Specifying
+'defaults' will set them all to their default settings, as detailed
+below.  If 'defaults' is not given, only explicitly specified options
+will be influenced: all others will keep their previous values, so you
+can turn on/off hidden line removal via 'set {no}hidden3d', without
+modifying the set of options you chose.
+
+   The first option, 'offset', influences the linetype used for lines on
+the 'back' side.  Normally, they are drawn in a linetype one index
+number higher than the one used for the front, to make the two sides of
+the surface distinguishable.  You can specify a different linetype
+offset to add instead of the default 1, by 'offset <offset>'.  Option
+'nooffset' stands for 'offset 0', making the two sides of the surface
+use the same linetype.
+
+   Next comes the option 'trianglepattern <bitpattern>'.  <bitpattern>
+must be a number between 0 and 7, interpreted as a bit pattern.  Each
+bit determines the visibility of one edge of the triangles each surface
+is split up into.  Bit 0 is for the 'horizontal' edges of the grid, Bit
+1 for the 'vertical' ones, and Bit 2 for the diagonals that split each
+cell of the original grid into two triangles.  The default pattern is 3,
+making all horizontal and vertical lines visible, but not the diagonals.
+You may want to choose 7 to see those diagonals as well.
+
+   The 'undefined <level>' option lets you decide what the algorithm is
+to do with data points that are undefined (missing data, or undefined
+function values), or exceed the given x-, y- or z-ranges.  Such points
+can either be plotted nevertheless, or taken out of the input data set.
+All surface elements touching a point that is taken out will be taken
+out as well, thus creating a hole in the surface.  If <level> = 3,
+equivalent to option 'noundefined', no points will be thrown away at
+all.  This may produce all kinds of problems elsewhere, so you should
+avoid this.  <level> = 2 will throw away undefined points, but keep the
+out-of-range ones.  <level> = 1, the default, will get rid of
+out-of-range points as well.
+
+   By specifying 'noaltdiagonal', you can override the default handling
+of a special case can occur if *note undefined:: is active (i.e.
+<level> is not 3).  Each cell of the grid-structured input surface will
+be divided in two triangles along one of its diagonals.  Normally, all
+these diagonals have the same orientation relative to the grid.  If
+exactly one of the four cell corners is excluded by the *note
+undefined:: handler, and this is on the usual diagonal, both triangles
+will be excluded.  However if the default setting of 'altdiagonal' is
+active, the other diagonal will be chosen for this cell instead,
+minimizing the size of the hole in the surface.
+
+   The 'bentover' option controls what happens to another special case,
+this time in conjunction with the 'trianglepattern'.  For rather crumply
+surfaces, it can happen that the two triangles a surface cell is divided
+into are seen from opposite sides (i.e.  the original quadrangle is
+'bent over'), as illustrated in the following ASCII art:
+
+                                                                   C----B
+         original quadrangle:  A--B      displayed quadrangle:     |\   |
+           ("set view 0,0")    | /|    ("set view 75,75" perhaps)  | \  |
+                               |/ |                                |  \ |
+                               C--D                                |   \|
+                                                                   A    D
+
+
+   If the diagonal edges of the surface cells aren't generally made
+visible by bit 2 of the <bitpattern> there, the edge CB above wouldn't
+be drawn at all, normally, making the resulting display hard to
+understand.  Therefore, the default option of 'bentover' will turn it
+visible in this case.  If you don't want that, you may choose
+'nobentover' instead.  D hidden 6 See also hidden line removal demo
+(hidden.dem) (http://www.gnuplot.info/demo/hidden.html) and complex
+hidden line demo (singulr.dem).
+(http://www.gnuplot.info/demo/singulr.html)
+
+
+File: gnuplot.info,  Node: history_,  Next: isosamples,  Prev: hidden3d,  Up: set-show
+
+3.33.34 history
+---------------
+
+Syntax:
+        set history {size <N>} {quiet|numbers} {full|trim} {default}
+
+
+   A log of recent gnuplot commands is kept by default in
+$HOME/.gnuplot_history.  If this file is not found and xdg desktop
+support is enabled, the program will instead use
+$XDG_STATE_HOME/gnuplot_history.
+
+   When leaving gnuplot the value of history size limits the number of
+lines saved to the history file.  'set history size -1' allows an
+unlimited number of lines to be written to the history file.
+
+   By default the *note history:: command prints a line number in front
+of each command.  'history quiet' suppresses the number for this command
+only.  'set history quiet' suppresses numbers for all future *note
+history:: commands.
+
+   The *note trim:: option reduces the number of duplicate lines in the
+history list by removing earlier instances of the current command.
+
+   Default settings: *note trim::.
+
+
+File: gnuplot.info,  Node: isosamples,  Next: isosurface_,  Prev: history_,  Up: set-show
+
+3.33.35 isosamples
+------------------
+
+The isoline density (grid) for plotting functions as surfaces may be
+changed by the *note isosamples:: command.
+
+   Syntax:
+           set isosamples <iso_1> {,<iso_2>}
+           show isosamples
+
+
+   Each function surface plot will have <iso_1> iso-u lines and <iso_2>
+iso-v lines.  If you only specify <iso_1>, <iso_2> will be set to the
+same value as <iso_1>.  By default, sampling is set to 10 isolines per u
+or v axis.  A higher sampling rate will produce more accurate plots, but
+will take longer.  These parameters have no effect on data file
+plotting.
+
+   An isoline is a curve parameterized by one of the surface parameters
+while the other surface parameter is fixed.  Isolines provide a simple
+means to display a surface.  By fixing the u parameter of surface
+s(u,v), the iso-u lines of the form c(v) = s(u0,v) are produced, and by
+fixing the v parameter, the iso-v lines of the form c(u) = s(u,v0) are
+produced.
+
+   When a function surface plot is being done without the removal of
+hidden lines, *note samples:: controls the number of points sampled
+along each isoline; see *note samples:: and *note hidden3d::.  The
+contour algorithm assumes that a function sample occurs at each isoline
+intersection, so change in *note samples:: as well as *note isosamples::
+may be desired when changing the resolution of a function
+surface/contour.
+
+
+File: gnuplot.info,  Node: isosurface_,  Next: isotropic,  Prev: isosamples,  Up: set-show
+
+3.33.36 isosurface
+------------------
+
+Syntax:
+          set isosurface {mixed|triangles}
+          set isosurface {no}insidecolor <n>
+
+   Surfaces plotted by the command *note isosurface:: are by default
+constructed from a mixture of quadrangles and triangles.  The use of
+quadrangles creates a less complicated visual impression.  This command
+provides an option to tessellate with only triangles.
+
+   By default the inside of an isosurface is drawn in a separate color.
+The method of choosing that color is the same as for hidden3d surfaces,
+where an offset <n> is added to the base linetype.  To draw both the
+inside and outside surfaces in the same color, use 'set isosurface
+noinsidecolor'.
+
+
+File: gnuplot.info,  Node: isotropic,  Next: jitter,  Prev: isosurface_,  Up: set-show
+
+3.33.37 isotropic
+-----------------
+
+Syntax:
+          set isotropic
+          unset isotropic
+
+   *note isotropic:: adjusts the aspect ratio and size of the plot so
+that the unit length along the x, y, and z axes is the same.  It is
+equivalent to 'set size ratio -1; set view equal xyz' and supersedes
+both of those commands.  This affects both 2D and 3D plots.
+
+   *note isotropic:: relaxes both the 2D and 3D constraints.  It is
+equivalent to the older commands 'set size noratio; set view
+noequal_axes' but hopefully easier to remember.
+
+
+File: gnuplot.info,  Node: jitter,  Next: key_,  Prev: isotropic,  Up: set-show
+
+3.33.38 jitter
+--------------
+
+Syntax:
+           set jitter {overlap <yposition>} {spread <factor>} {wrap <limit>}
+                      {swarm|square|vertical}
+
+   Examples:
+           set jitter                    # jitter points within 1 character width
+           set jitter overlap 1.5        # jitter points within 1.5 character width
+           set jitter over 1.5 spread 0.5  # same but half the displacement on x
+
+
+   When one or both coordinates of a data set are restricted to discrete
+values then many points may lie exactly on top of each other.  Jittering
+introduces an offset to the coordinates of these superimposed points
+that spreads them into a cluster.  The threshold value for treating the
+points as being overlapped may be specified in character widths or any
+of the usual coordinate options.  See 'coordinates'.  Jitter affects 2D
+plot styles 'with points', *note impulses:: and *note boxplot::.  It
+also affects 3D plotting of voxel grids.
+
+   The default jittering operation displaces points only along x.  This
+produces a distinctive pattern sometimes called a "bee swarm plot".  The
+optional keyword 'square' adjusts the y coordinate of displaced points
+in addition to their x coordinate so that the points lie in distinct
+layers separated by at least the 'overlap' distance.
+
+   To jitter along y (only) rather than along x, use keyword 'vertical'.
+
+   The maximum displacement (in character units) can be limited using
+the 'wrap' keyword.
+
+   Note that both the overlap criterion and the magnitude of jitter
+default to one character unit.  Thus the plot appearance will change
+with the terminal font size, canvas size, or zoom factor.  To avoid this
+you can specify the overlap criterion in the y axis coordinate system
+(the 'first' keyword) and adjust the point size and spread multiplier as
+appropriate.  See 'coordinates', *note pointsize::.
+
+   Caveat: jitter is incompatible with "pointsize variable".
+
+   *note jitter:: is also useful in 3D plots of voxel data.  Because
+voxel grids are regular lattices of evenly spaced points, many view
+angles cause points to overlap and/or generate Moiré patterns.  These
+artifacts can be removed by displacing the symbol drawn at each grid
+point by a random amount.
+
+
+File: gnuplot.info,  Node: key_,  Next: label,  Prev: jitter,  Up: set-show
+
+3.33.39 key
+-----------
+
+The 'set key' command enables a key (or legend) containing a title and a
+sample (line, point, box) for each plot in the graph.  The key may be
+turned off by requesting 'set key off' or 'unset key'.  Individual key
+entries may be turned off by using the 'notitle' keyword in the
+corresponding plot command.  The text of the titles is controlled by the
+'set key autotitle' option or by the *note title:: keyword of individual
+'plot' and 'splot' commands.
+
+   See 'key placement' for syntax of options that affect where the key
+is placed.  See 'key layout' for syntax of options that affect the
+content of the key.
+
+   Syntax (global options):
+           set key {on|off} {default}
+                 {font "<face>,<size>"} {{no}enhanced}
+                 {{no}title "<text>" {<font or other text options>}}
+                 {{no}autotitle {columnheader}}
+                 {{no}box {<line properties>}} {{no}opaque {fc <colorspec>}}
+                 {width <width_increment>} {height <height_increment>}
+           unset key
+
+
+   By default the key is placed in the upper right inside corner of the
+graph.  The optional 'font' becomes the default for all elements of the
+key.  You can provide an option title for the key as a whole that spans
+the full width of the key at the top.  This title can use different
+font, color, justification, and enhancement from individual plot titles.
+
+   Each component in a plot command is represented in the key by a
+single line containing corresponding title text and a line or symbol or
+shape representing the plot style.  The title text may be auto-generated
+or given explicitly in the plot command as 'title "text"'.  Using the
+keyword 'notitle' in the plot command will suppress generation of the
+entire line.  If you want to suppress the text only, use 'title ""' in
+the plot command.
+
+   Contour plots generated additional entries in the key (see *note
+cntrlabel::).  You can add extra lines to the key by inserting a dummy
+plot command that uses the keyword 'keyentry' rather than a filename or
+a function.  See 'keyentry'.
+
+   A box can be drawn around the key ('box {...}') with user-specified
+line properties.  The 'height' and 'width' increments (specified in
+character units) are added to or subtracted from the size of the key
+box.  This is useful mainly when you want larger borders around the key
+entries.
+
+   By default the key is built up one plot at a time.  That is, the key
+symbol and title are drawn at the same time as the corresponding plot.
+That means newer plots may sometimes place elements on top of the key.
+'set key opaque' causes the key to be generated after all the plots.  In
+this case the key area is filled with background color or the requested
+fill color and then the key symbols and titles are written.  The default
+can be restored by 'set key noopaque'.
+
+   The text in the key uses 'enhanced' mode by default.  This can be
+suppressed by the 'noenhanced' keyword applied to the entire key, to the
+key title only, or to individual plot titles.
+
+   'set key default' restores the default key configuration.
+          set key notitle
+          set key nobox noopaque
+          set key fixed right top vertical Right noreverse enhanced autotitle
+          set key noinvert samplen 4 spacing 1 width 0 height 0
+          set key maxcolumns 0 maxrows 0
+
+
+* Menu:
+
+* 3D_key::
+* key_examples::
+* extra_key_entries::
+* key_autotitle::
+* key_layout::
+* key_placement::
+* key_offset::
+* key_samples::
+* multiple_keys::
+
+
+File: gnuplot.info,  Node: 3D_key,  Next: key_examples,  Prev: key_,  Up: key_
+
+3.33.39.1 3D key
+................
+
+Placement of the key for 3D plots ('splot') by default uses the 'fixed'
+option.  This is very similar to 'inside' placement with one important
+difference.  The plot boundaries of a 3D plot change as the view point
+is rotated or scaled.  If the key is positioned 'inside' these
+boundaries then the key also moves when the view is changed.  'fixed'
+positioning ignores changes to the view angles or scaling; i.e.  the key
+remains fixed in one location on the canvas as the plot is rotated.
+
+   For 2D plots the 'fixed' option is exactly equivalent to 'inside'.
+
+   If 'splot' is being used to draw contours, by default a separate key
+entry is generated for each contour level with a distinct line type.  To
+modify this see *note cntrlabel::.
+
+
+File: gnuplot.info,  Node: key_examples,  Next: extra_key_entries,  Prev: 3D_key,  Up: key_
+
+3.33.39.2 key examples
+......................
+
+This places the key at the default location:
+           set key default
+
+
+   This places a key at a specific place (upper right) on the screen:
+           set key at screen 0.85, 0.85
+
+
+   This places the key below the graph and minimizes the vertical space
+taken:
+           set key below horizontal
+
+
+   This places the key in the bottom left corner of the plot,
+left-justifies the text, gives the key box a title at the top, and draws
+a box around it with a thick border:
+           set key left bottom Left title 'Legend' box lw 3
+
+
+
+File: gnuplot.info,  Node: extra_key_entries,  Next: key_autotitle,  Prev: key_examples,  Up: key_
+
+3.33.39.3 extra key entries
+...........................
+
+Normally each plot autogenerates a single line entry in the key.  If you
+need more control over what appears in the key you can use the
+'keyentry' keyword in the 'plot' or 'splot' command to insert extra
+lines.  Instead of providing a filename or function to plot, use
+'keyentry' as a placeholder followed by plot style information (used to
+generate a key symbol) and a title.  All the usual options for title
+font, text color, 'at' coordinates, and enhanced text markup apply.
+Example:
+          set key outside right center
+          plot $HEATMAP matrix with image notitle, \
+               keyentry "Outcomes" left, \
+               keyentry with boxes fc palette cb 0 title "no effect", \
+               keyentry with boxes fc palette cb 1 title "threshold", \
+               keyentry with boxes fc palette cb 3 title "typical range", \
+               keyentry                            title "as reported in [12]", \
+               keyentry with boxes fc palette cb 5 title "strong effect"
+
+
+   The line generated by 'keyentry "Outcomes" left' places
+left-justified text in the space that would normally hold the sample.
+This allows an embedded title that may span the full width of the key.
+If a title is given also in the same keyentry then both strings appear
+on the same line, allowing generation of two-column key entries.  You
+can use keywords 'left/right/center' for justification, 'boxed', etc.
+Example:
+          plot ..., keyentry "West Linn" boxed title "locations"
+
+
+
+File: gnuplot.info,  Node: key_autotitle,  Next: key_layout,  Prev: extra_key_entries,  Up: key_
+
+3.33.39.4 key autotitle
+.......................
+
+'set key autotitle' causes each plot to be identified in the key by the
+name of the data file or function used in the plot command.  This is the
+default.  'set key noautotitle' disables the automatic generation of
+plot titles.
+
+   The command 'set key autotitle columnheader' causes the first entry
+in each column of input data to be interpreted as a text string and used
+as a title for the corresponding plot.  If the quantity being plotted is
+a function of data from several columns, gnuplot may be confused as to
+which column to draw the title from.  In this case it is necessary to
+specify the column explicitly in the plot command, e.g.
+
+           plot "datafile" using (($2+$3)/$4) title columnhead(3) with lines
+
+
+   Note: The effect of 'set key autotitle columnheader', treatment of
+the first line in a data file as column headers rather than data applies
+even if the key is disabled by 'unset key'.  It also applies to 'stats'
+and *note fit:: commands even though they generate no key.  If you want
+the first line of data to be treated as column headers but _not_ to use
+them for plot titles, use *note columnheaders::.
+
+   In all cases an explicit *note title:: or 'notitle' keyword in the
+plot command itself will override the default from 'set key autotitle'.
+
+
+File: gnuplot.info,  Node: key_layout,  Next: key_placement,  Prev: key_autotitle,  Up: key_
+
+3.33.39.5 key layout
+....................
+
+Key layout options:
+          set key {vertical | horizontal}
+                 {maxcols {<max no. of columns> | auto}}
+                 {maxrows {<max no. of rows> | auto}}
+                 {columns <exact no. of columns>}
+                 {keywidth [screen|graph] <fraction>}
+                 {Left | Right}
+                 {{no}reverse} {{no}invert}
+                 {samplen <sample_length>} {spacing <line_spacing>}
+                 {width <width_increment>} {height <height_increment>}
+                 {title {"<text>"} {{no}enhanced} {center | left | right}}
+                 {font "<face>,<size>"} {textcolor <colorspec>}
+
+
+   Automatic arrangement of elements within the key into rows and
+columns is affected by the keywords shown above.  The default is
+'vertical', for which the key uses the fewest columns possible.
+Elements are aligned in a column until there is no more vertical space,
+at which point a new column is started.  The vertical space may be
+limited using 'maxrows'.  In the case of 'horizontal', the key instead
+uses the fewest rows possible.  The horizontal space may be limited
+using 'maxcols'.
+
+   The auto-selected number of rows and columns may be unsatisfactory.
+You can specify a definite number of columns using 'set key columns
+<N>'.  In this case you may need to adjust the sample widths ('samplen')
+and the total key width ('keywidth').
+
+   By default the first plot label is at the top of the key and
+successive labels are entered below it.  The 'invert' option causes the
+first label to be placed at the bottom of the key, with successive
+labels entered above it.  This option is useful to force the vertical
+ordering of labels in the key to match the order of box types in a
+stacked histogram.
+
+   'set key title "text"' places an overall title at the top of the key.
+Font, text justification, and other text properties specific to the
+title can be specified by placing the required keywords immediately
+after the '"text"' in this command.  Font or text properties specified
+elsewhere apply to all text in the key.
+
+   The default layout places a style sample (color, line, point, shape,
+etc) at the left of the key entry line, and the title text at the right.
+The text and sample positions can be swapped using the 'reverse'
+keyword.  Text justification of the individual plot titles within the
+key is controlled by 'Left' or 'Right' (default).  The horizontal extend
+of the style sample can be set to an approximate number of character
+width ('samplen').
+
+   When using the TeX/LaTeX group of terminals or terminals in which
+formatting information is embedded in the string, 'gnuplot' is bad at
+estimating the amount of space required, so the automatic key layout may
+be poor.  If the key is to be positioned at the left, it may help to use
+the combination 'set key left Left reverse' and force the appropriate
+number of columns or total key width.
+
+
+File: gnuplot.info,  Node: key_placement,  Next: key_offset,  Prev: key_layout,  Up: key_
+
+3.33.39.6 key placement
+.......................
+
+Key placement options:
+           set key {inside | outside | fixed}
+                   {lmargin | rmargin | tmargin | bmargin}
+                   {at <position>}}
+                   {left | right | center} {top | bottom | center}
+                   {offset <dx>,<dy>}
+
+
+   This section describes placement of the primary, auto-generated key.
+To construct a secondary key or place plot titles elsewhere, see
+'multiple keys'.
+
+   To understand positioning, the best concept is to think of a region,
+i.e., inside/outside, or one of the margins.  Along with the region,
+keywords 'left/center/right' (l/c/r) and 'top/center/bottom' (t/c/b)
+control where within the particular region the key should be placed.  In
+'inside' mode, the keywords 'left' (l), 'right' (r), 'top' (t), 'bottom'
+(b), and 'center' (c) push the key out toward the plot boundary as
+illustrated here:
+
+          t/l   t/c   t/r
+
+
+          c/l    c    c/r
+
+
+          b/l   b/c   b/r
+
+
+   In 'outside' mode, automatic placement is similar to the above
+illustration, but with respect to the view, rather than the graph
+boundary.  That is, a border is moved inward to make room for the key
+outside of the plotting area, although this may interfere with other
+labels and may cause an error on some devices.  The particular plot
+border that is moved depends upon the position described above and the
+stacking direction.  For options centered in one of the dimensions,
+there is no ambiguity about which border to move.  For the corners, when
+the stack direction is 'vertical', the left or right border is moved
+inward appropriately.  When the stack direction is 'horizontal', the top
+or bottom border is moved inward appropriately.
+
+   The margin syntax allows automatic placement of key regardless of
+stack direction.  When one of the margins *note lmargin:: (lm), *note
+rmargin:: (rm), *note tmargin:: (tm), and *note bmargin:: (bm) is
+combined with a single, non-conflicting direction keyword, the key is
+positioned along the outside of the page as shown here.  Keywords
+'above' and 'over' are synonymous with *note tmargin::.  Keywords
+'below' and 'under' are synonymous with *note bmargin::.
+
+               l/tm  c/tm  r/tm
+
+
+          t/lm                  t/rm
+
+
+          c/lm                  c/rm
+
+
+          b/lm                  b/rm
+
+
+               l/bm  c/bm  r/bm
+
+
+   For version compatibility, 'above', 'over', 'below', or 'under'
+without any additional l/c/r or stack direction keyword uses 'center'
+and 'horizontal'.  The keyword 'outside' without any additional t/b/c or
+stack direction keyword uses 'top', 'right' and 'vertical' (i.e., the
+same as t/rm above).
+
+   The <position> can be a simple x,y,z as in previous versions, but
+these can be preceded by one of five keywords ('first', 'second',
+'graph', 'screen', 'character') which selects the coordinate system in
+which the position of the first sample line is specified.  See
+'coordinates' for more details.  The effect of 'left', 'right', 'top',
+'bottom', and 'center' when <position> is given is to align the key as
+though it were text positioned using the label command, i.e., 'left'
+means left align with key to the right of <position>, etc.
+
+
+File: gnuplot.info,  Node: key_offset,  Next: key_samples,  Prev: key_placement,  Up: key_
+
+3.33.39.7 key offset
+....................
+
+Regardless of the key placement options chosen, the final position of
+the key can be adjusted manually by specifying an offset.  As usual, the
+x and y components of the offset may be given in character, graph, or
+screen coordinates.
+
+
+File: gnuplot.info,  Node: key_samples,  Next: multiple_keys,  Prev: key_offset,  Up: key_
+
+3.33.39.8 key samples
+.....................
+
+By default, each plot on the graph generates a corresponding entry in
+the key.  This entry contains a plot title and a sample line/point/box
+of the same color and fill properties as used in the plot itself.  The
+font and textcolor properties control the appearance of the individual
+plot titles that appear in the key.  Setting the textcolor to "variable"
+causes the text for each key entry to be the same color as the line or
+fill color for that plot.  This was the default in some earlier versions
+of gnuplot.
+
+   The length of the sample line can be controlled by 'samplen'.  The
+sample length is computed as the sum of the tic length and
+<sample_length> times the character width.  It also affects the
+positions of point samples in the key since these are drawn at the
+midpoint of the sample line, even if the line itself is not drawn.
+
+   Key entry lines are single-spaced based on the current font size.
+This can be adjusted by 'set key spacing <line-spacing>'.
+
+   The <width_increment> is a number of character widths to be added to
+or subtracted from the length of the string.  This is useful only when
+you are putting a box around the key and you are using control
+characters in the text.  'gnuplot' simply counts the number of
+characters in the string when computing the box width; this allows you
+to correct it.
+
+
+File: gnuplot.info,  Node: multiple_keys,  Prev: key_samples,  Up: key_
+
+3.33.39.9 multiple keys
+.......................
+
+It is possible to construct a legend/key manually rather than having the
+plot titles all appear in the auto-generated key.  This allows, for
+example, creating a single legend for the component panels in a
+multiplot.
+            set multiplot layout 3,2 columnsfirst
+            set style data boxes
+            plot $D using 0:6  lt 1 title at 0.75, 0.20
+            plot $D using 0:12 lt 2 title at 0.75, 0.17
+            plot $D using 0:13 lt 3 title at 0.75, 0.14
+            plot $D using 0:14 lt 4 title at 0.75, 0.11
+            set label 1 at screen 0.75, screen 0.22 "Custom combined key area"
+            plot $D using 0:($6+$12+$13+$14) with linespoints title "total"
+            unset multiplot
+
+
+
+File: gnuplot.info,  Node: label,  Next: linetype,  Prev: key_,  Up: set-show
+
+3.33.40 label
+-------------
+
+Arbitrary labels can be placed on the plot using the 'set label'
+command.
+
+   Syntax:
+           set label {<tag>} {"<label text>"} {at <position>}
+                     {left | center | right}
+                     {norotate | rotate {by <degrees>}}
+                     {font "<name>{,<size>}"}
+                     {noenhanced}
+                     {front | back}
+                     {textcolor <colorspec>}
+                     {point <pointstyle> | nopoint}
+                     {offset <offset>}
+                     {nobox} {boxed {bs <boxstyle>}}
+                     {hypertext}
+           unset label {<tag>}
+           show label
+
+
+   The <position> is specified by either x,y or x,y,z, and may be
+preceded by 'first', 'second', 'polar', 'graph', 'screen', or
+'character' to indicate the coordinate system.  See 'coordinates' for
+details.
+
+   The tag is an integer that is used to identify the label.  If no
+<tag> is given, the lowest unused tag value is assigned automatically.
+The tag can be used to delete or modify a specific label.  To change any
+attribute of an existing label, use the 'set label' command with the
+appropriate tag, and specify the parts of the label to be changed.
+
+   The <label text> can be a string constant, a string variable, or a
+string- valued expression.  See 'strings', *note sprintf::, and *note
+gprintf::.
+
+   By default, the text is placed flush left against the point x,y,z.
+To adjust the way the label is positioned with respect to the point
+x,y,z, add the justification parameter, which may be 'left', 'right' or
+'center', indicating that the point is to be at the left, right or
+center of the text.  Labels outside the plotted boundaries are permitted
+but may interfere with axis labels or other text.
+
+   Some terminals support enclosing the label in a box.  See 'set style
+textbox'.  Not all terminals can handle boxes for rotated text.
+
+   If 'rotate' is given, the label is written vertically.  If 'rotate by
+<degrees>' is given, the baseline of the text will be set to the
+specified angle.  Some terminals do not support text rotation.
+
+   Font and its size can be chosen explicitly by 'font
+"<name>{,<size>}"' if the terminal supports font settings.  Otherwise
+the default font of the terminal will be used.
+
+   Normally the enhanced text mode string interpretation, if enabled for
+the current terminal, is applied to all text strings including label
+text.  The 'noenhanced' property can be used to exempt a specific label
+from the enhanced text mode processing.  The can be useful if the label
+contains underscores, for example.  See 'enhanced text'.
+
+   If 'front' is given, the label is written on top of the graphed data.
+If 'back' is given (the default), the label is written underneath the
+graphed data.  Using 'front' will prevent a label from being obscured by
+dense data.
+
+   'textcolor <colorspec>' changes the color of the label text.
+<colorspec> can be a linetype, an rgb color, or a palette mapping.  See
+help for *note colorspec:: and *note palette::.  'textcolor' may be
+abbreviated 'tc'.
+        `tc default` resets the text color to its default state.
+        `tc lt <n>` sets the text color to that of line type <n>.
+        `tc ls <n>` sets the text color to that of line style <n>.
+        `tc palette z` selects a palette color corresponding to the label z position.
+        `tc palette cb <val>` selects a color corresponding to <val> on the colorbox.
+        `tc palette fraction <val>`, with 0<=val<=1, selects a color corresponding to
+            the mapping [0:1] to grays/colors of the *note palette::.
+        `tc rgb "#RRGGBB"` or `tc rgb "0xRRGGBB"` sets an arbitrary 24-bit RGB color.
+        `tc rgb 0xRRGGBB`  As above; a hexadecimal constant does not require quotes.
+
+
+   If a <pointstyle> is given, using keywords 'lt', 'pt' and 'ps', see
+*note style::, a point with the given style and color of the given line
+type is plotted at the label position and the text of the label is
+displaced slightly.  This option is used by default for placing labels
+in 'mouse' enhanced terminals.  Use 'nopoint' to turn off the drawing of
+a point near the label (this is the default).
+
+   The displacement defaults to 1,1 in *note pointsize:: units if a
+<pointstyle> is given, 0,0 if no <pointstyle> is given.  The
+displacement can be controlled by the optional 'offset <offset>' where
+<offset> is specified by either x,y or x,y,z, and may be preceded by
+'first', 'second', 'graph', 'screen', or 'character' to select the
+coordinate system.  See 'coordinates' for details.
+
+   If one (or more) axis is timeseries, the appropriate coordinate
+should be given as a quoted time string according to the *note timefmt::
+format string.  See *note xdata:: and *note timefmt::.
+
+   The options available for 'set label' are also available for the
+*note labels:: plot style.  See *note labels::.  In this case the
+properties 'textcolor', 'rotate', and *note pointsize:: may be followed
+by keyword 'variable' rather than by a fixed value.  In this case the
+corresponding property of individual labels is determined by additional
+columns in the 'using' specifier.
+
+* Menu:
+
+* examples_::
+* hypertext::
+
+
+File: gnuplot.info,  Node: examples_,  Next: hypertext,  Prev: label,  Up: label
+
+3.33.40.1 examples
+..................
+
+Examples:
+
+   To set a label at (1,2) to "y=x", use:
+           set label "y=x" at 1,2
+
+
+   To set a Sigma of size 24, from the Symbol font set, at the center of
+the graph, use:
+           set label "S" at graph 0.5,0.5 center font "Symbol,24"
+
+
+   To set a label "y=x^2" with the right of the text at (2,3,4), and tag
+the label as number 3, use:
+           set label 3 "y=x^2" at 2,3,4 right
+
+
+   To change the preceding label to center justification, use:
+           set label 3 center
+
+
+   To delete label number 2, use:
+           unset label 2
+
+
+   To delete all labels, use:
+           unset label
+
+
+   To show all labels (in tag order), use:
+           show label
+
+
+   To set a label on a graph with a timeseries on the x axis, use, for
+example:
+           set timefmt "%d/%m/%y,%H:%M"
+           set label "Harvest" at "25/8/93",1
+
+
+   To display a freshly fitted parameter on the plot with the data and
+the fitted function, do this after the *note fit::, but before the
+'plot':
+           set label sprintf("a = %3.5g",par_a) at 30,15
+           bfit = gprintf("b = %s*10^%S",par_b)
+           set label bfit at 30,20
+
+
+   To display a function definition along with its fitted parameters,
+use:
+           f(x)=a+b*x
+           fit f(x) 'datafile' via a,b
+           set label GPFUN_f at graph .05,.95
+           set label sprintf("a = %g", a) at graph .05,.90
+           set label sprintf("b = %g", b) at graph .05,.85
+
+
+   To set a label displaced a little bit from a small point:
+           set label 'origin' at 0,0 point lt 1 pt 2 ps 3 offset 1,-1
+
+
+   To set a label whose color matches the z value (in this case 5.5) of
+some point on a 3D splot colored using pm3d:
+           set label 'text' at 0,0,5.5 tc palette z
+
+
+
+File: gnuplot.info,  Node: hypertext,  Prev: examples_,  Up: label
+
+3.33.40.2 hypertext
+...................
+
+Some terminals (wxt, qt, svg, canvas, win) allow you to attach hypertext
+to specific points on the graph or elsewhere on the canvas.  When the
+mouse hovers over the anchor point, a pop-up box containing the text is
+displayed.  Terminals that do not support hypertext will display
+nothing.  You must enable the 'point' attribute of the label in order
+for the hypertext to be anchored.  Enhanced text markup is not applied
+to hypertext labels.  Examples:
+           set label at 0,0 "Plot origin" hypertext point pt 1
+           plot 'data' using 1:2:0 with labels hypertext point pt 7 \
+                title 'mouse over point to see its order in data set'
+
+
+           # mousing over any point of this pm3d surface will display
+           # its Z coordinate as hypertext
+           splot '++' using 1:2:(F($1,$2)) with pm3d, \
+                 '++' using 1:2:(F($1,$2)):(sprintf("%.3f", F($1,$2))) with labels \
+                      hypertext point lc rgb "0xff000000" notitle
+
+
+   For the wxt and qt terminals, left-click on a hypertext anchor after
+the text has appeared will copy the hypertext to the clipboard.
+
+   EXPERIMENTAL (implementation details may change) - Text of the form
+"image{<xsize>,<ysize>}:<filename>{\n<caption text>}" will trigger
+display of the image file in a pop-up box.  The optional size overrides
+a default box size 300x200.  The types of image file recognized may vary
+by terminal type, but *.png should always work.  Any additional text
+lines following the image filename are displayed as usual for hypertext.
+Example:
+           set label 7 "image:../figures/Fig7_inset.png\nFigure 7 caption..."
+           set label 7 at 10,100 hypertext point pt 7
+
+
+
+File: gnuplot.info,  Node: linetype,  Next: link,  Prev: label,  Up: set-show
+
+3.33.41 linetype
+----------------
+
+The 'set linetype' command allows you to redefine the basic linetypes
+used for plots.  The command options are identical to those for "set
+style line".  Unlike line styles, redefinitions by 'set linetype' are
+persistent.  They are not affected by *note reset::.  However the
+initial linetype properties are restored by 'reset session'.
+
+   For example, whatever linetypes one and two look like to begin with,
+if you redefine them like this:
+
+           set linetype 1 lw 2 lc rgb "blue" pointtype 6
+           set linetype 2 lw 2 lc rgb "forest-green" pointtype 8
+
+
+   everywhere that uses lt 1 will now get a thick blue line.  This
+includes uses such as the definition of a temporary linestyle derived
+from the base linetype 1.  Similarly lt 2 will now produce a thick green
+line.
+
+   This mechanism can be used to define a set of personal preferences
+for the sequence of lines used in gnuplot.  The recommended way to do
+this is to add to the run-time initialization file ~/.gnuplot a sequence
+of commands like
+
+           set linetype 1 lc rgb "dark-violet" lw 2 pt 1
+           set linetype 2 lc rgb "sea-green"   lw 2 pt 7
+           set linetype 3 lc rgb "cyan"        lw 2 pt 6 pi -1
+           set linetype 4 lc rgb "dark-red"    lw 2 pt 5 pi -1
+           set linetype 5 lc rgb "blue"        lw 2 pt 8
+           set linetype 6 lc rgb "dark-orange" lw 2 pt 3
+           set linetype 7 lc rgb "black"       lw 2 pt 11
+           set linetype 8 lc rgb "goldenrod"   lw 2
+           set linetype cycle 8
+
+
+   Every time you run gnuplot the line types will be initialized to
+these values.  You may initialize as many linetypes as you like.  If you
+do not redefine, say, linetype 3 then it will continue to have the
+default properties (in this case blue, pt 3, lw 1, etc).
+
+   Similar script files can be used to define theme-based color choices,
+or sets of colors optimized for a particular plot type or output device.
+
+   The command 'set linetype cycle 8' tells gnuplot to re-use these
+definitions for the color and linewidth of higher-numbered linetypes.
+That is, linetypes 9-16, 17-24, and so on will use this same sequence of
+colors and widths.  The point properties (pointtype, pointsize,
+pointinterval) are not affected by this command.  'unset linetype cycle'
+disables this feature.  If the line properties of a higher numbered
+linetype are explicitly defined, this takes precedence over the recycled
+low-number linetype properties.
+
+
+File: gnuplot.info,  Node: link,  Next: lmargin,  Prev: linetype,  Up: set-show
+
+3.33.42 link
+------------
+
+Syntax:
+           set link {x2 | y2} {via <expression1> inverse <expression2>}
+           unset link
+
+
+   The *note link:: command establishes a mapping between the x and x2
+axes, or the y and y2 axes.  <expression1> maps primary axis coordinates
+onto the secondary axis.  <expression2> maps secondary axis coordinates
+onto the primary axis.
+
+   Examples:
+
+           set link x2
+
+
+   This is the simplest form of the command.  It forces the x2 axis to
+have identically the same range, scale, and direction as the x axis.
+Commands *note xrange::, *note x2range::, 'set auto x', etc will affect
+both the x and x2 axes.
+
+           set link x2 via x**2 inverse sqrt(x)
+           plot "sqrt_data" using 1:2 axes x2y1, "linear_data" using 1:2 axes x1y1
+
+
+   This command establishes forward and reverse mapping between the x
+and x2 axes.  The forward mapping is used to generate x2 tic labels and
+x2 mouse coordinate The reverse mapping is used to plot coordinates
+given in the x2 coordinate system.  Note that the mapping as given is
+valid only for x non-negative.  When mapping to the y2 axis, both
+<expression1> and <expression2> must use y as dummy variable.
+
+
+File: gnuplot.info,  Node: lmargin,  Next: loadpath,  Prev: link,  Up: set-show
+
+3.33.43 lmargin
+---------------
+
+The command *note lmargin:: sets the size of the left margin.  Please
+see *note margin:: for details.
+
+
+File: gnuplot.info,  Node: loadpath,  Next: locale,  Prev: lmargin,  Up: set-show
+
+3.33.44 loadpath
+----------------
+
+The *note loadpath:: setting defines additional locations for data and
+command files searched by the *note call::, 'load', 'plot' and 'splot'
+commands.  If a file cannot be found in the current directory, the
+directories in *note loadpath:: are tried.
+
+   Syntax:
+           set loadpath {"pathlist1" {"pathlist2"...}}
+           show loadpath
+
+
+   Path names may be entered as single directory names, or as a list of
+path names separated by a platform-specific path separator, eg.  colon
+(':') on Unix, semicolon (';') on DOS/Windows/OS/2 platforms.  The *note
+loadpath::, *note save:: and 'save set' commands replace the
+platform-specific separator with a space character (' ').
+
+   If the environment variable GNUPLOT_LIB is set, its contents are
+appended to *note loadpath::.  However, *note loadpath:: prints the
+contents of *note loadpath:: and GNUPLOT_LIB separately.  Also, the
+*note save:: and 'save set' commands ignore the contents of GNUPLOT_LIB.
+
+
+File: gnuplot.info,  Node: locale,  Next: logscale,  Prev: loadpath,  Up: set-show
+
+3.33.45 locale
+--------------
+
+The *note locale:: setting determines the language with which
+'{x,y,z}{d,m}tics' will write the days and months.
+
+   Syntax:
+           set locale {"<locale>"}
+
+
+   <locale> may be any language designation acceptable to your
+installation.  See your system documentation for the available options.
+The command 'set locale ""' will try to determine the locale from the
+LC_TIME, LC_ALL, or LANG environment variables.
+
+   To change the decimal point locale, see *note decimalsign::.  To
+change the character encoding to the current locale, see *note
+encoding::.
+
+
+File: gnuplot.info,  Node: logscale,  Next: macros,  Prev: locale,  Up: set-show
+
+3.33.46 logscale
+----------------
+
+Syntax:
+           set logscale <axes> {<base>}
+           unset logscale <axes>
+           show logscale
+
+
+   where <axes> may be any combinations of 'x', 'x2', 'y', 'y2', 'z',
+'cb', and 'r' in any order.  <base> is the base of the log scaling
+(default is base 10).  If no axes are specified, the command affects all
+axes except 'r'.  The command *note logscale:: turns off log scaling for
+all axes.  Note that the ticmarks generated for logscaled axes are not
+uniformly spaced.  See 'set xtics'.
+
+   Examples:
+
+   To enable log scaling in both x and z axes:
+           set logscale xz
+
+
+   To enable scaling log base 2 of the y axis:
+           set logscale y 2
+
+
+   To enable z and color log axes for a pm3d plot:
+           set logscale zcb
+
+
+   To disable z axis log scaling:
+           unset logscale z
+
+
+
+File: gnuplot.info,  Node: macros,  Next: mapping,  Prev: logscale,  Up: set-show
+
+3.33.47 macros
+--------------
+
+In this version of gnuplot macro substitution is always enabled.  Tokens
+in the command line of the form @<stringvariablename> will be replaced
+by the text string contained in <stringvariablename>.  See
+'substitution'.
+
+
+File: gnuplot.info,  Node: mapping,  Next: margin,  Prev: macros,  Up: set-show
+
+3.33.48 mapping
+---------------
+
+If data are provided to 'splot' in spherical or cylindrical coordinates,
+the *note mapping:: command should be used to instruct 'gnuplot' how to
+interpret them.
+
+   Syntax:
+           set mapping {cartesian | spherical | cylindrical}
+
+
+   A cartesian coordinate system is used by default.
+
+   For a spherical coordinate system, the data occupy two or three
+columns (or 'using' entries).  The first two are interpreted as the
+azimuthal and polar angles theta and phi (or "longitude" and
+"latitude"), in the units specified by *note angles::.  The radius r is
+taken from the third column if there is one, or is set to unity if there
+is no third column.  The mapping is:
+
+           x = r * cos(theta) * cos(phi)
+           y = r * sin(theta) * cos(phi)
+           z = r * sin(phi)
+
+
+   Note that this is a "geographic" spherical system, rather than a
+"polar" one (that is, phi is measured from the equator, rather than the
+pole).
+
+   For a cylindrical coordinate system, the data again occupy two or
+three columns.  The first two are interpreted as theta (in the units
+specified by *note angles::) and z.  The radius is either taken from the
+third column or set to unity, as in the spherical case.  The mapping is:
+
+           x = r * cos(theta)
+           y = r * sin(theta)
+           z = z
+
+
+   The effects of *note mapping:: can be duplicated with the 'using'
+specifier of the 'splot' command, but *note mapping:: may be more
+convenient if many data files are to be processed.  However even if
+*note mapping:: is used, 'using' may still be necessary if the data in
+the file are not in the required order.
+
+   *note mapping:: has no effect on 'plot'.  world.dem: mapping demos.
+(http://www.gnuplot.info/demo/world.html)
+
+
+File: gnuplot.info,  Node: margin,  Next: micro,  Prev: mapping,  Up: set-show
+
+3.33.49 margin
+--------------
+
+The *note margin:: is the distance between the plot border and the outer
+edge of the canvas.  The size of the margin is chosen automatically, but
+can be overridden by the *note margin:: commands.  *note margin:: shows
+the current settings.  To alter the distance between the inside of the
+plot border and the data in the plot itself, see *note offsets::.
+
+   Syntax:
+           set lmargin {{at screen} <margin>}
+           set rmargin {{at screen} <margin>}
+           set tmargin {{at screen} <margin>}
+           set bmargin {{at screen} <margin>}
+           set margins <left>, <right>, <bottom>, <top>
+           show margin
+
+
+   The default units of <margin> are character heights or widths, as
+appropriate.  A positive value defines the absolute size of the margin.
+A negative value (or none) causes 'gnuplot' to revert to the computed
+value.  For 3D plots, only the left margin can be set using character
+units.
+
+   The keywords 'at screen' indicates that the margin is specified as a
+fraction of the full drawing area.  This can be used to precisely line
+up the corners of individual 2D and 3D graphs in a multiplot.  This
+placement ignores the current values of *note origin:: and *note size::,
+and is intended as an alternative method for positioning graphs within a
+multiplot.
+
+   Normally the margins of a plot are automatically calculated based on
+tics, tic labels, axis labels, the plot title, the timestamp and the
+size of the key if it is outside the borders.  If, however, tics are
+attached to the axes ('set xtics axis', for example), neither the tics
+themselves nor their labels will be included in either the margin
+calculation or the calculation of the positions of other text to be
+written in the margin.  This can lead to tic labels overwriting other
+text if the axis is very close to the border.
+
+
+File: gnuplot.info,  Node: micro,  Next: minussign,  Prev: margin,  Up: set-show
+
+3.33.50 micro
+-------------
+
+By default the "%c" format specifier for scientific notation used to
+generate axis tick labels uses a lower case u as a prefix to indicate
+"micro" (10^-6).  The *note micro:: command tells gnuplot to use a
+different typographic character (unicode U+00B5).  The byte sequence
+used to represent this character depends on the current encoding.  See
+'format specifiers', *note encoding::.
+
+   If the current encoding default is not satisfactory, you can provide
+a character string that generates the desired representation.  This is
+mostly useful for latex terminals, for example
+          set micro "{\textmu}"
+
+
+
+File: gnuplot.info,  Node: minussign,  Next: monochrome,  Prev: micro,  Up: set-show
+
+3.33.51 minussign
+-----------------
+
+Gnuplot uses the C language library routine sprintf() for most formatted
+input.  However it also has its own formatting routine 'gprintf()' that
+is used to generate axis tic labels.  The C library routine always use a
+hyphen character (ascii \055) to indicate a negative number, as in -7.
+Many people prefer a different typographic minus sign character (unicode
+U+2212) for this purpose, as in −7.  The command
+
+          set minussign
+
+
+   causes gprintf() to use this minus sign character rather than a
+hyphen in numeric output.  In a utf-8 locale this is the multibyte
+sequence corresponding to unicode U+2212.  In a Window codepage 1252
+locale this is the 8-bit character ALT+150 ("en dash").  The *note
+minussign:: command will affect axis tic labels and any labels that are
+created by explicitly invoking gprintf.  It has no effect on other
+strings that contain a hyphen.  See *note gprintf::.
+
+   Note that this command is ignored when you are using any of the LaTeX
+terminals, as LaTeX has its own mechanism for handling minus signs.  It
+also is not necessary when using the postscript terminal because the
+postscript prologue output by gnuplot remaps the ascii hyphen code \055
+to a different glyph named 'minus'.
+
+   Example (assumes utf8 locale):
+
+          set minus
+          A = -5
+          print "A = ",A                 # printed string will contain a hyphen
+          print gprintf("A = %g",A)      # printed string will contain character U+2212
+          set label "V = -5"             # label will contain a hyphen
+          set label sprintf("V = %g",-5) # label will contain a hyphen
+          set label gprintf("V = %g",-5) # label will contain character U+2212
+
+
+
+File: gnuplot.info,  Node: monochrome,  Next: mouse,  Prev: minussign,  Up: set-show
+
+3.33.52 monochrome
+------------------
+
+Syntax:
+          set monochrome {linetype N <linetype properties>}
+
+
+   The *note monochrome:: command selects an alternative set of
+linetypes that differ by dot/dash pattern or line width rather than by
+color.  This command replaces the monochrome option offered by certain
+terminal types in earlier versions of gnuplot.  For backward
+compatibility these terminal types now implicitly invoke "set
+monochrome" if their own "mono" option is present.  For example,
+          set terminal pdf mono
+
+   is equivalent to
+          set terminal pdf
+          set mono
+
+
+   Selecting monochrome mode does not prevent you from explicitly
+drawing lines using RGB or palette colors, but see also *note gray::.
+Six monochrome linetypes are defined by default.  You can change their
+properties or add additional monochrome linetypes by using the full form
+of the command.  Changes made to the monochrome linetypes do not affect
+the color linetypes and vice versa.  To restore the usual set of color
+linetypes, use either *note monochrome:: or 'set color'.
+
+
+File: gnuplot.info,  Node: mouse,  Next: mttics,  Prev: monochrome,  Up: set-show
+
+3.33.53 mouse
+-------------
+
+The command 'set mouse' enables mouse actions for the current
+interactive terminal.  It is enabled by default.
+
+   There are two mouse modes.  The 2D mode works for 'plot' commands and
+for 'splot' maps (i.e.  *note view:: with z-rotation 0, 90, 180, 270 or
+360 degrees, including 'set view map').  In this mode the mouse position
+is tracked and you can pan or zoom using the mouse buttons or arrow
+keys.  Some terminals support toggling individual plots on/off by
+clicking on the corresponding key title or on a separate widget.
+
+   For 3D graphs 'splot', the view and scaling of the graph can be
+changed with mouse buttons 1 and 2, respectively.  A vertical motion of
+Button 2 with the shift key held down changes the *note xyplane::.  If
+additionally to these buttons the modifier <ctrl> is held down, the
+coordinate axes are displayed but the data are suppressed.  This is
+useful for large data sets.  Mouse button 3 controls the azimuth of the
+z axis (see *note azimuth::).
+
+   Mousing coordinate readout in multiplot mode is displayed only with
+for the most recent plot within the multiplot.  See 'new multiplots'.
+
+   Syntax:
+           set mouse {doubleclick <ms>} {nodoubleclick}
+                     {{no}zoomcoordinates}
+                     {zoomfactors <xmultiplier>, <ymultiplier>}
+                     {noruler | ruler {at x,y}}
+                     {polardistance{deg|tan} | nopolardistance}
+                     {format <string>}
+                     {mouseformat <int> | <string> | function <f(x,y)>}
+                     {{no}labels {"labeloptions"}}
+                     {{no}zoomjump} {{no}verbose}
+           unset mouse
+
+
+   The options 'noruler' and 'ruler' switch the ruler off and on, the
+latter optionally setting the origin at the given coordinates.  While
+the ruler is on, the distance in user units from the ruler origin to the
+mouse is displayed continuously.  By default, toggling the ruler has the
+key binding 'r'.
+
+   The option 'polardistance' determines if the distance between the
+mouse cursor and the ruler is also shown in polar coordinates (distance
+and angle in degrees or tangent (slope)).  This corresponds to the
+default key binding '5'.
+
+   Choose the option *note labels:: to define persistent gnuplot labels
+using Button 2.  The default is 'nolabels', which makes Button 2 draw
+only a temporary label at the mouse position.  Labels are drawn with the
+current setting of *note mouseformat::.  The 'labeloptions' string is
+passed to the 'set label' command.  The default is "point pointtype 1"
+which will plot a small plus at the label position.  Temporary labels
+will disappear at the next *note replot:: or mouse zoom operation.
+Persistent labels can be removed by holding the Ctrl-Key down while
+clicking Button 2 on the label's point.  The threshold for how close you
+must be to the label is also determined by the *note pointsize::.
+
+   If the option 'verbose' is turned on the communication commands are
+shown during execution.  This option can also be toggled by hitting '6'
+in the driver's window.  'verbose' is off by default.
+
+   Press 'h' in the driver's window for a summary of the mouse and key
+bindings.  This will also display user defined bindings or 'hotkeys'
+defined by the 'bind' command.  Note that user defined binding may
+override default bindings.  See also help for 'bind'.
+
+* Menu:
+
+* doubleclick::
+* format___::
+* mouseformat::
+* scrolling::
+* zoom::
+
+
+File: gnuplot.info,  Node: doubleclick,  Next: format___,  Prev: mouse,  Up: mouse
+
+3.33.53.1 doubleclick
+.....................
+
+The doubleclick resolution is given in milliseconds and used for Button
+1, which copies the current mouse position to the 'clipboard' on some
+terminals.  The default value is 300 ms.  Setting the value to 0 ms
+triggers the copy on a single click.
+
+
+File: gnuplot.info,  Node: format___,  Next: mouseformat,  Prev: doubleclick,  Up: mouse
+
+3.33.53.2 format
+................
+
+The 'set mouse format' command specifies a format string for sprintf()
+which determines how the mouse cursor [x,y] coordinates are printed to
+the plot window and to the clipboard.  The default is "% #g".
+
+   This setting is superseded by "set mouse mouseformat".
+
+
+File: gnuplot.info,  Node: mouseformat,  Next: scrolling,  Prev: format___,  Up: mouse
+
+3.33.53.3 mouseformat
+.....................
+
+Syntax:
+          set mouse mouseformat i
+          set mouse mouseformat "custom format"
+          set mouse mouseformat function string_valued_function(x, y)
+
+   This command controls the format used to report the current mouse
+position.  An integer argument selects one of the format options in the
+table below.  A string argument is used as a format for sprintf() in
+option 7 and should contain two float specifiers, one for x and one for
+y.
+
+   Use of a custom function returning a string is EXPERIMENTAL. It
+allows readout of coordinate systems in which inverse mapping from
+screen coordinates to plot coordinates requires joint consideration of
+both x and y.  See for example the map_projection demo.
+
+   Example:
+          set mouse mouseformat "mouse x,y = %5.2g, %10.3f"
+
+   Use 'set mouse mouseformat ""' to turn this string off again.
+
+   The following formats are available:
+
+      0   default (same as 1)
+      1   axis coordinates                    1.23, 2.45
+      2   graph coordinates (from 0 to 1)    /0.00, 1.00/
+      3   x = timefmt     y = axis           [(as set by *note timefmt::), 2.45]
+      4   x = date        y = axis           [31. 12. 1999, 2.45]
+      5   x = time        y = axis           [23:59, 2.45]
+      6   x = date time   y = axis           [31. 12. 1999 23:59, 2.45]
+      7   format from `set mouse mouseformat <format-string>`
+      8   format from `set mouse mouseformat function <func>`
+
+
+
+File: gnuplot.info,  Node: scrolling,  Next: zoom,  Prev: mouseformat,  Up: mouse
+
+3.33.53.4 scrolling
+...................
+
+The mouse wheel adjusts x and y axis ranges in both 2D and 3D plots.
+Each adjustment increment is 10% of the current range by default.  This
+may be changed by 'set mouse zoomfactor <x-multiplier>, <y-multiplier>'.
+   * <wheel-up> scrolls y and y2 axis ranges up by a fraction of the
+     current range
+   * <wheel-down> scrolls y and y2 ranges down by a fraction of the
+     current range
+   * <shift+wheel-up> scrolls left (decreases x and x2 ranges)
+   * <shift+wheel-down> scrolls right (increases x and x2 ranges)
+   * <control+wheel-up> zooms in around the current mouse position
+   * <control+wheel-down> zooms out around the current mouse position
+   * <shift+control+wheel-up> zooms in only along x and x2 (pinch)
+   * <shift+control+wheel-down> zooms out only along x and x2 (expand)
+
+
+File: gnuplot.info,  Node: zoom,  Prev: scrolling,  Up: mouse
+
+3.33.53.5 zoom
+..............
+
+Proportional zoom in/out around the current mouse position is controlled
+by the mouse wheel (see *note scrolling::).
+
+   Enlarging a selected region in a 2D plot is accomplished by holding
+down the left mouse button and dragging the mouse to delineate a zoom
+region.  The original plot can be restored by typing the 'u' hotkey in
+the plot window.  Hotkeys 'p' and 'n' step back and forth through a
+history of zoom operations.
+
+   The option 'zoomcoordinates' determines if the coordinates of the
+zoom box are drawn at the edges while zooming.  This is on by default.
+
+   If the option 'zoomjump' is on, the mouse pointer will automatically
+offset a small distance after starting a zoom region with button 3.
+This can be useful to avoid a tiny (or even empty) zoom region.
+'zoomjump' is off by default.
+
+
+File: gnuplot.info,  Node: mttics,  Next: multiplot,  Prev: mouse,  Up: set-show
+
+3.33.54 mttics
+--------------
+
+Minor tic marks around the perimeter of a polar plot are controlled by
+by *note mttics::.  Please see 'set mxtics'.
+
+
+File: gnuplot.info,  Node: multiplot,  Next: mx2tics,  Prev: mttics,  Up: set-show
+
+3.33.55 multiplot
+-----------------
+
+The command *note multiplot:: places 'gnuplot' in multiplot mode, in
+which several plots are placed next to each other on the same page or
+screen window.
+
+   Syntax:
+           set multiplot
+               { title <page title> {font <fontspec>} {enhanced|noenhanced} }
+               { layout <rows>,<cols>
+                 {rowsfirst|columnsfirst} {downwards|upwards}
+                 {scale <xscale>{,<yscale>}} {offset <xoff>{,<yoff>}}
+                 {margins <left>,<right>,<bottom>,<top>}
+                 {spacing <xspacing>{,<yspacing>}}
+               }
+           set multiplot {next|previous}
+           unset multiplot
+
+
+   For some terminals, no plot is displayed until the command *note
+multiplot:: is given, which causes the entire page to be drawn and then
+returns gnuplot to its normal single-plot mode.  For other terminals,
+each separate 'plot' command produces an updated display.
+
+   The *note clear:: command is used to erase the rectangular area of
+the page that will be used for the next plot.  This is typically needed
+to inset a small plot inside a larger plot.
+
+   Any labels or arrows that have been defined will be drawn for each
+plot according to the current size and origin (unless their coordinates
+are defined in the 'screen' system).  Just about everything else that
+can be 'set' is applied to each plot, too.  If you want something to
+appear only once on the page, for instance a single time stamp, you'll
+need to put a 'set time'/'unset time' pair around one of the 'plot',
+'splot' or *note replot:: commands within the *note multiplot::/*note
+multiplot:: block.
+
+   The multiplot title is separate from the individual plot titles, if
+any.  Space is reserved for it at the top of the page, spanning the full
+width of the canvas.
+
+   The commands *note origin:: and *note size:: must be used to
+correctly position each plot if no layout is specified or if fine tuning
+is desired.  See *note origin:: and *note size:: for details of their
+usage.
+
+   Example:
+           set multiplot
+           set size 0.4,0.4
+           set origin 0.1,0.1
+           plot sin(x)
+           set size 0.2,0.2
+           set origin 0.5,0.5
+           plot cos(x)
+           unset multiplot
+
+
+   This displays a plot of cos(x) stacked above a plot of sin(x).
+
+   *note size:: and *note origin:: refer to the entire plotting area
+used for each plot.  Please also see *note size::.  If you want to have
+the axes themselves line up, you can guarantee that the margins are the
+same size with the *note margin:: commands.  See *note margin:: for
+their use.  Note that the margin settings are absolute, in character
+units, so the appearance of the graph in the remaining space will depend
+on the screen size of the display device, e.g., perhaps quite different
+on a video display and a printer.
+
+   With the 'layout' option you can generate simple multiplots without
+having to give the *note size:: and *note origin:: commands before each
+plot: Those are generated automatically, but can be overridden at any
+time.  With 'layout' the display will be divided by a grid with <rows>
+rows and <cols> columns.  This grid is filled rows first or columns
+first depending on whether the corresponding option is given in the
+multiplot command.  The stack of plots can grow 'downwards' or
+'upwards'.  Default is 'rowsfirst' and 'downwards'.  The commands 'set
+multiplot next' and 'set multiplot previous' are relevant only in the
+context of using the layout option.  'next' skips the next position in
+the grid, leaving a blank space.  'prev' returns to the grid position
+immediately preceding the most recently plotted position.
+
+   Each plot can be scaled by 'scale' and shifted with 'offset'; if the
+y-values for scale or offset are omitted, the x-value will be used.
+*note multiplot:: will turn off the automatic layout and restore the
+values of *note size:: and *note origin:: as they were before 'set
+multiplot layout'.
+
+   Example:
+           set size 1,1
+           set origin 0,0
+           set multiplot layout 3,2 columnsfirst scale 1.1,0.9
+           [ up to 6 plot commands here ]
+           unset multiplot
+
+
+   The above example will produce 6 plots in 2 columns filled top to
+bottom, left to right.  Each plot will have a horizontal size of 1.1/2
+and a vertical size of 0.9/3.
+
+   Another possibility is to set uniform margins for all plots in the
+layout with options 'layout margins' and 'spacing', which must be used
+together.  With 'margins' you set the outer margins of the whole
+multiplot grid.
+
+   'spacing' gives the gap size between two adjacent subplots, and can
+also be given in 'character' or 'screen' units.  If a single value is
+given, it is used for both x and y direction, otherwise two different
+values can be selected.
+
+   If one value has no unit, the one of the preceding margin setting is
+used.
+
+   Example:
+           set multiplot layout 2,2 margins 0.1, 0.9, 0.1, 0.9 spacing 0.0
+
+
+   In this case the two left-most subplots will have left boundaries at
+screen coordinate 0.1, the two right-most subplots will have right
+boundaries at screen coordinate 0.9, and so on.  Because the spacing
+between subplots is given as 0, their inner boundaries will superimpose.
+
+   Example:
+           set multiplot layout 2,2 margins char 5,1,1,2 spacing screen 0, char 2
+
+
+   This produces a layout in which the boundary of both left subplots is
+5 character widths from the left edge of the canvas, the right boundary
+of the right subplots is 1 character width from the canvas edge.  The
+overall bottom margin is one character height and the overall top margin
+is 2 character heights.  There is no horizontal gap between the two
+columns of subplots.  The vertical gap between subplots is equal to 2
+character heights.
+
+   Example:
+           set multiplot layout 2,2 columnsfirst margins 0.1,0.9,0.1,0.9 spacing 0.1
+           set ylabel 'ylabel'
+           plot sin(x)
+           set xlabel 'xlabel'
+           plot cos(x)
+           unset ylabel
+           unset xlabel
+           plot sin(2*x)
+           set xlabel 'xlabel'
+           plot cos(2*x)
+           unset multiplot
+
+
+   See also *note remultiplot::, 'new multiplots', multiplot demo
+(multiplt.dem) (http://www.gnuplot.info/demo/multiplt.html)
+
+
+File: gnuplot.info,  Node: mx2tics,  Next: mxtics,  Prev: multiplot,  Up: set-show
+
+3.33.56 mx2tics
+---------------
+
+Minor tic marks along the x2 (top) axis are controlled by *note
+mx2tics::.  Please see 'set mxtics'.
+
+
+File: gnuplot.info,  Node: mxtics,  Next: my2tics,  Prev: mx2tics,  Up: set-show
+
+3.33.57 mxtics
+--------------
+
+Minor tic marks along the x axis are controlled by 'set mxtics'.  They
+can be turned off with 'unset mxtics'.  Similar commands control minor
+tics along the other axes.
+
+   Syntax:
+           set mxtics <freq>
+           set mxtics default
+           set mxtics time <N> <units>
+           unset mxtics
+           show mxtics
+
+
+   The same syntax applies to *note mytics::, *note mztics::, *note
+mx2tics::, *note my2tics::, 'mrtics', *note mttics:: and 'mcbtics'.
+
+   <freq> is the number of sub-intervals (NOT the number of minor tic
+marks) between major tics.  The default for a linear axis is either 2
+(one mark) or 5 (four marks) depending on the spacing of the major tics.
+
+   'default' will return the number of minor ticks to its default value.
+
+   'set mxtics time <N> <units>' applies only when the major tics are
+set to time mode.  See 'set mxtics time'.
+
+   If the axis is logarithmic, the number of sub-intervals will be set
+to a reasonable number by default (based upon the length of a decade).
+This will be overridden if <freq> is given.  However the usual minor
+tics (2, 3, ..., 8, 9 between 1 and 10, for example) are obtained by
+setting <freq> to 10, even though there are but nine sub-intervals.
+
+   To set minor tics at arbitrary positions, use the ("<label>" <pos>
+<level>, ...)  form of 'set {x|x2|y|y2|z}tics' with <label> empty and
+<level> set to 1.
+
+   The 'set m{x|x2|y|y2|z}tics' commands work only when there are
+uniformly spaced major tics.  If all major tics were placed explicitly
+by 'set {x|x2|y|y2|z}tics', then minor tic commands are ignored.
+Implicit major tics and explicit minor tics can be combined using 'set
+{x|x2|y|y2|z}tics' and 'set {x|x2|y|y2|z}tics add'.
+
+   Examples:
+           set xtics 0, 5, 10
+           set xtics add (7.5)
+           set mxtics 5
+
+   Major tics at 0,5,7.5,10, minor tics at 1,2,3,4,6,7,8,9
+           set logscale y
+           set ytics format ""
+           set ytics 1e-6, 10, 1
+           set ytics add ("1" 1, ".1" 0.1, ".01" 0.01, "10^-3" 0.001, \
+                          "10^-4" 0.0001)
+           set mytics 10
+
+   Major tics with special formatting, minor tics at log positions
+
+   By default, minor tics are off for linear axes and on for logarithmic
+axes.  They inherit the settings for 'axis|border' and '{no}mirror'
+specified for the major tics.  Please see 'set xtics' for information
+about these.
+
+* Menu:
+
+* mxtics_time::
+
+
+File: gnuplot.info,  Node: mxtics_time,  Prev: mxtics,  Up: mxtics
+
+3.33.57.1 mxtics time
+.....................
+
+Syntax:
+          set mxtics time <N> {seconds|minutes|hours|days|weeks|months|years}
+
+
+   This is a new command option introduced in gnuplot version 6.  It
+places minor tic marks exactly at some integral number of time units
+rather than at some fraction of the major tic interval.
+
+   The new default is that minor tics are not generated if the major
+tics are in time mode ('set xdata time' or 'set xtics time').
+
+   'set mxtics' or 'set mxtics <freq>' can restore the pre-version 6
+behavior but this was always problematic.  For example, automatic
+subdivision of a 72-year span placed major tics at 12-year intervals and
+minor tics at 5-year intervals.
+
+   Using 'set mxtics time 2 years', however, will place a minor tic mark
+exactly at the start of alternate years.  'set mxtics time 1 month' will
+place tic marks exactly at 1 Jan, 1 Feb, 1 Mar, 1 Apr, ...  even though
+those intervals contain an unequal number of days.
+
+
+File: gnuplot.info,  Node: my2tics,  Next: mytics,  Prev: mxtics,  Up: set-show
+
+3.33.58 my2tics
+---------------
+
+Minor tic marks along the y2 (right-hand) axis are controlled by *note
+my2tics::.  Please see 'set mxtics'.
+
+
+File: gnuplot.info,  Node: mytics,  Next: mztics,  Prev: my2tics,  Up: set-show
+
+3.33.59 mytics
+--------------
+
+Minor tic marks along the y axis are controlled by *note mytics::.
+Please see 'set mxtics'.
+
+
+File: gnuplot.info,  Node: mztics,  Next: nonlinear,  Prev: mytics,  Up: set-show
+
+3.33.60 mztics
+--------------
+
+Minor tic marks along the z axis are controlled by *note mztics::.
+Please see 'set mxtics'.
+
+
+File: gnuplot.info,  Node: nonlinear,  Next: object,  Prev: mztics,  Up: set-show
+
+3.33.61 nonlinear
+-----------------
+
+Syntax:
+           set nonlinear <axis> via f(axis) inverse g(axis)
+           unset nonlinear <axis>
+
+
+   This command is similar to the *note link:: command except that only
+one of the two linked axes is visible.  The hidden axis remains linear.
+Coordinates along the visible axis are mapped by applying g(x) to hidden
+axis coordinates.  f(x) maps the visible axis coordinates back onto the
+hidden linear axis.  You must provide both the forward and inverse
+expressions.
+
+   To illustrate how this works, consider the case of a log-scale x2
+axis.
+
+           set x2ange [1:1000]
+           set nonlinear x2 via log10(x) inverse 10**x
+
+
+   This achieves the same effect as 'set log x2'.  The hidden axis in
+this case has range [0:3], obtained by calculating
+[log10(xmin):log10(xmax)].
+
+   The transformation functions f() and g() must be defined using a
+dummy variable appropriate to the nonlinear axis:
+         axis: x x2   dummy variable x
+         axis: y y2   dummy variable y
+         axis: z cb   dummy variable z
+         axis: r      dummy variable r
+
+
+   Example:
+
+           set xrange [-3:3]
+           set nonlinear x via norm(x) inverse invnorm(x)
+
+
+   This example establishes a probability-scaled ("probit") x axis, such
+that plotting the cumulative normal function Phi(x) produces a straight
+line plot against a linear y axis.
+
+   Example:
+
+           logit(p) = log(p/(1-p))
+           logistic(a) = 1. / (1. + exp(-a))
+           set xrange [.001 : .999]
+           set nonlinear y via logit(y) inverse logistic(y)
+           plot logit(x)
+
+
+   This example establishes a logit-scaled y axis such that plotting
+logit(x) on a linear x axis produces a straight line plot.
+
+   Example:
+
+           f(x) = (x <= 100) ? x : (x < 500) ? NaN : x-390
+           g(x) = (x <= 100) ? x : x+390
+           set xrange [0:1000] noextend
+           set nonlinear x via f(x) inverse g(x)
+           set xtics add (100,500)
+           plot sample [x=1:100] x, [x=500:1000] x
+
+
+   This example creates a "broken axis".  X coordinates 0-100 are at the
+left, X coordinates 500-1000 are at the right, there is a small gap (10
+units) between them.  So long as no data points with (100 < x < 500) are
+plotted, this works as expected.
+
+
+File: gnuplot.info,  Node: object,  Next: offsets,  Prev: nonlinear,  Up: set-show
+
+3.33.62 object
+--------------
+
+The *note object:: command defines a single object which will appear in
+subsequent plots.  You may define as many objects as you like.
+Currently the supported object types are *note rectangle::, 'circle',
+'ellipse', and 'polygon'.  Rectangles inherit a default set of style
+properties (fill, color, border) from those set by the command *note
+rectangle::.  Every object can be given individual style properties when
+it is defined or in a later command.
+
+   Objects to be drawn in 2D plots may be defined in any combination of
+axis, graph, polar, or screen coordinates.  Object specifications in 3D
+plots cannot use graph coordinates.  Rectangles and ellipses in 3D plots
+are limited to screen coordinates.
+
+   Syntax:
+         set object <index>
+             <object-type> <object-properties>
+             {front|back|behind|depthorder}
+             {clip|noclip}
+             {fc|fillcolor <colorspec>} {fs <fillstyle>}
+             {default} {lw|linewidth <width>} {dt|dashtype <dashtype>}
+         unset object <index>
+
+
+   <object-type> is either *note rectangle::, 'ellipse', 'circle', or
+'polygon'.  Each object type has its own set of characteristic
+properties.
+
+   The options 'front', 'back', 'behind' control whether the object is
+drawn before or after the plot itself.  See *note layers::.  Setting
+'front' will draw the object in front of all plot elements, but behind
+any labels that are also marked 'front'.  Setting 'back' will place the
+object behind all plot curves and labels.  Setting 'behind' will place
+the object behind everything including the axes and 'back' rectangles,
+thus
+         set object rectangle from screen 0,0 to screen 1,1 behind
+
+   can be used to provide a colored background for the entire graph or
+page.
+
+   By default, objects are clipped to the graph boundary unless one or
+more vertices are given in screen coordinates.  Setting 'noclip' will
+disable clipping to the graph boundary, but will still clip against the
+screen size.
+
+   The fill color of the object is taken from the <colorspec>.  *note
+fillcolor:: may be abbreviated 'fc'.  The fill style is taken from
+<fillstyle>.  See *note colorspec:: and 'fillstyle'.  If the keyword
+'default' is given, these properties are inherited from the default
+settings at the time a plot is drawn.  See *note rectangle::.
+
+* Menu:
+
+* rectangle::
+* ellipse::
+* circle::
+* polygon::
+
+
+File: gnuplot.info,  Node: rectangle,  Next: ellipse,  Prev: object,  Up: object
+
+3.33.62.1 rectangle
+...................
+
+Syntax:
+         set object <index> rectangle
+             {from <position> {to|rto} <position> |
+              center <position> size <w>,<h> |
+              at <position> size <w>,<h>}
+
+
+   The position of the rectangle may be specified by giving the position
+of two diagonal corners (bottom left and top right) or by giving the
+position of the center followed by the width and the height.  In either
+case the positions may be given in axis, graph, or screen coordinates.
+See 'coordinates'.  The options 'at' and 'center' are synonyms.
+
+   Examples:
+         # Force the entire area enclosed by the axes to have background color cyan
+         set object 1 rect from graph 0, graph 0 to graph 1, graph 1 back
+         set object 1 rect fc rgb "cyan" fillstyle solid 1.0
+
+
+         # Position a red square with lower left at 0,0 and upper right at 2,3
+         set object 2 rect from 0,0 to 2,3 fc lt 1
+
+
+         # Position an empty rectangle (no fill) with a blue border
+         set object 3 rect from 0,0 to 2,3 fs empty border rgb "blue"
+
+
+         # Return fill and color to the default style but leave vertices unchanged
+         set object 2 rect default
+
+
+   Rectangle corners specified in screen coordinates may extend beyond
+the edge of the current graph.  Otherwise the rectangle is clipped to
+fit in the graph.
+
+
+File: gnuplot.info,  Node: ellipse,  Next: circle,  Prev: rectangle,  Up: object
+
+3.33.62.2 ellipse
+.................
+
+Syntax:
+         set object <index> ellipse {at|center} <position> size <w>,<h>
+             {angle <orientation>} {units xy|xx|yy}
+             {<other-object-properties>}
+
+
+   The position of the ellipse is specified by giving the center
+followed by the width and the height (actually the major and minor
+axes).  The keywords 'at' and 'center' are synonyms.  The center
+position may be given in axis, graph, or screen coordinates.  See
+'coordinates'.  The major and minor axis lengths must be given in axis
+coordinates.  The orientation of the ellipse is specified by the angle
+between the horizontal axis and the major diameter of the ellipse.  If
+no angle is given, the default ellipse orientation will be used instead
+(see 'set style ellipse').  The 'units' keyword controls the scaling of
+the axes of the ellipse.  'units xy' means that the major axis is
+interpreted in terms of units along the x axis, while the minor axis in
+that of the y axis.  'units xx' means that both axes of the ellipses are
+scaled in the units of the x axis, while 'units yy' means that both axes
+are in units of the y axis.  The default is 'xy' or whatever 'set style
+ellipse units' was set to.
+
+   NB: If the x and y axis scales are not equal, (e.g.  'units xy' is in
+effect) then the major/minor axis ratio will no longer be correct after
+rotation.
+
+   Note that 'set object ellipse size <2r>,<2r>' does not in general
+produce the same result as 'set object circle <r>'.  The circle radius
+is always interpreted in terms of units along the x axis, and will
+always produce a circle even if the x and y axis scales are different
+and even if the aspect ratio of your plot is not 1.  If 'units' is set
+to 'xy', then 'set object ellipse' interprets the first <2r> in terms of
+x axis units and the second <2r> in terms of y axis units.  This will
+only produce a circle if the x and y axis scales are identical and the
+plot aspect ratio is 1.  On the other hand, if 'units' is set to 'xx' or
+'yy', then the diameters specified in the 'set object' command will be
+interpreted in the same units, so the ellipse will have the correct
+aspect ratio, and it will maintain its aspect ratio even if the plot is
+resized.
+
+
+File: gnuplot.info,  Node: circle,  Next: polygon,  Prev: ellipse,  Up: object
+
+3.33.62.3 circle
+................
+
+Syntax:
+         set object <index> circle {at|center} <position> size <radius>
+             {arc [<begin>:<end>]} {no{wedge}}
+             {<other-object-properties>}
+
+
+   The position of the circle is specified by giving the position of the
+center center followed by the radius.  The keywords 'at' and 'center'
+are synonyms.  In 2D plots the position and radius may be given in any
+coordinate system.  See 'coordinates'.  Circles in 3D plots cannot use
+graph coordinates.  In all cases the radius is calculated relative to
+the horizontal scale of the axis, graph, or canvas.  Any disparity
+between the horizontal and vertical scaling will be corrected for so
+that the result is always a circle.  If you want to draw a circle in
+plot coordinates (such that it will appear as an ellipse if the
+horizontal and vertical scales are different), use 'set object ellipse'
+instead.
+
+   By default a full circle is drawn.  The optional qualifier 'arc'
+specifies a starting angle and ending angle, in degrees, for one arc of
+the circle.  The arc is always drawn counterclockwise.
+
+   See also 'set style circle', 'set object ellipse'.
+
+
+File: gnuplot.info,  Node: polygon,  Prev: circle,  Up: object
+
+3.33.62.4 polygon
+.................
+
+Syntax:
+         set object <index> polygon
+             from <position> to <position> ... {to <position>}
+
+   or
+             from <position> rto <position> ... {rto <position>}
+
+
+   The position of the polygon may be specified by giving the position
+of a sequence of vertices.  These may be given in any coordinate system.
+If relative coordinates are used (rto) then the coordinate type must
+match that of the previous vertex.  See 'coordinates'.
+
+   Example:
+         set object 1 polygon from 0,0 to 1,1 to 2,0
+         set object 1 fc rgb "cyan" fillstyle solid 1.0 border lt -1
+
+
+-- DEPTHORDER --
+
+   The option 'set object N depthorder' applies to 3D polygon objects
+only.  Rather than assigning the object to layer front/back/behind it is
+included in the list of pm3d quadrangles sorted and rendered in order of
+depth by 'set pm3d depthorder'.  As with pm3d surfaces, two-sided
+coloring can be generated by specifying the object fillcolor as a
+linestyle.  In this case the ordering of the first three vertices in the
+polygon determines the "side".
+
+   If you set this property for an object that is not a 3D polygon it
+probably will not be drawn at all.
+
+
+File: gnuplot.info,  Node: offsets,  Next: origin,  Prev: object,  Up: set-show
+
+3.33.63 offsets
+---------------
+
+Autoscaling sets the x and y axis ranges to match the coordinates of the
+data that is plotted.  Offsets provide a mechanism to expand these
+ranges to leave empty space between the data and the plot borders.
+Autoscaling then further extends each range to reach the next axis tic
+unless this has been suppressed by *note noextend:: or *note noextend::.
+See *note noextend::.  Offsets affect only scaling for the x1 and y1
+axes.
+
+   Syntax:
+           set offsets <left>, <right>, <top>, <bottom>
+           unset offsets
+           show offsets
+
+
+   Each offset may be a constant or an expression.  Each defaults to 0.
+By default, the left and right offsets are given in units of the first x
+axis, the top and bottom offsets in units of the first y axis.
+Alternatively, you may specify the offsets as a fraction of the total
+graph dimension by using the keyword "graph".  Only "graph" offsets are
+possible for nonlinear axes.
+
+   A positive offset expands the axis range in the specified direction,
+e.g.  a positive bottom offset makes ymin more negative.  Negative
+offsets interact badly with autoscaling and clipping.
+
+   Example:
+           set autoscale noextend
+           set offsets graph 0.05, 0, 2, 2
+           plot sin(x)
+
+
+   This graph of sin(x) will have y range [-3:3] because the function
+will be autoscaled to [-1:1] and the vertical offsets add 2 at each end
+of the range.  The x range will be [-11:10] because the default is
+[-10:10] and it has been expanded to the left by 0.05 of that total
+range.
+
+
+File: gnuplot.info,  Node: origin,  Next: output,  Prev: offsets,  Up: set-show
+
+3.33.64 origin
+--------------
+
+The *note origin:: command is used to specify the origin of a plotting
+surface (i.e., the graph and its margins) on the screen.  The
+coordinates are given in the 'screen' coordinate system (see
+'coordinates' for information about this system).
+
+   Syntax:
+           set origin <x-origin>,<y-origin>
+
+
+
+File: gnuplot.info,  Node: output,  Next: overflow,  Prev: origin,  Up: set-show
+
+3.33.65 output
+--------------
+
+Syntax:
+           set output {"<filename>"}
+           unset output
+           show output
+
+
+   Graphs produced by non-interactive terminals are by default sent to
+'stdout'.  The *note output:: command redirects output to the specified
+file or device.  The file opened by this command remains open until a
+subsequent set/unset output command, a change in terminal type, or exit
+from gnuplot.
+
+   Interactive terminals ignore *note output::.
+
+   The filename must be enclosed in quotes.  If the filename is omitted,
+the command is equivalent to *note output::; any output file opened by a
+previous *note output:: will be closed and new output will be sent to
+'stdout'.
+
+   When both *note terminal:: and *note output:: are used together, it
+is safest to give *note terminal:: first, because some terminals set a
+flag which is needed in some operating systems.  This would be the case,
+for example, if the operating system needs a separate open command for
+binary files.
+
+   On platforms that support pipes, it may be useful to pipe terminal
+output.  For instance,
+
+           set output "|lpr -Plaser filename"
+           set term png; set output "|display png:-"
+
+
+   On MSDOS machines, 'set output "PRN"' directs output to the default
+printer.
+
+
+File: gnuplot.info,  Node: overflow,  Next: palette__,  Prev: output,  Up: set-show
+
+3.33.66 overflow
+----------------
+
+Syntax:
+          set overflow {float | NaN | undefined}
+          unset overflow
+
+
+   This version of gnuplot supports 64-bit integer arithmetic.  This
+means that for values from 2^53 to 2^63 (roughly 10^16 to 10^19) integer
+evaluation preserves more precision than evaluation using IEEE 754
+floating point arithmetic.  However unlike the IEEE floating point
+representation, which sacrifices precision to span a total range of
+roughly [-10^307 : 10^307], integer operations that result in values
+outside the range [-2^63 : 2^63] overflow.  The *note overflow:: command
+lets you control what happens in case of overflow.  See options below.
+
+   *note overflow:: is the same as *note float::.  It causes the result
+to be returned as a real number rather than as an integer.  This is the
+default.
+
+   The command *note overflow:: causes integer arithmetic overflow to be
+ignored.  No error is shown.  This may be desirable if your platform
+allows only 32-bit integer arithmetic and you want to approximate the
+behaviour of gnuplot versions prior to 5.4.
+
+   The *note reset:: command does not affect the state of overflow
+handling.
+
+   Earlier gnuplot versions were limited to 32-bit arithmetic and
+ignored integer overflow.  Note, however, that some built-in operators
+did not use integer arithmetic at all, even when given integer
+arguments.  This included the exponentiation operator N**M and the
+summation operator (see *note summation::).  These operations now return
+an integer value when given integer arguments, making them potentially
+susceptible to overflow and thus affected by the state of *note
+overflow::.
+
+* Menu:
+
+* float::
+* NaN::
+* undefined::
+* affected_operations::
+
+
+File: gnuplot.info,  Node: float,  Next: NaN,  Prev: overflow,  Up: overflow
+
+3.33.66.1 float
+...............
+
+If an integer arithmetic expression overflows the limiting range, [-2^63
+: 2^63] for 64-bit integers, the result is returned as a floating point
+value instead.  This is not treated as an error.  Example:
+          gnuplot> set overflow float
+          gnuplot> A = 2**62 - 1;  print A, A+A, A+A+A
+          4611686018427387903 9223372036854775806 1.38350580552822e+19
+
+
+
+File: gnuplot.info,  Node: NaN,  Next: undefined,  Prev: float,  Up: overflow
+
+3.33.66.2 NaN
+.............
+
+If an integer arithmetic expression overflows the limiting range, [-2^63
+: 2^63] for 64-bit integers, the result is returned as NaN (Not a
+Number).  This is not treated as an error.  Example:
+          gnuplot> set overflow NaN
+          gnuplot> print 10**18, 10**19
+          1000000000000000000 NaN
+
+
+
+File: gnuplot.info,  Node: undefined,  Next: affected_operations,  Prev: NaN,  Up: overflow
+
+3.33.66.3 undefined
+...................
+
+If an integer arithmetic expression overflows the limiting range, [-2^63
+: 2^63] for 64-bit integers, the result is undefined.  This is treated
+as an error.  Example:
+          gnuplot> set overflow undefined
+          gnuplot> A = 10**19
+                       ^
+                   undefined value
+
+
+
+File: gnuplot.info,  Node: affected_operations,  Prev: undefined,  Up: overflow
+
+3.33.66.4 affected operations
+.............................
+
+The *note overflow:: state affects the arithmetic operators
+          + - * / **
+
+   and the built-in summation operation 'sum'.
+
+   All of these operations will return an integer result if all of the
+arguments are integers, so long as no overflow occurs during evaluation.
+
+   The *note overflow:: state does not affect logical or bit operations
+          << >>  | ^ &
+
+
+   If overflow occurs at any point during the course of evaluating of a
+summation *note float:: will cause the result to be returned as a real
+number even if the final sum is within the range of integer
+representation.
+
+
+File: gnuplot.info,  Node: palette__,  Next: parametric_,  Prev: overflow,  Up: set-show
+
+3.33.67 palette
+---------------
+
+The palette is a set of colors, usually ordered as one or more stepped
+gradients, used to color pm3d surfaces, heat maps, and other plot
+elements.  Colors in the current palette are automatically mapped from
+plot coordinate z values or from an extra data column of gray values.
+The current palette is shown by default in a separate 'colorbox' drawn
+next to plots that use plot style 'pm3d'.  The colorbox can be
+customized or disabled.  See 'set colorbox'.  See also *note palette::
+and *note palette::.
+
+   Syntax:
+           set palette
+           set palette {
+                      { gray | color }
+                      { gamma <gamma> }
+                      {   rgbformulae <r>,<g>,<b>
+                        | defined { ( <gray1> <color1> {, <grayN> <colorN>}... ) }
+                        | file '<filename>' {datafile-modifiers}
+                        | colormap <colormap-name>
+                        | functions <R>,<G>,<B>
+                      }
+                      { cubehelix {start <val>} {cycles <val>} {saturation <val>} }
+                      { viridis }
+                      { model { RGB | CMY | HSV {start <radians>} } }
+                      { positive | negative }
+                      { nops_allcF | ps_allcF }
+                      { maxcolors <maxcolors> }
+                    }
+
+
+   A palette can be defined in several ways.  - Provide formulae for the
+red, green, and blue components as a function of the gray value between
+0 and 1.  *note rgbformulae:: allows you to choose from 36 predefined
+formulae.  *note functions:: allows you to define your own functions.  -
+Use *note defined:: to specify one or more smooth gradients, each
+spanning one segment of the total z range.  - Load a previously save
+palette into the current palette.  'Set palette file' reads a saved
+palette from a file.  *note colormap:: extracts the RGB components from
+a saved colormap.  - Specify a named palette, perhaps with additional
+parameters to customize.  The named palettes currently provided are
+*note cubehelix:: (a customizable family of palettes) and *note
+viridis::.
+
+   *note palette:: (without options) restores the default values.
+
+   'set palette negative' inverts the direction of the palette, e.g.
+'set palette viridis negative' creates a gradient from yellow to blue
+rather than from blue to yellow.
+
+   *note gray:: switches to a grayscale palette.  'set palette color'
+restores the most recent color palette.
+
+   In 'pm3d' color surfaces the gray value of each small quadrangle is
+obtained by mapping the averaged z-coordinate of its 4 corners from the
+range [min_z,max_z] into the range of grays, which is always [0:1].  The
+palette maps that gray value into an RGB color.
+
+   Palette colors can be mentioned explicitly in a color specification
+(see *note colorspec::).  This is useful to assign a palette color to an
+object or label.
+
+   The palette can be defined in any of three color spaces: RGB CMY HSV.
+See 'set palette model'.  All color component values in all color spaces
+are limited to [0,1].
+
+* Menu:
+
+* rgbformulae::
+* defined::
+* functions_::
+* gray::
+* cubehelix::
+* viridis::
+* colormap_::
+* file::
+* gamma_correction::
+* maxcolors::
+* Color_model::
+* postscript::
+
+
+File: gnuplot.info,  Node: rgbformulae,  Next: defined,  Prev: palette__,  Up: palette__
+
+3.33.67.1 rgbformulae
+.....................
+
+          set palette rgbformulae <function 1>, <function 2>, <function 3>
+
+   Despite its name, this option applies to all color spaces.  You must
+specify one of 36 preset mapping functions by number for each color
+component.  The available functions are listed by *note rgbformulae::.
+The default is 'set palette rgbformulae 7,5,15'.  In RGB space this uses
+function 7 to map the red component, function 5 to map the green
+component, and function 15 to map the blue component.  A negative
+function number inverts the sense of that component by mapping f(1-gray)
+rather than f(gray).
+
+   Some nice schemes in RGB color space
+        7,5,15   ... default (black-blue-red-yellow)
+        3,11,6   ... green-red-violet
+        23,28,3  ... ocean (green-blue-white)
+        21,22,23 ... hot (black-red-yellow-white)
+        30,31,32 ... black-blue-violet-yellow-white
+        33,13,10 ... rainbow (blue-green-yellow-red)
+        34,35,36 ... AFM hot (black-red-yellow-white)
+
+
+   A full color palette in HSV color space
+        3,2,2    ... red-yellow-green-cyan-blue-magenta-red
+
+
+
+File: gnuplot.info,  Node: defined,  Next: functions_,  Prev: rgbformulae,  Up: palette__
+
+3.33.67.2 defined
+.................
+
+Gray-to-rgb mapping can be manually set by use of *note defined::: A
+color gradient is defined and used to give the rgb values.  Such a
+gradient is a piecewise linear mapping from gray values in [0,1] to the
+RGB space [0,1]x[0,1]x[0,1].  You must specify the gray values and the
+corresponding RGB values between which linear interpolation will be
+done.
+
+   Syntax:
+           set palette  defined { ( <gray1> <color1> {, <grayN> <colorN>}... ) }
+
+
+   where N ≥ 2 and <grayN> are gray values which are mapped to [0,1].
+The corresponding rgb color <colorN> can be specified in three different
+ways:
+
+          <color> :=  { <r> <g> <b> | '<color-name>' | '#rrggbb' }
+
+
+   Either by three numbers (each in [0,1]) for red, green and blue,
+separated by whitespace, or the name of the color in quotes or X style
+color specifiers also in quotes.  You may freely mix the three types in
+a gradient definition, but the named color "red" will be something
+strange if RGB is not selected as color space.  Use *note colornames::
+for a list of known color names.
+
+   The <gray> values must form an ascending sequence of real numbers;
+the sequence will be automatically rescaled to [0,1].
+
+   *note defined:: (without a gradient definition in braces) switches to
+RGB color space and uses a preset full-spectrum color gradient.  Use
+'show palette gradient' to display the gradient.
+
+   Examples:
+
+   To produce a gray palette (useless but instructive) use:
+           set palette model RGB
+           set palette defined ( 0 "black", 1 "white" )
+
+
+   To produce a blue-to-yellow-to-red palette use (all equivalent):
+           set palette defined ( 0 "blue", 1 "yellow", 2 "red" )
+           set palette defined ( 0 0 0 1, 1 1 1 0, 2 1 0 0 )
+           set palette defined ( 0 "#0000ff", 1 "#ffff00", 2 "#ff0000" )
+
+
+   Full color spectrum within HSV color space:
+           set palette model HSV
+           set palette defined ( 0 0 1 1, 1 1 1 1 )
+           set palette defined ( 0 0 1 0, 1 0 1 1, 6 0.8333 1 1, 7 0.8333 0 1)
+
+
+   Full color HSV spectrum wrapping at some hue other than red
+           set palette model HSV start 0.15
+           set palette defined ( 0 0 1 1, 1 1 1 1 )
+
+
+   To produce a palette with only a few, equally-spaced colors:
+           set palette model RGB maxcolors 4
+           set palette defined ( 0 "yellow", 1 "red" )
+
+
+   'Traffic light' palette (non-smooth color jumps at gray = 1/3 and
+2/3).
+           set palette model RGB
+           set palette defined (0 "dark-green", 1 "green", \
+                                1 "yellow",     2 "dark-yellow", \
+                                2 "red",        3 "dark-red" )
+
+
+
+File: gnuplot.info,  Node: functions_,  Next: gray,  Prev: defined,  Up: palette__
+
+3.33.67.3 functions
+...................
+
+          set palette functions <f1(gray)>, <f2(gray)>, <f3(gray)>
+
+   This option is like *note rgbformulae:: except that you must provide
+an actual function for each color component rather than the index of a
+preset function.  The dummy parameter of each function, if any, must be
+"gray".  The function must map gray values in [0,1] to output values
+also in [0,1].
+
+   Examples:
+
+   To produce a full color palette use:
+           set palette model HSV functions gray, 1, 1
+
+
+   A nice black to gold palette:
+           set palette model RGB functions 1.1*gray**0.25, gray**0.75, 0
+
+
+   A gamma-corrected black and white palette
+           gamma = 2.2
+           map(gray) = gray**(1./gamma)
+           set palette model RGB functions map(gray), map(gray), map(gray)
+
+
+
+File: gnuplot.info,  Node: gray,  Next: cubehelix,  Prev: functions_,  Up: palette__
+
+3.33.67.4 gray
+..............
+
+*note gray:: switches to a grayscale palette shading from 0.0 = black to
+1.0 = white.  'set palette color' is an easy way to switch back from the
+gray palette to the last color mapping.
+
+
+File: gnuplot.info,  Node: cubehelix,  Next: viridis,  Prev: gray,  Up: palette__
+
+3.33.67.5 cubehelix
+...................
+
+The "cubehelix" option defines a family of palettes in which color (hue)
+varies around the standard color wheel while the net perceived intensity
+increases monotonically as the gray value goes from 0 to 1.
+           D A Green (2011) http://arxiv.org/abs/1108.5083
+
+   'start' defines the starting point along the color wheel in radians.
+'cycles' defines how many color wheel cycles span the palette range.
+Larger values of 'saturation' produce more saturated color; saturation >
+1 may lead to clipping of the individual RGB components and to intensity
+becoming non-monotonic.  The palette is also affected by 'set palette
+gamma'.  The default values are
+           set palette cubehelix start 0.5 cycles -1.5 saturation 1
+           set palette gamma 1.5
+
+
+
+File: gnuplot.info,  Node: viridis,  Next: colormap_,  Prev: cubehelix,  Up: palette__
+
+3.33.67.6 viridis
+.................
+
+           set palette viridis
+
+   The "viridis" palette is a (blue->yellow) gradient designed to
+accommodate users with impaired color vision.  Viridis was developed by
+Stéfan van der Walt and Nathaniel Smith.  It features an approximately
+linear gradient of perceived brightness (luminance).  The colormap
+version used in gnuplot is based on
+           "Viridis - Colorblind-Friendly Color Maps for R", Garnier et al (2021)
+           https://CRAN.R-project.org/package=viridis
+
+   D viridis 1
+
+
+File: gnuplot.info,  Node: colormap_,  Next: file,  Prev: viridis,  Up: palette__
+
+3.33.67.7 colormap
+..................
+
+'set palette colormap <name>' loads a defined gradient that was
+previously saved to a colormap.  Alpha channel information in the
+colormap, if any, will be lost when the color values are copied into the
+palette definition.  See *note colormap::.
+
+
+File: gnuplot.info,  Node: file,  Next: gamma_correction,  Prev: colormap_,  Up: palette__
+
+3.33.67.8 file
+..............
+
+'set palette file' is basically a 'set palette defined (<gradient>)'
+where <gradient> is read from a datafile or datablock.  The color values
+may be provided either as a single 24-bit packed RGB integer (1 or 2
+'using' columns) or as three separate fractional R, G, B components (3
+or 4 'using' columns).  If no explicit gray value is provided in the
+first input column, the line number is used; this generates equal
+spacing along the color axis.
+
+   The file is read as a normal data file, so all datafile modifiers can
+be used.  Please note that 'R' might actually be 'H' if HSV color space
+is selected.
+
+   Use 'show palette gradient' to display the gradient.
+
+   Examples:
+
+   Read in a palette of RGB triples each in range [0,255]:
+           set palette file 'some-palette' using ($1/255):($2/255):($3/255)
+
+
+   Equidistant rainbow (blue-green-yellow-red) palette:
+           set palette model RGB file "-" using 1:2:3
+           0 0 1
+           0 1 0
+           1 1 0
+           1 0 0
+           e
+
+
+   Same thing using explicit gray intervals and packed RGB values:
+           set palette model RGB file "-" using 1:2
+           1  0x0000ff
+           2  0x00ff00
+           3  0xffff00
+           4  0xff0000
+           e
+
+
+   Binary palette files are supported as well, see *note general::.
+Example: put 64 triplets of R,G,B doubles into file palette.bin and load
+it by
+           set palette file "palette.bin" binary record=64 using 1:2:3
+
+
+
+File: gnuplot.info,  Node: gamma_correction,  Next: maxcolors,  Prev: file,  Up: palette__
+
+3.33.67.9 gamma correction
+..........................
+
+Automatic gamma correction via 'set palette gamma <gamma>' can be done
+for gray maps (*note gray::) and for the *note cubehelix:: color palette
+schemes.  Gamma = 1 produces a linear ramp of intensity.  See *note
+palette::.
+
+   For gray mappings, <gamma> defaults to 1.5 which is usually suitable.
+
+   The gamma correction is applied to the cubehelix color palette
+family, but not to other palette coloring schemes.  However, you may
+easily implement gamma correction for explicit color functions.
+
+   Example:
+           set palette model RGB
+           set palette functions gray**0.64, gray**0.67, gray**0.70
+
+
+   To use gamma correction with interpolated gradients specify
+intermediate gray values with appropriate colors.  Instead of
+
+           set palette defined ( 0 0 0 0, 1 1 1 1 )
+
+
+   use e.g.
+
+           set palette defined ( 0 0 0 0, 0.5 .73 .73 .73, 1 1 1 1 )
+
+
+   or even more intermediate points until the linear interpolation fits
+the "gamma corrected" interpolation well enough.
+
+
+File: gnuplot.info,  Node: maxcolors,  Next: Color_model,  Prev: gamma_correction,  Up: palette__
+
+3.33.67.10 maxcolors
+....................
+
+'set palette maxcolors <N>' limits the palette to N discrete colors
+selected from a continuous palette sampled at equally spaced intervals.
+If you want unequal spacing of N discrete colors, use *note defined::
+instead of a single continuous palette.
+
+   The primary use for this is to generate heat maps with discrete
+colors, each representing a range of values.
+
+   A second use is to handle terminals that support only a limited
+number of colors (e.g.  256 colors in gif or sixel).  The default
+gnuplot linetype colors use up some of these, further limiting the
+number available for palette use.  Thus a multiplot using multiple
+palettes could fail because the first palette has used all the available
+color positions.  You can mitigate this by restricting the number of
+colors used by each palette.
+
+
+File: gnuplot.info,  Node: Color_model,  Next: postscript,  Prev: maxcolors,  Up: palette__
+
+3.33.67.11 Color model
+......................
+
+          set palette model { RGB | CMY | HSV {start <radians>} }
+
+   Sometimes RGB color space is not the most convenient color space to
+work in.  You may change the color space 'model' to one of 'RGB', 'HSV',
+'CMY'. RGB stands for Red, Green, Blue; CMY stands for Cyan, Magenta,
+Yellow; HSV stands for Hue, Saturation, Value.  In HSV space the full
+color wheel is traversed as H runs from 0 to 1, so H=0 and H=1 describe
+the same color.  By default the cycle starts and ends at red.  The
+optional parameter 'start' introduces an offset, so after 'set palette
+model HSV start 0.3' H=0 and H=1 both correspond to green.
+
+   For more information on color models see:
+http://en.wikipedia.org/wiki/Color_space
+(http://en.wikipedia.org/wiki/Color_space)
+
+   Documentation for palette options was written for RGB color space, so
+please note that 'R' really means "first color component", which can be
+'H' or 'C' depending on the actual color space in use.
+
+
+File: gnuplot.info,  Node: postscript,  Prev: Color_model,  Up: palette__
+
+3.33.67.12 postscript
+.....................
+
+This section is only relevant to output from 'set term postscript
+color'.  When the palette is defined using *note rgbformulae::, gnuplot
+writes a postscript implementation of the required analytical formulae
+as a header just before a pm3d drawing (see /g and /cF definitions).
+Usually, it makes sense to write definitions of only the 3 formulae used
+in the palette.  This is the default option 'nops_allcF'. The option
+'ps_allcF' instead writes definitions of all 36 formulae.  This allows
+you to edit the postscript file in order to have different palettes for
+different surfaces in one graph.
+
+   If you write a pm3d surface to a postscript file, it may be possible
+to reduce the file size by running the awk script 'pm3dCompress.awk'
+afterward.  If the data lies on a rectangular grid, even greater
+compression may be possible using the awk script
+'pm3dConvertToImage.awk'.  Both scripts are distributed with gnuplot.
+Usage:
+         awk -f pm3dCompress.awk thefile.ps >smallerfile.ps
+         awk -f pm3dConvertToImage.awk thefile.ps >smallerfile.ps
+
+
+
+File: gnuplot.info,  Node: parametric_,  Next: paxis,  Prev: palette__,  Up: set-show
+
+3.33.68 parametric
+------------------
+
+The *note parametric:: command changes the meaning of 'plot' ('splot')
+from normal functions to parametric functions.  The command *note
+parametric:: restores the plotting style to normal, single-valued
+expression plotting.
+
+   Syntax:
+           set parametric
+           unset parametric
+           show parametric
+
+
+   For 2D plotting, a parametric function is determined by a pair of
+parametric functions operating on a parameter.  An example of a 2D
+parametric function would be 'plot sin(t),cos(t)', which draws a circle
+(if the aspect ratio is set correctly--see *note size::).  'gnuplot'
+will display an error message if both functions are not provided for a
+parametric 'plot'.
+
+   For 3D plotting, the surface is described as x=f(u,v), y=g(u,v),
+z=h(u,v).  Therefore a triplet of functions is required.  An example of
+a 3D parametric function would be 'cos(u)*cos(v),cos(u)*sin(v),sin(u)',
+which draws a sphere.  'gnuplot' will display an error message if all
+three functions are not provided for a parametric 'splot'.
+
+   The total set of possible plots is a superset of the simple f(x)
+style plots, since the two functions can describe the x and y values to
+be computed separately.  In fact, plots of the type t,f(t) are
+equivalent to those produced with f(x) because the x values are computed
+using the identity function.  Similarly, 3D plots of the type u,v,f(u,v)
+are equivalent to f(x,y).
+
+   Note that the order the parametric functions are specified is
+xfunction, yfunction (and zfunction) and that each operates over the
+common parametric domain.
+
+   Also, the *note parametric:: function implies a new range of values.
+Whereas the normal f(x) and f(x,y) style plotting assume an xrange and
+yrange (and zrange), the parametric mode additionally specifies a
+trange, urange, and vrange.  These ranges may be set directly with *note
+trange::, *note urange::, and *note vrange::, or by specifying the range
+on the 'plot' or 'splot' commands.  Currently the default range for
+these parametric variables is [-5:5].  Setting the ranges to something
+more meaningful is expected.
+
+
+File: gnuplot.info,  Node: paxis,  Next: pixmap,  Prev: parametric_,  Up: set-show
+
+3.33.69 paxis
+-------------
+
+Syntax:
+           set paxis <axisno> {range <range-options> | tics <tic-options>}
+           set paxis <axisno> label <label-options> { offset <radial-offset> }
+           show paxis <axisno> {range | tics}
+
+   The *note paxis:: command is equivalent to the *note xrange:: and
+'set xtics' commands except that it acts on one of the axes p1, p2, ...
+used in parallel axis plots and spiderplots.  See *note parallelaxes::,
+*note xrange::, and 'set xtics'.  The normal options to the range and
+tics commands are accepted although not all options make sense for
+parallel axis plots.
+
+   'set paxis <axisno> label <label-options>' is relevant to spiderplots
+but ignored otherwise.  Axes of a parallel axis plot can be labeled
+using the *note title:: option of the plot command, which generates an
+xtic label.  Note that this may require also 'set xtics'.
+
+   The axis linetype properties are controlled using 'set style
+parallelaxis'.
+
+
+File: gnuplot.info,  Node: pixmap,  Next: pm3d,  Prev: paxis,  Up: set-show
+
+3.33.70 pixmap
+--------------
+
+Syntax:
+           set pixmap <index> {"filename" | colormap <name>}
+                      at <position>
+                      {width <w> | height <h> | size <w>,<h>}
+                      {front|back|behind} {center}
+           show pixmaps
+           unset pixmaps
+           unset pixmap <index>
+
+
+   The 'set pixmap' command is similar to *note object:: in that it
+defines an object that will appear on subsequent plots.  The rectangular
+array of red/green/blue/alpha values making up the pixmap are read from
+a png, jpeg, or gif file.  The position and extent occupied by the
+pixmap in the gnuplot output may be specified in any coordinate system
+(see 'coordinates').  The coordinates given by 'at <position>' refer to
+the lower left corner of the pixmap unless keyword 'center' is present.
+
+   If the x-extent of the rendered pixmap is set using 'width
+<x-extent>' the aspect ratio of the original image is retained and
+neither the aspect ratio nor the orientation of the pixmap changes with
+axis scaling or rotation.  Similarly if the y-extent is set using
+'height <y-extent>'.  If both the x-extent and y-extent are given using
+'size <x-extent> <y-extent>' this overrides the original aspect ratio.
+If no size is set then the original size in pixels is used (the
+effective size is then terminal-dependent).
+
+   Pixmaps are not clipped to the border of the plot.  As an exception
+to the general behaviour of objects and layers, a pixmap assigned to
+layer 'behind' is rendered for only the first plot in a multiplot.  This
+allows all panels in a multiplot to share a single background pixmap.
+
+   Examples:
+           # Use a gradient as the background for all plotting
+           # Both x and y will be resized to fill the entire canvas
+           set pixmap 1 "gradient.png"
+           set pixmap 1 at screen 0, 0 size screen 1, 1 behind
+
+
+           # Place a logo at the lower right of each page plotted
+           set pixmap 2 "logo.jpg"
+           set pixmap 2 at screen 0.95, 0 width screen 0.05 behind
+
+
+           # Place a small image at some 3D coordinate
+           # It will move as if attached to the surface being plotted
+           # but will always face forward and remain upright
+           set pixmap 3 "image.png" at my_x, my_y, f(my_x,my_y) width screen .05
+           splot f(x,y)
+
+
+* Menu:
+
+* pixmap_from_colormap::
+
+
+File: gnuplot.info,  Node: pixmap_from_colormap,  Prev: pixmap,  Up: pixmap
+
+3.33.70.1 pixmap from colormap
+..............................
+
+Syntax:
+          set pixmap <index> colormap <name>
+
+
+   Another use of pixmaps is to store a gradient described by a named
+palette.  This is an easy way to specify gradient fill for a rectangular
+area.  It could be used to draw a separate colorbox for that named
+palette, or even as a background for the entire plot or the entire
+canvas.
+          set palette defined (0 "beige", 1 "light-cyan")
+          set colormap new Gradient
+          set pixmap 1 colormap Gradient behind
+          set pixmap 1 at screen 0,0 size screen 1,1
+          plot <something>
+
+
+
+File: gnuplot.info,  Node: pm3d,  Next: pointintervalbox,  Prev: pixmap,  Up: set-show
+
+3.33.71 pm3d
+------------
+
+pm3d is an 'splot' style for drawing palette-mapped 3d and 4d data as
+color/gray maps and surfaces.  It allows plotting gridded or non-gridded
+data without preprocessing.  pm3d style options also affect solid-fill
+polygons used to construct other 3D plot elements.
+
+   Syntax (the options can be given in any order):
+           set pm3d {
+                      { at <position> }
+                      { interpolate <steps/points in scan, between scans> }
+                      { scansautomatic | scansforward | scansbackward
+                                       | depthorder {base} }
+                      { flush { begin | center | end } }
+                      { ftriangles | noftriangles }
+                      { clip | clip1in | clip4in }
+                      { {no}clipcb }
+                      { corners2color
+                        { mean|geomean|harmean|rms|median|min|max|c1|c2|c3|c4 }
+                      }
+                      { {no}lighting
+                        {primary <fraction>} {specular <fraction>} {spec2 <fraction>}
+                      }
+                      { {no}border {retrace} {<linestyle-options>}}
+                      { implicit | explicit }
+                      { map }
+                    }
+           show pm3d
+           unset pm3d
+
+
+   Note that pm3d plots are plotted sequentially in the order given in
+the splot command.  Thus earlier plots may be obscured by later plots.
+To avoid this you can use the 'depthorder' scan option.
+
+   The pm3d surfaces can be projected onto the 'top' or 'bottom' of the
+view box.  See *note position::.  The following command draws three
+color surfaces at different altitudes:
+           set border 4095
+           set pm3d at s
+           splot 10*x with pm3d at b, x*x-y*y, x*x+y*y with pm3d at t
+
+
+   See also help for *note palette::, *note cbrange::, 'set colorbox',
+and the demo file 'demo/pm3d.dem'.
+
+* Menu:
+
+* with_pm3d_(pm3d_explicit)::
+* pm3d_implicit::
+* algorithm::
+* lighting::
+* position::
+* scanorder::
+* clipping::
+* color_assignment::
+* corners2color::
+* border_::
+* fillcolor::
+* interpolate::
+* deprecated_options::
+
+
+File: gnuplot.info,  Node: with_pm3d_(pm3d_explicit),  Next: pm3d_implicit,  Prev: pm3d,  Up: pm3d
+
+3.33.71.1 with pm3d (pm3d explicit)
+...................................
+
+Syntax
+          splot DATA using (x):(y):(z){:(color)} with pm3d
+                     {fs|fillstyle <fillstyle>} {fc|fillcolor <colorspec>}
+                     {zclip [zmin:zmax]}
+
+
+   The rendering properties of all pm3d surfaces are controlled using
+'set pm3d'.  By default the full surface is rendered as a grid of
+quadrangles, each colored by the palette color mapped to that z
+coordinate.  If you provide a fourth input column, the palette mapping
+uses that value rather than z.  See *note fillcolor::, *note
+color_assignment::.
+
+   When you explicitly use 'with pm3d' in the plot command rather than
+using another plot style while 'set pm3 implicit' is active, additional
+rendering options are possible.  This allows you to use separate
+coloring schemes for different surfaces in the same plot.
+
+   EXPERIMENTAL: This gnuplot version introduces an option 'zclip' that
+clips the generated surface smoothly at a pair of limiting z values.
+The example below animates gradual removal of the top portion of a
+two-color 3D surface.
+          set style line 101 lc "gray"
+          set style line 102 lc "blue"
+          set pm3d depthorder
+          do for [i=0:N] {
+              splot f(x,y) with pm3d fillcolor ls 101 zclip [* : zmax-(i*delta)]
+              pause 0.2  # 1/5 second between animation frames
+          }
+
+
+
+File: gnuplot.info,  Node: pm3d_implicit,  Next: algorithm,  Prev: with_pm3d_(pm3d_explicit),  Up: pm3d
+
+3.33.71.2 pm3d implicit
+.......................
+
+A pm3d color surface is drawn if the splot command explicitly specifies
+'with pm3d', if the data or function *note style:: is set to pm3d
+globally, or if the pm3d mode is 'set pm3d implicit'.  For the latter
+two cases the pm3d surface is draw in addition to the mesh produced by
+the style specified in the plot command.  E.g.
+           splot 'fred.dat' with lines, 'lola.dat' with lines
+
+   would draw both a mesh of lines and a pm3d surface for each data set.
+If the option 'explicit' is on (or 'implicit' is off) only plots
+specified by the 'with pm3d' attribute are plotted with a pm3d surface,
+e.g.:
+           splot 'fred.dat' with lines, 'lola.dat' with pm3d
+
+   would plot 'fred.dat' with lines (only) and 'lola.dat' with a pm3d
+surface.
+
+   On gnuplot start-up, the mode is 'explicit'.  For historical and
+compatibility reasons, the commands 'set pm3d;' (i.e.  no options) and
+'set pm3d at X ...'  (i.e.  'at' is the first option) change the mode to
+'implicit'.  The command 'set pm3d;' sets other options to their default
+state.
+
+   If you set the default data or function style to 'pm3d', e.g.:
+           set style data pm3d
+
+   then the options 'implicit' and 'explicit' have no effect.
+
+
+File: gnuplot.info,  Node: algorithm,  Next: lighting,  Prev: pm3d_implicit,  Up: pm3d
+
+3.33.71.3 algorithm
+...................
+
+Let us first describe how a map/surface is drawn.  The input data come
+from an evaluated function or from an 'splot data file'.  Each surface
+consists of a sequence of separate scans (isolines).  The pm3d algorithm
+fills the region between two neighbouring points in one scan with
+another two points in the next scan by a gray (or color) according to
+z-values (or according to an additional 'color' column, see help for
+'using') of these 4 corners; by default the 4 corner values are
+averaged, but this can be changed by the option *note corners2color::.
+In order to get a reasonable surface, the neighbouring scans should not
+cross and the number of points in the neighbouring scans should not
+differ too much; of course, the best plot is with scans having same
+number of points.  There are no other requirements (e.g.  the data need
+not be gridded).  Another advantage is that the pm3d algorithm does not
+draw anything outside of the input (measured or calculated) region.
+
+   Surface coloring works with the following input data:
+
+   1.  splot of function or of data file with one or three data columns:
+The gray/color scale is obtained by mapping the averaged (or *note
+corners2color::) z-coordinate of the four corners of the above-specified
+quadrangle into the range [min_color_z,max_color_z] of *note zrange:: or
+*note cbrange:: providing a gray value in the range [0:1].  This value
+can be used directly as the gray for gray maps.  The normalized gray
+value can be further mapped into a color--see *note palette:: for the
+complete description.
+
+   2.  splot of data file with two or four data columns: The gray/color
+value is obtained by using the last-column coordinate instead of the
+z-value, thus allowing the color and the z-coordinate be mutually
+independent.  This can be used for 4d data drawing.
+
+   Other notes:
+
+   1.  The term 'scan' referenced above is used more among physicists
+than the term 'iso_curve' referenced in gnuplot documentation and
+sources.  You measure maps recorded one scan after another scan, that's
+why.
+
+   2.  The 'gray' or 'color' scale is a linear mapping of a continuous
+variable onto a smoothly varying palette of colors.  The mapping is
+shown in a rectangle next to the main plot.  This documentation refers
+to this as a "colorbox", and refers to the indexing variable as lying on
+the colorbox axis.  See 'set colorbox', *note cbrange::.
+
+
+File: gnuplot.info,  Node: lighting,  Next: position,  Prev: algorithm,  Up: pm3d
+
+3.33.71.4 lighting
+..................
+
+Syntax:
+          set pm3d lighting {primary <frac>} {specular <frac>} {spec2 <frac>}
+          set pm3d spotlight {rgb <color>} {rot_x <angle>} {rot_z <angle>}
+                             {Phong <value>} {default}
+
+
+   By default the colors assigned to pm3d objects are not dependent on
+orientation or viewing angle.  This state corresponds to 'set pm3d
+nolighting'.  The command *note lighting:: selects a simple lighting
+model consisting of a single fixed source of illumination contributing
+50% of the overall lighting.  The strength of this light relative to the
+ambient illumination can be adjusted by 'set pm3d lighting primary
+<fraction>'.  Inclusion of specular highlighting can be adjusted by
+setting a fractional contribution:
+          set pm3d lighting primary 0.50 specular 0.0   # no highlights
+          set pm3d lighting primary 0.50 specular 0.6   # strong highlights
+
+   Solid-color pm3d surfaces tend to look very flat without specular
+highlights.
+
+   Since highlights the primary source only affect one side of the
+surface, it may help to add illumination from a second spotlight shining
+from another direction.  The strength of this second spotlight is set by
+"spec2 <fraction>".  The second spotlight is included in the lighting
+model only if spec2 is greater than zero.  The direction, color, and
+specular model is controlled by "set pm3d spotlight".  Use and
+positioning of this spotlight is illustrated in the interactive demo
+'spotlight.dem'.  See also hidden_compare.dem (comparison of hidden3d
+and pm3d treatment of solid-color surfaces)
+(http://www.gnuplot.info/demo/hidden_compare.html) Example:
+          set pm3d lighting primary 0.8 spec 0.4 spec2 0.4
+          set pm3d spot rgb "blue"
+
+   D spotlight 1
+
+
+File: gnuplot.info,  Node: position,  Next: scanorder,  Prev: lighting,  Up: pm3d
+
+3.33.71.5 position
+..................
+
+The pm3d colored surface can be drawn at the true z position of the
+surface or projected onto the base plane or the top plane.  This is
+controlled by the 'at' option with a string of up to 6 combinations of
+'b', 't' and 's'.  For instance, 'at b' plots at the bottom only, 'at
+st' plots first at the surface and then on the top plane, while 'at
+bstbst' is unlikely to be useful.
+
+   Colored quadrangles are plotted one after another.  That means later
+quadrangles can occlude or overlap the previous ones.  You may try to
+switch between 'scansforward' and 'scansbackward' to force the first
+scan of the data to be plotted first or last.  The default is
+'scansautomatic' where gnuplot makes a guess about scans order.  The
+'depthorder' option completely reorders the quadrangles by sorting on
+the distance from the viewpoint.  This allow to visualize even
+complicated surfaces; see 'pm3d depthorder' for more details.
+
+
+File: gnuplot.info,  Node: scanorder,  Next: clipping,  Prev: position,  Up: pm3d
+
+3.33.71.6 scanorder
+...................
+
+          set pm3d {scansautomatic | scansforward | scansbackward | depthorder}
+
+
+   By default the quadrangles making up a pm3d solid surface are
+rendered in the order they are encountered along the surface grid
+points.  This order may be controlled by the options
+'scansautomatic'|'scansforward'|'scansbackward'.  These scan options are
+not in general compatible with hidden-surface removal.
+
+   If two successive scans do not have same number of points, then it
+has to be decided whether to start taking points for quadrangles from
+the beginning of both scans ('flush begin'), from their ends ('flush
+end') or to center them ('flush center').  Note, that 'flush
+(center|end)' are incompatible with 'scansautomatic': if you specify
+'flush center' or 'flush end' and 'scansautomatic' is set, it is
+silently switched to 'scansforward'.
+
+   If two subsequent scans do not have the same number of points, the
+option 'ftriangles' specifies whether color triangles are drawn at the
+scan tail(s) where there are not enough points in either of the scans.
+This can be used to draw a smooth map boundary.
+
+   Gnuplot does not do true hidden surface removal for solid surfaces,
+but often it is sufficient to render the component quadrangles in order
+from furthest to closest.  This mode may be selected using the option
+           set pm3d depthorder
+
+   Note that the global option *note hidden3d:: does not affect pm3d
+surfaces.
+
+   The 'depthorder' option by itself tends to produce bad results when
+applied to the long thin rectangles generated by *note boxes::.  It
+works better to add the keyword 'base', which performs the depth sort
+using the intersection of the box with the plane at z=0.  This type of
+plot is further improved by adding a lighting model.  Example:
+          set pm3d depthorder base
+          set pm3d lighting
+          set boxdepth 0.4
+          splot $DATA using 1:2:3 with boxes
+
+
+
+File: gnuplot.info,  Node: clipping,  Next: color_assignment,  Prev: scanorder,  Up: pm3d
+
+3.33.71.7 clipping
+..................
+
+Syntax:
+          set pm3d {clip | clip1in | clip4in}
+          set pm3d {no}clipcb
+
+
+   The component quadrangles of a pm3d surface or other 3D object are by
+default smoothly clipped against the current zrange.  This is a change
+from earlier gnuplot versions.  In 2D projection ('set view map') this
+mode also clips against xrange and yrange.
+
+   Alternatively, surfaces can be clipped by rendering whole quadrangles
+but only those with all 4 corners in-range on x, y, and z ('set pm3d
+clip4in'), or only those with at least one corner in-range on x, y, and
+z ('set pm3d clip1in').  The options 'clip', 'clip1in', and 'clip4in'
+are mutually exclusive.
+
+   Separate from clipping based on spatial x, y, and z coordinates,
+quadrangles can be rendered or not based on extreme palette color
+values.  'clipcb': (default) palette color values < cbmin are treated as
+cbmin; palette color values > cbmax are treated as cbmax.  'noclipcb':
+quadrangles with color value outside cbrange are not drawn at all.
+
+
+File: gnuplot.info,  Node: color_assignment,  Next: corners2color,  Prev: clipping,  Up: pm3d
+
+3.33.71.8 color_assignment
+..........................
+
+The default pm3d coloring assigns an individual color to each quadrangle
+of the surface grid.  For alternative coloring schemes that assign
+uniform color to the entire surface, see *note fillcolor::.
+
+   A single gray/color value (i.e.  not a gradient) is assigned to each
+quadrangle.  This value is calculated from the z-coordinates the four
+quadrangle corners according to 'corners2color <option>'.  The value is
+then used to select a color from the current palette.  See *note
+palette::.  It is not possible to change palettes inside a single
+'splot' command.
+
+   If a fourth column of data is provided, the coloring of individual
+quadrangles works as above except that the color value is distinct from
+the z value.  As a separate coloring option, the fourth data column may
+provide instead an RGB color.  See 'rgbcolor variable'.  In this case
+the plotting command must be
+
+           splot ... using 1:2:3:4 with pm3d lc rgb variable
+
+
+   Notice that ranges of z-values and color-values for surfaces are
+adjustable independently by *note zrange::, *note cbrange::, 'set log
+z', 'set log cb', etc.
+
+
+File: gnuplot.info,  Node: corners2color,  Next: border_,  Prev: color_assignment,  Up: pm3d
+
+3.33.71.9 corners2color
+.......................
+
+The color of each quadrangle in a pm3d surface is assigned based on the
+color values of its four bounding vertices.  The options 'mean'
+(default), 'geomean', 'harmean, 'rms', and 'median' produce various
+kinds of surface color smoothing, while options 'min' and 'max' choose
+minimal or maximal value, respectively.  This may not be desired for
+pixel images or for maps with sharp and intense peaks, in which case the
+options 'c1', 'c2', 'c3' or 'c4' can be used instead to assign the
+quadrangle color based on the z-coordinate of only one corner.  Some
+experimentation may be needed to determine which corner corresponds to
+'c1', as the orientation depends on the drawing direction.  Because the
+pm3d algorithm does not extend the colored surface outside the range of
+the input data points, the 'c<j>' coloring options will result in pixels
+along two edges of the grid not contributing to the color of any
+quadrangle.  For example, applying the pm3d algorithm to the 4x4 grid of
+data points in script 'demo/pm3d.dem' (please have a look) produces only
+(4-1)x(4-1)=9 colored rectangles.
+
+
+File: gnuplot.info,  Node: border_,  Next: fillcolor,  Prev: corners2color,  Up: pm3d
+
+3.33.71.10 border
+.................
+
+          set pm3d border {retrace} {line-properties}
+          set pm3d noborder
+
+
+   This option draws bounding lines around each pm3d quadrangle as it is
+rendered.  Additional line properties (linetype, color, linewidth) are
+optional.  By default the border is drawn as a solid black line with
+width 1.
+
+   'set pm3d border retrace' causes a border to be drawn in the same
+color as the quadrangle.  In principle this should give the same result
+as 'noborder', but some output modes can suffer from antialiasing
+artifacts between adjacent filled quadrangles.  Retracing the border
+hides these artifacts, at the cost of a larger output file.
+
+
+File: gnuplot.info,  Node: fillcolor,  Next: interpolate,  Prev: border_,  Up: pm3d
+
+3.33.71.11 fillcolor
+....................
+
+          splot FOO with pm3d fillcolor <colorspec>
+
+
+   Plot style 'with pm3d' accepts an optional fillcolor in the splot
+command.  This specification is applied to the entire pm3d surface.  See
+*note colorspec::.  Most fillcolor specifications will result in a
+single solid color, which is hard to interpret visually unless there is
+also a lighting model present to distinguish surface components based on
+orientation.  See *note lighting::.
+
+   There are a few special cases.  *note palette:: would produce the
+same result as the default pm3d palette-based coloring, and is therefore
+not a useful option.  'with pm3d fillcolor linestyle N' is more
+interesting.  This variant assigns distinct colors to the top and bottom
+of the pm3d surface, similar to the color scheme used by gnuplot's *note
+hidden3d:: mode.  Linestyle N is used for the top surface; linestyle N+1
+for the bottom surface.  Note that "top" and "bottom" depend on the scan
+order, so that the colors are inverted for 'pm3d scansbackward' as
+compared to 'pm3d scansforward'.  This coloring option works best with
+'pm3d depthorder', however, which unfortunately does not allow you to
+control the scan order so you may have to instead swap the colors
+defined for linestyles N and N+1.
+
+
+File: gnuplot.info,  Node: interpolate,  Next: deprecated_options,  Prev: fillcolor,  Up: pm3d
+
+3.33.71.12 interpolate
+......................
+
+The option 'interpolate m,n' will interpolate between grid points to
+generate a finer mesh.  For data files, this smooths the color surface
+and enhances the contrast of spikes in the surface.  When working with
+functions, interpolation makes little sense.  It would usually make more
+sense to increase *note samples:: and *note isosamples::.
+
+   For positive m and n, each quadrangle or triangle is interpolated
+m-times and n-times in the respective direction.  For negative m and n,
+the interpolation frequency is chosen so that there will be at least |m|
+and |n| points drawn; you can consider this as a special gridding
+function.
+
+   Note: 'interpolate 0,0', will automatically choose an optimal number
+of interpolated surface points.
+
+   Note: Currently color interpolation is always linear, even if
+corners2color is set to a nonlinear scheme such as the geometric mean.
+
+
+File: gnuplot.info,  Node: deprecated_options,  Prev: interpolate,  Up: pm3d
+
+3.33.71.13 deprecated_options
+.............................
+
+The deprecated option 'set pm3d map' was equivalent to 'set pm3d at b;
+set view map; set style data pm3d; set style func pm3d;'
+
+   The deprecated option 'set pm3d hidden3d N' was equivalent to 'set
+pm3d border ls N'.
+
+
+File: gnuplot.info,  Node: pointintervalbox,  Next: pointsize,  Prev: pm3d,  Up: set-show
+
+3.33.72 pointintervalbox
+------------------------
+
+The 'pointinterval' and 'pointnumber' properties of a line type are used
+only in plot style *note linespoints::.  A negative value of
+pointinterval or pointnumber, e.g.  -N, means that before the selected
+set of point symbols are drawn a box (actually circle) behind each point
+symbol is blanked out by filling with the background color.  The command
+*note pointintervalbox:: controls the radius of this blanked-out region.
+It is a multiplier for the default radius, which is equal to the point
+size.  *note pointintervalbox:: draws no blanked-out region.
+
+
+File: gnuplot.info,  Node: pointsize,  Next: polar,  Prev: pointintervalbox,  Up: set-show
+
+3.33.73 pointsize
+-----------------
+
+The *note pointsize:: command scales the size of the points used in
+plots.
+
+   Syntax:
+           set pointsize <multiplier>
+           show pointsize
+
+
+   The default is a multiplier of 1.0.  Larger pointsizes may be useful
+to make points more visible in bitmapped graphics.
+
+   The pointsize of a single plot may be changed on the 'plot' command.
+See 'plot with' for details.
+
+   Please note that the pointsize setting is not supported by all
+terminal types.
+
+
+File: gnuplot.info,  Node: polar,  Next: print_,  Prev: pointsize,  Up: set-show
+
+3.33.74 polar
+-------------
+
+The 'set polar' command changes the meaning of the plot from rectangular
+coordinates to polar coordinates.
+
+   Syntax:
+           set polar
+           set polar grid <grid options>
+           unset polar
+           show polar
+
+
+   In polar coordinates, the dummy variable (t) represents an angle
+theta.  The default range of t is [0:2*pi], or [0:360] if degree units
+have been selected (see *note angles::).
+
+   The command 'unset polar' changes the meaning of the plot back to the
+default rectangular coordinate system.
+
+   The 'set polar' command affects only 2D plotting.  See the *note
+mapping:: command for analogous 3D functionality.
+
+   While in polar coordinates the meaning of an expression in t is
+really r = f(t), where t is an angle of rotation.  The trange controls
+the domain (the angle) of the function.  The r, x and y ranges control
+the extent of the graph in the x and y directions.  Each of these
+ranges, as well as the rrange, may be autoscaled or set explicitly.  For
+details, see *note rrange:: and *note xrange::.
+
+   Example:
+           set polar
+           plot t*sin(t)
+           set trange [-2*pi:2*pi]
+           set rrange [0:3]
+           plot t*sin(t)
+
+
+   The first 'plot' uses the default polar angular domain of 0 to 2*pi.
+The radius and the size of the graph are scaled automatically.  The
+second 'plot' expands the domain, and restricts the size of the graph to
+the area within 3 units of the origin.  This has the effect of limiting
+x and y to [-3:3].
+
+   By default polar plots are oriented such that theta=0 is at the far
+right, with theta increasing counterclockwise.  You can change both the
+origin and the sense explicitly.  See *note theta::.
+
+   You may want to 'set size square' to have 'gnuplot' try to make the
+aspect ratio equal to unity, so that circles look circular.  Tic marks
+around the perimeter can be specified using *note ttics::.  See also
+polar demos (polar.dem) (http://www.gnuplot.info/demo/polar.html) and
+polar data plot (poldat.dem).
+(http://www.gnuplot.info/demo/poldat.html)
+
+* Menu:
+
+* polar_grid::
+
+
+File: gnuplot.info,  Node: polar_grid,  Prev: polar,  Up: polar
+
+3.33.74.1 polar grid
+....................
+
+Syntax:
+           set polar grid {<theta_segments>, <radial_segments>}
+                          { qnorm {<power>} | gauss | cauchy | exp | box | hann }
+                          { kdensity } { scale <scale> }
+                          {theta [min:max]} {r [min:max]}
+
+
+   The polar grid settings are used in conjunction with the plot style
+'with surface' to generate a heat map from a set of polar coordinate
+points.  The surface consists of a grid filling a circle divided into
+segments formed by discrete ranges on theta and r.
+
+   Each segment is assigned a value derived from the input set of
+individual scattered points [x,y,z] by applying a filter operation.  The
+default filter is 'qnorm 1', which averages each point's z value
+weighted by the inverse of the point's distance from the center of that
+grid segment.
+
+   Alternative filter operations gauss, cauchy, exp, box, and hann are
+described in more detail elsewhere.  See *note dgrid3d::.
+
+   'kdensity': This keyword tells the program to use the weighted sum of
+contributions from all points rather than the weighted average.
+
+   'scale': This scale facter (default 1.0) is applied to all distances
+prior to using them in the weighting calculation.
+
+   Masking: All input points are used to calculate grid values.  The
+full gridded surface always spans theta range [0:360] and the radial
+defined by autoscaling or by a previous *note rrange:: command.  However
+the portion of the surface that actually appears in the plot can be
+restricted to a truncated wedge bounded by lower and upper limits on
+theta and r.  Theta limits must be given in degrees.
+
+   For example the following commands will generate a plot which is
+auto-scaled in size to show all input points.  The contributions of all
+input points are summed, not averaged ('kdensity'), and only a wedge of
+the resulting gridded surface is displayed.
+
+          set rrange [0:*]
+          set polar grid qnorm kdensity theta [0:190]
+          plot DATA with surface, DATA with points
+
+
+
+File: gnuplot.info,  Node: print_,  Next: psdir,  Prev: polar,  Up: set-show
+
+3.33.75 print
+-------------
+
+The 'set print' command redirects the output of the 'print' command.
+
+   Syntax:
+           set print
+           set print "-"
+           set print "<filename>" [append]
+           set print "|<shell_command>"
+           set print $datablock [append]
+
+
+   'set print' with no parameters restores output to <STDERR>.  The
+<filename> "-" means <STDOUT>.  The 'append' flag causes the file to be
+opened in append mode.  A <filename> starting with "|" is opened as a
+pipe to the <shell_command> on platforms that support piping.
+
+   The destination for 'print' commands can also be a named data block.
+Data block names start with '$', see also 'inline data'.  When printing
+a string to a data block, embedded newline characters are expanded to
+generate multiple data block entries.
+
+
+File: gnuplot.info,  Node: psdir,  Next: raxis,  Prev: print_,  Up: set-show
+
+3.33.76 psdir
+-------------
+
+The 'set psdir <directory>' command controls the search path used by the
+postscript terminal to find prologue.ps and character encoding files.
+You can use this mechanism to switch between different sets of
+locally-customized prolog files.  The search order is
+           1) The directory specified by *note psdir::, if any
+           2) The directory specified by environmental variable GNUPLOT_PS_DIR
+           3) A built-in header or one from the default system directory
+           4) Directories set by *note loadpath::
+
+
+
+File: gnuplot.info,  Node: raxis,  Next: rgbmax,  Prev: psdir,  Up: set-show
+
+3.33.77 raxis
+-------------
+
+The commands *note raxis:: and *note raxis:: toggle whether the polar
+axis is drawn separately from grid lines and the x axis.  If the minimum
+of the current rrange is non-zero (and not autoscaled), then a white
+circle is drawn at the center of the polar plot to indicate that the
+plot lines and axes do not reach 0.  The axis line is drawn using the
+same line type as the plot border.  See 'polar', *note rrange::, *note
+rtics::, *note rlabel::, 'set grid'.
+
+
+File: gnuplot.info,  Node: rgbmax,  Next: rlabel,  Prev: raxis,  Up: set-show
+
+3.33.78 rgbmax
+--------------
+
+Syntax:
+          set rgbmax {1.0 | 255}
+          unset rgbmax
+
+   The red/green/blue color components of an rgbimage plot are by
+default interpreted as integers in the range [0:255].  'set rgbmax 1.0'
+tells the program that data values used to generate the color components
+of a plot with *note rgbimage:: or *note rgbalpha:: are floating point
+values in the range [0:1].  *note rgbmax:: returns to the default
+integer range [0:255].
+
+
+File: gnuplot.info,  Node: rlabel,  Next: rmargin,  Prev: rgbmax,  Up: set-show
+
+3.33.79 rlabel
+--------------
+
+This command places a label above the r axis.  The label will be drawn
+whether or not the plot is in polar mode.  See *note xlabel:: for
+additional keywords.
+
+
+File: gnuplot.info,  Node: rmargin,  Next: rrange,  Prev: rlabel,  Up: set-show
+
+3.33.80 rmargin
+---------------
+
+The command *note rmargin:: sets the size of the right margin.  Please
+see *note margin:: for details.
+
+
+File: gnuplot.info,  Node: rrange,  Next: rtics,  Prev: rmargin,  Up: set-show
+
+3.33.81 rrange
+--------------
+
+The *note rrange:: command sets the range of the radial coordinate for a
+graph in polar mode.  This has the effect of setting both xrange and
+yrange as well.  The resulting xrange and yrange are both [-(rmax-rmin)
+: +(rmax-rmin)].  However if you later change the x or y range, for
+example by zooming, this does not change rrange, so data points continue
+to be clipped against rrange.  Unlike other axes, autoscaling the raxis
+always results in rmin = 0.  The 'reverse' autoscaling flag is ignored.
+Note: Setting a negative value for rmin may produce unexpected results.
+
+
+File: gnuplot.info,  Node: rtics,  Next: samples,  Prev: rrange,  Up: set-show
+
+3.33.82 rtics
+-------------
+
+The *note rtics:: command places tics along the polar axis.  The tics
+and labels are drawn to the right of the origin.  The 'mirror' keyword
+causes them to be drawn also to the left of the origin.  See 'polar',
+'set xtics', and 'set mxtics' for discussion of keywords.
+
+
+File: gnuplot.info,  Node: samples,  Next: size,  Prev: rtics,  Up: set-show
+
+3.33.83 samples
+---------------
+
+Function plots are constructed by sampling the function at a given
+number of x values and drawing line segments to connect the values
+f(x0)..f(x1)..f(x2)...  The default sampling rate for functions, or for
+interpolating data, may be changed by the *note samples:: command.  To
+change the sampling range for a particular component of a 'plot' or
+'splot' command, see *note sampling::.
+
+   Syntax:
+           set samples <samples_1> {,<samples_2>}
+           show samples
+
+
+   By default, sampling is set to 100 points.  A higher sampling rate
+will produce more accurate plots, but will take longer.  This parameter
+has no effect on data file plotting unless one of the
+interpolation/approximation options is used.  See *note smooth::, *note
+cntrparam:: and *note dgrid3d::.
+
+   When a 2D graph is being done, only the value of <samples_1> is
+relevant.
+
+   When a surface plot is being done without the removal of hidden
+lines, the value of samples specifies the number of samples that are to
+be evaluated for the isolines.  Each iso-v line will have <sample_1>
+samples and each iso-u line will have <sample_2> samples.  If you only
+specify <samples_1>, <samples_2> will be set equal to <samples_1>.  See
+also *note isosamples::.
+
+
+File: gnuplot.info,  Node: size,  Next: spiderplot_,  Prev: samples,  Up: set-show
+
+3.33.84 size
+------------
+
+Syntax:
+           set size {{no}square | ratio <r> | noratio} {<xscale>,<yscale>}
+           show size
+
+
+   The <xscale> and <yscale> values are scale factors for the size of
+the plot, which includes the graph, labels, and margins.
+
+   Historical note: In early versions of gnuplot some terminal types
+used *note size:: to control also the size of the output canvas.  Now
+there are two distinct properties: ''set size'' and ''set term ...
+size''.
+
+   'set term <terminal_type> size <x units>, <y units>' controls the
+size of the output file, or 'canvas'.  Please see individual terminal
+documentation for the units of the size parameters.  By default, the
+plot will fill this canvas.
+
+   'set size <xscale>, <yscale>' scales the plot itself relative to the
+size of the canvas.  Scale values less than 1.0 cause the plot to fill
+only part of the canvas.  This can be used together with *note
+multiplot:: to inset a small plot inside a larger plot or to place
+several small plots side-by-side.  Scale values greater than 1.0 are not
+supported and may cause errors.
+
+   'ratio' causes 'gnuplot' to try to create a graph with an aspect
+ratio of <r> (the ratio of the y-axis length to the x-axis length)
+within the portion of the plot specified by <xscale> and <yscale>.
+
+   The meaning of a negative value for <r> is different.  If <r>=-1,
+gnuplot tries to set the scales so that the unit length along on both
+the x and y axes is the same; i.e.  they are isotropic.  See also *note
+isotropic::.  This is the 2D equivalent to the 3D command 'set view
+equal xy'.  If <r>=-2, the unit on y has twice the length of the unit on
+x, and so on.  See also *note isotropic::.
+
+   The success of 'gnuplot' in producing the requested aspect ratio
+depends on the terminal selected.  The graph area will be the largest
+rectangle of aspect ratio <r> that will fit into the specified portion
+of the output (leaving adequate margins, of course).
+
+   'set size square' is a synonym for 'set size ratio 1'.
+
+   Both 'noratio' and 'nosquare' return the graph to the default aspect
+ratio of the terminal, but do not return <xscale> or <yscale> to their
+default values (1.0).
+
+   'ratio' and 'square' have no effect on 3D plots, but do affect 3D
+projections created using 'set view map'.  See also 'set view equal',
+which forces the x and y axes of a 3D onto the same scale.
+
+   Examples:
+
+   To set the size so that the plot fills the available canvas:
+           set size 1,1
+
+
+   To make the graph half size and square use:
+           set size square 0.5,0.5
+
+
+   To make the graph twice as high as wide use:
+           set size ratio 2
+
+
+
+File: gnuplot.info,  Node: spiderplot_,  Next: style,  Prev: size,  Up: set-show
+
+3.33.85 spiderplot
+------------------
+
+The *note spiderplot:: command switches interpretation of coordinates to
+a polar system in which each data point is mapped to a position along a
+radial axis.  paxis 1 is always vertical; axes 2 to N proceed clockwise
+with even spacing.  The command must be issued prior to plotting.  It
+has additional effects equivalent to
+          set style data spiderplot
+          unset border
+          unset tics
+          set key noautotitle
+          set size ratio 1.0
+
+   Use *note reset:: to restore these after plotting.
+
+
+File: gnuplot.info,  Node: style,  Next: surface_,  Prev: spiderplot_,  Up: set-show
+
+3.33.86 style
+-------------
+
+Default plotting styles are chosen with the 'set style data' and 'set
+style function' commands.  See 'plot with' for information about how to
+override the default plotting style for individual functions and data
+sets.  See 'plotting styles' or 'plot with' for a complete list of
+styles.
+
+   Syntax:
+           set style function <style>
+           set style data <style>
+           show style function
+           show style data
+
+
+   Default styles for specific plotting elements may also be set.
+
+   Syntax:
+           set style arrow <n> <arrowstyle>
+           set style boxplot <boxplot style options>
+           set style circle radius <size> {clip|noclip}
+           set style ellipse size <size> units {xy|xx|yy} {clip|noclip}
+           set style fill <fillstyle>
+           set style histogram <histogram style options>
+           set style line <n> <linestyle>
+           set style rectangle <object options> <linestyle> <fillstyle>
+           set style textbox {<n>} {opaque|transparent} {{no}border} {fillcolor}
+           set style watchpoint labels <label options>
+
+
+* Menu:
+
+* set_style_arrow::
+* boxplot_::
+* set_style_data::
+* set_style_fill::
+* set_style_function::
+* set_style_histogram::
+* set_style_increment::
+* set_style_line::
+* set_style_circle::
+* set_style_rectangle::
+* set_style_ellipse::
+* set_style_parallelaxis::
+* set_style_spiderplot::
+* set_style_textbox::
+* set_style_watchpoint::
+
+
+File: gnuplot.info,  Node: set_style_arrow,  Next: boxplot_,  Prev: style,  Up: style
+
+3.33.86.1 set style arrow
+.........................
+
+You can use 'set style arrow' to define a set of arrow types.  Each type
+has its own width, point type, color, etc so that you can refer to them
+later by an index instead of repeating all the information at each
+invocation.
+
+   Syntax:
+           set style arrow <index> default
+           set style arrow <index> {nohead | head | backhead | heads}
+                                   {size <length>,<angle>{,<backangle>} {fixed}}
+                                   {filled | empty | nofilled | noborder}
+                                   {front | back}
+                                   { {linestyle | ls <line_style>}
+                                     | {linetype | lt <line_type>}
+                                       {linewidth | lw <line_width}
+                                       {linecolor | lc <colorspec>}
+                                       {dashtype | dt <dashtype>} }
+           unset style arrow
+           show style arrow
+
+
+   <index> is an integer that identifies the arrowstyle.
+
+   If 'default' is given all arrow style parameters are set to their
+default values.
+
+   If the linestyle <index> already exists, only the given parameters
+are changed while all others are preserved.  If not, all undefined
+values are set to the default values.
+
+   An arrow style invoked from a 'plot' or 'splot' command can include a
+data-dependent linecolor ('lc variable' or 'lc rgb variable') that
+consumes an additional column of data in the corresponding 'using'
+specification.  In this case the style is probably not useful for
+individual arrows created by 'set arrow'.
+
+   Specifying 'nohead' produces arrows drawn without a head--a line
+segment.  This gives you yet another way to draw a line segment on the
+plot.  By default, arrows have one head.  Specifying 'heads' draws arrow
+heads on both ends of the line.
+
+   Head size can be modified using 'size <length>,<angle>' or 'size
+<length>,<angle>,<backangle>', where '<length>' defines length of each
+branch of the arrow head and '<angle>' the angle (in degrees) they make
+with the arrow.  '<Length>' is in x-axis units; this can be changed by
+'first', 'second', 'graph', 'screen', or 'character' before the
+<length>; see 'coordinates' for details.
+
+   By default the size of the arrow head is reduced for very short
+arrows.  This can be disabled using the 'fixed' keyword after the *note
+size:: command.
+
+   '<backangle>' is the angle (in degrees) the back branches make with
+the arrow (in the same direction as '<angle>').  It is ignored if the
+style is 'nofilled'.
+
+   Specifying 'filled' produces filled arrow heads with a border line
+around the arrow head.  Specifying 'noborder' produces filled arrow
+heads with no border.  In this case the tip of the arrow head lies
+exactly on the endpoint of the vector and the arrow head is slightly
+smaller overall.  Dashed arrows should always use 'noborder', since a
+dashed border is ugly.  Not all terminals support filled arrow heads.
+
+   The line style may be selected from a user-defined list of line
+styles (see 'set style line') or may be defined here by providing values
+for '<line_type>' (an index from the default list of styles) and/or
+'<line_width>' (which is a multiplier for the default width).
+
+   Note, however, that if a user-defined line style has been selected,
+its properties (type and width) cannot be altered merely by issuing
+another 'set style arrow' command with the appropriate index and 'lt' or
+'lw'.
+
+   If 'front' is given, the arrows are written on top of the graphed
+data.  If 'back' is given (the default), the arrow is written underneath
+the graphed data.  Using 'front' will prevent a arrow from being
+obscured by dense data.
+
+   Examples:
+
+   To draw an arrow without an arrow head and double width, use:
+           set style arrow 1 nohead lw 2
+           set arrow arrowstyle 1
+
+
+   See also 'set arrow' for further examples.
+
+
+File: gnuplot.info,  Node: boxplot_,  Next: set_style_data,  Prev: set_style_arrow,  Up: style
+
+3.33.86.2 boxplot
+.................
+
+The *note boxplot:: command allows you to change the layout of plots
+created using the *note boxplot:: plot style.
+
+   Syntax:
+           set style boxplot {range <r> | fraction <f>}
+                             {{no}outliers} {pointtype <p>}
+                             {candlesticks | financebars}
+                             {medianlinewidth <width>}
+                             {separation <x>}
+                             {labels off | auto | x | x2}
+                             {sorted | unsorted}
+
+
+   The box in the boxplot always spans the range of values from the
+first quartile to the third quartile of the data points.  The limit of
+the whiskers that extend from the box can be controlled in two different
+ways.  By default the whiskers extend from each end of the box for a
+range equal to 1.5 times the interquartile range (i.e.  the vertical
+height of the box proper).  Each whisker is truncated back toward the
+median so that it terminates at a y value belonging to some point in the
+data set.  Since there may be no point whose value is exactly 1.5 times
+the interquartile distance, the whisker may be shorter than its nominal
+range.  This default corresponds to
+           set style boxplot range 1.5
+
+
+   Alternatively, you can specify the fraction of the total number of
+points that the whiskers should span.  In this case the range is
+extended symmetrically from the median value until it encompasses the
+requested fraction of the data set.  Here again each whisker is
+constrained to end at a point in the data set.  To span 95% of the
+points in the set
+           set style boxplot fraction 0.95
+
+
+   Any points that lie outside the range of the whiskers are considered
+outliers.  By default these are drawn as individual circles (pointtype
+7).  The option 'nooutliers' disables this.  If outliers are not drawn
+they do not contribute to autoscaling.
+
+   By default boxplots are drawn in a style similar to candlesticks, but
+you have the option of using instead a style similar to finance bars.
+
+   A crossbar indicating the median is drawn using the same line type as
+box boundary.  If you want a thicker line for the median
+           set style boxplot medianlinewidth 2.0
+
+   If you want no median line, set this to 0.
+
+   If the using specification for a boxplot contains a fourth column,
+the values in that column will be interpreted as a discrete category to
+which this data point belongs.  In this case one boxplot is drawn for
+each category found in the input.  These boxplots will be drawn next to
+each other spaced by 1.0 along x (in x-axis units).  This spacing can be
+changed by the option 'set style boxplot separation'.
+
+   The *note labels:: option governs how and where these boxplots (each
+representing a part of the dataset) are labeled.  By default the
+category identifier is used as a tick label on the horizontal axis - x
+or x2, depending on which one is used for the plot itself.  This setting
+corresponds to option 'labels auto'.  The labels can be forced to use
+either of the x or x2 axes - options 'labels x' and 'labels x2',
+respectively -, or they can be turned off altogether with the option
+'labels off'.
+
+   By default the boxplots corresponding to different categories will be
+drawn in the same order the levels are encountered in the data file.
+This behavior corresponds to the 'unsorted' option.  If the 'sorted'
+option is active, the category identifiers are first sorted
+alphabetically, and the boxplots are drawn in the sorted order.
+
+   The 'separation', *note labels::, 'sorted' and 'unsorted' option only
+have an effect if a fourth column is given the plot specification.
+
+   See *note boxplot::, *note candlesticks::, *note financebars::.
+
+
+File: gnuplot.info,  Node: set_style_data,  Next: set_style_fill,  Prev: boxplot_,  Up: style
+
+3.33.86.3 set style data
+........................
+
+The 'set style data' command changes the default plotting style for data
+plots.
+
+   Syntax:
+           set style data <plotting-style>
+           show style data
+
+
+   See 'plotting styles' for the choices.  'show style data' shows the
+current default data plotting style.
+
+
+File: gnuplot.info,  Node: set_style_fill,  Next: set_style_function,  Prev: set_style_data,  Up: style
+
+3.33.86.4 set style fill
+........................
+
+The 'set style fill' command is used to set the default style of the
+plot elements in plots with boxes, histograms, candlesticks and
+filledcurves.  This default can be superseded by fillstyles attached to
+individual plots.  Note that there is a separate default fill style for
+rectangles created by 'set obj'.  See *note rectangle::.
+
+   Syntax:
+           set style fill {empty
+                           | {transparent} solid {<density>}
+                           | {transparent} pattern {<n>}}
+                          {border {lt} {lc <colorspec>} | noborder}
+
+
+   The default fillstyle is 'empty'.
+
+   The 'solid' option causes filling with a solid color, if the terminal
+supports that.  The <density> parameter specifies the intensity of the
+fill color.  At a <density> of 0.0, the box is empty, at <density> of
+1.0, the inner area is of the same color as the current linetype.  Some
+terminal types can vary the density continuously; others implement only
+a few levels of partial fill.  If no <density> parameter is given, it
+defaults to 1.
+
+   The 'pattern' option causes filling to be done with a fill pattern
+supplied by the terminal driver.  The kind and number of available fill
+patterns depend on the terminal driver.  If multiple datasets using
+filled boxes are plotted, the pattern cycles through all available
+pattern types, starting from pattern <n>, much as the line type cycles
+for multiple line plots.
+
+   The 'empty' option causes filled boxes not to be filled.  This is the
+default.
+
+   Fill color ('fillcolor <colorspec>') is distinct from fill style.
+I.e.  plot elements or objects can share a fillstyle while retaining
+separate colors.  In most places where a fillstyle is accepted you can
+also specify a fill color.  Fillcolor may be abbreviated 'fc'.
+Otherwise the fill color is take from the current linetype.  Example:
+
+           plot FOO with boxes fillstyle solid 1.0 fillcolor "cyan"
+
+
+-- SET STYLE FILL BORDER --
+
+   The bare keyword *note border:: causes the filled object to be
+surrounded by a solid line of the current linetype and color.  You can
+change the color of this line by adding either a linetype or a
+linecolor.  'noborder' specifies that no bounding line is drawn.
+Examples:
+          # Half-intensity fill, full intensity border in same color
+          set style fill solid 0.5 border
+          # Half-transparent fill, solid black border (linetype -1)
+          set style fill transparent solid 0.5 border -1
+          # Pattern fill in current color, border using color of linetype 5
+          plot ... with boxes fillstyle pattern 2 border lt 5
+          # Fill area in cyan, border in blue
+          plot ... with boxes fillcolor "cyan" fs solid border linecolor "blue"
+
+
+   Note: The border property of a fill style only affects plots drawn
+*note filledcurves:: in the default mode (closed curve).
+
+-- SET STYLE FILL TRANSPARENT --
+
+   Some terminals support the attribute 'transparent' for filled areas.
+In the case of transparent solid fill areas, the 'density' parameter is
+interpreted as an alpha value; that is, density 0 is fully transparent,
+density 1 is fully opaque.  In the case of transparent pattern fill, the
+background of the pattern is either fully transparent or fully opaque.
+
+   Note that there may be additional limitations on the creation or
+viewing of graphs containing transparent fill areas.  For example, the
+png terminal can only use transparent fill if the "truecolor" option is
+set.  Some pdf viewers may not correctly display the fill areas even if
+they are correctly described in the pdf file.  Ghostscript/gv does not
+correctly display pattern-fill areas even though actual PostScript
+printers generally have no problem.
+
+
+File: gnuplot.info,  Node: set_style_function,  Next: set_style_histogram,  Prev: set_style_fill,  Up: style
+
+3.33.86.5 set style function
+............................
+
+The 'set style function' command changes the default plotting style for
+function plots (e.g.  lines, points, filledcurves).  See 'plotting
+styles'.
+
+   Syntax:
+           set style function <plotting-style>
+           show style function
+
+
+
+File: gnuplot.info,  Node: set_style_histogram,  Next: set_style_increment,  Prev: set_style_function,  Up: style
+
+3.33.86.6 set style histogram
+.............................
+
+See *note histograms::.
+
+
+File: gnuplot.info,  Node: set_style_increment,  Next: set_style_line,  Prev: set_style_histogram,  Up: style
+
+3.33.86.7 set style increment
+.............................
+
+By default, successive plots within the same graph will use successive
+linetypes.  'set style increment userstyles' changed this to step
+through successive user-defined line styles instead.
+
+   DEPRECATED. This command is present in gnuplot version 6.0 only if
+your copy was built with configuration option
+-enable-backward-compatibility.  Instead use 'set linetype' to redefine
+a convenient range of linetypes for the program to use.  See 'set
+linetype'.
+
+
+File: gnuplot.info,  Node: set_style_line,  Next: set_style_circle,  Prev: set_style_increment,  Up: style
+
+3.33.86.8 set style line
+........................
+
+Each terminal has a default set of line and point types, which can be
+seen by using the command 'test'.  'set style line' defines a set of
+line types and widths and point types and sizes so that you can refer to
+them later by an index instead of repeating all the information at each
+invocation.
+
+   Syntax:
+           set style line <index> default
+           set style line <index> {{linetype  | lt} <line_type> | <colorspec>}
+                                  {{linecolor | lc} <colorspec>}
+                                  {{linewidth | lw} <line_width>}
+                                  {{pointtype | pt} <point_type>}
+                                  {{pointsize | ps} <point_size>}
+                                  {{pointinterval | pi} <interval>}
+                                  {{pointnumber | pn} <max_symbols>}
+                                  {{dashtype | dt} <dashtype>}
+                                  {palette}
+           unset style line
+           show style line
+
+
+   'default' sets all line style parameters to those of the linetype
+with that same index.
+
+   If the linestyle <index> already exists, only the given parameters
+are changed while all others are preserved.  If not, all undefined
+values are set to the default values.
+
+   Line styles created by this mechanism do not replace the default
+linetype styles; both may be used.  Line styles are temporary.  They are
+lost whenever you execute a *note reset:: command.  To redefine the
+linetype itself, please see 'set linetype'.
+
+   The line and point types default to the index value.  The exact
+symbol that is drawn for that index value may vary from one terminal
+type to another.
+
+   The line width and point size are multipliers for the current
+terminal's default width and size (but note that <point_size> here is
+unaffected by the multiplier given by the command*note pointsize::).
+
+   The 'pointinterval' controls the spacing between points in a plot
+drawn with style *note linespoints::.  The default is 0 (every point is
+drawn).  For example, 'set style line N pi 3' defines a linestyle that
+uses pointtype N, pointsize and linewidth equal to the current defaults
+for the terminal, and will draw every 3rd point in plots using *note
+linespoints::.  A negative value for the interval is treated the same as
+a positive value, except that some terminals will try to interrupt the
+line where it passes through the point symbol.
+
+   The 'pointnumber' property is similar to 'pointinterval' except that
+rather than plotting every Nth point it limits the total number of
+points to N.
+
+   Not all terminals support the 'linewidth' and *note pointsize::
+features; if not supported, the option will be ignored.
+
+   Terminal-independent colors may be assigned using either 'linecolor
+<colorspec>' or 'linetype <colorspec>', abbreviated 'lc' or 'lt'.  This
+requires giving a RGB color triple, a known palette color name, a
+fractional index into the current palette, or a constant value from the
+current mapping of the palette onto cbrange.  See 'colors', *note
+colorspec::, *note palette::, *note colornames::, *note cbrange::.
+
+   'set style line <n> linetype <lt>' will set both a terminal-dependent
+dot/dash pattern and color.  The commands'set style line <n> linecolor
+<colorspec>' or 'set style line <n> linetype <colorspec>' will set a new
+line color while leaving the existing dot-dash pattern unchanged.
+
+   In 3d mode ('splot' command), the special keyword *note palette:: is
+allowed as a shorthand for "linetype palette z".  The color value
+corresponds to the z-value (elevation) of the splot, and varies smoothly
+along a line or surface.
+
+   Examples: Suppose that the default lines for indices 1, 2, and 3 are
+red, green, and blue, respectively, and the default point shapes for the
+same indices are a square, a cross, and a triangle, respectively.  Then
+
+           set style line 1 lt 2 lw 2 pt 3 ps 0.5
+
+
+   defines a new linestyle that is green and twice the default width and
+a new pointstyle that is a half-sized triangle.  The commands
+
+           set style function lines
+           plot f(x) lt 3, g(x) ls 1
+
+
+   will create a plot of f(x) using the default blue line and a plot of
+g(x) using the user-defined wide green line.  Similarly the commands
+
+           set style function linespoints
+           plot p(x) lt 1 pt 3, q(x) ls 1
+
+
+   will create a plot of p(x) using the default triangles connected by a
+red line and q(x) using small triangles connected by a green line.
+
+           splot sin(sqrt(x*x+y*y))/sqrt(x*x+y*y) w l pal
+
+
+   creates a surface plot using smooth colors according to *note
+palette::.  Note, that this works only on some terminals.  See also
+*note palette::, 'set pm3d'.
+
+           set style line 10 linetype 1 linecolor rgb "cyan"
+
+
+   will assign linestyle 10 to be a solid cyan line on any terminal that
+supports rgb colors.
+
+
+File: gnuplot.info,  Node: set_style_circle,  Next: set_style_rectangle,  Prev: set_style_line,  Up: style
+
+3.33.86.9 set style circle
+..........................
+
+Syntax:
+           set style circle {radius {graph|screen} <R>}
+                            {{no}wedge}
+                            {clip|noclip}
+
+
+   This command sets the default radius used in plot style "with
+circles".  It applies to data plots with only 2 columns of data (x,y)
+and to function plots.  The default is "set style circle radius graph
+0.02".  'Nowedge' disables drawing of the two radii that connect the
+ends of an arc to the center.  The default is 'wedge'.  This parameter
+has no effect on full circles.  'Clip' clips the circle at the plot
+boundaries, 'noclip' disables this.  Default is 'clip'.
+
+
+File: gnuplot.info,  Node: set_style_rectangle,  Next: set_style_ellipse,  Prev: set_style_circle,  Up: style
+
+3.33.86.10 set style rectangle
+..............................
+
+Rectangles defined with the *note object:: command can have individual
+styles.  However, if the object is not assigned a private style then it
+inherits a default that is taken from the *note rectangle:: command.
+
+   Syntax:
+         set style rectangle {front|back} {lw|linewidth <lw>}
+                             {fillcolor <colorspec>} {fs <fillstyle>}
+
+
+   See *note colorspec:: and 'fillstyle'.  *note fillcolor:: may be
+abbreviated as 'fc'.
+
+   Examples:
+         set style rectangle back fc rgb "white" fs solid 1.0 border lt -1
+         set style rectangle fc linestyle 3 fs pattern 2 noborder
+
+
+   The default values correspond to solid fill with the background color
+and a black border.
+
+
+File: gnuplot.info,  Node: set_style_ellipse,  Next: set_style_parallelaxis,  Prev: set_style_rectangle,  Up: style
+
+3.33.86.11 set style ellipse
+............................
+
+Syntax:
+           set style ellipse {units xx|xy|yy}
+                             {size {graph|screen} <a>, {{graph|screen} <b>}}
+                             {angle <angle>}
+                             {clip|noclip}
+
+
+   This command governs whether the diameters of ellipses are
+interpreted in the same units or not.  Default is 'xy', which means that
+the major diameter (first axis) of ellipses will be interpreted in the
+same units as the x (or x2) axis, while the minor (second) diameter in
+those of the y (or y2) axis.  In this mode the ratio of the ellipse axes
+depends on the scales of the plot axes and aspect ratio of the plot.
+When set to 'xx' or 'yy', both axes of all ellipses will be interpreted
+in the same units.  This means that the ratio of the axes of the plotted
+ellipses will be correct even after rotation, but either their vertical
+or horizontal extent will not be correct.
+
+   This is a global setting that affects all ellipses, both those
+defined as objects and those generated with the 'plot' command, however,
+the value of 'units' can also be redefined on a per-plot and per-object
+basis.
+
+   It is also possible to set a default size for ellipses with the *note
+size:: keyword.  This default size applies to data plots with only 2
+columns of data (x,y) and to function plots.  The two values are
+interpreted as the major and minor diameters (as opposed to semi-major
+and semi-minor axes) of the ellipse.
+
+   The default is "set style ellipse size graph 0.05,0.03".
+
+   Last, but not least it is possible to set the default orientation
+with the 'angle' keyword.  The orientation, which is defined as the
+angle between the major axis of the ellipse and the plot's x axis, must
+be given in degrees.
+
+   'Clip' clips the ellipse at the plot boundaries, 'noclip' disables
+this.  Default is 'clip'.
+
+   For defining ellipse objects, see 'set object ellipse'; for the 2D
+plot style, see *note ellipses::.
+
+
+File: gnuplot.info,  Node: set_style_parallelaxis,  Next: set_style_spiderplot,  Prev: set_style_ellipse,  Up: style
+
+3.33.86.12 set style parallelaxis
+.................................
+
+Syntax:
+           set style parallelaxis {front|back} {line-properties}
+
+
+   Determines the line type and layer for drawing the vertical axes in
+plots *note parallelaxes::.  See *note parallelaxes::, *note paxis::.
+
+
+File: gnuplot.info,  Node: set_style_spiderplot,  Next: set_style_textbox,  Prev: set_style_parallelaxis,  Up: style
+
+3.33.86.13 set style spiderplot
+...............................
+
+Syntax:
+             set style spiderplot
+                       {fillstyle <fillstyle-properties>}
+                       {<line-properties> | <point-properties>}
+
+   This commands controls the default appearance of spider plots.  The
+fill, line, and point properties can be modified in the first component
+of the plot command.  The overall appearance of the plot is also
+affected by other settings such as *note spiderplot::.  See also *note
+paxis::, *note spiderplot::.  Example:
+          # Default spider plot will be a polygon with a thick border but no fill
+          set style spiderplot fillstyle empty border lw 3
+          # This one will additionally place an open circle (pt 6) at each axis
+          plot for [i=1:6] DATA pointtype 6 pointsize 3
+
+
+
+File: gnuplot.info,  Node: set_style_textbox,  Next: set_style_watchpoint,  Prev: set_style_spiderplot,  Up: style
+
+3.33.86.14 set style textbox
+............................
+
+Syntax:
+             set style textbox {<boxstyle-index>}
+                       {opaque|transparent} {fillcolor <color>}
+                       {{no}border {linecolor <colorspec>}}{linewidth <lw>}
+                       {margins <xmargin>,<ymargin>}
+
+
+   This command controls the appearance of labels with the attribute
+'boxed'.  Terminal types that do not support boxed text will ignore this
+style.  Note: Implementation for some terminals (svg, latex) is
+incomplete.  Most terminals cannot place a box correctly around rotated
+text.
+
+   Three numbered textbox styles can be defined.  If no boxstyle index
+<bs> is given, the default (unnumbered) style is changed.  Example:
+
+          # default style has only a black border
+          set style textbox transparent border lc "black"
+          # style 2 (bs 2) has a light blue background with no border
+          set style textbox 2 opaque fc "light-cyan" noborder
+          set label 1 "I'm in a box" boxed
+          set label 2 "I'm blue" boxed bs 2
+
+
+
+File: gnuplot.info,  Node: set_style_watchpoint,  Prev: set_style_textbox,  Up: style
+
+3.33.86.15 set style watchpoint
+...............................
+
+Syntax:
+          set style watchpoint nolabels
+          set style watchpoint labels {label-options}
+
+
+   The watchpoint target "mouse" always prints a label to the plot.
+Other watchpoint targets either print or do not print a label depending
+on whether the style is set to 'label' or 'nolabel'.
+
+   The appearance of watchpoint labels can be customized using the full
+range of label properties available to other gnuplot labels, including
+font, textcolor, point type and size of a point marking the exact x,y
+coordinates.  See 'set label'.
+
+   Currently the text of the label is always autogenerated by the
+program using the axis tic formats for the current plot to produce the
+string " x-coordinate : y-coordinate".
+
+   Examples:
+          set style watchpoint labels point pt 4 ps 2
+          set style watchpoint labels font ":Italic,6" textcolor "blue"
+          set style watchpoint labels boxed offset 1, 0.5
+
+
+
+File: gnuplot.info,  Node: surface_,  Next: table,  Prev: style,  Up: set-show
+
+3.33.87 surface
+---------------
+
+The 'set surface' command is only relevant for 3D plots ('splot').
+
+   Syntax:
+           set surface {implicit|explicit}
+           unset surface
+           show surface
+
+
+   'unset surface' will cause 'splot' to not draw points or lines
+corresponding to any of the function or data file points.  This is
+mainly useful for drawing only contour lines rather than the surface
+they were derived from.  Contours may still be drawn on the surface,
+depending on the 'set contour' option.  To turn off the surface for an
+individual function or data file while leaving others active, use the
+'nosurface' keyword in the 'splot' command.  The combination 'unset
+surface; set contour base' is useful for displaying contours on the grid
+base.  See also 'set contour'.
+
+   If a 3D data set is recognizable as a mesh (grid) then by default the
+program implicitly treats the plot style 'with lines' as requesting a
+gridded surface.  See 'grid_data'.  The command 'set surface explicit'
+suppresses this expansion, plotting only the individual lines described
+by separate blocks of data in the input file.  A gridded surface can
+still be plotted by explicitly requesting splot 'with surface'.
+
+
+File: gnuplot.info,  Node: table,  Next: terminal,  Prev: surface_,  Up: set-show
+
+3.33.88 table
+-------------
+
+When *note table:: mode is enabled, 'plot' and 'splot' commands print
+out a multicolumn text table of values
+          X Y {Z} <flag>
+
+   rather than creating an actual plot on the current terminal.  The
+flag character is "i" if the point is in the active range, "o" if it is
+out-of-range, or "u" if it is undefined.  The data format is determined
+by the format of the axis tickmarks (see 'set format'), and the columns
+are separated by single spaces.  This can be useful if you want to
+generate contours and then save them for further use.  The same method
+can be used to save interpolated data (see *note samples:: and *note
+dgrid3d::).
+
+   Syntax:
+           set table {"outfile" | $datablock} {append}
+                     {separator {whitespace|tab|comma|"<char>"}}
+           plot <whatever>
+           unset table
+
+
+   Subsequent tabular output is written to "outfile", if specified,
+otherwise it is written to stdout or other current value of *note
+output::.  If 'outfile' exists it will be replaced unless the 'append'
+keyword is given.  Alternatively, tabular output can be redirected to a
+named data block.  Data block names start with '$', see also 'inline
+data'.  You must explicitly *note table:: in order to go back to normal
+plotting on the current terminal.
+
+   The 'separator' character can be used to output csv (comma separated
+value) files.  This mode only affects plot style *note table::.  See
+*note table::.
+
+* Menu:
+
+* plot_with_table::
+
+
+File: gnuplot.info,  Node: plot_with_table,  Prev: table,  Up: table
+
+3.33.88.1 plot with table
+.........................
+
+This discussion applies only to the special plot style *note table::.
+
+   To avoid any style-dependent processing of the input data being
+tabulated (filters, smoothing, errorbar expansion, secondary range
+checking, etc), or to increase the number of columns that can be
+tabulated, use the keyword "table" instead of a normal plot style.  In
+this case the output does not contain an extra column containing a flag
+'i', 'o', 'u' indicating inrange/outrange/undefined.  The destination
+for output must first be specified with 'set table <where>'.  For
+example
+
+          set table $DATABLOCK1
+          plot <file> using 1:2:3:4:($5+$6):(func($7)):8:9:10 with table
+
+
+   Because there is no actual plot style in this case the columns do not
+correspond to specific axes.  Therefore xrange, yrange, etc are ignored.
+
+   If a 'using' term evaluates to a string, the string is tabulated.
+Numerical data is always written with format %g.  If you want some other
+format use sprintf or gprintf to create a formatted string.
+
+          plot <file> using ("File 1"):1:2:3 with table
+          plot <file> using (sprintf("%4.2f",$1)) : (sprintf("%4.2f",$3)) with table
+
+
+   To create a csv file use
+          set table "tab.csv" separator comma
+          plot <foo> using 1:2:3:4 with table
+
+
+   [EXPERIMENTAL] To select only a subset of the data points for
+tabulation you can provide an input filter condition ('if <expression>')
+at the end of the command.  Note that the input filter may reference
+data columns that are not part of the output.  Details of this feature
+may change in a future version.
+
+          plot <file> using 1:2:($4+$5) with table if (strcol(3) eq "Red")
+          plot <file> using 1:2:($4+$5) with table if (10. < $1 && $1 < 100.)
+          plot <file> using 1:2:($4+$5) with table if (filter($6,$7) != 0)
+
+
+
+File: gnuplot.info,  Node: terminal,  Next: termoption,  Prev: table,  Up: set-show
+
+3.33.89 terminal
+----------------
+
+'gnuplot' supports many different graphics devices.  Use *note
+terminal:: to tell 'gnuplot' what kind of output to generate.  Use *note
+output:: to redirect that output to a file or device.
+
+   Syntax:
+           set terminal {<terminal-type> | push | pop}
+           show terminal
+
+
+   If <terminal-type> is omitted, 'gnuplot' will list the available
+terminal types.  <terminal-type> may be abbreviated.
+
+   If both *note terminal:: and *note output:: are used together, it is
+safest to give *note terminal:: first, because some terminals set a flag
+which is needed in some operating systems.
+
+   Some terminals have many additional options.  The options used by a
+previous invocation 'set term <term> <options>' of a given '<term>' are
+remembered, thus subsequent 'set term <term>' does not reset them.  This
+helps in printing, for instance, when switching among different
+terminals--previous options don't have to be repeated.
+
+   The command 'set term push' remembers the current terminal including
+its settings while 'set term pop' restores it.  This is equivalent to
+'save term' and 'load term', but without accessing the filesystem.
+Therefore they can be used to achieve platform independent restoring of
+the terminal after printing, for instance.  After gnuplot's startup, the
+default terminal or that from 'startup' file is pushed automatically.
+Therefore portable scripts can rely that 'set term pop' restores the
+default terminal on a given platform unless another terminal has been
+pushed explicitly.
+
+   For more information, see the 'complete list of terminals'.
+
+
+File: gnuplot.info,  Node: termoption,  Next: theta,  Prev: terminal,  Up: set-show
+
+3.33.90 termoption
+------------------
+
+The *note termoption:: command allows you to change the behaviour of the
+current terminal without requiring a new *note terminal:: command.  Only
+one option can be changed per command, and only a small number of
+options can be changed this way.  Currently the only options accepted
+are
+
+          set termoption {no}enhanced
+          set termoption font "<fontname>{,<fontsize>}"
+          set termoption fontscale <scale>
+          set termoption {linewidth <lw>}{lw <lw>} {dashlength <dl>}{dl <dl>}
+          set termoption {pointscale <scale>} {ps <scale>}
+
+
+
+File: gnuplot.info,  Node: theta,  Next: tics,  Prev: termoption,  Up: set-show
+
+3.33.91 theta
+-------------
+
+Polar coordinate plots are by default oriented such that theta = 0 is on
+the right side of the plot, with theta increasing as you proceed
+counterclockwise so that theta = 90 degrees is at the top.  *note
+theta:: allows you to change the origin and direction of the polar
+angular coordinate theta.
+          set theta {right|top|left|bottom}
+          set theta {clockwise|cw|counterclockwise|ccw}
+
+   *note theta:: restores the default state "set theta right ccw".
+
+
+File: gnuplot.info,  Node: tics,  Next: ticslevel,  Prev: theta,  Up: set-show
+
+3.33.92 tics
+------------
+
+The 'set tics' command controls the tic marks and labels on all axes at
+once.
+
+   The tics may be turned off with the 'unset tics' command, and may be
+turned on (the default state) with 'set tics'.  Fine control of tics on
+individual axes is possible using the alternative commands 'set xtics',
+*note ztics::, etc.
+
+   Syntax:
+           set tics {axis | border} {{no}mirror}
+                    {in | out} {front | back}
+                    {{no}rotate {by <ang>}} {offset <offset> | nooffset}
+                    {left | right | center | autojustify}
+                    {format "formatstring"} {font "name{,<size>}"} {{no}enhanced}
+                    { textcolor <colorspec> }
+           set tics scale {default | <major> {,<minor>}}
+           unset tics
+           show tics
+
+
+   The options can be applied to a single axis (x, y, z, x2, y2, cb),
+e.g.
+           set xtics rotate by -90
+           unset cbtics
+
+
+   All tic marks are drawn using the same line properties as the plot
+border (see *note border::).
+
+   Set tics 'back' or 'front' applies to all axes at once, but only for
+2D plots (not splot).  It controls whether the tics are placed behind or
+in front of the plot elements, in the case that there is overlap.
+
+   'axis' or *note border:: tells 'gnuplot' to put the tics (both the
+tics themselves and the accompanying labels) along the axis or the
+border, respectively.  If the axis is very close to the border, the
+'axis' option will move the tic labels to outside the border in case the
+border is printed (see *note border::).  The relevant margin settings
+will usually be sized badly by the automatic layout algorithm in this
+case.
+
+   'mirror' tells 'gnuplot' to put unlabeled tics at the same positions
+on the opposite border.  'nomirror' does what you think it does.
+
+   'in' and 'out' change the tic marks to be drawn inwards or outwards.
+
+   'set tics scale' controls the size of the tic marks.  The first value
+<major> controls the auto-generated or user-specified major tics (level
+0).  The second value controls the auto-generated or user-specified
+minor tics (level 1).  <major> defaults to 1.0, <minor> defaults to
+<major>/2.  Additional values control the size of user-specified tics
+with level 2, 3, ...  Default tic sizes are restored by 'set tics scale
+default'.
+
+   'rotate' asks 'gnuplot' to rotate the text through 90 degrees, which
+will be done if the terminal driver in use supports text rotation.
+'norotate' cancels this.  'rotate by <ang>' asks for rotation by <ang>
+degrees, supported by some terminal types.
+
+   The defaults are 'border mirror norotate' for tics on the x and y
+axes, and 'border nomirror norotate' for tics on the x2 and y2 axes.
+For the z axis, the default is 'nomirror'.
+
+   The <offset> is specified by either x,y or x,y,z, and may be preceded
+by 'first', 'second', 'graph', 'screen', or 'character' to select the
+coordinate system.  <offset> is the offset of the tics texts from their
+default positions, while the default coordinate system is 'character'.
+See 'coordinates' for details.  'nooffset' switches off the offset.
+
+   By default, tic labels are justified automatically depending on the
+axis and rotation angle to produce aesthetically pleasing results.  If
+this is not desired, justification can be overridden with an explicit
+'left', 'right' or 'center' keyword.  'autojustify' restores the default
+behavior.
+
+   'set tics' with no options restores mirrored, inward-facing tic marks
+for the primary axes.  All other settings are retained.
+
+   See also 'set xtics' for more control of major (labeled) tic marks
+and 'set mxtics' for control of minor tic marks.  These commands provide
+control of each axis independently.
+
+
+File: gnuplot.info,  Node: ticslevel,  Next: ticscale,  Prev: tics,  Up: set-show
+
+3.33.93 ticslevel
+-----------------
+
+Deprecated.  See *note xyplane::.
+
+
+File: gnuplot.info,  Node: ticscale,  Next: timestamp,  Prev: ticslevel,  Up: set-show
+
+3.33.94 ticscale
+----------------
+
+The *note ticscale:: command is deprecated, use 'set tics scale'
+instead.
+
+
+File: gnuplot.info,  Node: timestamp,  Next: timefmt,  Prev: ticscale,  Up: set-show
+
+3.33.95 timestamp
+-----------------
+
+The command *note timestamp:: places the current time and date in the
+plot margin.
+
+   Syntax:
+           set timestamp {"<format>"} {top|bottom} {{no}rotate}
+                         {offset <xoff>{,<yoff>}} {font "<fontspec>"}
+                         {textcolor <colorspec>}
+           unset timestamp
+           show timestamp
+
+
+   The format string is used to write the date and time.  Its default
+value is what asctime() uses: "%a %b %d %H:%M:%S %Y" (weekday, month
+name, day of the month, hours, minutes, seconds, four-digit year).  With
+'top' or 'bottom' you can place the timestamp along the top left or
+bottom left margin (default: bottom).  'rotate' writes the timestamp
+vertically.  The constants <xoff> and <yoff> are offsets that let you
+adjust the position more finely.  <font> is used to specify the font
+with which the time is to be written.
+
+   Example:
+           set timestamp "%d/%m/%y %H:%M" offset 80,-2 font "Helvetica"
+
+
+   See *note timefmt:: for more information about time format strings.
+
+
+File: gnuplot.info,  Node: timefmt,  Next: title_,  Prev: timestamp,  Up: set-show
+
+3.33.96 timefmt
+---------------
+
+This command sets the default format used to input time data.  See 'set
+xdata time', 'timecolumn'.
+
+   Syntax:
+           set timefmt "<format string>"
+           show timefmt
+
+
+   The valid formats for both *note timefmt:: and 'timecolumn' are:
+
+           Format       Explanation
+           %d           day of the month, 1--31
+           %m           month of the year, 1--12
+           %y           year, 0--99
+           %Y           year, 4-digit
+           %j           day of the year, 1--365
+           %H           hour, 0--24
+           %M           minute, 0--60
+           %s           seconds since the Unix epoch (1970-01-01, 00:00 UTC)
+           %S           second, integer 0--60 on output, (double) on input
+           %b           three-character abbreviation of the name of the month
+           %B           name of the month
+           %p           two character match to one of:  am AM pm PM
+
+
+   Any character is allowed in the string, but must match exactly.  \t
+(tab) is recognized.  Backslash-octals (\nnn) are converted to char.  If
+there is no separating character between the time/date elements, then
+%d, %m, %y, %H, %M and %S read two digits each.  If a decimal point
+immediately follows the field read by %S, the decimal and any following
+digits are interpreted as a fractional second.  %Y reads four digits.
+%j reads three digits.  %b requires three characters, and %B requires as
+many as it needs.
+
+   Spaces are treated slightly differently.  A space in the string
+stands for zero or more whitespace characters in the file.  That is, "%H
+%M" can be used to read "1220" and "12 20" as well as "12 20".
+
+   Each set of non-blank characters in the timedata counts as one column
+in the 'using n:n' specification.  Thus '11:11 25/12/76 21.0' consists
+of three columns.  To avoid confusion, 'gnuplot' requires that you
+provide a complete 'using' specification if your file contains timedata.
+
+   If the date format includes the day or month in words, the format
+string must exclude this text.  But it can still be printed with the
+"%a", "%A", "%b", or "%B" specifier.  'gnuplot' will determine the
+proper month and weekday from the numerical values.  See 'set format'
+for more details about these and other options for printing time data.
+
+   When reading two-digit years with %y, values 69-99 refer to the 20th
+century, while values 00-68 refer to the 21st century.  NB: This is in
+accordance with the UNIX98 spec, but conventions vary widely and
+two-digit year values are inherently ambiguous.
+
+   If the %p format returns "am" or "AM", hour 12 will be interpreted as
+hour 0.  If the %p format returns "pm" or "PM", hours < 12 will be
+increased by 12.
+
+   See also *note xdata:: 'time/date' and 'time_specifiers' for more
+information.
+
+   Example:
+           set timefmt "%d/%m/%Y\t%H:%M"
+
+   tells 'gnuplot' to read date and time separated by tab.  (But look
+closely at your data--what began as a tab may have been converted to
+spaces somewhere along the line; the format string must match what is
+actually in the file.)  See also time data demo.
+(http://www.gnuplot.info/demo/timedat.html)
+
+
+File: gnuplot.info,  Node: title_,  Next: tmargin,  Prev: timefmt,  Up: set-show
+
+3.33.97 title
+-------------
+
+The *note title:: command produces a plot title that is centered at the
+top of the plot.  *note title:: is a special case of 'set label'.
+
+   Syntax:
+           set title {"<title-text>"} {offset <offset>} {font "<font>{,<size>}"}
+                     {{textcolor | tc} {<colorspec> | default}} {{no}enhanced}
+           show title
+
+
+   If <offset> is specified by either x,y or x,y,z the title is moved by
+the given offset.  It may be preceded by 'first', 'second', 'graph',
+'screen', or 'character' to select the coordinate system.  See
+'coordinates' for details.  By default, the 'character' coordinate
+system is used.  For example, "'set title offset 0,-1'" will change only
+the y offset of the title, moving the title down by roughly the height
+of one character.  The size of a character depends on both the font and
+the terminal.
+
+   <font> is used to specify the font with which the title is to be
+written; the units of the font <size> depend upon which terminal is
+used.
+
+   'textcolor <colorspec>' changes the color of the text.  <colorspec>
+can be a linetype, an rgb color, or a palette mapping.  See help for
+*note colorspec:: and *note palette::.
+
+   'noenhanced' requests that the title not be processed by the enhanced
+text mode parser, even if enhanced text mode is currently active.
+
+   *note title:: with no parameters clears the title.
+
+   See 'syntax' for details about the processing of backslash sequences
+and the distinction between single- and double-quotes.
+
+
+File: gnuplot.info,  Node: tmargin,  Next: trange,  Prev: title_,  Up: set-show
+
+3.33.98 tmargin
+---------------
+
+The command *note tmargin:: sets the size of the top margin.  Please see
+*note margin:: for details.
+
+
+File: gnuplot.info,  Node: trange,  Next: ttics,  Prev: tmargin,  Up: set-show
+
+3.33.99 trange
+--------------
+
+Syntax: set trange [tmin:tmax] The range of the parametric variable t is
+useful in three contexts.
+   * In parametric mode 'plot' commands it limits the range of sampling
+     for both generating functions.  See *note parametric::, *note
+     samples::.
+   * In polar mode 'plot' commands it limits or defines the acceptable
+     range of the angular parameter theta during input.  Data points
+     with theta value outside this range are excluded from the plot even
+     if they would otherwise lie inside the plot boundary.  See 'polar'.
+   * In 'plot' or 'splot' commands using 1-dimensional sampled data via
+     the pseudofile "+".  See 'sampling 1D', *note special-filenames::.
+
+
+File: gnuplot.info,  Node: ttics,  Next: urange,  Prev: trange,  Up: set-show
+
+3.33.100 ttics
+--------------
+
+The *note ttics:: command places tics around the perimeter of a polar
+plot.  This is the border if 'set border polar' is enabled, otherwise
+the outermost circle of the polar grid drawn at the rightmost ticmark
+along the r axis.  See 'set grid', *note rtics::.  The angular position
+is always labeled in degrees.  The full perimeter can be labeled
+regardless of the current trange setting.  The desired range of the tic
+labels should be given as shown below.  Additional properties of the tic
+marks can be set.  See 'xtics'.
+
+          set ttics -180, 30, 180
+          set ttics add ("Theta = 0" 0)
+          set ttics font ":Italic" rotate
+
+   D ttics 3
+
+
+File: gnuplot.info,  Node: urange,  Next: version,  Prev: ttics,  Up: set-show
+
+3.33.101 urange
+---------------
+
+Syntax: set urange [umin:umax] The range of the parametric variables u
+and v is useful in two contexts.  1) 'splot' in parametric mode.  See
+*note parametric::, *note isosamples::.  2) generating 2-dimension
+sampled data for either 'plot' or 'splot' using the pseudofile "++".
+See 'sampling 2D'.
+
+
+File: gnuplot.info,  Node: version,  Next: vgrid,  Prev: urange,  Up: set-show
+
+3.33.102 version
+----------------
+
+The *note version:: command lists the version of gnuplot being run, its
+last modification date, the copyright holders, and email addresses for
+the FAQ, the gnuplot-info mailing list, and reporting bugs-in short, the
+information listed on the screen when the program is invoked
+interactively.
+
+   Syntax:
+           show version {long}
+
+
+   Show version 'long' also lists the operating system, configuration
+and compilation options used when this copy of 'gnuplot' was built.
+
+
+File: gnuplot.info,  Node: vgrid,  Next: view,  Prev: version,  Up: set-show
+
+3.33.103 vgrid
+--------------
+
+Syntax:
+          set vgrid $gridname {size N}
+          unset vgrid $gridname
+          show vgrid
+
+
+   If the named grid already exists, mark it as active (use it for
+subsequent *note vfill:: and 'voxel' operations).  If a new size is
+given, replace the existing content with a zero-filled N x N x N grid.
+If a grid with this name does not already exist, allocate an N x N x N
+grid (default N=100), zero the contents, and mark it as active.  Note
+that grid names must begin with '$'.
+
+   *note vgrid:: lists all currently defined voxel grids.  Example
+output:
+           $vgrid1: (active)
+                    size 100 X 100 X 100
+                    vxrange [-4:4]  vyrange[-4:4]  vzrange[-4:4]
+                    non-zero voxel values:  min 0.061237 max 94.5604
+                    number of zero voxels:  992070   (99.21%)
+
+
+   'unset vgrid $gridname' releases all data structures associated with
+that voxel grid.  The data structures are also released by 'reset
+session'.  The function 'voxel(x,y,z)' returns the value of the active
+grid point nearest that coordinate.  See also 'splot voxel-grids'.
+
+
+File: gnuplot.info,  Node: view,  Next: vrange,  Prev: vgrid,  Up: set-show
+
+3.33.104 view
+-------------
+
+The *note view:: command sets the viewing angle for 'splot's.  It
+controls how the 3D coordinates of the plot are mapped into the 2D
+screen space.  It provides controls for both rotation and scaling of the
+plotted data, but supports orthographic projections only.  It supports
+both 3D projection or orthogonal 2D projection into a 2D plot-like map.
+
+   Syntax:
+           set view <rot_x>{,{<rot_z>}{,{<scale>}{,<scale_z>}}}
+           set view map {scale <scale>}
+           set view projection {xy|xz|yz}
+           set view {no}equal {xy|xyz}
+           set view azimuth <angle>
+           show view
+
+
+   where <rot_x> and <rot_z> control the rotation angles (in degrees) in
+a virtual 3D coordinate system aligned with the screen such that
+initially (that is, before the rotations are performed) the screen
+horizontal axis is x, screen vertical axis is y, and the axis
+perpendicular to the screen is z.  The first rotation applied is <rot_x>
+around the x axis.  The second rotation applied is <rot_z> around the
+new z axis.
+
+   Command 'set view map' is used to represent the drawing as a map.  It
+is useful for 'contour' plots or 2D heatmaps using pm3d mode rather than
+'with image'.  In the latter case, take care that you properly use *note
+zrange:: and *note cbrange:: for input data point filtering and color
+range scaling, respectively.
+
+   <rot_x> is bounded to the [0:180] range with a default of 60 degrees,
+while <rot_z> is bounded to the [0:360] range with a default of 30
+degrees.  <scale> controls the scaling of the entire 'splot', while
+<scale_z> scales the z axis only.  Both scales default to 1.0.
+
+   Examples:
+           set view 60, 30, 1, 1
+           set view ,,0.5
+
+
+   The first sets all the four default values.  The second changes only
+scale, to 0.5.
+
+* Menu:
+
+* azimuth::
+* equal_axes::
+* projection::
+
+
+File: gnuplot.info,  Node: azimuth,  Next: equal_axes,  Prev: view,  Up: view
+
+3.33.104.1 azimuth
+..................
+
+           set view azimuth <angle-in-degrees>
+
+   The setting of azimuth affects the orientation of the z axis in a 3D
+graph (splot).  At the default azimuth = 0 the z axis of the plot lies
+in the plane orthogonal to the screen horizontal.  I.e.  the projection
+of the z axis lies along the screen vertical.  Non-zero azimuth rotates
+the plot about the line of sight through the origin so that a projection
+of the z axis is no longer vertical.  When azimuth = 90 the z axis is
+horizontal rather than vertical.  During interactive viewing, hot-key
+'z' resets azimuth to 0.
+
+
+File: gnuplot.info,  Node: equal_axes,  Next: projection,  Prev: azimuth,  Up: view
+
+3.33.104.2 equal_axes
+.....................
+
+The command 'set view equal xy' forces the unit length of the x and y
+axes to be on the same scale, and chooses that scale so that the plot
+will fit on the page.  The command 'set view equal xyz' additionally
+sets the z axis scale to match the x and y axes; however there is no
+guarantee that the z axis range will fit within the plot boundary.  See
+also *note isotropic::.  By default all three axes are scaled
+independently to fill the available area.
+
+   See also *note xyplane::.
+
+
+File: gnuplot.info,  Node: projection,  Prev: equal_axes,  Up: view
+
+3.33.104.3 projection
+.....................
+
+Syntax:
+          set view projection {xy|xz|yz}
+
+   Rotates the view angles of a 3D plot so that one of the primary
+planes xy, xz, or yz lies in the plane of the plot.  Axis label and tic
+positioning is adjusted accordingly; tics and labels on the third axis
+are disabled.  The plot is scaled up to approximately match the size
+that 'plot' would generate for the same axis ranges.  'set view
+projection xy' is equivalent to 'set view map'.
+
+   When the x and y coordinates used to specify objects, labels, arrows
+and other elements are both provided as "graph" coordinates, then in
+projection views they are interpreted as "horizontal/vertical" rather
+than "x/y".
+
+         set key top right at graph 0.95, graph 0.95     # works in any projection
+
+
+
+File: gnuplot.info,  Node: vrange,  Next: vxrange,  Prev: view,  Up: set-show
+
+3.33.105 vrange
+---------------
+
+Syntax: set vrange [vmin:vmax] The range of the parametric variables u
+and v is useful in two contexts.  1) 'splot' in parametric mode.  See
+*note parametric::, *note isosamples::.  2) generating 2-dimension
+sampled data for either 'plot' or 'splot' using the pseudofile "++".
+See 'sampling 2D'.
+
+
+File: gnuplot.info,  Node: vxrange,  Next: vyrange,  Prev: vrange,  Up: set-show
+
+3.33.106 vxrange
+----------------
+
+Syntax: set vxrange [vxmin:vxmax]
+
+   Establishes the range of x coordinates spanned by the active voxel
+grid.  Analogous commands *note vyrange:: and *note vzrange:: exist for
+the other two dimensions of the voxel grid.  If no explicit ranges have
+been set prior to the first *note vclear::, *note vfill::, or
+'voxel(x,y,z) = ' command, vmin and vmax will be copied from the current
+values of *note xrange::.
+
+
+File: gnuplot.info,  Node: vyrange,  Next: vzrange,  Prev: vxrange,  Up: set-show
+
+3.33.107 vyrange
+----------------
+
+See *note vxrange::
+
+
+File: gnuplot.info,  Node: vzrange,  Next: walls,  Prev: vyrange,  Up: set-show
+
+3.33.108 vzrange
+----------------
+
+See *note vxrange::
+
+
+File: gnuplot.info,  Node: walls,  Next: watchpoints,  Prev: vzrange,  Up: set-show
+
+3.33.109 walls
+--------------
+
+Syntax:
+          set walls
+          set wall {x0|y0|z0|x1|y1} {<fillstyle>} {fc <fillcolor>}
+
+
+   3D surfaces drawn by 'splot' lie within a normalized unit cube
+regardless of the x y and z axis ranges.  The bounding walls of this
+cube are described by the planes (graph coord x == 0), (graph coord x ==
+1), etc.  The *note walls:: command renders the walls x0 y0 and z0 as
+solid surfaces.  By default these surfaces are semi-transparent
+(fillstyle transparent solid 0.5).  You can customize which walls are
+drawn and also their individual color and fill style.  If you choose to
+enable walls, you may also want to use 'set xyplane 0'.
+
+   Example:
+          set wall x0; set wall y1; set wall z0 fillstyle solid 1.0 fillcolor "gray"
+          splot f(x,y) with pm3d fc "goldenrod"
+
+
+
+File: gnuplot.info,  Node: watchpoints,  Next: x2data,  Prev: walls,  Up: set-show
+
+3.33.110 watchpoints
+--------------------
+
+One or more watchpoints may be set for each component plot in a plot
+command.  All watchpoint targets and hits from the previous plot command
+are summarized by the command *note watchpoints::.
+
+   Example:
+          plot DATA using 1:2 smooth cnormal watch y=0.25 watch y=0.5 watch y=0.75
+          show watchpoints
+
+
+              Plot title:     "DATA using 1:2 smooth cnormal"
+                Watch 1 target y = 0.25         (1 hits)
+                        hit 1   x 50.6  y 0.25
+                Watch 2 target y = 0.5          (1 hits)
+                        hit 1   x 63.6  y 0.5
+                Watch 3 target y = 0.75         (1 hits)
+                        hit 1   x 68.3  y 0.75
+
+
+   The coordinates of all points satisfying the first watchpoint
+(y=0.25) are stored in an array WATCH_1.  The points satisfying (y=0.5)
+are stored in an array WATCH_2, and so on.
+
+   Each hit is stored as a complex number with x as the real component
+and y as the imaginary component.  So the first hit of watchpoint 2 has
+x = real(WATCH_2[1]) y = imag(WATCH_2[1]).  In this example only the x
+coordinates of the hits are interesting, as the y coordinates will
+always match the corresponding target y value.  However if the
+watchpoint target is a z value or a function f(x,y), neither the x or
+the y coordinate of a hit is known in advance.
+
+
+File: gnuplot.info,  Node: x2data,  Next: x2dtics,  Prev: watchpoints,  Up: set-show
+
+3.33.111 x2data
+---------------
+
+The *note x2data:: command sets data on the x2 (top) axis to timeseries
+(dates/times).  Please see *note xdata::.
+
+
+File: gnuplot.info,  Node: x2dtics,  Next: x2label,  Prev: x2data,  Up: set-show
+
+3.33.112 x2dtics
+----------------
+
+The *note x2dtics:: command changes tics on the x2 (top) axis to days of
+the week.  Please see *note xdtics:: for details.
+
+
+File: gnuplot.info,  Node: x2label,  Next: x2mtics,  Prev: x2dtics,  Up: set-show
+
+3.33.113 x2label
+----------------
+
+The *note x2label:: command sets the label for the x2 (top) axis.
+Please see *note xlabel::.
+
+
+File: gnuplot.info,  Node: x2mtics,  Next: x2range,  Prev: x2label,  Up: set-show
+
+3.33.114 x2mtics
+----------------
+
+The *note x2mtics:: command changes tics on the x2 (top) axis to months
+of the year.  Please see *note xmtics:: for details.
+
+
+File: gnuplot.info,  Node: x2range,  Next: x2tics,  Prev: x2mtics,  Up: set-show
+
+3.33.115 x2range
+----------------
+
+The *note x2range:: command sets the horizontal range that will be
+displayed on the x2 (top) axis.  See *note xrange:: for the full set of
+command options.  See also *note link::.
+
+
+File: gnuplot.info,  Node: x2tics,  Next: x2zeroaxis,  Prev: x2range,  Up: set-show
+
+3.33.116 x2tics
+---------------
+
+The *note x2tics:: command controls major (labeled) tics on the x2 (top)
+axis.  Please see 'set xtics' for details.
+
+
+File: gnuplot.info,  Node: x2zeroaxis,  Next: xdata,  Prev: x2tics,  Up: set-show
+
+3.33.117 x2zeroaxis
+-------------------
+
+The *note x2zeroaxis:: command draws a line at the origin of the x2
+(top) axis (y2 = 0).  For details, please see *note zeroaxis::.
+
+
+File: gnuplot.info,  Node: xdata,  Next: xdtics,  Prev: x2zeroaxis,  Up: set-show
+
+3.33.118 xdata
+--------------
+
+This command controls interpretation of data on the x axis.  An
+analogous command acts on each of the other axes.
+
+   Syntax:
+           set xdata {time}
+           show xdata
+
+
+   The same syntax applies to *note ydata::, *note zdata::, *note
+x2data::, *note y2data:: and *note cbdata::.
+
+   The 'time' option signals that data represents a time/date in
+seconds.  Gnuplot version 6 stores time to millisecond precision.
+
+   *note xdata:: (with no 'time' keyword) restores data interpretation
+to normal.
+
+* Menu:
+
+* time_::
+
+
+File: gnuplot.info,  Node: time_,  Prev: xdata,  Up: xdata
+
+3.33.118.1 time
+...............
+
+'set xdata time' indicates that the x coordinate represents a date or
+time to millisecond precision.  There is an analogous command 'set ydata
+time'.
+
+   There are separate format mechanisms for interpretation of time data
+on input and output.  Input data is read from a file either by using the
+global *note timefmt:: or by using the function timecolumn() as part of
+the plot command.  These input mechanisms also apply to using time
+values to set an axis range.  See *note timefmt::, 'timecolumn'.
+
+   Example:
+
+          set xdata time
+          set timefmt "%d-%b-%Y"
+          set xrange ["01-Jan-2013" : "31-Dec-2014"]
+          plot DATA using 1:2
+
+   or
+          plot DATA using (timecolumn(1,"%d-%b-%Y")):2
+
+
+   For output, i.e.  tick labels along that axis or coordinates output
+by mousing, the function 'strftime' (type "man strftime" on unix to look
+it up) is used to convert from the internal time in seconds to a string
+representation of a date.  'gnuplot' tries to figure out a reasonable
+format for this.  You can customize the format using either 'set format
+x' or 'set xtics format'.  See 'time_specifiers' for a special set of
+time format specifiers.  See also 'time/date' for more information.
+
+
+File: gnuplot.info,  Node: xdtics,  Next: xlabel,  Prev: xdata,  Up: set-show
+
+3.33.119 xdtics
+---------------
+
+The *note xdtics:: commands converts the x-axis tic marks to days of the
+week where 0=Sun and 6=Sat.  Overflows are converted modulo 7 to dates.
+'set noxdtics' returns the labels to their default values.  Similar
+commands do the same things for the other axes.
+
+   Syntax:
+           set xdtics
+           unset xdtics
+           show xdtics
+
+
+   The same syntax applies to *note ydtics::, *note zdtics::, *note
+x2dtics::, *note y2dtics:: and *note cbdtics::.
+
+   See also the 'set format' command.
+
+
+File: gnuplot.info,  Node: xlabel,  Next: xmtics,  Prev: xdtics,  Up: set-show
+
+3.33.120 xlabel
+---------------
+
+The *note xlabel:: command sets the x axis label.  Similar commands set
+labels on the other axes.
+
+   Syntax:
+           set xlabel {"<label>"} {offset <offset>} {font "<font>{,<size>}"}
+                      {textcolor <colorspec>} {{no}enhanced}
+                      {rotate by <degrees> | rotate parallel | norotate}
+           show xlabel
+
+
+   The same syntax applies to *note x2label::, *note ylabel::, *note
+y2label::, *note zlabel:: and *note cblabel::.
+
+   If <offset> is specified by either x,y or x,y,z the label is moved by
+the given offset.  It may be preceded by 'first', 'second', 'graph',
+'screen', or 'character' to select the coordinate system.  See
+'coordinates' for details.  By default, the 'character' coordinate
+system is used.  For example, "'set xlabel offset -1,0'" will change
+only the x offset of the title, moving the label roughly one character
+width to the left.  The size of a character depends on both the font and
+the terminal.
+
+   <font> is used to specify the font in which the label is written; the
+units of the font <size> depend upon which terminal is used.
+
+   'noenhanced' requests that the label text not be processed by the
+enhanced text mode parser, even if enhanced text mode is currently
+active.
+
+   To clear a label, put no options on the command line, e.g., "*note
+y2label::".
+
+   The default positions of the axis labels are as follows:
+
+   xlabel: The x-axis label is centered below the bottom of the plot.
+
+   ylabel: The y-axis label is centered to the left of the plot,
+defaulting to either horizontal or vertical orientation depending on the
+terminal type.  The program may not reserve enough space to the left of
+the plot to hold long non-rotated ylabel text.  You can adjust this with
+*note lmargin::.
+
+   zlabel: The z-axis label is centered along the z axis and placed in
+the space above the grid level.
+
+   cblabel: The color box axis label is centered along the box and
+placed below or to the right according to horizontal or vertical color
+box gradient.
+
+   y2label: The y2-axis label is placed to the right of the y2 axis.
+The position is terminal-dependent in the same manner as is the y-axis
+label.
+
+   x2label: The x2-axis label is placed above the plot but below the
+title.  It is also possible to create an x2-axis label by using new-line
+characters to make a multi-line plot title, e.g.,
+
+           set title "This is the title\n\nThis is the x2label"
+
+
+   Note that double quotes must be used.  The same font will be used for
+both lines, of course.
+
+   The orientation (rotation angle) of the x, x2, y and y2 axis labels
+in 2D plots can be changed by specifying 'rotate by <degrees>'.  The
+orientation of the x and y axis labels in 3D plots defaults to
+horizontal but can be changed to run parallel to the axis by specifying
+'rotate parallel'.
+
+   If you are not satisfied with the default position of an axis label,
+use 'set label' instead-that command gives you much more control over
+where text is placed.
+
+   Please see 'syntax' for further information about backslash
+processing and the difference between single- and double-quoted strings.
+
+
+File: gnuplot.info,  Node: xmtics,  Next: xrange,  Prev: xlabel,  Up: set-show
+
+3.33.121 xmtics
+---------------
+
+The *note xmtics:: command converts the x-axis tic marks to months of
+the year where 1=Jan and 12=Dec.  Overflows are converted modulo 12 to
+months.  The tics are returned to their default labels by *note
+xmtics::.  Similar commands perform the same duties for the other axes.
+
+   Syntax:
+           set xmtics
+           unset xmtics
+           show xmtics
+
+
+   The same syntax applies to *note x2mtics::, *note ymtics::, *note
+y2mtics::, *note zmtics:: and *note cbmtics::.
+
+   See also the 'set format' command.
+
+
+File: gnuplot.info,  Node: xrange,  Next: xtics,  Prev: xmtics,  Up: set-show
+
+3.33.122 xrange
+---------------
+
+The *note xrange:: command sets the horizontal range that will be
+displayed.  A similar command exists for each of the other axes, as well
+as for the polar radius r and the parametric variables t, u, and v.
+
+   Syntax:
+           set xrange [{{<min>}:{<max>}}] {{no}reverse} {{no}writeback} {{no}extend}
+                      | restore
+           show xrange
+
+
+   where <min> and <max> terms are constants, expressions or an asterisk
+to set autoscaling.  If the data are time/date, you must give the range
+as a quoted string according to the *note timefmt:: format.  If <min> or
+<max> is omitted the current value will not be changed.  See below for
+full autoscaling syntax.  See also *note noextend::.
+
+   The same syntax applies to *note yrange::, *note zrange::, *note
+x2range::, *note y2range::, *note cbrange::, *note rrange::, *note
+trange::, *note urange:: and *note vrange::.
+
+   See *note link:: for options that link the ranges of x and x2, or y
+and y2.
+
+   The 'reverse' option reverses the direction of an autoscaled axis.
+For example, if the data values range from 10 to 100, it will autoscale
+to the equivalent of set xrange [100:10].  The 'reverse' flag has no
+effect if the axis is not autoscaled.
+
+   Autoscaling: If <min> (the same applies for correspondingly to <max>)
+is an asterisk "*" autoscaling is turned on.  The range in which
+autoscaling is being performed may be limited by a lower bound <lb> or
+an upper bound <ub> or both.  The syntax is
+           { <lb> < } * { < <ub> }
+
+   For example,
+           0 < * < 200
+
+   sets <lb> = 0 and <ub> = 200.  With such a setting <min> would be
+autoscaled, but its final value will be between 0 and 200 (both
+inclusive despite the '<' sign).  If no lower or upper bound is
+specified, the '<' to also be omitted.  If <ub> is lower than <lb> the
+constraints will be turned off and full autoscaling will happen.  This
+feature is useful to plot measured data with autoscaling but providing a
+limit on the range, to clip outliers, or to guarantee a minimum range
+that will be displayed even if the data would not need such a big range.
+
+   The 'writeback' option essentially saves the range found by *note
+autoscale:: in the buffers that would be filled by *note xrange::.  This
+is useful if you wish to plot several functions together but have the
+range determined by only some of them.  The 'writeback' operation is
+performed during the 'plot' execution, so it must be specified before
+that command.  To restore, the last saved horizontal range use 'set
+xrange restore'.  For example,
+
+           set xrange [-10:10]
+           set yrange [] writeback
+           plot sin(x)
+           set yrange restore
+           replot x/2
+
+
+   results in a yrange of [-1:1] as found only from the range of sin(x);
+the [-5:5] range of x/2 is ignored.  Executing *note yrange:: after each
+command in the above example should help you understand what is going
+on.
+
+   In 2D, *note xrange:: and *note yrange:: determine the extent of the
+axes, *note trange:: determines the range of the parametric variable in
+parametric mode or the range of the angle in polar mode.  Similarly in
+parametric 3D, *note xrange::, *note yrange::, and *note zrange:: govern
+the axes and *note urange:: and *note vrange:: govern the parametric
+variables.
+
+   In polar mode, *note rrange:: determines the radial range plotted.
+<rmin> acts as an additive constant to the radius, whereas <rmax> acts
+as a clip to the radius--no point with radius greater than <rmax> will
+be plotted.  *note xrange:: and *note yrange:: are affected--the ranges
+can be set as if the graph was of r(t)-rmin, with rmin added to all the
+labels.
+
+   Any range may be partially or totally autoscaled, although it may not
+make sense to autoscale a parametric variable unless it is plotted with
+data.
+
+   Ranges may also be specified on the 'plot' command line.  A range
+given on the plot line will be used for that single 'plot' command; a
+range given by a 'set' command will be used for all subsequent plots
+that do not specify their own ranges.  The same holds true for 'splot'.
+
+* Menu:
+
+* examples__::
+* extend::
+
+
+File: gnuplot.info,  Node: examples__,  Next: extend,  Prev: xrange,  Up: xrange
+
+3.33.122.1 examples
+...................
+
+Examples:
+
+   To set the xrange to the default:
+           set xrange [-10:10]
+
+
+   To set the yrange to increase downwards:
+           set yrange [10:-10]
+
+
+   To change zmax to 10 without affecting zmin (which may still be
+autoscaled):
+           set zrange [:10]
+
+
+   To autoscale xmin while leaving xmax unchanged:
+           set xrange [*:]
+
+
+   To autoscale xmin but keeping xmin positive:
+           set xrange [0<*:]
+
+
+   To autoscale x but keep minimum range of 10 to 50 (actual might be
+larger):
+           set xrange [*<10:50<*]
+
+
+   Autoscaling but limit maximum xrange to -1000 to 1000, i.e.
+autoscaling within [-1000:1000]
+           set xrange [-1000<*:*<1000]
+
+
+   Make sure xmin is somewhere between -200 and 100:
+           set xrange [-200<*<100:]
+
+
+
+File: gnuplot.info,  Node: extend,  Prev: examples__,  Up: xrange
+
+3.33.122.2 extend
+.................
+
+*note noextend:: is the same as *note noextend::.  See *note noextend::.
+
+
+File: gnuplot.info,  Node: xtics,  Next: xyplane,  Prev: xrange,  Up: set-show
+
+3.33.123 xtics
+--------------
+
+Fine control of the major (labeled) tics on the x axis is possible with
+the 'set xtics' command.  The tics may be turned off with the 'unset
+xtics' command, and may be turned on (the default state) with 'set
+xtics'.  Similar commands control the major tics on the y, z, x2 and y2
+axes.
+
+   Syntax:
+           set xtics {axis | border} {{no}mirror}
+                     {in | out} {scale {default | <major> {,<minor>}}}
+                     {{no}rotate {by <ang>}} {offset <offset> | nooffset}
+                     {left | right | center | autojustify}
+                     {add}
+                     {  autofreq
+                      | <incr>
+                      | <start>, <incr> {,<end>}
+                      | ({"<label>"} <pos> {<level>} {,{"<label>"}...) }
+                     {format "formatstring"} {font "name{,<size>}"} {{no}enhanced}
+                     { numeric | timedate | geographic }
+                     {{no}logscale}
+                     { rangelimited }
+                     { textcolor <colorspec> }
+           unset xtics
+           show xtics
+
+
+   The same syntax applies to *note ytics::, *note ztics::, *note
+x2tics::, *note y2tics:: and *note cbtics::.
+
+   'axis' or *note border:: tells 'gnuplot' to put the tics (both the
+tics themselves and the accompanying labels) along the axis or the
+border, respectively.  If the axis is very close to the border, the
+'axis' option will move the tic labels to outside the border.  The
+relevant margin settings will usually be sized badly by the automatic
+layout algorithm in this case.
+
+   'mirror' tells 'gnuplot' to put unlabeled tics at the same positions
+on the opposite border.  'nomirror' does what you think it does.
+
+   'in' and 'out' change the tic marks to be drawn inwards or outwards.
+
+   With 'scale', the size of the tic marks can be adjusted.  If <minor>
+is not specified, it is 0.5*<major>.  The default size 1.0 for major
+tics and 0.5 for minor tics is requested by 'scale default'.
+
+   'rotate' asks 'gnuplot' to rotate the text through 90 degrees, which
+will be done if the terminal driver in use supports text rotation.
+'norotate' cancels this.  'rotate by <ang>' asks for rotation by <ang>
+degrees, supported by some terminal types.
+
+   The defaults are 'border mirror norotate' for tics on the x and y
+axes, and 'border nomirror norotate' for tics on the x2 and y2 axes.
+For the z axis, the '{axis | border}' option is not available and the
+default is 'nomirror'.  If you do want to mirror the z-axis tics, you
+might want to create a bit more room for them with *note border::.
+
+   The <offset> is specified by either x,y or x,y,z, and may be preceded
+by 'first', 'second', 'graph', 'screen', or 'character' to select the
+coordinate system.  <offset> is the offset of the tics texts from their
+default positions, while the default coordinate system is 'character'.
+See 'coordinates' for details.  'nooffset' switches off the offset.
+
+   Example:
+
+   Move xtics more closely to the plot.
+           set xtics offset 0,graph 0.05
+
+
+   To change the relative order of drawing axis tics and the plot
+itself, use the 'set grid' command with options 'front', 'back' or
+'layerdefault'.  There is no option to assign different axis tics or
+grid lines to different layers.
+
+   By default, tic labels are justified automatically depending on the
+axis and rotation angle to produce aesthetically pleasing results.  If
+this is not desired, justification can be overridden with an explicit
+'left', 'right' or 'center' keyword.  'autojustify' restores the default
+behavior.
+
+   'set xtics' with no options restores the default border or axis if
+xtics are being displayed; otherwise it has no effect.  Any previously
+specified tic frequency or position {and labels} are retained.
+
+   Tic positions are calculated automatically by default or if the
+'autofreq' option is given.
+
+   A series of tic positions can be specified by giving either a tic
+interval alone, or a start point, interval, and end point (see 'xtics
+series').
+
+   Individual tic positions can be specified individually by providing
+an explicit list of positions, where each position may have an
+associated text label.  See 'xtics list'.
+
+   However they are specified, tics will only be plotted when in range.
+
+   Format (or omission) of the tic labels is controlled by 'set format',
+unless the explicit text of a label is included in the 'set xtics
+("<label>")' form.
+
+   Minor (unlabeled) tics can be added automatically by the 'set mxtics'
+command, or at explicit positions by the 'set xtics ("" <pos> 1, ...)'
+form.
+
+   The appearance of the tics (line style, line width etc.)  is
+determined by the border line (see *note border::), even if the tics are
+drawn at the axes.
+
+* Menu:
+
+* xtics_series::
+* xtics_list::
+* xtics_timedata::
+* geographic::
+* xtics_logscale::
+* xtics_rangelimited::
+
+
+File: gnuplot.info,  Node: xtics_series,  Next: xtics_list,  Prev: xtics,  Up: xtics
+
+3.33.123.1 xtics series
+.......................
+
+Syntax:
+          set xtics <incr>
+          set xtics <start>, <incr>, <end>
+
+   The implicit <start>, <incr>, <end> form specifies that a series of
+tics will be plotted on the axis between the values <start> and <end>
+with an increment of <incr>.  If <end> is not given, it is assumed to be
+infinity.  The increment may be negative.  If neither <start> nor <end>
+is given, <start> is assumed to be negative infinity, <end> is assumed
+to be positive infinity, and the tics will be drawn at integral
+multiples of <incr>.  If the axis is logarithmic, the increment will be
+used as a multiplicative factor.
+
+   If you specify to a negative <start> or <incr> after a numerical
+value (e.g., 'rotate by <angle>' or 'offset <offset>'), the parser fails
+because it subtracts <start> or <incr> from that value.  As a
+workaround, specify '0-<start>' resp.  '0-<incr>' in that case.
+
+   Example:
+           set xtics border offset 0,0.5 -5,1,5
+
+   Fails with 'invalid expression' at the last comma.  Use instead
+           set xtics border offset 0,0.5 0-5,1,5
+
+   or
+           set xtics offset 0,0.5 border -5,1,5
+
+   These place tics at the border, tics text with an offset of 0,0.5
+characters, and sets the start, increment, and end to -5, 1, and 5, as
+requested.
+
+   Examples:
+
+   Make tics at 0, 0.5, 1, 1.5, ..., 9.5, 10.
+           set xtics 0,.5,10
+
+
+   Make tics at ..., -10, -5, 0, 5, 10, ...
+           set xtics 5
+
+
+   Make tics at 1, 100, 1e4, 1e6, 1e8.
+           set logscale x; set xtics 1,100,1e8
+
+
+
+File: gnuplot.info,  Node: xtics_list,  Next: xtics_timedata,  Prev: xtics_series,  Up: xtics
+
+3.33.123.2 xtics list
+.....................
+
+Syntax:
+          set xtics {add} ("label1" <pos1> <level1>, "label2" <pos2> <level2>, ...)
+
+
+   The explicit ("label" <pos> <level>, ...)  form allows arbitrary tic
+positions or non-numeric tic labels.  In this form, the tics do not need
+to be listed in numerical order.  Each tic has a position, optionally
+with a label.
+
+   The label is a string enclosed by quotes or a string-valued
+expression.  It may contain formatting information for converting the
+position into its label, such as "%3f clients", or it may be the empty
+string "".  See 'set format' for more information.  If no string is
+given, the default label (numerical) is used.
+
+   An explicit tic mark has a third parameter, the level.  The default
+is level 0, a major tic.  Level 1 generates a minor tic.  Labels are
+never printed for minor tics.  Major and minor tics may be
+auto-generated by the program or specified explicitly by the user.  Tics
+with level 2 and higher must be explicitly specified by the user, and
+take priority over auto-generated tics.  The size of tics marks at each
+level is controlled by the command 'set tics scale'.
+
+   Examples:
+           set xtics ("low" 0, "medium" 50, "high" 100)
+           set xtics (1,2,4,8,16,32,64,128,256,512,1024)
+           set ytics ("bottom" 0, "" 10, "top" 20)
+           set ytics ("bottom" 0, "" 10 1, "top" 20)
+
+
+   In the second example, all tics are labeled.  In the third, only the
+end tics are labeled.  In the fourth, the unlabeled tic is a minor tic.
+
+   Normally if explicit tics are given, they are used instead of
+auto-generated tics.  Conversely if you specify 'set xtics auto' or the
+like it will erase any previously specified explicit tics.  You can mix
+explicit and auto- generated tics by using the keyword 'add', which must
+appear before the tic style being added.
+
+   Example:
+           set xtics 0,.5,10
+           set xtics add ("Pi" 3.14159)
+
+
+   This will automatically generate tic marks every 0.5 along x, but
+will also add an explicit labeled tic mark at pi.
+
+
+File: gnuplot.info,  Node: xtics_timedata,  Next: geographic,  Prev: xtics_list,  Up: xtics
+
+3.33.123.3 xtics timedata
+.........................
+
+Times and dates are stored internally as a number of seconds.
+
+   Input: Non-numeric time and date values are converted to seconds on
+input using the format specifier in *note timefmt::.  Axis range limits,
+tic placement, and plot coordinates may be given as quoted dates or
+times interpreted using *note timefmt::.
+
+   Output: Axis tic labels are generated using a separate format
+specified either by 'set format' or 'set xtics format'.  By default the
+usual numeric format specifiers are expected ('set xtics numeric').
+Other options are geographic coordinates (*note geographic::), or times
+or dates ('set xtics time').
+
+   Note: For backward compatibility with earlier gnuplot versions, the
+command 'set xdata time' will implicitly also do 'set xtics time', and
+*note xdata:: or *note xdata:: will implicitly reset to 'set xtics
+numeric'.  However you can change this with a later call to 'set xtics'.
+
+   Examples:
+           set xdata time           # controls interpretation of input data
+           set timefmt "%d/%m"      # format used to read input data
+           set xtics timedate       # controls interpretation of output format
+           set xtics format "%b %d" # format used for tic labels
+           set xrange ["01/12":"06/12"]
+           set xtics "01/12", 172800, "05/12"
+
+
+           set xdata time
+           set timefmt "%d/%m"
+           set xtics format "%b %d" time
+           set xrange ["01/12":"06/12"]
+           set xtics ("01/12", "" "03/12", "05/12")
+
+   Both of these will produce tics "Dec 1", "Dec 3", and "Dec 5", but in
+the second example the tic at "Dec 3" will be unlabeled.
+
+   If the <start>, <incr>, <end> form is used, <incr> defaults to
+seconds but an explicit time unit of 'minutes', 'hours', 'days',
+'weeks', 'months', or 'years' can be appended.  The same is true if only
+an interval <incr> is given.
+
+   Examples
+          set xtics time 5 years     # place labeled tics at five year intervals
+          set xtics "01-Jan-2000", 1 month, "01-Jan-2001"
+
+
+   There is also a special time mode for minor tics.  See 'set mxtics
+time'.
+
+
+File: gnuplot.info,  Node: geographic,  Next: xtics_logscale,  Prev: xtics_timedata,  Up: xtics
+
+3.33.123.4 geographic
+.....................
+
+*note geographic:: indicates that x-axis values are to be interpreted as
+a geographic coordinate measured in degrees.  Use 'set xtics format' or
+'set format x' to specify the appearance of the axis tick labels.  The
+format specifiers for geographic data are as follows:
+            %D                   = integer degrees
+            %<width.precision>d  = floating point degrees
+            %M                   = integer minutes
+            %<width.precision>m  = floating point minutes
+            %S                   = integer seconds
+            %<width.precision>s  = floating point seconds
+            %E                   = label with E/W instead of +/-
+            %N                   = label with N/S instead of +/-
+
+   For example, the command 'set format x "%Ddeg %5.2mmin %E"' will
+cause x coordinate -1.51 to be labeled as '" 1deg 30.60min W"'.
+
+   If the xtics are left in the default state ('set xtics numeric') the
+coordinate will be reported as a decimal number of degrees, and 'format'
+will be assumed to contain normal numeric format specifiers rather than
+the special set above.
+
+   To output degrees/minutes/seconds in a context other than axis tics,
+such as placing labels on a map, you can use the relative time format
+specifiers %tH %tM %tS for strptime.  See 'time_specifiers', *note
+strptime::.
+
+
+File: gnuplot.info,  Node: xtics_logscale,  Next: xtics_rangelimited,  Prev: geographic,  Up: xtics
+
+3.33.123.5 xtics logscale
+.........................
+
+If the *note logscale:: attribute is set for a tic series along a
+log-scaled axis, the tic interval is interpreted as a multiplicative
+factor rather than a constant.  For example:
+          # generate a series of tics at y=20 y=200 y=2000 y=20000
+          set log y
+          set ytics 20, 10, 50000 logscale
+
+   Note that no tic is placed at y=50000 because it is not in the series
+2*10^x.  If the logscale property is disabled, the tic increment will be
+treated as an additive constant even for a log-scaled axis.  For
+example:
+          # generate a series of tics at y=20 y=40 y=60 ... y=200
+          set log y
+          set yrange [20:200]
+          set ytics 20 nologscale
+
+   The *note logscale:: attribute is set automatically by the 'set log'
+command, so normally you do not need this keyword unless you want to
+force a constant tic interval as in the second example above.
+
+
+File: gnuplot.info,  Node: xtics_rangelimited,  Prev: xtics_logscale,  Up: xtics
+
+3.33.123.6 xtics rangelimited
+.............................
+
+This option limits both the auto-generated axis tic labels and the
+corresponding plot border to the range of values actually present in the
+data that has been plotted.  Note that this is independent of the
+current range limits for the plot.  For example, suppose that the data
+in "file.dat" all lies in the range 2 < y < 4.  Then the following
+commands will create a plot for which the left-hand plot border (y axis)
+is drawn for only this portion of the total y range, and only the axis
+tics in this region are generated.  I.e., the plot will be scaled to the
+full range on y, but there will be a gap between 0 and 2 on the left
+border and another gap between 4 and 10.  This style is sometimes
+referred to as a 'range-frame' graph.
+           set border 3
+           set yrange [0:10]
+           set ytics nomirror rangelimited
+           plot "file.dat"
+
+
+
+File: gnuplot.info,  Node: xyplane,  Next: xzeroaxis,  Prev: xtics,  Up: set-show
+
+3.33.124 xyplane
+----------------
+
+The *note xyplane:: command adjusts the position at which the xy plane
+is drawn in a 3D plot.  The synonym "set ticslevel" is accepted for
+backwards compatibility.
+
+   Syntax:
+           set xyplane at <zvalue>
+           set xyplane relative <frac>
+           set ticslevel <frac>        # equivalent to set xyplane relative
+           show xyplane
+
+
+   The form 'set xyplane relative <frac>' places the xy plane below the
+range in Z, where the distance from the xy plane to Zmin is given as a
+fraction of the total range in z.  The default value is 0.5.  Negative
+values are permitted, but tic labels on the three axes may overlap.
+
+   The alternative form 'set xyplane at <zvalue>' fixes the placement of
+the xy plane at a specific Z value regardless of the current z range.
+Thus to force the x, y, and z axes to meet at a common origin one would
+specify 'set xyplane at 0'.
+
+   See also *note view::, and *note zeroaxis::.
+
+
+File: gnuplot.info,  Node: xzeroaxis,  Next: y2data,  Prev: xyplane,  Up: set-show
+
+3.33.125 xzeroaxis
+------------------
+
+The *note xzeroaxis:: command draws a line at y = 0.  For details,
+please see *note zeroaxis::.
+
+
+File: gnuplot.info,  Node: y2data,  Next: y2dtics,  Prev: xzeroaxis,  Up: set-show
+
+3.33.126 y2data
+---------------
+
+The *note y2data:: command sets y2 (right-hand) axis data to timeseries
+(dates/times).  Please see *note xdata::.
+
+
+File: gnuplot.info,  Node: y2dtics,  Next: y2label,  Prev: y2data,  Up: set-show
+
+3.33.127 y2dtics
+----------------
+
+The *note y2dtics:: command changes tics on the y2 (right-hand) axis to
+days of the week.  Please see *note xdtics:: for details.
+
+
+File: gnuplot.info,  Node: y2label,  Next: y2mtics,  Prev: y2dtics,  Up: set-show
+
+3.33.128 y2label
+----------------
+
+The *note y2label:: command sets the label for the y2 (right-hand) axis.
+Please see *note xlabel::.
+
+
+File: gnuplot.info,  Node: y2mtics,  Next: y2range,  Prev: y2label,  Up: set-show
+
+3.33.129 y2mtics
+----------------
+
+The *note y2mtics:: command changes tics on the y2 (right-hand) axis to
+months of the year.  Please see *note xmtics:: for details.
+
+
+File: gnuplot.info,  Node: y2range,  Next: y2tics,  Prev: y2mtics,  Up: set-show
+
+3.33.130 y2range
+----------------
+
+The *note y2range:: command sets the vertical range that will be
+displayed on the y2 (right) axis.  See *note xrange:: for the full set
+of command options.  See also *note link::.
+
+
+File: gnuplot.info,  Node: y2tics,  Next: y2zeroaxis,  Prev: y2range,  Up: set-show
+
+3.33.131 y2tics
+---------------
+
+The *note y2tics:: command controls major (labeled) tics on the y2
+(right-hand) axis.  Please see 'set xtics' for details.
+
+
+File: gnuplot.info,  Node: y2zeroaxis,  Next: ydata,  Prev: y2tics,  Up: set-show
+
+3.33.132 y2zeroaxis
+-------------------
+
+The *note y2zeroaxis:: command draws a line at the origin of the y2
+(right-hand) axis (x2 = 0).  For details, please see *note zeroaxis::.
+
+
+File: gnuplot.info,  Node: ydata,  Next: ydtics,  Prev: y2zeroaxis,  Up: set-show
+
+3.33.133 ydata
+--------------
+
+The *note ydata:: commands sets y-axis data to timeseries (dates/times).
+Please see *note xdata::.
+
+
+File: gnuplot.info,  Node: ydtics,  Next: ylabel,  Prev: ydata,  Up: set-show
+
+3.33.134 ydtics
+---------------
+
+The *note ydtics:: command changes tics on the y axis to days of the
+week.  Please see *note xdtics:: for details.
+
+
+File: gnuplot.info,  Node: ylabel,  Next: ymtics,  Prev: ydtics,  Up: set-show
+
+3.33.135 ylabel
+---------------
+
+This command sets the label for the y axis.  Please see *note xlabel::.
+
+
+File: gnuplot.info,  Node: ymtics,  Next: yrange,  Prev: ylabel,  Up: set-show
+
+3.33.136 ymtics
+---------------
+
+The *note ymtics:: command changes tics on the y axis to months of the
+year.  Please see *note xmtics:: for details.
+
+
+File: gnuplot.info,  Node: yrange,  Next: ytics,  Prev: ymtics,  Up: set-show
+
+3.33.137 yrange
+---------------
+
+The *note yrange:: command sets the vertical range that will be
+displayed on the y axis.  Please see *note xrange:: for details.
+
+
+File: gnuplot.info,  Node: ytics,  Next: yzeroaxis,  Prev: yrange,  Up: set-show
+
+3.33.138 ytics
+--------------
+
+The *note ytics:: command controls major (labeled) tics on the y axis.
+Please see 'set xtics' for details.
+
+
+File: gnuplot.info,  Node: yzeroaxis,  Next: zdata,  Prev: ytics,  Up: set-show
+
+3.33.139 yzeroaxis
+------------------
+
+The *note yzeroaxis:: command draws a line at x = 0.  For details,
+please see *note zeroaxis::.
+
+
+File: gnuplot.info,  Node: zdata,  Next: zdtics,  Prev: yzeroaxis,  Up: set-show
+
+3.33.140 zdata
+--------------
+
+The *note zdata:: command sets zaxis data to timeseries (dates/times).
+Please see *note xdata::.
+
+
+File: gnuplot.info,  Node: zdtics,  Next: zzeroaxis,  Prev: zdata,  Up: set-show
+
+3.33.141 zdtics
+---------------
+
+The *note zdtics:: command changes tics on the z axis to days of the
+week.  Please see *note xdtics:: for details.
+
+
+File: gnuplot.info,  Node: zzeroaxis,  Next: cbdata,  Prev: zdtics,  Up: set-show
+
+3.33.142 zzeroaxis
+------------------
+
+The *note zzeroaxis:: command draws a line through (x=0,y=0).  This has
+no effect on 2D plots, including splot with 'set view map'.  For
+details, please see *note zeroaxis:: and *note xyplane::.
+
+
+File: gnuplot.info,  Node: cbdata,  Next: cbdtics,  Prev: zzeroaxis,  Up: set-show
+
+3.33.143 cbdata
+---------------
+
+Set color box axis data to timeseries (dates/times).  Please see *note
+xdata::.
+
+
+File: gnuplot.info,  Node: cbdtics,  Next: zero,  Prev: cbdata,  Up: set-show
+
+3.33.144 cbdtics
+----------------
+
+The *note cbdtics:: command changes tics on the color box axis to days
+of the week.  Please see *note xdtics:: for details.
+
+
+File: gnuplot.info,  Node: zero,  Next: zeroaxis,  Prev: cbdtics,  Up: set-show
+
+3.33.145 zero
+-------------
+
+The 'zero' value is the default threshold for values approaching 0.0.
+
+   Syntax:
+           set zero <expression>
+           show zero
+
+
+   'gnuplot' will not plot a point if its imaginary part is greater in
+magnitude than the 'zero' threshold.  This threshold is also used in
+various other parts of 'gnuplot' as a (crude) numerical-error threshold.
+The default 'zero' value is 1e-8.  'zero' values larger than 1e-3 (the
+reciprocal of the number of pixels in a typical bitmap display) should
+probably be avoided, but it is not unreasonable to set 'zero' to 0.0.
+
+
+File: gnuplot.info,  Node: zeroaxis,  Next: zlabel,  Prev: zero,  Up: set-show
+
+3.33.146 zeroaxis
+-----------------
+
+The x axis may be drawn by *note xzeroaxis:: and removed by *note
+xzeroaxis::.  Similar commands behave similarly for the y, x2, y2, and z
+axes.  'set zeroaxis ...'  (no prefix) acts on the x, y, and z axes
+jointly.
+
+   Syntax:
+           set {x|x2|y|y2|z}zeroaxis { {linestyle | ls <line_style>}
+                                      | {linetype | lt <line_type>}
+                                        {linewidth | lw <line_width>}
+                                        {linecolor | lc <colorspec>}
+                                        {dashtype | dt <dashtype>} }
+           unset {x|x2|y|y2|z}zeroaxis
+           show {x|y|z}zeroaxis
+
+
+   By default, these options are off.  The selected zero axis is drawn
+with a line of type <line_type>, width <line_width>, color <colorspec>,
+and dash type <dashtype> (if supported by the terminal driver currently
+in use), or a user-defined style <line_style> (see 'set style line').
+
+   If no linetype is specified, any zero axes selected will be drawn
+using the axis linetype (linetype 0).
+
+   Examples:
+
+   To simply have the y=0 axis drawn visibly:
+
+            set xzeroaxis
+
+
+   If you want a thick line in a different color or pattern, instead:
+
+            set xzeroaxis linetype 3 linewidth 2.5
+
+
+
+File: gnuplot.info,  Node: zlabel,  Next: zmtics,  Prev: zeroaxis,  Up: set-show
+
+3.33.147 zlabel
+---------------
+
+This command sets the label for the z axis.  Please see *note xlabel::.
+
+
+File: gnuplot.info,  Node: zmtics,  Next: zrange,  Prev: zlabel,  Up: set-show
+
+3.33.148 zmtics
+---------------
+
+The *note zmtics:: command changes tics on the z axis to months of the
+year.  Please see *note xmtics:: for details.
+
+
+File: gnuplot.info,  Node: zrange,  Next: ztics,  Prev: zmtics,  Up: set-show
+
+3.33.149 zrange
+---------------
+
+The *note zrange:: command sets the range that will be displayed on the
+z axis.  The zrange is used only by 'splot' and is ignored by 'plot'.
+Please see *note xrange:: for details.
+
+
+File: gnuplot.info,  Node: ztics,  Next: cblabel,  Prev: zrange,  Up: set-show
+
+3.33.150 ztics
+--------------
+
+The *note ztics:: command controls major (labeled) tics on the z axis.
+Please see 'set xtics' for details.
+
+
+File: gnuplot.info,  Node: cblabel,  Next: cbmtics,  Prev: ztics,  Up: set-show
+
+3.33.151 cblabel
+----------------
+
+This command sets the label for the color box axis.  Please see *note
+xlabel::.
+
+
+File: gnuplot.info,  Node: cbmtics,  Next: cbrange,  Prev: cblabel,  Up: set-show
+
+3.33.152 cbmtics
+----------------
+
+The *note cbmtics:: command changes tics on the color box axis to months
+of the year.  Please see *note xmtics:: for details.
+
+
+File: gnuplot.info,  Node: cbrange,  Next: cbtics,  Prev: cbmtics,  Up: set-show
+
+3.33.153 cbrange
+----------------
+
+The *note cbrange:: command sets the range of values which are colored
+using the current *note palette:: by styles 'with pm3d', 'with image'
+and *note palette::.  Values outside of the color range use color of the
+nearest extreme.
+
+   If the cb-axis is autoscaled in 'splot', then the colorbox range is
+taken from *note zrange::.  Points drawn in 'splot ...  pm3d|palette'
+can be filtered by using different *note zrange:: and *note cbrange::.
+
+   Please see *note xrange:: for details on *note cbrange:: syntax.  See
+also *note palette:: and 'set colorbox'.
+
+
+File: gnuplot.info,  Node: cbtics,  Prev: cbrange,  Up: set-show
+
+3.33.154 cbtics
+---------------
+
+The *note cbtics:: command controls major (labeled) tics on the color
+box axis.  Please see 'set xtics' for details.
+
+
+File: gnuplot.info,  Node: shell,  Next: show,  Prev: set-show,  Up: Commands
+
+3.34 shell
+==========
+
+The *note shell:: command spawns an interactive shell.  To return to
+'gnuplot', type *note exit:: or the END-OF-FILE character if using Unix,
+or *note exit:: if using MS-DOS or OS/2.
+
+   The *note shell:: command ignores anything else on the gnuplot
+command line.  If instead you want to pass a command string to a shell
+for immediate execution, use the *note system:: function or the shortcut
+'!'.  See *note system::.
+
+   Examples:
+
+           shell
+           system "print previous_plot.ps"
+           ! print previous_plot.ps
+           current_time = system("date")
+
+
+
+File: gnuplot.info,  Node: show,  Next: splot,  Prev: shell,  Up: Commands
+
+3.35 show
+=========
+
+Most 'set' commands have a corresponding show command with no special
+options.  For example
+          show linetype 3
+
+   will report the current properties in effect from previous commands
+like
+          set linetype 3 linewidth 2 dashpattern '.-'
+
+   A few 'show' commands that diverge from this pattern are documented
+separately.
+
+* Menu:
+
+* show_colornames::
+* show_functions::
+* show_palette::
+* show_plot::
+* show_variables::
+
+
+File: gnuplot.info,  Node: show_colornames,  Next: show_functions,  Prev: show,  Up: show
+
+3.35.1 show colornames
+----------------------
+
+Gnuplot knows about 100 colors by name (see *note colornames::).  You
+can dump a list of these to the terminal by using the command *note
+colornames::.  There is currently no way to set new names.
+
+
+File: gnuplot.info,  Node: show_functions,  Next: show_palette,  Prev: show_colornames,  Up: show
+
+3.35.2 show functions
+---------------------
+
+The *note functions:: command lists all user-defined functions and their
+definitions.
+
+   Syntax:
+           show functions
+
+
+   For information about the definition and usage of functions in
+'gnuplot', please see 'expressions'.  See also splines as user defined
+functions (spline.dem) (http://www.gnuplot.info/demo/spline.html) and
+use of functions and complex variables for airfoils (airfoil.dem).
+(http://www.gnuplot.info/demo/airfoil.html)
+
+
+File: gnuplot.info,  Node: show_palette,  Next: show_plot,  Prev: show_functions,  Up: show
+
+3.35.3 show palette
+-------------------
+
+Syntax:
+           show palette
+           show palette palette {<ncolors>} {{float | int | hex}}
+           show palette gradient
+           show palette rgbformulae
+           test palette
+
+
+   The *note palette:: command will plot the R,G,B profiles for the
+current palette and store the profile values in a datablock $PALETTE.
+
+* Menu:
+
+* show_palette_gradient::
+* show_palette_palette::
+* show_palette_rgbformulae::
+
+
+File: gnuplot.info,  Node: show_palette_gradient,  Next: show_palette_palette,  Prev: show_palette,  Up: show_palette
+
+3.35.3.1 show palette gradient
+..............................
+
+'show palette gradient' displays the piecewise gradient established by a
+prior *note defined:: command.  If the current palette is based on
+rgbformulae or a set of predefined values then this command does
+nothing.
+
+
+File: gnuplot.info,  Node: show_palette_palette,  Next: show_palette_rgbformulae,  Prev: show_palette_gradient,  Up: show_palette
+
+3.35.3.2 show palette palette
+.............................
+
+           show palette palette {<ncolors>} {{float | int | hex}}
+
+
+   'show palette palette <n>' prints to the screen or to the file given
+by 'set print' a table of color components for each entry in the current
+palette.  By default the continuous palette is sampled in 128
+increments.  Specifying <ncolors> will sample the palette evenly at this
+number of increments (rather than 128).  The default is a long listing
+in the form
+          0. gray=0.0000, (r,g,b)=(0.0000,0.0000,0.0000), #000000 =   0   0   0
+          1. gray=0.1111, (r,g,b)=(0.3333,0.0014,0.6428), #5500a4 =  85   0 164
+          2. gray=0.2222, (r,g,b)=(0.4714,0.0110,0.9848), #7803fb = 120   3 251
+          ...
+
+   An optional trailing keyword *note float::, 'int', or 'hex' instead
+prints only single representation of the color components per entry:
+             int:        85       0     164
+           float:    0.3333  0.0014  0.6428
+             hex:  0x5500a4
+
+
+   By using 'set print' to direct this output to a file, the current
+gnuplot color palette can be loaded into other imaging applications such
+as Octave.
+
+   By using 'set print' to direct output to a datablock, the current
+palette can be saved so that it is available to future plot commands
+even if the active palette is redefined.  This allows creating plots
+that draw from multiple palettes, although the colorbox still represents
+only the current active palette.
+
+
+File: gnuplot.info,  Node: show_palette_rgbformulae,  Prev: show_palette_palette,  Up: show_palette
+
+3.35.3.3 show palette rgbformulae
+.................................
+
+*note rgbformulae:: prints the available fixed gray -> color
+transformation formulae.  It does _not_ show the state of the current
+palette.
+
+
+File: gnuplot.info,  Node: show_plot,  Next: show_variables,  Prev: show_palette,  Up: show
+
+3.35.4 show plot
+----------------
+
+The 'show plot' command shows the most recent plotting command as it
+results from the last 'plot' and/or 'splot' and possible subsequent
+*note replot:: commands.
+
+   In addition, the 'show plot add2history' command adds this current
+plot command into the *note history::.  It is useful if you have used
+*note replot:: to add more curves to the current plot and you want to
+edit the whole command now.
+
+
+File: gnuplot.info,  Node: show_variables,  Prev: show_plot,  Up: show
+
+3.35.5 show variables
+---------------------
+
+The 'show variables' command lists the current value of user-defined and
+internal variables.  Gnuplot internally defines variables whose names
+begin with GPVAL_, MOUSE_, FIT_, and TERM_.
+
+   Syntax:
+           show variables      # show variables that do not begin with GPVAL_
+           show variables all  # show all variables including those beginning GPVAL_
+           show variables NAME # show only variables beginning with NAME
+
+
+
+File: gnuplot.info,  Node: splot,  Next: stats_(Statistical_Summary),  Prev: show,  Up: Commands
+
+3.36 splot
+==========
+
+'splot' is the command for drawing 3D plots (well, actually projections
+on a 2D surface, but you knew that).  It is the 3D equivalent of the
+'plot' command.  'splot' provides only a single x, y, and z axis; there
+is no equivalent to the x2 and y2 secondary axes provided by 'plot'.
+
+   See the 'plot' command for many options available in both 2D and 3D
+plots.
+
+   Syntax:
+           splot {<ranges>}
+                 {<iteration>}
+                 <function> | {{<file name> | <datablock name>} {datafile-modifiers}}
+                            | <voxelgridname>
+                            | keyentry
+                 {<title-spec>} {with <style>}
+                 {, {definitions{,}} <function> ...}
+
+
+   The 'splot' command operates on a data generated by a function, read
+from a data file, or stored previously in a named data block.  Data file
+names are usually provided as a quoted string.  The function can be a
+mathematical expression, or a triple of mathematical expressions in
+parametric mode.
+
+   Starting in version 5.4 'splot' can operate on voxel data.  See
+'voxel-grids', *note vgrid::, *note vxrange::.  At present voxel grids
+can be be plotted using styles *note dots::, 'with points', or *note
+isosurface::.  Voxel grid values can also be referenced in the 'using'
+specifiers of other plot styles, for example to assign colors.
+
+   By default 'splot' draws the xy plane completely below the plotted
+data.  The offset between the lowest ztic and the xy plane can be
+changed by *note xyplane::.  The orientation of a 'splot' projection is
+controlled by *note view::.  See *note view:: and *note xyplane:: for
+more information.
+
+   The syntax for setting ranges on the 'splot' command is the same as
+for 'plot'.  In non-parametric mode, ranges must be given in the order
+           splot [<xrange>][<yrange>][<zrange>] ...
+
+   In parametric mode, the order is
+           splot [<urange>][<vrange>][<xrange>][<yrange>][<zrange>] ...
+
+
+   The *note title:: option is the same as in 'plot'.  The operation of
+'with' is also the same as in 'plot' except that not all 2D plotting
+styles are available.
+
+   The *note datafile:: options have more differences.
+
+   As an alternative to surfaces drawn using parametric or function
+mode, the pseudo-file '++' can be used to generate samples on a grid in
+the xy plane.
+
+   See also 'show plot', 'set view map', and *note sampling::.
+
+* Menu:
+
+* data-file::
+* grid_data::
+* splot_surfaces::
+* voxel-grid::
+
+
+File: gnuplot.info,  Node: data-file,  Next: grid_data,  Prev: splot,  Up: splot
+
+3.36.1 data-file
+----------------
+
+'Splot', like 'plot', can display from a file.
+
+   Syntax:
+           splot '<file_name>' {binary <binary list>}
+                               {{nonuniform|sparse} matrix}
+                               {index <index list>}
+                               {every <every list>}
+                               {using <using list>}
+
+
+   The special filenames '""' and '"-"' are permitted, as in 'plot'.
+See *note special-filenames::.
+
+   Keywords *note binary:: and *note matrix:: indicate that the data are
+in a special form, *note index:: selects which data sets in a
+multi-data-set file are plotted, *note every:: specifies a subset of
+lines within a single data set, 'using' determines how the columns
+within a single record are interpreted.
+
+   The options *note index:: and *note every:: behave the same way as
+with 'plot'; 'using' does so also, except that the 'using' list must
+provide three entries instead of two.
+
+   The 'plot' option *note smooth:: is not available for 'splot', but
+*note cntrparam:: and *note dgrid3d:: provide limited smoothing
+capabilities.
+
+   Data file organization is essentially the same as for 'plot', except
+that each point is an (x,y,z) triple.  If only a single value is
+provided, it will be used for z, the block number will be used for y,
+and the index of the data point in the block will be used for x.  If two
+or four values are provided, 'gnuplot' uses the last value for
+calculating the color in pm3d plots.  Three values are interpreted as an
+(x,y,z) triple.  Additional values are generally used as errors, which
+can be used by *note fit::.
+
+   Single blank records separate blocks of data in a 'splot' datafile;
+'splot' treats blocks as the equivalent of function y-isolines.  No line
+will join points separated by a blank record.  If all blocks contain the
+same number of points, 'gnuplot' will draw cross-isolines between points
+in the blocks, connecting corresponding points.  This is termed "grid
+data", and is required for drawing a surface, for contouring ('set
+contour') and hidden-line removal (*note hidden3d::).  See also 'splot
+grid_data'.
+
+* Menu:
+
+* matrix::
+* example_datafile_::
+
+
+File: gnuplot.info,  Node: matrix,  Next: example_datafile_,  Prev: data-file,  Up: data-file
+
+3.36.1.1 matrix
+...............
+
+Matrix data can be input in several formats ('uniform', 'nonuniform',
+'sparse') from either text or binary files.
+
+   The first variant assumes a uniform grid of x and y coordinates and
+assigns each value in the input matrix to one element M[i,j] of this
+uniform grid.  The assigned x coordinates are the integers [0:NCOLS-1].
+The assigned y coordinates are the integers [0:NROWS-1].  This is the
+default for text data input, but not for binary input.  See 'uniform'
+for examples and additional keywords.
+
+   The second variant handles a non-uniform grid with explicit x and y
+coordinates.  The first row of input data contains the y coordinates;
+the first column of input data contains the x coordinates.  For binary
+input data, the first element of the first row must contain the number
+of columns.  This is the default for *note matrix:: input, but requires
+an additional keyword 'nonuniform' for text input data.  See
+'nonuniform' for examples.
+
+   The *note matrix:: variant defines a uniform grid into which any
+number of individual point values are read from the input file, one per
+line, in any order.  This is primarily intended for the generation of
+heatmaps from incomplete data.  See 'sparse' for examples.
+
+-- UNIFORM MATRIX --
+
+   Example commands for plotting uniform matrix data:
+          splot 'file' matrix using 1:2:3          # text input
+          splot 'file' binary general using 1:2:3  # binary input
+
+
+   In a uniform grid matrix the z-values are read in a row at a time, i.
+e.,
+         z11 z12 z13 z14 ...
+         z21 z22 z23 z24 ...
+         z31 z32 z33 z34 ...
+
+   and so forth.
+
+   For text input, if the first row contains column labels rather than
+data, use the additional keyword *note columnheaders::.  Similarly if
+the first field in each row contains a label rather than data, use the
+additional keyword 'rowheaders'.  Here is an example that uses both:
+         $DATA << EOD
+         xxx A   B   C   D
+         aa  z11 z12 z13 z14
+         bb  z21 z22 z23 z24
+         cc  z31 z32 z33 z34
+         EOD
+         plot $DATA matrix columnheaders rowheaders with image
+
+
+   For text input, a blank line or comment line ends the matrix, and
+starts a new data block.  You can select among the data blocks in a file
+by the *note index:: option to the 'splot' command, as usual.  The
+columnheaders option, if present, is applied only to the first data
+block.
+
+-- NONUNIFORM MATRIX --
+
+   The first row of input data contains the y coordinates.  The first
+column of input data contains the x coordinates.  For binary input data,
+the first field of the first row must contain the number of columns.
+(This number is ignored for text input).
+
+   Example commands for plotting non-uniform matrix data:
+          splot 'file' nonuniform matrix using 1:2:3  # text input
+          splot 'file' binary matrix using 1:2:3      # binary input
+
+
+   Thus the data organization for non-uniform matrix input is
+
+           <N+1>  <x0>   <x1>   <x2>  ...  <xN>
+            <y0> <z0,0> <z0,1> <z0,2> ... <z0,N>
+            <y1> <z1,0> <z1,1> <z1,2> ... <z1,N>
+             :      :      :      :   ...    :
+
+
+   which is then converted into triplets:
+           <x0> <y0> <z0,0>
+           <x0> <y1> <z0,1>
+           <x0> <y2> <z0,2>
+            :    :     :
+           <x0> <yN> <z0,N>
+
+
+           <x1> <y0> <z1,0>
+           <x1> <y1> <z1,1>
+            :    :     :
+
+
+   These triplets are then converted into 'gnuplot' iso-curves and then
+'gnuplot' proceeds in the usual manner to do the rest of the plotting.
+
+-- SPARSE MATRIX --
+
+   Syntax:
+           sparse matrix=(cols,rows) origin=(x0,y0) dx=<delx> dy=<dely>
+
+   The 'sparse' matrix variant defines a uniform grid as part of the
+'plot' or 'splot' command line.  The grid is initially empty.  Any
+number of individual points are then read from the input file, one per
+line, and assigned to the nearest grid point.  I.e.  a data line
+           x y value
+
+   is evaluated as
+           i = (x - x0) / delx
+           j = (y - y0) / dely
+           matrix[i,j] = value
+
+   The size of the matrix is required.  *note origin:: (optional)
+defaults to origin=(0,0).  'dx' (optional) defaults to dx=1.  'dy'
+(optional) defaults to dy=dx.
+
+   The intended use of this variant is to generate heatmaps from
+unordered, possibly incomplete, data using the 'image', *note
+rgbimage::, or *note rgbalpha:: plot styles.  The example below
+generates a distance matrix in the form of a 4x4 heatmap with only the
+upper triangle elements present:
+           $DATA << EOD
+           1 1 10
+           1 2 20
+           1 3 30
+           1 4 40
+           2 2 10
+           2 3 50
+           2 4 60
+           3 3 10
+           3 4 20
+           4 4 10
+           EOD
+           plot $DATA sparse matrix=(4,4) origin=(1,1) with image
+
+
+-- EVERY --
+
+   The *note every:: keyword has special meaning when used with matrix
+data.  Rather than applying to blocks of single points, it applies to
+rows and column values.  Note that matrix rows and columns are indexed
+starting from 0, so the row with index N is the (N+1)th row.  Syntax:
+           plot 'file' matrix every {<column_incr>}
+                                    {:{<row_incr>}
+                                      {:{<start_column>}
+                                        {:{<start_row>}
+                                          {:{<end_column>}
+                                            {:<end_row>}}}}}
+
+   Examples:
+           plot 'file' matrix every :::N::N   # plot all values in row with index N
+           plot 'file' matrix every ::3::7    # plot columns 3 to 7 for all rows
+           plot 'file' matrix every ::3:0:7:4 # submatrix bounded by [3,0] and [7,4]
+
+
+-- EXAMPLES --
+
+   A collection of matrix and vector manipulation routines (in C) is
+provided in 'binary.c'.  The routine to write binary data is
+
+           int fwrite_matrix(file,m,nrl,nrl,ncl,nch,row_title,column_title)
+
+
+   An example of using these routines is provided in the file
+'bf_test.c', which generates binary files for the demo file
+'demo/binary.dem'.
+
+   Usage in 'plot':
+         plot 'a.dat' matrix
+         plot 'a.dat' matrix using 1:3
+         plot 'a.gpbin' {matrix} binary using 1:3
+
+   will plot rows of the matrix, while using 2:3 will plot matrix
+columns, and using 1:2 the point coordinates (rather useless).  Applying
+the *note every:: option you can specify explicit rows and columns.
+
+   Example - rescale axes of a matrix in a text file:
+         splot `a.dat` matrix using (1+$1):(1+$2*10):3
+
+
+   Example - plot the 3rd row of a matrix in a text file:
+         plot 'a.dat' matrix using 1:3 every 1:999:1:2
+
+   (rows are enumerated from 0, thus 2 instead of 3).
+
+   Gnuplot can read matrix binary files by use of the option *note
+binary:: appearing without keyword qualifications unique to general
+binary, i.e., 'array', *note record::, 'format', or *note filetype::.
+Other general binary keywords for translation should also apply to
+matrix binary.  (See *note general:: for more details.)
+
+
+File: gnuplot.info,  Node: example_datafile_,  Prev: matrix,  Up: data-file
+
+3.36.1.2 example datafile
+.........................
+
+A simple example of plotting a 3D data file is
+
+           splot 'datafile.dat'
+
+
+   where the file "datafile.dat" might contain:
+
+           # The valley of the Gnu.
+              0 0 10
+              0 1 10
+              0 2 10
+
+
+              1 0 10
+              1 1 5
+              1 2 10
+
+
+              2 0 10
+              2 1 1
+              2 2 10
+
+
+              3 0 10
+              3 1 0
+              3 2 10
+
+
+   Note that "datafile.dat" defines a 4 by 3 grid ( 4 rows of 3 points
+each ).  Rows (blocks) are separated by blank records.
+
+   Note also that the x value is held constant within each dataline.  If
+you instead keep y constant, and plot with hidden-line removal enabled,
+you will find that the surface is drawn 'inside-out'.
+
+   Actually for grid data it is not necessary to keep the x values
+constant within a block, nor is it necessary to keep the same sequence
+of y values.  'gnuplot' requires only that the number of points be the
+same for each block.  However since the surface mesh, from which
+contours are derived, connects sequentially corresponding points, the
+effect of an irregular grid on a surface plot is unpredictable and
+should be examined on a case-by-case basis.
+
+
+File: gnuplot.info,  Node: grid_data,  Next: splot_surfaces,  Prev: data-file,  Up: splot
+
+3.36.2 grid data
+----------------
+
+The 3D routines are designed for points in a grid format, with one
+sample, datapoint, at each mesh intersection; the datapoints may
+originate from either evaluating a function, see *note isosamples::, or
+reading a datafile, see *note datafile::.  The term "isoline" is applied
+to the mesh lines for both functions and data.  Note that the mesh need
+not be rectangular in x and y, as it may be parameterized in u and v,
+see *note isosamples::.
+
+   However, 'gnuplot' does not require that format.  In the case of
+functions, 'samples' need not be equal to 'isosamples', i.e., not every
+x-isoline sample need intersect a y-isoline.  In the case of data files,
+if there are an equal number of scattered data points in each block,
+then "isolines" will connect the points in a block, and "cross-isolines"
+will connect the corresponding points in each block to generate a
+"surface".  In either case, contour and hidden3d modes may give
+different plots than if the points were in the intended format.
+
+   Scattered data can be fit to a grid before plotting.  See *note
+dgrid3d::.
+
+   The contour code tests for z intensity along a line between a point
+on a y-isoline and the corresponding point in the next y-isoline.  Thus
+a 'splot' contour of a surface with samples on the x-isolines that do
+not coincide with a y-isoline intersection will ignore such samples.
+Try:
+            set xrange [-pi/2:pi/2]; set yrange [-pi/2:pi/2]
+            set style function lp
+            set contour
+            set isosamples 10,10; set samples 10,10;
+            splot cos(x)*cos(y)
+            set samples 4,10; replot
+            set samples 10,4; replot
+
+
+
+File: gnuplot.info,  Node: splot_surfaces,  Next: voxel-grid,  Prev: grid_data,  Up: splot
+
+3.36.3 splot surfaces
+---------------------
+
+'splot' can display a surface as a collection of points, or by
+connecting those points.  As with 'plot', the points may be read from a
+data file or result from evaluation of a function at specified
+intervals, see *note isosamples::.  The surface may be approximated by
+connecting the points with straight line segments, see 'set surface', in
+which case the surface can be made opaque with 'set hidden3d.'  The
+orientation from which the 3d surface is viewed can be changed with
+*note view::.
+
+   Additionally, for points in a grid format, 'splot' can interpolate
+points having a common amplitude (see 'set contour') and can then
+connect those new points to display contour lines, either directly with
+straight-line segments or smoothed lines (see *note cntrparam::).
+Functions are already evaluated in a grid format, determined by *note
+isosamples:: and *note samples::, while file data must either be in a
+grid format, as described in *note data-file::, or be used to generate a
+grid (see *note dgrid3d::).
+
+   Contour lines may be displayed either on the surface or projected
+onto the base.  The base projections of the contour lines may be written
+to a file, and then read with 'plot', to take advantage of 'plot''s
+additional formatting capabilities.
+
+
+File: gnuplot.info,  Node: voxel-grid,  Prev: splot_surfaces,  Up: splot
+
+3.36.4 voxel-grid
+-----------------
+
+Syntax:
+          splot $voxelgridname with {dots|points} {above <threshold>} ...
+          splot $voxelgridname with isosurface {level <threshold>} ...
+
+
+   Voxel data can be plotted with dots or points marking individual
+voxels whose value is above the specified threshold value (default
+threshold = 0).  Color/pointtype/linewidth properties can be appended as
+usual.
+
+   At many view angles the voxel grid points will occlude each other or
+create Moiré artifacts on the display.  These effects can be avoided by
+introducing jitter so that the displayed dot or point is displaced
+randomly from the true voxel grid coordinate.  See *note jitter::.
+
+   Dense voxel grids can be down-sampled by using the 'pointinterval'
+property ('pi' for short) to reduce the number of points drawn.
+          splot $vgrid with points pointtype 6 pointinterval 2
+
+
+   *note isosurface:: will create a tessellated surface in 3D enclosing
+all voxels with value greater than the requested threshold.  The surface
+placement is adjusted by linear interpolation to pass through the
+threshold value itself.
+
+   See *note vgrid::, *note vfill::.  See demos 'vplot.dem',
+'isosurface.dem'.
+
+
+File: gnuplot.info,  Node: stats_(Statistical_Summary),  Next: system_,  Prev: splot,  Up: Commands
+
+3.37 stats (Statistical Summary)
+================================
+
+Syntax:
+          stats {<ranges>} 'filename' {matrix | using N{:M}} {name 'prefix'} {{no}output}
+          stats $voxelgridname {name 'prefix'}
+
+
+   This command prepares a statistical summary of the data in one or two
+columns of a file.  The using specifier is interpreted in the same way
+as for plot commands.  See 'plot' for details on the *note index::,
+*note every::, and 'using' directives.  Data points are filtered against
+both xrange and yrange before analysis.  See *note xrange::.  The
+summary is printed to the screen by default.  Output can be redirected
+to a file by prior use of the command 'set print', or suppressed
+altogether using the 'nooutput' option.
+
+   If the file cannot be found or cannot be read, a non-fatal warning is
+issued.  This can be used to test for the existence of a file without
+generating a program error.  See 'stats test'.
+
+   In addition to printed output, the program stores the individual
+statistics into three sets of variables.  The first set of variables
+reports how the data is laid out in the file.  The array of column
+headers is generated only if option *note columnheaders:: is in effect:
+
+          STATS_records           # total number N of in-range data records
+          STATS_outofrange        # number of records filtered out by range limits
+          STATS_invalid           # number of invalid/incomplete/missing records
+          STATS_blank             # number of blank lines in the file
+          STATS_blocks            # number of indexable blocks of data in the file
+          STATS_columns           # number of data columns in the first row of data
+          STATS_column_header     # array of strings holding column headers found
+
+
+   The second set reports properties of the in-range data from a single
+column.  This column is treated as y.  If the y axis is autoscaled then
+no range limits are applied.  Otherwise only values in the range
+[ymin:ymax] are considered.
+
+   If two columns are analysed jointly by a single 'stats' command, the
+suffix "_x" or "_y" is appended to each variable name.  I.e.
+STATS_min_x is the minimum value found in the first column, while
+STATS_min_y is the minimum value found in the second column.  In this
+case points are filtered by testing against both xrange and yrange.
+
+          STATS_min               # minimum value of in-range data points
+          STATS_max               # maximum value of in-range data points
+          STATS_index_min         # index i for which data[i] == STATS_min
+          STATS_index_max         # index i for which data[i] == STATS_max
+          STATS_lo_quartile       # value of the lower (1st) quartile boundary
+          STATS_median            # median value
+          STATS_up_quartile       # value of the upper (3rd) quartile boundary
+          STATS_mean              # mean value of the in-range data points
+          STATS_ssd               # sample standard deviation of the in-range data
+                                       = sqrt( Sum[(y-ymean)^2] / (N-1) )
+          STATS_stddev            # population standard deviation of the in-range data
+                                       = sqrt( Sum[(y-ymean)^2] / N )
+          STATS_sum               # sum
+          STATS_sumsq             # sum of squares
+          STATS_skewness          # skewness of the in-range data points
+          STATS_kurtosis          # kurtosis of the in-range data points
+          STATS_adev              # mean absolute deviation of the in-range data points
+          STATS_mean_err          # standard error of the mean value
+          STATS_stddev_err        # standard error of the standard deviation
+          STATS_skewness_err      # standard error of the skewness
+          STATS_kurtosis_err      # standard error of the kurtosis
+
+
+   The third set of variables is only relevant to analysis of two data
+columns.
+
+          STATS_correlation       # sample correlation coefficient between x and y values
+          STATS_slope             # A corresponding to a linear fit y = Ax + B
+          STATS_slope_err         # uncertainty of A
+          STATS_intercept         # B corresponding to a linear fit y = Ax + B
+          STATS_intercept_err     # uncertainty of B
+          STATS_sumxy             # sum of x*y
+          STATS_pos_min_y         # x coordinate of a point with minimum y value
+          STATS_pos_max_y         # x coordinate of a point with maximum y value
+
+
+   Keyword *note matrix:: indicates that the input consists of a matrix
+(see *note matrix::); the usual statistics are generated by considering
+all matrix elements.  The matrix dimensions are saved in variables
+STATS_size_x and STATS_size_y.
+
+          STATS_size_x            # number of matrix columns
+          STATS_size_y            # number of matrix rows
+
+
+   The index reported in STATS_index_xxx corresponds to the value of
+pseudo-column 0 ($0) in plot commands.  I.e.  the first point has index
+0, the last point has index N-1.
+
+   Data values are sorted to find the median and quartile boundaries.
+If the total number of points N is odd, then the median value is taken
+as the value of data point (N+1)/2.  If N is even, then the median is
+reported as the mean value of points N/2 and (N+2)/2.  Equivalent
+treatment is used for the quartile boundaries.
+
+   For an example of using the 'stats' command to annotate a subsequent
+plot, see stats.dem.  (http://www.gnuplot.info/demo/stats.html)
+
+   The 'stats' command in this version of gnuplot can handle log-scaled
+data, but not the content of time/date fields ('set xdata time' or 'set
+ydata time').  This restriction may be relaxed in a future version.
+
+* Menu:
+
+* name::
+* test_for_existence_of_a_file::
+* voxelgrid::
+
+
+File: gnuplot.info,  Node: name,  Next: test_for_existence_of_a_file,  Prev: stats_(Statistical_Summary),  Up: stats_(Statistical_Summary)
+
+3.37.1 name
+-----------
+
+It may be convenient to track the statistics from more than one file or
+data column in parallel.  The *note name:: option causes the default
+prefix "STATS" to be replaced by a user-specified string.  For example,
+the mean value of column 2 data from two different files could be
+compared by
+          stats "file1.dat" using 2 name "A"
+          stats "file2.dat" using 2 name "B"
+          if (A_mean < B_mean) {...}
+
+
+   Instead of providing a string constant as the name, the keyword
+'columnheader' or function 'columnheader(N)' can be used to generate the
+name from whatever string is found in that column in the first row of
+the data file:
+          do for [COL=5:8] { stats 'datafile' using COL name columnheader }
+
+
+
+File: gnuplot.info,  Node: test_for_existence_of_a_file,  Next: voxelgrid,  Prev: name,  Up: stats_(Statistical_Summary)
+
+3.37.2 test for existence of a file
+-----------------------------------
+
+Trying to plot a nonexistent or unreadable file will generate an error
+that halts the progress of a script or iteration.  The stats command can
+be used to avoid this as in the example below
+          do for [i=first:last] {
+              filename = sprintf("file%02d.dat", i)
+              stats filename nooutput
+              if (GPVAL_ERRNO) {
+                  print GPVAL_ERRMSG
+                  continue
+              }
+              plot filename title filename
+          }
+
+
+
+File: gnuplot.info,  Node: voxelgrid,  Prev: test_for_existence_of_a_file,  Up: stats_(Statistical_Summary)
+
+3.37.3 voxelgrid
+----------------
+
+          stats $vgridname {name "prefix"}
+
+   The stats command can be used to interrogate the content of a voxel
+grid.  It yields the same information as *note vgrid:: but saves it in
+variables accessible for use in a script.
+
+          STATS_min               # minimum non-zero value over all voxels in grid
+          STATS_max               # maximum value over all voxels in grid
+          STATS_mean              # mean value of non-zero voxels in grid
+          STATS_stderr            # standard deviation of non-zero voxel values
+          STATS_sum               # sum over all values in grid
+          STATS_nonzero           # number of non-zero voxels
+
+
+
+File: gnuplot.info,  Node: system_,  Next: test,  Prev: stats_(Statistical_Summary),  Up: Commands
+
+3.38 system
+===========
+
+Syntax:
+           system "command string"
+           ! command string
+           output = system("command string")
+           show variable GPVAL_SYSTEM
+
+
+   'system "command"' executes "command" in a subprocess by invoking the
+operating system's default shell.  If called as a function,
+'system("command")' returns the character stream from the subprocess's
+stdout as a string.  One trailing newline is stripped from the resulting
+string if present.  See also 'backquotes'.
+
+   The exit status of the subprocess is reported in variables
+GPVAL_SYSTEM_ERRNO and GPVAL_SYSTEM_ERRMSG. Note that if the command
+string invokes more than one programs, the subprocess may return
+"Success" even if one of the programs produced an error.  E.g.  file =
+system("ls -1 *.plt | tail -1") will return "Success" even if there are
+no *.plt files because 'tail' succeeds even if 'ls' does not.
+
+
+File: gnuplot.info,  Node: test,  Next: toggle,  Prev: system_,  Up: Commands
+
+3.39 test
+=========
+
+This command graphically tests or presents terminal and palette
+capabilities.
+
+   Syntax:
+           test {terminal | palette}
+
+
+   'test' or *note terminal:: creates a display of line and point styles
+and other useful things supported by the *note terminal:: you are
+currently using.
+
+   *note palette:: plots profiles of R(z),G(z),B(z), where 0<=z<=1.
+These are the RGB components of the current color palette as defined by
+*note palette::.  It also plots the apparent net intensity as calculated
+using NTSC coefficients to map RGB onto a grayscale.  The command also
+loads the profile values into a datablock named $PALETTE. D viridis 1
+
+
+File: gnuplot.info,  Node: toggle,  Next: undefine,  Prev: test,  Up: Commands
+
+3.40 toggle
+===========
+
+Syntax:
+           toggle {<plotno> | "plottitle" | all}
+
+
+   This command has the same effect as left-clicking on the key entry
+for a plot currently displayed by an interactive terminal (qt, wxt,
+x11).  If the plot is showing, it is toggled off; if it is currently
+hidden, it is toggled on.  'toggle all' acts on all active plots,
+equivalent to the hotkey "i".  'toggle "title"' requires an exact match
+to the plot title.  'toggle "ti*"' acts on the first plot whose title
+matches the characters before the final '*'.  If the current terminal is
+not interactive, the toggle command has no effect.
+
+
+File: gnuplot.info,  Node: undefine,  Next: unset,  Prev: toggle,  Up: Commands
+
+3.41 undefine
+=============
+
+Clear one or more previously defined user variables.  This is useful in
+order to reset the state of a script containing an initialization test.
+
+   A variable name can contain the wildcard character '*' as last
+character.  If the wildcard character is found, all variables with names
+that begin with the prefix preceding the wildcard will be removed.  This
+is useful to remove several variables sharing a common prefix.  Note
+that the wildcard character is only allowed at the end of the variable
+name!  Specifying the wildcard character as sole argument to 'undefine'
+has no effect.
+
+   Example:
+
+           undefine foo foo1 foo2
+           if (!exists("foo")) load "initialize.gp"
+
+
+           bar = 1; bar1 = 2; bar2 = 3
+           undefine bar*                 # removes all three variables
+
+
+
+File: gnuplot.info,  Node: unset,  Next: update,  Prev: undefine,  Up: Commands
+
+3.42 unset
+==========
+
+Options set using the 'set' command may be returned to their default
+state by the corresponding *note unset:: command.  The *note unset::
+command may contain an optional iteration clause.  See 'plot for'.
+
+   Examples:
+           set xtics mirror rotate by -45 0,10,100
+           ...
+           unset xtics
+
+
+           # Unset labels numbered between 100 and 200
+           unset for [i=100:200] label i
+
+
+* Menu:
+
+* linetype_::
+* monochrome_::
+* output_::
+* terminal_::
+* warnings::
+
+
+File: gnuplot.info,  Node: linetype_,  Next: monochrome_,  Prev: unset,  Up: unset
+
+3.42.1 linetype
+---------------
+
+Syntax:
+           unset linetype N
+
+   Remove all characteristics previously associated with a single
+linetype.  Subsequent use of this linetype will use whatever
+characteristics and color that is native to the current terminal type
+(i.e.  the default linetypes properties available in gnuplot versions
+prior to 4.6).
+
+
+File: gnuplot.info,  Node: monochrome_,  Next: output_,  Prev: linetype_,  Up: unset
+
+3.42.2 monochrome
+-----------------
+
+Switches the active set of linetypes from monochrome to color.
+Equivalent to 'set color'.
+
+
+File: gnuplot.info,  Node: output_,  Next: terminal_,  Prev: monochrome_,  Up: unset
+
+3.42.3 output
+-------------
+
+Because some terminal types allow multiple plots to be written into a
+single output file, the output file is not automatically closed after
+plotting.  In order to print or otherwise use the file safely, it should
+first be closed explicitly by using *note output:: or by using *note
+output:: to close the previous file and then open a new one.
+
+
+File: gnuplot.info,  Node: terminal_,  Next: warnings,  Prev: output_,  Up: unset
+
+3.42.4 terminal
+---------------
+
+The default terminal that is active at the time of program entry depends
+on the system platform, gnuplot build options, and the environmental
+variable GNUTERM. Whatever this default may be, gnuplot saves it to
+internal variable GNUTERM. The *note terminal:: command restores the
+initial terminal type.  It is equivalent to 'set terminal GNUTERM'.
+However if the string in GNUTERM contains terminal options in addition
+to the bare terminal name, you may want to instead use 'set terminal
+@GNUTERM'.
+
+
+File: gnuplot.info,  Node: warnings,  Prev: terminal_,  Up: unset
+
+3.42.5 warnings
+---------------
+
+          set warnings
+          unset warnings
+
+
+   Warning messages for non-fatal errors are normally printed to stderr
+after echoing the file name, line number, and command line that
+triggered the warning.  Warnings may be suppressed by the command *note
+warnings::.  A warning may be generated on demand by the command 'warn
+"message"'.  They remain suppressed until explicitly reenabled by *note
+warnings::.
+
+
+File: gnuplot.info,  Node: update,  Next: vclear,  Prev: unset,  Up: Commands
+
+3.43 update
+===========
+
+Note: This command is DEPRECATED. Use *note fit:: instead.
+
+
+File: gnuplot.info,  Node: vclear,  Next: vfill,  Prev: update,  Up: Commands
+
+3.44 vclear
+===========
+
+Syntax:
+          vclear {$gridname}
+
+   Resets the value of all voxels in an existing grid to zero.  If no
+grid name is given, clears the currently active grid.
+
+
+File: gnuplot.info,  Node: vfill,  Next: warn,  Prev: vclear,  Up: Commands
+
+3.45 vfill
+==========
+
+Syntax:
+          vfill  FILE using x:y:z:radius:(<expression>)
+          vgfill FILE using x:y:z:radius:(<expression>)
+
+
+   The *note vfill:: command acts analogously to a 'plot' command except
+that instead of creating a plot it modifies voxels in the currently
+active voxel grid.  For each point read from the input file, the voxel
+containing that point and also all other voxels within a sphere of given
+radius centered about (x,y,z) are incremented as follows:
+   * user variable VoxelDistance is set to the distance from (x,y,z) to
+     that voxel's origin in user coordinates (vx,vy,vz).
+   * user variable GridDistance is set to the distance from (x,y,z) to
+     that voxel's origin in grid coordinates.
+   * The expression provided in the 5th 'using' specifier is evaluated.
+     This expression can use the new value of VoxelDistance and/or
+     GridDistance.
+   * voxel(vx,vy,vz) += result of evaluating <expression>
+   Examples:
+          vfill "file.dat" using 1:2:3:(3.0):(1.0)
+
+   This command adds 1 to the value of every voxel within a sphere of
+radius 3.0 around each point in file.dat.  The number of voxels that
+this sphere impinges on depends on the grid spacing in user coordinates,
+which may be different along the x, y, and z directions.
+
+          vgfill "file.dat" using 1:2:3:(2):(1.0)
+
+   This command adds 1 to the value of voxels within a 5x5x5 cube of
+voxels centered on the current point.  The radius "2" is interpreted as
+extending exactly 2 voxels in either direction along x, 2 voxels in
+either direction along y, etc, regardless of the relative scaling of
+user coordinates along those axes.
+
+   Example:
+          vfill "file.dat" using 1:2:3:4:(VoxelDistance < 1 ? 1 : 1/VoxelDistance)
+
+   This command modifies all voxels in a sphere whose radius is
+determined for each point by the content of column 4.  The increment
+added to a voxel decreases with its distance from the data point.
+
+   Note that *note vfill:: and 'vgfill' always increments existing
+values in the current voxel grid.  To reset a single voxel to zero, use
+'voxel(x,y,z) = 0'.  To reset the entire grid to zero, use *note
+vclear::.
+
+
+File: gnuplot.info,  Node: warn,  Next: While,  Prev: vfill,  Up: Commands
+
+3.46 warn
+=========
+
+Syntax:
+           warn "message"
+
+   The 'warn' command is essentially the same as *note printerr:: except
+that it prepends the current filename or function block name and the
+current line number before printing the requested message to stderr.
+Unlike *note printerr:: the output from 'warn' is suppressed by *note
+warnings::.
+
+
+File: gnuplot.info,  Node: While,  Prev: warn,  Up: Commands
+
+3.47 While
+==========
+
+Syntax:
+           while (<expr>) {
+               <commands>
+           }
+
+   Execute a block of commands repeatedly so long as <expr> evaluates to
+a non-zero value.  This command cannot be mixed with old-style
+(un-bracketed) if/else statements.  See also 'do', 'continue', 'break'.
+
+
+File: gnuplot.info,  Node: Terminal_types,  Next: Concept_Index,  Prev: Commands,  Up: Top
+
+4 Terminal types
+****************
+
+* Menu:
+
+* complete_list_of_terminals::
+
+
+File: gnuplot.info,  Node: complete_list_of_terminals,  Prev: Terminal_types,  Up: Terminal_types
+
+4.1 complete list of terminals
+==============================
+
+Gnuplot supports a large number of output formats.  These are selected
+by choosing an appropriate terminal type, possibly with additional
+modifying options.  See *note terminal::.
+
+   This document may describe terminal types that are not available to
+you because they were not configured or installed on your system.
+Terminals marked 'legacy' are not built by default in recent gnuplot
+versions and may not actually work.  To see a list of terminals
+available in a particular gnuplot session, type 'set terminal' with no
+modifiers.
+
+   Several terminals are designed for use with TeX/LaTeX document
+preparation.  A summary of TeX-friendly terminals is available here:
+http://www.gnuplot.info/docs/latex_demo.pdf
+(http://www.gnuplot.info/docs/latex_demo.pdf)
+
+* Menu:
+
+* aifm::
+* aqua::
+* be::
+* epscairo::
+* canvas::
+* cgm::
+* context::
+* corel::
+* debug::
+* svga::
+* dumb::
+* dxf::
+* dxy800a::
+* eepic::
+* emf::
+* epson_180dpi::
+* excl::
+* fig::
+* png_::
+* ggi::
+* gpic::
+* grass::
+* hp2623a::
+* hp2648::
+* hp500c::
+* hpgl::
+* hpljii::
+* hppj::
+* imagen::
+* kyo::
+* latex::
+* lua::
+* mf::
+* mp::
+* mif::
+* pbm::
+* dospc::
+* pdf::
+* pstricks::
+* qms::
+* regis::
+* svg::
+* tek410x::
+* tek40::
+* texdraw::
+* tgif::
+* tkcanvas::
+* tpic::
+* windows::
+* wxt::
+* x11::
+* xlib::
+
+
+File: gnuplot.info,  Node: aifm,  Next: aqua,  Prev: complete_list_of_terminals,  Up: complete_list_of_terminals
+
+4.1.1 aifm
+----------
+
+*note terminal::, originally written for Adobe Illustrator 3.0+.  Since
+Adobe Illustrator understands PostScript level 1 commands directly, you
+should use 'set terminal post level1' instead.
+
+   Syntax:
+           set terminal aifm {color|monochrome} {"<fontname>"} {<fontsize>}
+
+
+
+File: gnuplot.info,  Node: aqua,  Next: be,  Prev: aifm,  Up: complete_list_of_terminals
+
+4.1.2 aqua
+----------
+
+This terminal relies on AquaTerm.app for display on MacOS.
+
+   Syntax:
+           set terminal aqua {<n>} {title "<wintitle>"} {size <x> <y>}
+                             {font "<fontname>{,<fontsize>}"}
+                             {linewidth <lw>}"}
+                             {{no}enhanced} {solid|dashed} {dl <dashlength>}}
+
+
+   where <n> is the number of the window to draw in (default is 0),
+<wintitle> is the name shown in the title bar (default "Figure <n>"),
+<x> <y> is the size of the plot (default is 846x594 pt = 11.75x8.25 in).
+
+   Use <fontname> to specify the font (default is "Times-Roman"), and
+<fontsize> to specify the font size (default is 14.0 pt).
+
+   The aqua terminal supports enhanced text mode (see 'enhanced'),
+except for overprint.  Font support is limited to the fonts available on
+the system.  Character encoding can be selected by *note encoding:: and
+currently supports iso_latin_1, iso_latin_2, cp1250, and UTF8 (default).
+
+   Lines can be drawn either solid or dashed, (default is solid) and the
+dash spacing can be modified by <dashlength> which is a multiplier > 0.
+
+
+File: gnuplot.info,  Node: be,  Next: epscairo,  Prev: aqua,  Up: complete_list_of_terminals
+
+4.1.3 be
+--------
+
+The 'be' terminal type is present if gnuplot is built for the 'beos'
+operating system and for use with X servers.  It is selected at program
+startup if the 'DISPLAY' environment variable is set, if the 'TERM'
+environment variable is set to 'xterm', or if the '-display' command
+line option is used.
+
+   Syntax:
+               set terminal be {reset} {<n>}
+
+
+   Multiple plot windows are supported: 'set terminal be <n>' directs
+the output to plot window number n.  If n>0, the terminal number will be
+appended to the window title and the icon will be labeled 'gplt <n>'.
+The active window may distinguished by a change in cursor (from default
+to crosshair.)
+
+   Plot windows remain open even when the 'gnuplot' driver is changed to
+a different device.  A plot window can be closed by pressing the letter
+q while that window has input focus, or by choosing 'close' from a
+window manager menu.  All plot windows can be closed by specifying *note
+reset::, which actually terminates the subprocess which maintains the
+windows (unless '-persist' was specified).
+
+   Plot windows will automatically be closed at the end of the session
+unless the '-persist' option was given.
+
+   The size or aspect ratio of a plot may be changed by resizing the
+'gnuplot' window.
+
+   Linewidths and pointsizes may be changed from within 'gnuplot' with
+'set linestyle'.
+
+   For terminal type 'be', 'gnuplot' accepts (when initialized) the
+standard X Toolkit options and resources such as geometry, font, and
+name from the command line arguments or a configuration file.  See the
+X(1) man page (or its equivalent) for a description of such options.
+
+   A number of other 'gnuplot' options are available for the 'be'
+terminal.  These may be specified either as command-line options when
+'gnuplot' is invoked or as resources in the configuration file
+".Xdefaults".  They are set upon initialization and cannot be altered
+during a 'gnuplot' session.
+
+* Menu:
+
+* command-line_options::
+* monochrome_options::
+* color_resources::
+* grayscale_resources::
+* line_resources::
+
+
+File: gnuplot.info,  Node: command-line_options,  Next: monochrome_options,  Prev: be,  Up: be
+
+4.1.3.1 command-line_options
+............................
+
+In addition to the X Toolkit options, the following options may be
+specified on the command line when starting 'gnuplot' or as resources in
+your ".Xdefaults" file:
+
+      `-mono`        forces monochrome rendering on color displays.
+      `-gray`        requests grayscale rendering on grayscale or color displays.
+                             (Grayscale displays receive monochrome rendering by default.)
+      `-clear`   requests that the window be cleared momentarily before a
+                             new plot is displayed.
+      `-raise`   raises plot window after each plot
+      `-noraise` does not raise plot window after each plot
+      `-persist` plots windows survive after main gnuplot program exits
+
+
+   The options are shown above in their command-line syntax.  When
+entered as resources in ".Xdefaults", they require a different syntax.
+
+   Example:
+               gnuplot*gray: on
+
+
+   'gnuplot' also provides a command line option ('-pointsize <v>') and
+a resource, 'gnuplot*pointsize: <v>', to control the size of points
+plotted with the 'points' plotting style.  The value 'v' is a real
+number (greater than 0 and less than or equal to ten) used as a scaling
+factor for point sizes.  For example, '-pointsize 2' uses points twice
+the default size, and '-pointsize 0.5' uses points half the normal size.
+
+
+File: gnuplot.info,  Node: monochrome_options,  Next: color_resources,  Prev: command-line_options,  Up: be
+
+4.1.3.2 monochrome_options
+..........................
+
+For monochrome displays, 'gnuplot' does not honor foreground or
+background colors.  The default is black-on-white.  '-rv' or
+'gnuplot*reverseVideo: on' requests white-on-black.
+
+
+File: gnuplot.info,  Node: color_resources,  Next: grayscale_resources,  Prev: monochrome_options,  Up: be
+
+4.1.3.3 color_resources
+.......................
+
+For color displays, 'gnuplot' honors the following resources (shown here
+with their default values) or the greyscale resources.  The values may
+be color names as listed in the BE rgb.txt file on your system,
+hexadecimal RGB color specifications (see BE documentation), or a color
+name followed by a comma and an 'intensity' value from 0 to 1.  For
+example, 'blue, 0.5' means a half intensity blue.
+
+      gnuplot*background:  white
+      gnuplot*textColor:   black
+      gnuplot*borderColor: black
+      gnuplot*axisColor:   black
+      gnuplot*line1Color:  red
+      gnuplot*line2Color:  green
+      gnuplot*line3Color:  blue
+      gnuplot*line4Color:  magenta
+      gnuplot*line5Color:  cyan
+      gnuplot*line6Color:  sienna
+      gnuplot*line7Color:  orange
+      gnuplot*line8Color:  coral
+
+
+   The command-line syntax for these is, for example,
+
+   Example:
+               gnuplot -background coral
+
+
+
+File: gnuplot.info,  Node: grayscale_resources,  Next: line_resources,  Prev: color_resources,  Up: be
+
+4.1.3.4 grayscale_resources
+...........................
+
+When '-gray' is selected, 'gnuplot' honors the following resources for
+grayscale or color displays (shown here with their default values).
+Note that the default background is black.
+
+      gnuplot*background: black
+      gnuplot*textGray:   white
+      gnuplot*borderGray: gray50
+      gnuplot*axisGray:   gray50
+      gnuplot*line1Gray:  gray100
+      gnuplot*line2Gray:  gray60
+      gnuplot*line3Gray:  gray80
+      gnuplot*line4Gray:  gray40
+      gnuplot*line5Gray:  gray90
+      gnuplot*line6Gray:  gray50
+      gnuplot*line7Gray:  gray70
+      gnuplot*line8Gray:  gray30
+
+
+
+File: gnuplot.info,  Node: line_resources,  Prev: grayscale_resources,  Up: be
+
+4.1.3.5 line_resources
+......................
+
+'gnuplot' honors the following resources for setting the width (in
+pixels) of plot lines (shown here with their default values.)  0 or 1
+means a minimal width line of 1 pixel width.  A value of 2 or 3 may
+improve the appearance of some plots.
+
+      gnuplot*borderWidth: 2
+      gnuplot*axisWidth:   0
+      gnuplot*line1Width:  0
+      gnuplot*line2Width:  0
+      gnuplot*line3Width:  0
+      gnuplot*line4Width:  0
+      gnuplot*line5Width:  0
+      gnuplot*line6Width:  0
+      gnuplot*line7Width:  0
+      gnuplot*line8Width:  0
+
+
+   'gnuplot' honors the following resources for setting the dash style
+used for plotting lines.  0 means a solid line.  A two-digit number 'jk'
+('j' and 'k' are >= 1 and <= 9) means a dashed line with a repeated
+pattern of 'j' pixels on followed by 'k' pixels off.  For example, '16'
+is a "dotted" line with one pixel on followed by six pixels off.  More
+elaborate on/off patterns can be specified with a four-digit value.  For
+example, '4441' is four on, four off, four on, one off.  The default
+values shown below are for monochrome displays or monochrome rendering
+on color or grayscale displays.  For color displays, the default for
+each is 0 (solid line) except for 'axisDashes' which defaults to a '16'
+dotted line.
+
+      gnuplot*borderDashes:   0
+      gnuplot*axisDashes:        16
+      gnuplot*line1Dashes:        0
+      gnuplot*line2Dashes:   42
+      gnuplot*line3Dashes:   13
+      gnuplot*line4Dashes:   44
+      gnuplot*line5Dashes:   15
+      gnuplot*line6Dashes: 4441
+      gnuplot*line7Dashes:   42
+      gnuplot*line8Dashes:   13
+
+
+
+File: gnuplot.info,  Node: epscairo,  Next: canvas,  Prev: be,  Up: complete_list_of_terminals
+
+4.1.4 epscairo
+--------------
+
+The 'epscairo' terminal device generates encapsulated PostScript (*.eps)
+using the cairo and pango support libraries.  cairo version >= 1.6 is
+required.
+
+   Please read the help for the 'pdfcairo' terminal."
+
+
+File: gnuplot.info,  Node: canvas,  Next: cgm,  Prev: epscairo,  Up: complete_list_of_terminals
+
+4.1.5 canvas
+------------
+
+The 'canvas' terminal creates a set of javascript commands that draw
+onto the HTML5 canvas element.  Syntax:
+           set terminal canvas {size <xsize>, <ysize>} {background <rgb_color>}
+                               {font {<fontname>}{,<fontsize>}} | {fsize <fontsize>}
+                               {{no}enhanced} {linewidth <lw>}
+                               {rounded | butt | square}
+                               {dashlength <dl>}
+                               {standalone {mousing} | name '<funcname>'}
+                               {jsdir 'URL/for/javascripts'}
+                               {title '<some string>'}
+
+
+   where <xsize> and <ysize> set the size of the plot area in pixels.
+The default size in standalone mode is 600 by 400 pixels.  The default
+font size is 10.
+
+   NB: Only one font is available, the ascii portion of Hershey simplex
+Roman provided in the file canvastext.js.  You can replace this with the
+file canvasmath.js, which contains also UTF-8 encoded Hershey simplex
+Greek and math symbols.  For consistency with other terminals, it is
+also possible to use 'font "name,size"'.  Currently the font *note
+name:: is ignored, but browser support for named fonts is likely to
+arrive eventually.
+
+   The default 'standalone' mode creates an html page containing
+javascript code that renders the plot using the HTML 5 canvas element.
+The html page links to two required javascript files 'canvastext.js' and
+'gnuplot_common.js'.  An additional file 'gnuplot_dashedlines.js' is
+needed to support dashed lines.  By default these point to local files,
+on unix-like systems usually in directory
+/usr/local/share/gnuplot/<version>/js.  See installation notes for other
+platforms.  You can change this by using the 'jsdir' option to specify
+either a different local directory or a general URL. The latter is
+usually appropriate if the plot is exported for viewing on remote client
+machines.
+
+   All plots produced by the canvas terminal are mouseable.  The
+additional keyword 'mousing' causes the 'standalone' mode to add a
+mouse-tracking box underneath the plot.  It also adds a link to a
+javascript file 'gnuplot_mouse.js' and to a stylesheet for the mouse box
+'gnuplot_mouse.css' in the same local or URL directory as
+'canvastext.js'.
+
+   The *note name:: option creates a file containing only javascript.
+Both the javascript function it contains and the id of the canvas
+element that it draws onto are taken from the following string
+parameter.  The commands
+           set term canvas name 'fishplot'
+           set output 'fishplot.js'
+
+   will create a file containing a javascript function fishplot() that
+will draw onto a canvas with id=fishplot.  An html page that invokes
+this javascript function must also load the canvastext.js function as
+described above.  A minimal html file to wrap the fishplot created above
+might be:
+
+           <html>
+           <head>
+               <script src="canvastext.js"></script>
+               <script src="gnuplot_common.js"></script>
+           </head>
+           <body onload="fishplot();">
+               <script src="fishplot.js"></script>
+               <canvas id="fishplot" width=600 height=400>
+                   <div id="err_msg">No support for HTML 5 canvas element</div>
+               </canvas>
+           </body>
+           </html>
+
+
+   The individual plots drawn on this canvas will have names
+fishplot_plot_1, fishplot_plot_2, and so on.  These can be referenced by
+external javascript routines, for example
+gnuplot.toggle_visibility("fishplot_plot_2").
+
+
+File: gnuplot.info,  Node: cgm,  Next: context,  Prev: canvas,  Up: complete_list_of_terminals
+
+4.1.6 cgm
+---------
+
+The 'cgm' terminal generates a Computer Graphics Metafile, Version 1.
+This file format is a subset of the ANSI X3.122-1986 standard entitled
+"Computer Graphics - Metafile for the Storage and Transfer of Picture
+Description Information".
+
+   Syntax:
+           set terminal cgm {color | monochrome} {solid | dashed} {{no}rotate}
+                            {<mode>} {width <plot_width>} {linewidth <line_width>}
+                            {font "<fontname>,<fontsize>"}
+                            {background <rgb_color>}
+       [deprecated]         {<color0> <color1> <color2> ...}
+
+
+   'solid' draws all curves with solid lines, overriding any dashed
+patterns; <mode> is 'landscape', 'portrait', or 'default'; <plot_width>
+is the assumed width of the plot in points; <line_width> is the line
+width in points (default 1); <fontname> is the name of a font (see list
+of fonts below) <fontsize> is the size of the font in points (default
+12).
+
+   The first six options can be in any order.  Selecting 'default' sets
+all options to their default values.
+
+   The mechanism of setting line colors in the 'set term' command is
+deprecated.  Instead you should set the background using a separate
+keyword and set the line colors using 'set linetype'.  The deprecated
+mechanism accepted colors of the form 'xrrggbb', where x is the literal
+character 'x' and 'rrggbb' are the red, green and blue components in
+hex.  The first color was used for the background, subsequent colors are
+assigned to successive line types.
+
+   Examples:
+           set terminal cgm landscape color rotate dashed width 432 \\
+                          linewidth 1  'Helvetica Bold' 12       # defaults
+           set terminal cgm linewidth 2  14  # wider lines & larger font
+           set terminal cgm portrait "Times Italic" 12
+           set terminal cgm color solid      # no pesky dashes!
+
+
+* Menu:
+
+* cgm_font::
+* cgm_fontsize::
+* cgm_linewidth::
+* cgm_rotate::
+* cgm_solid::
+* cgm_size::
+* cgm_width::
+* cgm_nofontlist::
+
+
+File: gnuplot.info,  Node: cgm_font,  Next: cgm_fontsize,  Prev: cgm,  Up: cgm
+
+4.1.6.1 cgm font
+................
+
+The first part of a Computer Graphics Metafile, the metafile
+description, includes a font table.  In the picture body, a font is
+designated by an index into this table.  By default, this terminal
+generates a table with the following 35 fonts, plus six more with
+'italic' replaced by 'oblique', or vice-versa (since at least the
+Microsoft Office and Corel Draw CGM import filters treat 'italic' and
+'oblique' as equivalent):
+
+           Helvetica
+           Helvetica Bold
+           Helvetica Oblique
+           Helvetica Bold Oblique
+           Times Roman
+           Times Bold
+           Times Italic
+           Times Bold Italic
+           Courier
+           Courier Bold
+           Courier Oblique
+           Courier Bold Oblique
+           Symbol
+           Hershey/Cartographic_Roman
+           Hershey/Cartographic_Greek
+           Hershey/Simplex_Roman
+           Hershey/Simplex_Greek
+           Hershey/Simplex_Script
+           Hershey/Complex_Roman
+           Hershey/Complex_Greek
+           Hershey/Complex_Script
+           Hershey/Complex_Italic
+           Hershey/Complex_Cyrillic
+           Hershey/Duplex_Roman
+           Hershey/Triplex_Roman
+           Hershey/Triplex_Italic
+           Hershey/Gothic_German
+           Hershey/Gothic_English
+           Hershey/Gothic_Italian
+           Hershey/Symbol_Set_1
+           Hershey/Symbol_Set_2
+           Hershey/Symbol_Math
+           ZapfDingbats
+           Script
+           15
+
+
+   The first thirteen of these fonts are required for WebCGM. The
+Microsoft Office CGM import filter implements the 13 standard fonts
+listed above, and also 'ZapfDingbats' and 'Script'.  However, the script
+font may only be accessed under the name '15'.  For more on Microsoft
+import filter font substitutions, check its help file which you may find
+here:
+       C:\\Program Files\\Microsoft Office\\Office\\Cgmimp32.hlp
+
+   and/or its configuration file, which you may find here:
+       C:\\Program Files\\Common Files\\Microsoft Shared\\Grphflt\\Cgmimp32.cfg
+
+
+   In the 'set term' command, you may specify a font name which does not
+appear in the default font table.  In that case, a new font table is
+constructed with the specified font as its first entry.  You must ensure
+that the spelling, capitalization, and spacing of the name are
+appropriate for the application that will read the CGM file.  (Gnuplot
+and any MIL-D-28003A compliant application ignore case in font names.)
+If you need to add several new fonts, use several 'set term' commands.
+
+   Example:
+           set terminal cgm 'Old English'
+           set terminal cgm 'Tengwar'
+           set terminal cgm 'Arabic'
+           set output 'myfile.cgm'
+           plot ...
+           set output
+
+
+   You cannot introduce a new font in a 'set label' command.
+
+
+File: gnuplot.info,  Node: cgm_fontsize,  Next: cgm_linewidth,  Prev: cgm_font,  Up: cgm
+
+4.1.6.2 cgm fontsize
+....................
+
+Fonts are scaled assuming the page is 6 inches wide.  If the *note
+size:: command is used to change the aspect ratio of the page or the CGM
+file is converted to a different width, the resulting font sizes will be
+scaled up or down accordingly.  To change the assumed width, use the
+'width' option.
+
+
+File: gnuplot.info,  Node: cgm_linewidth,  Next: cgm_rotate,  Prev: cgm_fontsize,  Up: cgm
+
+4.1.6.3 cgm linewidth
+.....................
+
+The 'linewidth' option sets the width of lines in pt.  The default width
+is 1 pt.  Scaling is affected by the actual width of the page, as
+discussed under the 'fontsize' and 'width' options.
+
+
+File: gnuplot.info,  Node: cgm_rotate,  Next: cgm_solid,  Prev: cgm_linewidth,  Up: cgm
+
+4.1.6.4 cgm rotate
+..................
+
+The 'norotate' option may be used to disable text rotation.  For
+example, the CGM input filter for Word for Windows 6.0c can accept
+rotated text, but the DRAW editor within Word cannot.  If you edit a
+graph (for example, to label a curve), all rotated text is restored to
+horizontal.  The Y axis label will then extend beyond the clip boundary.
+With 'norotate', the Y axis label starts in a less attractive location,
+but the page can be edited without damage.  The 'rotate' option confirms
+the default behavior.
+
+
+File: gnuplot.info,  Node: cgm_solid,  Next: cgm_size,  Prev: cgm_rotate,  Up: cgm
+
+4.1.6.5 cgm solid
+.................
+
+The 'solid' option may be used to disable dashed line styles in the
+plots.  This is useful when color is enabled and the dashing of the
+lines detracts from the appearance of the plot.  The 'dashed' option
+confirms the default behavior, which gives a different dash pattern to
+each line type.
+
+
+File: gnuplot.info,  Node: cgm_size,  Next: cgm_width,  Prev: cgm_solid,  Up: cgm
+
+4.1.6.6 cgm size
+................
+
+Default size of a CGM plot is 32599 units wide and 23457 units high for
+landscape, or 23457 units wide by 32599 units high for portrait.
+
+
+File: gnuplot.info,  Node: cgm_width,  Next: cgm_nofontlist,  Prev: cgm_size,  Up: cgm
+
+4.1.6.7 cgm width
+.................
+
+All distances in the CGM file are in abstract units.  The application
+that reads the file determines the size of the final plot.  By default,
+the width of the final plot is assumed to be 6 inches (15.24 cm).  This
+distance is used to calculate the correct font size, and may be changed
+with the 'width' option.  The keyword should be followed by the width in
+points.  (Here, a point is 1/72 inch, as in PostScript.  This unit is
+known as a "big point" in TeX.) Gnuplot 'expressions' can be used to
+convert from other units.
+
+   Example:
+           set terminal cgm width 432            # default
+           set terminal cgm width 6*72           # same as above
+           set terminal cgm width 10/2.54*72     # 10 cm wide
+
+
+
+File: gnuplot.info,  Node: cgm_nofontlist,  Prev: cgm_width,  Up: cgm
+
+4.1.6.8 cgm nofontlist
+......................
+
+The default font table includes the fonts recommended for WebCGM, which
+are compatible with the Computer Graphics Metafile input filter for
+Microsoft Office and Corel Draw.  Another application might use
+different fonts and/or different font names, which may not be
+documented.  The 'nofontlist' (synonym 'winword6') option deletes the
+font table from the CGM file.  In this case, the reading application
+should use a default table.  Gnuplot will still use its own default font
+table to select font indices.  Thus, 'Helvetica' will give you an index
+of 1, which should get you the first entry in your application's default
+font table.  'Helvetica Bold' will give you its second entry, etc.
+
+
+File: gnuplot.info,  Node: context,  Next: corel,  Prev: cgm,  Up: complete_list_of_terminals
+
+4.1.7 context
+-------------
+
+ConTeXt is a macro package for TeX, highly integrated with Metapost (for
+drawing figures) and intended for creation of high-quality PDF
+documents.  The terminal outputs Metafun source, which can be edited
+manually, but you should be able to configure most things from outside.
+
+   For an average user of ConTeXt + gnuplot module it's recommended to
+refer to 'Using ConTeXt' rather than reading this page or to read the
+manual of the gnuplot module for ConTeXt.
+
+   The 'context' terminal supports the following options:
+
+   Syntax:
+          set term context {default}
+                  {defaultsize | size <scale> | size <xsize>{in|cm}, <ysize>{in|cm}}
+                  {input | standalone}
+                  {timestamp | notimestamp}
+                  {noheader | header "<header>"}
+                  {color | colour | monochrome}
+                  {rounded | mitered | beveled} {round | butt | squared}
+                  {dashed | solid} {dashlength | dl <dl>}
+                  {linewidth | lw <lw>}
+                  {fontscale <fontscale>}
+                  {mppoints | texpoints}
+                  {inlineimages | externalimages}
+                  {defaultfont | font "{<fontname>}{,<fontsize>}"}
+
+
+   In non-standalone ('input') graphic only parameters *note size:: to
+select graphic size, 'fontscale' to scale all the labels for a factor
+<fontscale> and font size, make sense, the rest is silently ignored and
+should be configured in the .tex file which inputs the graphic.  It's
+highly recommended to set the proper fontsize if document font differs
+from 12pt, so that gnuplot will know how much space to reserve for
+labels.
+
+   'default' resets all the options to their default values.
+
+   'defaultsize' sets the plot size to 5in,3in.  *note size:: <scale>
+sets the plot size to <scale> times <default value>.  If two arguments
+are given (separated with ','), the first one sets the horizontal size
+and the second one the vertical size.  Size may be given without units
+(in which case it means relative to the default value), with inches
+('in') or centimeters ('cm').
+
+   'input' (default) creates a graphic that can be included into another
+ConTeXt document.  'standalone' adds some lines, so that the document
+might be compiled as-is.  You might also want to add 'header' in that
+case.
+
+   Use 'header' for any additional settings/definitions/macros that you
+might want to include in a standalone graphic.  'noheader' is the
+default.
+
+   'notimestamp' prevents printing creation time in comments (if version
+control is used, one may prefer not to commit new version when only date
+changes).
+
+   'color' to make color plots is the default, but *note monochrome::
+doesn't do anything special yet.  If you have any good ideas how the
+behaviour should differ to suit the monochrome printers better, your
+suggestions are welcome.
+
+   'rounded' (default), 'mitered' and 'beveled' control the shape of
+line joins.  'round' (default), 'butt' and 'squared' control the shape
+of line caps.  See PostScript or PDF Reference Manual for explanation.
+For wild-behaving functions and thick lines it is better to use
+'rounded' and 'round' to prevent sharp corners in line joins.  (Some
+general support for this should be added to Gnuplot, so that the same
+options could be set for each line (style) separately).
+
+   'dashed' (default) uses different dash patterns for different line
+types, 'solid' draws all plots with solid lines.
+
+   'dashlength' or 'dl' scales the length of the dashed-line segments by
+<dl>.  'linewidth' or 'lw' scales all linewidths by <lw>.  (lw 1 stands
+for 0.5bp, which is the default line width when drawing with Metapost.)
+'fontscale' scales text labels for factor <fontscale> relative to
+default document font.
+
+   'mppoints' uses predefined point shapes, drawn in Metapost.
+'texpoints' uses easily configurable set of symbols, defined with
+ConTeXt in the following way:
+          \\defineconversion[my own points][+,{\\ss x},\\mathematics{\\circ}]
+          \\setupGNUPLOTterminal[context][points=tex,pointset=my own points]
+
+
+   'inlineimages' writes binary images to a string and only works in
+ConTeXt MKIV. 'externalimages' writes PNG files to disk and also works
+with ConTeXt MKII. Gnuplot needs to have support for PNG images built in
+for this to work.
+
+   With 'font' you can set font name and size in standalone graphics.
+In non-standalone ('input') mode only the font size is important to
+reserve enough space for text labels.  The command
+          set term context font "myfont,ss,10"
+
+   will result in
+          \\setupbodyfont[myfont,ss,10pt]
+
+   If you additionally set 'fontscale' to 0.8 for example, then the
+resulting font will be 8pt big and
+          set label ... font "myfont,12"
+
+   will come out as 9.6pt.
+
+   It is your own responsibility to provide proper typescripts (and
+header), otherwise switching the font will have no effect.  For a
+standard font in ConTeXt MKII (pdfTeX) you could use:
+          set terminal context standalone header '\\usetypescript[iwona][ec]' \\
+              font "iwona,ss,11"
+
+   Please take a look into ConTeXt documentation, wiki or mailing list
+(archives) for any up-to-date information about font usage.
+
+   Examples:
+          set terminal context size 10cm, 5cm     # 10cm, 5cm
+          set terminal context size 4in, 3in      # 4in, 3in
+
+   For standalone (whole-page) plots with labels in UTF-8 encoding:
+          set terminal context standalone header '\\enableregime[utf-8]'
+
+   , /* TODO: LaTeX formatting */
+
+* Menu:
+
+* Requirements::
+* Calling_gnuplot_from_ConTeXt::
+
+
+File: gnuplot.info,  Node: Requirements,  Next: Calling_gnuplot_from_ConTeXt,  Prev: context,  Up: context
+
+4.1.7.1 Requirements
+....................
+
+You need gnuplot module for ConTeXt http://ctan.org/pkg/context-gnuplot
+(http://ctan.org/pkg/context-gnuplot) and a recent version of ConTeXt.
+If you want to call gnuplot on-the-fly, you also need write18 enabled.
+In most TeX distributions this can be set with shell_escape=t in
+texmf.cnf.
+
+   See http://wiki.contextgarden.net/Gnuplot
+(http://wiki.contextgarden.net/Gnuplot) for details about this terminal
+and for more exhaustive help & examples.
+
+
+File: gnuplot.info,  Node: Calling_gnuplot_from_ConTeXt,  Prev: Requirements,  Up: context
+
+4.1.7.2 Calling gnuplot from ConTeXt
+....................................
+
+The easiest way to make plots in ConTeXt documents is
+          \\usemodule[gnuplot]
+          \\starttext
+          \\title{How to draw nice plots with {\\sc gnuplot}?}
+          \\startGNUPLOTscript[sin]
+          set format y "%.1f"
+          plot sin(x) t '$\\sin(x)$'
+          \\stopGNUPLOTscript
+          \\useGNUPLOTgraphic[sin]
+          \\stoptext
+
+   This will run gnuplot automatically and include the resulting figure
+in the document."
+
+
+File: gnuplot.info,  Node: corel,  Next: debug,  Prev: context,  Up: complete_list_of_terminals
+
+4.1.8 corel
+-----------
+
+Legacy terminal for CorelDraw (circa 1995).
+
+   Syntax:
+           set terminal corel {monochrome | color} {"<font>" {<fontsize>}}
+                              {<xsize> <ysize> {<linewidth> }}
+
+
+   where the fontsize and linewidth are specified in points and the
+sizes in inches.  The defaults are monochrome, "SwitzerlandLight", 22,
+8.2, 10 and 1.2."
+
+
+File: gnuplot.info,  Node: debug,  Next: svga,  Prev: corel,  Up: complete_list_of_terminals
+
+4.1.9 debug
+-----------
+
+This terminal is provided to allow for the debugging of 'gnuplot'.  It
+is likely to be of use only for users who are modifying the source
+code."
+
+
+File: gnuplot.info,  Node: svga,  Next: dumb,  Prev: debug,  Up: complete_list_of_terminals
+
+4.1.10 svga
+-----------
+
+Legacy terminal.  The 'svga' terminal driver supports PCs with SVGA
+graphics.  It is typically only compiled with DJGPP and uses the GRX
+graphics library.  There is also a variant for Windows 32bit, which is
+mainly used for debugging.  The underlying library also supports X11,
+Linux console and SDL, but these targets are currently not supported.
+
+   Syntax:
+           set terminal svga {font "<fontname>"}
+                             {{no}enhanced}
+                             {background <rgb color>}
+                             {linewidth|lw <lw>}
+                             {pointscale|ps <scale>}
+                             {fontscale|fs <scale>}
+
+
+   Enhanced text support can be activated using the 'enhanced' option, "
+see 'enhanced text'.  Note that changing the font size in enhanced text
+is currently not supported.  Hence, super- and subscripts will have the
+same size.
+
+   The 'linewidth' parameter scales the width of lines.  The
+'pointscale' parameter sets the scale factor for point symbols.  You can
+use 'fontscale' to scale the bitmap font.  This might be useful if you
+have a hi-res display.  Note that integer factors give best results."
+
+
+File: gnuplot.info,  Node: dumb,  Next: dxf,  Prev: svga,  Up: complete_list_of_terminals
+
+4.1.11 dumb
+-----------
+
+The 'dumb' terminal driver plots into a text block using ascii
+characters.  It has an optional size specification and a trailing
+linefeed flag.
+
+   Syntax:
+           set terminal dumb {size <xchars>,<ychars>} {[no]feed}
+                             {aspect <htic>{,<vtic>}}
+                             {[no]enhanced}
+                             {fillchar {solid|"<char>"}}
+                             {[no]attributes}
+                             {mono|ansi|ansi256|ansirgb}
+
+
+   where <xchars> and <ychars> set the size of the text block.  The
+default is 79 by 24.  The last newline is printed only if 'feed' is
+enabled.
+
+   The 'aspect' option can be used to control the aspect ratio of the
+plot by setting the length of the horizontal and vertical tic marks.
+Only integer values are allowed.  Default is 2,1 - corresponding to the
+aspect ratio of common screen fonts.
+
+   The character "#" is used for area-fill.  You can replace this with
+any character available in the terminal font.  'fillchar solid' is short
+for 'fillchar "\\U+2588"' (unicode FULL BLOCK).
+
+   The 'ansi', 'ansi256', and 'ansirgb' options will include escape
+sequences in the output to handle colors.  Note that these might not be
+handled by your terminal.  Default is 'mono'.  To obtain the best color
+match in 'ansi' mode, you should use 'set colorsequence classic'.
+Depending on the mode, the 'dumb' terminal will emit the following
+sequences (without the additional whitespace):
+
+           ESC [ 0 m           reset attributes to defaults
+           foreground color:
+           ESC [ 1 m           set intense/bold
+           ESC [ 22 m          intense/bold off
+           ESC [ <fg> m        with color code 30 <= <fg> <= 37
+           ESC [ 39 m          reset to default
+           ESC [ 38; 5; <c> m  with palette index 16 <= <c> <= 255
+           ESC [ 38; 2; <r>; <g>; <b> m  with components 0 <= <r,g,b> <= 255
+           background color:
+           ESC [ <bg> m        with color code 40 <= <bg> <= 47
+           ESC [ 49 m          reset to default
+           ESC [ 48; 5; <c> m  with palette index 16 <= <c> <= 231
+           ESC [ 48; 2; <r>; <g>; <b> m  with components 0 <= <r,g,b> <= 255
+
+
+   See also e.g.  the description at
+https://en.wikipedia.org/wiki/ANSI_escape_code#Colors
+(https://en.wikipedia.org/wiki/ANSI_escape_code#Colors)
+
+   The 'attributes' option enables bold and italic text on terminals or
+emulators that support the escape sequences
+           ESC [ 1 m / 22 m    for bold on/off and
+           ESC [ 3 m / 23 m    for italic on /off.
+
+
+   Example:
+           set term dumb mono size 60,15 aspect 1
+           set tics nomirror scale 0.5
+           plot [-5:6.5] sin(x) with impulse ls -1
+
+
+               1 +-------------------------------------------------+
+             0.8 +|||++                   ++||||++                 |
+             0.6 +|||||+                 ++|||||||+  sin(x) +----+ |
+             0.4 +||||||+               ++|||||||||+               |
+             0.2 +|||||||+             ++|||||||||||+             +|
+               0 ++++++++++++++++++++++++++++++++++++++++++++++++++|
+            -0.2 +        +|||||||||||+              +|||||||||||+ |
+            -0.4 +         +|||||||||+                +|||||||||+  |
+            -0.6 +          +|||||||+                  +|||||||+   |
+            -0.8 +           ++||||+                    ++||||+    |
+              -1 +---+--------+--------+-------+--------+--------+-+
+                    -4       -2        0       2        4        6  "
+
+
+
+File: gnuplot.info,  Node: dxf,  Next: dxy800a,  Prev: dumb,  Up: complete_list_of_terminals
+
+4.1.12 dxf
+----------
+
+Terminal driver 'dxf' for export to AutoCad (Release 10.x).  It has no
+options.  The default size is 120x80 AutoCad units.  'dxf' uses seven
+colors (white, red, yellow, green, cyan, blue and magenta) that can be
+changed only by modifying the source file.  If a black-and-white
+plotting device is used the colors are mapped to differing line
+thicknesses.  Note: someone please update this terminal to the 2012 DXF
+standard!"
+
+
+File: gnuplot.info,  Node: dxy800a,  Next: eepic,  Prev: dxf,  Up: complete_list_of_terminals
+
+4.1.13 dxy800a
+--------------
+
+Note: legacy terminal.  This terminal driver supports the Roland DXY800A
+plotter.  It has no options."
+
+
+File: gnuplot.info,  Node: eepic,  Next: emf,  Prev: dxy800a,  Up: complete_list_of_terminals
+
+4.1.14 eepic
+------------
+
+Note: Legacy terminal (not built by default).  The latex, emtex, eepic,
+and tpic terminals in older versions of gnuplot provided minimal support
+for graphics styles beyond simple lines and points.  They have been
+directly superseded by the 'pict2e' terminal.  For more capable
+TeX/LaTeX compatible terminal types see 'cairolatex', 'context',
+'epslatex', 'mp', 'pstricks', and 'tikz'.
+
+   The output of this terminal is intended for use with the "eepic.sty"
+macro package for LaTeX. To use it, you need "eepic.sty", "epic.sty" and
+a DVI driver that supports the "tpic" \\specials.  If your driver
+doesn't support those \\specials, "eepicemu.sty" will enable you to use
+some of them.  dvips and dvipdfm do support the "tpic" \\specials,
+pdflatex does not.
+
+   Syntax:
+        set terminal eepic {default} {color|monochrome|dashed}
+                           {rotate} {size XX,YY}
+                           {small|tiny|<fontsize>}
+
+
+   'color' causes gnuplot to produce \\color{...} commands so that the
+graphs are colored.  Using this option, you must include
+\\usepackage{color} in the preamble of your latex document.
+
+   'dashed' will allow dashed line types; without this option, only
+solid lines with varying thickness will be used.  'dashed' and 'color'
+are mutually exclusive; if 'color' is specified, then 'dashed' will be
+ignored.
+
+   'rotate' will enable true rotated text (by 90 degrees).  Otherwise,
+rotated text will be typeset with letters stacked above each other.  If
+you use this option you must include \\usepackage{graphicx} in the
+preamble.
+
+   'small' will use \\scriptsize symbols as point markers.  Default is
+to use the" default math size.  'tiny' uses \\scriptscriptstyle symbols.
+
+   The default size of an eepic plot is 5x3 inches.  You can change this
+using the *note size:: terminal option.
+
+   <fontsize> is a number which specifies the font size inside the
+picture environment; the unit is pt (points), i.e., 10 pt equals approx.
+3.5 mm.  If fontsize is not specified, then all text inside the picture
+will be set in \\footnotesize.
+
+   'default' resets all options to their defaults = no color, no dashed
+lines, pseudo-rotated (stacked) text, large point symbols.
+
+   Notes:
+
+   Remember to escape the # character (or other chars meaningful to
+(La-)TeX) by \\\\ (2 backslashes).
+
+   It seems that dashed lines become solid lines when the vertices of a
+plot are too close.  (I do not know if that is a general problem with
+the tpic specials, or if it is caused by a bug in eepic.sty or
+dvips/dvipdfm.)
+
+   Points, among other things, are drawn using the LaTeX commands
+"\\Diamond", "\\Box", etc.  These commands no longer belong to the
+LaTeX2e core; they are included in the latexsym package, which is part
+of the base distribution and thus part of any LaTeX implementation.
+Please do not forget to use this package.  Instead of latexsym, you can
+also include the amssymb package.
+
+   All drivers for LaTeX offer a special way of controlling text
+positioning: If any text string begins with '{', you also need to
+include a '}' at the end of the text, and the whole text will be
+centered both horizontally and vertically.  If the text string begins
+with '[', you need to follow this with a position specification (up to
+two out of t,b,l,r), ']{', the text itself, and finally '}'.  The text
+itself may be anything LaTeX can typeset as an LR-box.  '\\rule{}{}'s
+may help for best positioning.
+
+   Examples:
+            set term eepic
+
+   output graphs as eepic macros inside a picture environment; \\input
+the resulting file in your LaTeX document.
+            set term eepic color tiny rotate 8
+
+   eepic macros with \\color macros, \\scripscriptsize point markers,
+true rotated text, and all text set with 8pt.
+
+   About label positioning: Use gnuplot defaults (mostly sensible, but
+sometimes not really best):
+            set title '\\LaTeX\\ -- $ \\gamma $'
+
+   Force centering both horizontally and vertically:
+            set label '{\\LaTeX\\ -- $ \\gamma $}' at 0,0
+
+   Specify own positioning (top here):
+            set xlabel '[t]{\\LaTeX\\ -- $ \\gamma $}'
+
+   The other label - account for long ticlabels:
+            set ylabel '[r]{\\LaTeX\\ -- $ \\gamma $\\rule{7mm}{0pt}}'"
+
+
+
+File: gnuplot.info,  Node: emf,  Next: epson_180dpi,  Prev: eepic,  Up: complete_list_of_terminals
+
+4.1.15 emf
+----------
+
+The 'emf' terminal generates an Enhanced Metafile Format file.  This
+file format is recognized by many Windows applications.
+
+   Syntax:
+           set terminal emf {color | monochrome}
+                            {enhanced {noproportional}}
+                            {rounded | butt}
+                            {linewidth <LW>} {dashlength <DL>}
+                            {size XX,YY} {background <rgb_color>}
+                            {font "<fontname>{,<fontsize>}"}
+                            {fontscale <scale>}
+
+
+   In *note monochrome:: mode successive line types cycle through dash
+patterns.  'linewidth <factor>' multiplies all line widths by this
+factor.  'dashlength <factor>' is useful for thick lines.  <fontname> is
+the name of a font; and '<fontsize>' is the size of the font in points.
+
+   The nominal size of the output image defaults to 1024x768 in
+arbitrary units.  You may specify a different nominal size using the
+*note size:: option.
+
+   Enhanced text mode tries to approximate proportional character
+spacing.  If you are using a monospaced font, or don't like the
+approximation, you can turn off this correction using the
+'noproportional' option.
+
+   The default settings are 'color font "Arial,12" size 1024,768'
+Selecting 'default' sets all options to their default values.
+
+   Examples:
+           set terminal emf 'Times Roman Italic, 12'"
+
+
+
+File: gnuplot.info,  Node: epson_180dpi,  Next: excl,  Prev: emf,  Up: complete_list_of_terminals
+
+4.1.16 epson_180dpi
+-------------------
+
+Note: only available if gnuplot is configured -with-bitmap-terminals.
+This driver supports a family of Epson printers and derivatives.
+
+   'epson_180dpi' and 'epson_60dpi' are drivers for Epson LQ-style
+24-pin printers with resolutions of 180 and 60 dots per inch,
+respectively.
+
+   'epson_lx800' is a generic 9-pin driver appropriate for printers like
+the Epson LX-800, the Star NL-10 and NX-1000, the PROPRINTER, and so
+forth.
+
+   'nec_cp6' is generic 24-pin driver that can be used for printers like
+the NEC CP6 and the Epson LQ-800.
+
+   The 'okidata' driver supports the 9-pin OKIDATA 320/321 Standard
+printers.
+
+   The 'starc' driver is for the Star Color Printer.
+
+   The 'tandy_60dpi' driver is for the Tandy DMP-130 series of 9-pin,
+60-dpi printers.
+
+   The 'dpu414' driver is for the Seiko DPU-414 thermal printer.
+
+   'nec_cp6' has the options:
+
+   Syntax:
+           set terminal nec_cp6 {monochrome | colour | draft}
+
+
+   which defaults to monochrome.
+
+   'dpu414' has the options:
+
+   Syntax:
+           set terminal dpu414 {small | medium | large} {normal | draft}
+
+
+   which defaults to medium (=font size) and normal.  Preferred
+combinations are 'medium normal' and 'small draft'.
+
+   With each of these drivers, a binary copy is required on a PC to
+print.  Do not use 'print'--use instead 'copy file /b lpt1:'.
+
+
+File: gnuplot.info,  Node: excl,  Next: fig,  Prev: epson_180dpi,  Up: complete_list_of_terminals
+
+4.1.17 excl
+-----------
+
+Note: legacy terminal.  The 'excl' terminal driver supports Talaris
+printers such as the EXCL Laser printer and the 1590.  It has no
+options."
+
+
+File: gnuplot.info,  Node: fig,  Next: png_,  Prev: excl,  Up: complete_list_of_terminals
+
+4.1.18 fig
+----------
+
+The 'fig' terminal device generates output in the Fig graphics language
+for import into the xfig interactive drawing tool.  Notes:
+           The fig terminal was significantly revised in gnuplot version 5.3.
+           Currently only version 3.2 of the fig file format is supported.
+           Use of dash patterns may require Xfig 3.2.6 or newer.
+
+
+   Syntax:
+           set terminal fig {monochrome | color}
+                            {small | big | size <xsize>{in|cm},<ysize>{in|cm}}
+                            {landscape | portrait}
+                            {pointsmax <max_points>}
+                            {font "<fontname>{,<fontsize>}"} {fontsize <size>}
+                            {textnormal | {textspecial texthidden textrigid}}
+                            {{linewidth|lw} <multiplier>}
+
+
+   The default settings are
+           set term fig color small landscape font "Times Roman,10" lw 1.0
+
+
+   *note size:: sets the size of the drawing area to <xsize>*<ysize> in
+units of inches (default) or centimeters.  The default is 'size
+5in,3in'.  'small' is shorthand for 'size 5in,3in' (3in,5in in portrait
+mode).  'big' is shorthand for 'size 8in,5in'.
+
+   'pointsmax' sets the maximum number of vertices in a polyline; longer
+polylines will be broken into segments.
+
+   'font' sets the text font face to <fontname> and its size to
+<fontsize> points.  Choice is limited to the 35 standard PostScript
+fonts.  'textnormal' resets the text flags and selects postscript fonts,
+'textspecial' sets the text flags for LaTeX specials, 'texthidden' sets
+the hidden flag and 'textrigid' the rigid flag.
+
+   'linewidth' is a multiplier for the linewidth property of all lines.
+
+   Additional point-plot symbols are also available in the 'fig' driver.
+The symbols can be used through 'pointtype' values % 100 above 50, with
+different fill intensities controlled by <pointtype> % 5 and outlines in
+black (for <pointtype> % 10 < 5) or in the current color.  Available
+symbols are
+             50 - 59:  circles
+             60 - 69:  squares
+             70 - 79:  diamonds
+             80 - 89:  upwards triangles
+             90 - 99:  downwards triangles
+
+   The size of these symbols scales with the font size.
+
+   RGB colors will be replaced with gray unless they have been defined
+in a linetype prior to plotting or match a known named color or palette
+value.  See *note colornames::.  E.g.
+           set linetype 999 lc rgb '#aabbcc'
+           plot $data with fillecurve fillcolor rgb '#aabbcc'
+
+
+
+File: gnuplot.info,  Node: png_,  Next: ggi,  Prev: fig,  Up: complete_list_of_terminals
+
+4.1.19 png
+----------
+
+Syntax:
+           set terminal png
+                  {{no}enhanced}
+                  {{no}transparent} {{no}interlace}
+                  {{no}truecolor} {rounded|butt}
+                  {linewidth <lw>} {dashlength <dl>}
+                  {tiny | small | medium | large | giant}
+                  {font "<face> {,<pointsize>}"} {fontscale <scale>}
+                  {size <x>,<y>} {{no}crop}
+                  {background <rgb_color>}
+
+
+   PNG, JPEG and GIF images are created using the external library
+libgd.  PNG plots may be viewed interactively by piping the output to
+the 'display' program from the ImageMagick package as follows:
+                    set term png
+                    set output '| display png:-'
+
+   You can view the output from successive plot commands interactively
+by typing <space> in the display window.  To save the current plot to a
+file, left click in the display window and choose *note save::.
+
+   'transparent' instructs the driver to make the background color
+transparent.  Default is 'notransparent'.
+
+   'interlace' instructs the driver to generate interlaced PNGs.
+Default is 'nointerlace'.
+
+   The 'linewidth' and 'dashlength' options are scaling factors that
+affect all lines drawn, i.e.  they are multiplied by values requested in
+various drawing commands.
+
+   By default the png terminal creates TrueColor images with 24 bits of
+color information per pixel.  The 'notruecolor' option instead uses only
+8 bits, (256 indexed colors).  Transparent fill styles require the
+'truecolor' option.  See 'fillstyle'.  A transparent background is
+possible in either indexed or TrueColor images.  Antialiasing also
+requires TrueColor.
+
+   'butt' instructs the driver to use a line drawing method that does
+not overshoot the desired end point of a line.  This setting is only
+relevant for line widths greater than 1.  The alternative is 'rounded',
+which produces somewhat more uniform curved lines if antialiasing is not
+available ('notruecolor') but can be much slower.
+
+   The details of font selection are complicated.  Two equivalent simple
+examples are given below:
+          set term png font arial 11
+          set term png font "arial,11"
+
+   For more information please see the separate section under 'fonts'.
+
+   The output plot size <x,y> is given in pixels--it defaults to
+640x480.  Please see additional information under 'canvas' and *note
+size::.  Blank space at the edges of the finished plot may be trimmed
+using the 'crop' option, resulting in a smaller final image size.
+Default is 'nocrop'.
+
+* Menu:
+
+* examples____::
+
+
+File: gnuplot.info,  Node: examples____,  Prev: png_,  Up: png_
+
+4.1.19.1 examples
+.................
+
+           set terminal png font "arial,14" size 800,600 background "white"
+
+
+   Searches for a scalable font with face name 'arial' and sets the font
+size to 14pt.  Please see 'fonts' for details of how the font search is
+done.
+
+           set terminal png transparent enhanced
+
+
+   Use 24 bits of color information per pixel, with a transparent
+background.  Use the 'enhanced text' mode to control the layout of
+strings to be printed.
+
+
+File: gnuplot.info,  Node: ggi,  Next: gpic,  Prev: png_,  Up: complete_list_of_terminals
+
+4.1.20 ggi
+----------
+
+Legacy terminal driver for the GGI (General Graphics Interface)
+project."
+
+   Syntax:
+        set terminal ggi [acceleration <integer>] [[mode] {mode}]
+
+
+   In X the window cannot be resized using window manager handles, but
+the mode can be given with the mode option, e.g.:
+      - V1024x768
+      - V800x600
+      - V640x480
+      - V320x200
+
+   Please refer to the ggi documentation for other modes.  The 'mode'
+keyword is optional.  It is recommended to select the target by
+environment variables as explained in the libggi manual page.  To get
+DGA on X, you should for example
+        bash> export GGI_DISPLAY=DGA
+        csh>  setenv GGI_DISPLAY DGA
+
+
+   'acceleration' is only used for targets which report relative pointer
+motion events (e.g.  DGA) and is a strictly positive integer
+multiplication factor for the relative distances.  The default for
+acceleration is 7.
+
+   Examples:
+        set term ggi acc 10
+        set term ggi acc 1 mode V1024x768
+        set term ggi V1024x768"
+
+
+
+File: gnuplot.info,  Node: gpic,  Next: grass,  Prev: ggi,  Up: complete_list_of_terminals
+
+4.1.21 gpic
+-----------
+
+Note: Legacy terminal (present only if gnuplot was configured
+-with-gpic).  The 'gpic' terminal driver generates GPIC graphs in the
+Free Software Foundations's "groff" package.  The default size is 5 x 3
+inches.  The only option is the origin, which defaults to (0,0).
+
+   Syntax:
+           set terminal gpic {<x> <y>}
+
+
+   where 'x' and 'y' are in inches.
+
+   A simple graph can be formatted using
+
+           groff -p -mpic -Tps file.pic > file.ps.
+
+
+   The output from pic can be pipe-lined into eqn, so it is possible to
+put complex functions in a graph with the 'set label' and 'set
+{x/y}label' commands.  For instance,
+
+           set ylab '@space 0 int from 0 to x alpha ( t ) roman d t@'
+
+
+   will label the y axis with a nice integral if formatted with the
+command:
+
+           gpic filename.pic | geqn -d@@ -Tps | groff -m[macro-package] -Tps
+               > filename.ps
+
+
+   Figures made this way can be scaled to fit into a document.  The pic
+language is easy to understand, so the graphs can be edited by hand if
+need be.  All co-ordinates in the pic-file produced by 'gnuplot' are
+given as x+gnuplotx and y+gnuploty.  By default x and y are given the
+value 0.  If this line is removed with an editor in a number of files,
+one can put several graphs in one figure like this (default size is
+5.0x3.0 inches):
+
+           .PS 8.0
+           x=0;y=3
+           copy "figa.pic"
+           x=5;y=3
+           copy "figb.pic"
+           x=0;y=0
+           copy "figc.pic"
+           x=5;y=0
+           copy "figd.pic"
+           .PE
+
+
+   This will produce an 8-inch-wide figure with four graphs in two rows
+on top of each other.
+
+   One can also achieve the same thing by specifying x and y in the
+command
+
+           set terminal gpic x y
+
+
+
+File: gnuplot.info,  Node: grass,  Next: hp2623a,  Prev: gpic,  Up: complete_list_of_terminals
+
+4.1.22 grass
+------------
+
+Note: legacy terminal.  The 'grass' terminal driver gives 'gnuplot'
+capabilities to users of the GRASS geographic information system.
+Contact grassp-list@moon.cecer.army.mil for more information.  Pages are
+written to the current frame of the GRASS Graphics Window.  There are no
+options."
+
+
+File: gnuplot.info,  Node: hp2623a,  Next: hp2648,  Prev: grass,  Up: complete_list_of_terminals
+
+4.1.23 hp2623a
+--------------
+
+The 'hp2623a' terminal driver supports the Hewlett Packard HP2623A. It
+has no options."
+
+
+File: gnuplot.info,  Node: hp2648,  Next: hp500c,  Prev: hp2623a,  Up: complete_list_of_terminals
+
+4.1.24 hp2648
+-------------
+
+The 'hp2648' terminal driver supports the Hewlett Packard HP2647 and
+HP2648.  It has no options."
+
+
+File: gnuplot.info,  Node: hp500c,  Next: hpgl,  Prev: hp2648,  Up: complete_list_of_terminals
+
+4.1.25 hp500c
+-------------
+
+Note: only available if gnuplot is configured -with-bitmap-terminals.
+The 'hp500c' terminal driver supports the Hewlett Packard HP DeskJet
+500c.  It has options for resolution and compression.
+
+   Syntax:
+           set terminal hp500c {<res>} {<comp>}
+
+
+   where 'res' can be 75, 100, 150 or 300 dots per inch and 'comp' can
+be "rle", or "tiff".  Any other inputs are replaced by the defaults,
+which are 75 dpi and no compression.  Rasterization at the higher
+resolutions may require a large amount of memory."
+
+
+File: gnuplot.info,  Node: hpgl,  Next: hpljii,  Prev: hp500c,  Up: complete_list_of_terminals
+
+4.1.26 hpgl
+-----------
+
+Syntax:
+           set terminal hpgl {<number_of_pens>} {eject} {fontscale <scale>}
+
+
+   The 'hpgl' driver produces HPGL output for Hewlett Packard pen
+plotters like the HP7475A and many other plotters dating back to the
+1970s.  Also, HPGL graphics can be imported by many software packages.
+The HPGL command language was largely superseded in later printers by
+the PCL command language.  See 'set term pcl5'.
+
+   Terminal options control the number of pens used and whether or not
+the plotter ejects a page when done.  The default is to use 6 pens and
+not eject the page.
+
+   All text is drawn in a uniform size.  The 'fontscale' option applies
+a scale factor to make this size larger or smaller.  If gnuplot's
+current encoding is set to either iso_8859_1 cp850, non-ascii characters
+are translated for handling by some printer models that support the
+corresponding character set.  If your printer model does not support
+this, do not set these encodings.
+
+
+File: gnuplot.info,  Node: hpljii,  Next: hppj,  Prev: hpgl,  Up: complete_list_of_terminals
+
+4.1.27 hpljii
+-------------
+
+Note: only available if gnuplot is configured -with-bitmap-terminals.
+The 'hpljii' terminal driver supports the HP Laserjet Series II printer.
+The 'hpdj' driver supports the HP DeskJet 500 printer.  These drivers
+allow a choice of resolutions.
+
+   Syntax:
+           set terminal hpljii | hpdj {<res>}
+
+
+   where 'res' may be 75, 100, 150 or 300 dots per inch; the default is
+75.  Rasterization at the higher resolutions may require a large amount
+of memory.
+
+   The 'hp500c' terminal is similar to 'hpdj'; 'hp500c' additionally
+supports color and compression."
+
+
+File: gnuplot.info,  Node: hppj,  Next: imagen,  Prev: hpljii,  Up: complete_list_of_terminals
+
+4.1.28 hppj
+-----------
+
+Note: only available if gnuplot is configured -with-bitmap-terminals.
+The 'hppj' terminal driver supports the HP PaintJet and HP3630 printers.
+The only option is the choice of font.
+
+   Syntax:
+           set terminal hppj {FNT5X9 | FNT9X17 | FNT13X25}
+
+
+   with the middle-sized font (FNT9X17) being the default."
+
+
+File: gnuplot.info,  Node: imagen,  Next: kyo,  Prev: hppj,  Up: complete_list_of_terminals
+
+4.1.29 imagen
+-------------
+
+The 'imagen' terminal driver supports Imagen laser printers.  It is
+capable of placing multiple graphs on a single page.
+
+   Syntax:
+           set terminal imagen {<fontsize>} {portrait | landscape}
+                               {[<horiz>,<vert>]}
+
+
+   where 'fontsize' defaults to 12 points and the layout defaults to
+'landscape'.  '<horiz>' and '<vert>' are the number of graphs in the
+horizontal and vertical directions; these default to unity.
+
+   Example:
+           set terminal imagen portrait [2,3]
+
+
+   puts six graphs on the page in three rows of two in portrait
+orientation."
+
+
+File: gnuplot.info,  Node: kyo,  Next: latex,  Prev: imagen,  Up: complete_list_of_terminals
+
+4.1.30 kyo
+----------
+
+The 'kyo' and 'prescribe' terminal drivers support the Kyocera laser
+printer.  The only difference between the two is that 'kyo' uses
+"Helvetica" whereas 'prescribe' uses "Courier".  There are no options.
+Note: legacy terminal."
+
+
+File: gnuplot.info,  Node: latex,  Next: lua,  Prev: kyo,  Up: complete_list_of_terminals
+
+4.1.31 latex
+------------
+
+Note: Legacy terminal (not built by default).  The latex, emtex, eepic,
+and tpic terminals in older versions of gnuplot provided minimal support
+for graphics styles beyond simple lines and points.  They have been
+directly superseded by the 'pict2e' terminal.  For more capable
+TeX/LaTeX compatible terminal types see 'cairolatex', 'context',
+'epslatex', 'mp', 'pstricks', and 'tikz'.
+
+   Syntax:
+           set terminal {latex | emtex} {default | {courier|roman} {<fontsize>}}
+                        {size <XX>{unit}, <YY>{unit}} {rotate | norotate}
+                        {color | monochrome}
+
+
+   By default the plot will inherit font settings from the embedding
+document.  You have the option of forcing either Courier (cmtt) or Roman
+(cmr) fonts instead.  In this case you may also specify a fontsize.
+Unless your driver is capable of building fonts at any size (e.g.
+dvips), stick to the standard 10, 11 and 12 point sizes.
+
+   METAFONT users beware: METAFONT does not like odd sizes.
+
+   All drivers for LaTeX offer a special way of controlling text
+positioning: If any text string begins with '{', you also need to
+include a '}' at the end of the text, and the whole text will be
+centered both horizontally and vertically.  If the text string begins
+with '[', you need to follow this with a position specification (up to
+two out of t,b,l,r), ']{', the text itself, and finally '}'.  The text
+itself may be anything LaTeX can typeset as an LR-box.  '\\rule{}{}'s
+may help for best positioning.
+
+   Points, among other things, are drawn using the LaTeX commands
+"\\Diamond" and "\\Box".  These commands no longer belong to the LaTeX2e
+core; they are included in the latexsym package, which is part of the
+base distribution and thus part of any LaTeX implementation.  Please do
+not forget to use this package.  Other point types use symbols from the
+amssymb package.
+
+   The default size for the plot is 5 inches by 3 inches.  The *note
+size:: option changes this to whatever the user requests.  By default
+the X and Y sizes are taken to be in inches, but other units are
+possible (currently only cm).
+
+   If 'rotate' is specified, rotated text, especially a rotated y-axis
+label, is possible (the packages graphics or graphicx are needed).  The
+'stacked' y-axis label mechanism is then deactivated.  This will also
+significantly improve the quality of line drawing, and is default since
+version 5.3.
+
+   The option 'color' enables color, while *note monochrome:: uses only
+black and white drawing elements.  You need to load the color or xcolor
+package in the preamble of your latex document.
+
+   Examples: About label positioning: Use gnuplot defaults (mostly
+sensible, but sometimes not really best):
+            set title '\\LaTeX\\ -- $ \\gamma $'
+
+   Force centering both horizontally and vertically:
+            set label '{\\LaTeX\\ -- $ \\gamma $}' at 0,0
+
+   Specify own positioning (top here):
+            set xlabel '[t]{\\LaTeX\\ -- $ \\gamma $}'
+
+   The other label - account for long ticlabels:
+            set ylabel '[r]{\\LaTeX\\ -- $ \\gamma $\\rule{7mm}{0pt}}'"
+
+
+
+File: gnuplot.info,  Node: lua,  Next: mf,  Prev: latex,  Up: complete_list_of_terminals
+
+4.1.32 lua
+----------
+
+The 'lua' generic terminal driver works in conjunction with an external
+Lua script to create a target-specific plot file.  Currently the only
+supported target is TikZ -> pdflatex.
+
+   Information about Lua is available at http://www.lua.org .
+
+   Syntax:
+        set terminal lua <target name> | "<file name>"
+                            {<script_args> ...}
+                            {help}
+
+
+   A 'target name' or 'file name' (in quotes) for a script is mandatory.
+If a 'target name' for the script is given, the terminal will look for
+"gnuplot-<target name>.lua" in the local directory and on failure in the
+environmental variable GNUPLOT_LUA_DIR.
+
+   All arguments will be provided to the selected script for further
+evaluation.  E.g.  'set term lua tikz help' will cause the script itself
+to print additional help on options and choices for the script.
+
+
+File: gnuplot.info,  Node: mf,  Next: mp,  Prev: lua,  Up: complete_list_of_terminals
+
+4.1.33 mf
+---------
+
+Note: legacy terminal (not built by default).  The 'mf' terminal driver
+creates an input file to the METAFONT program.  Thus a figure may be
+used in the TeX document in the same way as is a character.
+
+   To use a picture in a document, the METAFONT program must be run with
+the output file from 'gnuplot' as input.  Thus, the user needs a basic
+knowledge of the font creating process and the procedure for including a
+new font in a document.  However, if the METAFONT program is set up
+properly at the local site, an unexperienced user could perform the
+operation without much trouble.
+
+   The text support is based on a METAFONT character set.  Currently the
+Computer Modern Roman font set is input, but the user is in principal
+free to choose whatever fonts he or she needs.  The METAFONT source
+files for the chosen font must be available.  Each character is stored
+in a separate picture variable in METAFONT. These variables may be
+manipulated (rotated, scaled etc.)  when characters are needed.  The
+drawback is the interpretation time in the METAFONT program.  On some
+machines (i.e.  PC) the limited amount of memory available may also
+cause problems if too many pictures are stored.
+
+   The 'mf' terminal has no options.
+
+* Menu:
+
+* METAFONT_Instructions::
+
+
+File: gnuplot.info,  Node: METAFONT_Instructions,  Prev: mf,  Up: mf
+
+4.1.33.1 METAFONT Instructions
+..............................
+
+- Set your terminal to METAFONT:
+       set terminal mf
+
+   - Select an output-file, e.g.:
+       set output "myfigures.mf"
+
+   - Create your pictures.  Each picture will generate a separate
+character.  Its default size will be 5*3 inches.  You can change the
+size by saying 'set size 0.5,0.5' or whatever fraction of the default
+size you want to have.
+
+   - Quit 'gnuplot'.
+
+   - Generate a TFM and GF file by running METAFONT on the output of
+'gnuplot'.  Since the picture is quite large (5*3 in), you will have to
+use a version of METAFONT that has a value of at least 150000 for
+memmax.  On Unix systems these are conventionally installed under the
+name bigmf.  For the following assume that the command virmf stands for
+a big version of METAFONT. For example:
+
+   - Invoke METAFONT:
+         virmf '&plain'
+
+   - Select the output device: At the METAFONT prompt ('*') type:
+         \\mode:=CanonCX;     % or whatever printer you use
+
+   - Optionally select a magnification:
+         mag:=1;             % or whatever you wish
+
+   - Input the 'gnuplot'-file:
+         input myfigures.mf
+
+   On a typical Unix machine there will usually be a script called "mf"
+that executes virmf '&plain', so you probably can substitute mf for
+virmf &plain.  This will generate two files: mfput.tfm and mfput.$$$gf
+(where $$$ indicates the resolution of your device).  The above can be
+conveniently achieved by typing everything on the command line, e.g.:
+virmf '&plain' '\\mode:=CanonCX; mag:=1; input myfigures.mf' In this
+case the output files will be named myfigures.tfm and myfigures.300gf.
+
+   - Generate a PK file from the GF file using gftopk:
+       gftopk myfigures.300gf myfigures.300pk
+
+   The name of the output file for gftopk depends on the DVI driver you
+use.  Ask your local TeX administrator about the naming conventions.
+Next, either install the TFM and PK files in the appropriate
+directories, or set your environment variables properly.  Usually this
+involves setting TEXFONTS to include the current directory and doing the
+same thing for the environment variable that your DVI driver uses (no
+standard name here...).  This step is necessary so that TeX will find
+the font metric file and your DVI driver will find the PK file.
+
+   - To include your pictures in your document you have to tell TeX the
+font:
+       \\font\\gnufigs=myfigures
+
+   Each picture you made is stored in a single character.  The first
+picture is character 0, the second is character 1, and so on...  After
+doing the above step, you can use the pictures just like any other
+characters.  Therefore, to place pictures 1 and 2 centered in your
+document, all you have to do is:
+       \\centerline{\\gnufigs\\char0}
+       \\centerline{\\gnufigs\\char1}
+
+   in plain TeX. For LaTeX you can, of course, use the picture
+environment and place the picture wherever you wish by using the
+\\makebox and \\put macros.
+
+   This conversion saves you a lot of time once you have generated the
+font; TeX handles the pictures as characters and uses minimal time to
+place them, and the documents you make change more often than the
+pictures do.  It also saves a lot of TeX memory.  One last advantage of
+using the METAFONT driver is that the DVI file really remains device
+independent, because no \\special commands are used as in the eepic and
+tpic drivers."
+
+
+File: gnuplot.info,  Node: mp,  Next: mif,  Prev: mf,  Up: complete_list_of_terminals
+
+4.1.34 mp
+---------
+
+Note: legacy terminal (not built by default).  The 'mp' driver produces
+output intended to be input to the Metapost program.  Running Metapost
+on the file creates EPS files containing the plots.  By default,
+Metapost passes all text through TeX. This has the advantage of allowing
+essentially any TeX symbols in titles and labels.
+
+   Syntax:
+        set term mp {color | colour | monochrome}
+                    {solid | dashed}
+                    {notex | tex | latex}
+                    {magnification <magsize>}
+                    {psnfss | psnfss-version7 | nopsnfss}
+                    {prologues <value>}
+                    {a4paper}
+                    {amstex}
+                    {"<fontname> {,<fontsize>}"}
+
+
+   The option 'color' causes lines to be drawn in color (on a printer or
+display that supports it), *note monochrome:: (or nothing) selects black
+lines.  The option 'solid' draws solid lines, while 'dashed' (or
+nothing) selects lines with different patterns of dashes.  If 'solid' is
+selected but 'color' is not, nearly all lines will be identical.  This
+may occasionally be useful, so it is allowed.
+
+   The option 'notex' bypasses TeX entirely, therefore no TeX code can
+be used in labels under this option.  This is intended for use on old
+plot files or files that make frequent use of common characters like '$'
+and '%' that require special handling in TeX.
+
+   The option 'tex' sets the terminal to output its text for TeX to
+process.
+
+   The option 'latex' sets the terminal to output its text for
+processing by LaTeX. This allows things like \\frac for fractions which
+LaTeX knows about but TeX does not.  Note that you must set the
+environment variable TEX to the name of your LaTeX executable (normally
+latex) if you use this option or use 'mpost -tex=<name of LaTeX
+executable> ...'.  Otherwise metapost will try and use TeX to process
+the text and it won't work.
+
+   Changing font sizes in TeX has no effect on the size of mathematics,
+and there is no foolproof way to make such a change, except by globally
+setting a magnification factor.  This is the purpose of the
+'magnification' option.  It must be followed by a scaling factor.  All
+text (NOT the graphs) will be scaled by this factor.  Use this if you
+have math that you want at some size other than the default 10pt.
+Unfortunately, all math will be the same size, but see the discussion
+below on editing the MP output.  'mag' will also work under 'notex' but
+there seems no point in using it as the font size option (below) works
+as well.
+
+   The option 'psnfss' uses postscript fonts in combination with LaTeX.
+Since this option only makes sense, if LaTeX is being used, the 'latex'
+option is selected automatically.  This option includes the following
+packages for LaTeX: inputenc(latin1), fontenc(T1), mathptmx,
+helvet(scaled=09.2), courier, latexsym and textcomp.
+
+   The option 'psnfss-version7' uses also postscript fonts in LaTeX
+(option 'latex' is also automatically selected), but uses the following
+packages with LaTeX: inputenc(latin1), fontenc(T1), times, mathptmx,
+helvet and courier.
+
+   The option 'nopsnfss' is the default and uses the standard font
+(cmr10 if not otherwise specified).
+
+   The option 'prologues' takes a value as an additional argument and
+adds the line 'prologues:=<value>' to the metapost file.  If a value of
+'2' is specified metapost uses postscript fonts to generate the
+eps-file, so that the result can be viewed using e.g.  ghostscript.
+Normally the output of metapost uses TeX fonts and therefore has to be
+included in a (La)TeX file before you can look at it.
+
+   The option 'noprologues' is the default.  No additional line
+specifying the prologue will be added.
+
+   The option 'a4paper' adds a '[a4paper]' to the documentclass.
+Normally letter paper is used (default).  Since this option is only used
+in case of LaTeX, the 'latex' option is selected automatically.
+
+   The option 'amstex' automatically selects the 'latex' option and
+includes the following LaTeX packages: amsfonts, amsmath(intlimits).  By
+default these packages are not included.
+
+   A name in quotes selects the font that will be used when no explicit
+font is given in a 'set label' or *note title::.  A name recognized by
+TeX (a TFM file exists) must be used.  The default is "cmr10" unless
+'notex' is selected, then it is "pcrr8r" (Courier).  Even under 'notex',
+a TFM file is needed by Metapost.  The file 'pcrr8r.tfm' is the name
+given to Courier in LaTeX's psnfss package.  If you change the font from
+the 'notex' default, choose a font that matches the ASCII encoding at
+least in the range 32-126.  'cmtt10' almost works, but it has a nonblank
+character in position 32 (space).
+
+   The size can be any number between 5.0 and 99.99.  If it is omitted,
+10.0 is used.  It is advisable to use 'magstep' sizes: 10 times an
+integer or half-integer power of 1.2, rounded to two decimals, because
+those are the most available sizes of fonts in TeX systems.
+
+   All the options are optional.  If font information is given, it must
+be at the end, with size (if present) last.  The size is needed to
+select a size for the font, even if the font name includes size
+information.  For example, 'set term mp "cmtt12"' selects cmtt12 shrunk
+to the default size 10.  This is probably not what you want or you would
+have used cmtt10.
+
+   The following common ascii characters need special treatment in TeX:
+        $, &, #, %, _;  |, <, >;  ^, ~,  \\, {, and }
+
+   The five characters $, #, &, _, and % can simply be escaped, e.g.,
+'\\$'.  The three characters <, >, and | can be wrapped in math mode,
+e.g., '$<$'.  The remainder require some TeX work-arounds.  Any good
+book on TeX will give some guidance.
+
+   If you type your labels inside double quotes, backslashes in TeX code
+need to be escaped (doubled).  Using single quotes will avoid having to
+do this, but then you cannot use '\\n' for line breaks.  As of this
+writing, version 3.7 of gnuplot processes titles given in a 'plot'
+command differently than in other places, and backslashes in TeX
+commands need to be doubled regardless of the style of quotes.
+
+   Metapost pictures are typically used in TeX documents.  Metapost
+deals with fonts pretty much the same way TeX does, which is different
+from most other document preparation programs.  If the picture is
+included in a LaTeX document using the graphics package, or in a
+plainTeX document via epsf.tex, and then converted to PostScript with
+dvips (or other dvi-to-ps converter), the text in the plot will usually
+be handled correctly.  However, the text may not appear if you send the
+Metapost output as-is to a PostScript interpreter.
+
+* Menu:
+
+* Metapost_Instructions::
+
+
+File: gnuplot.info,  Node: Metapost_Instructions,  Prev: mp,  Up: mp
+
+4.1.34.1 Metapost Instructions
+..............................
+
+- Set your terminal to Metapost, e.g.:
+        set terminal mp mono "cmtt12" 12
+
+
+   - Select an output-file, e.g.:
+        set output "figure.mp"
+
+
+   - Create your pictures.  Each plot (or multiplot group) will generate
+a separate Metapost beginfig...endfig group.  Its default size will be 5
+by 3 inches.  You can change the size by saying 'set size 0.5,0.5' or
+whatever fraction of the default size you want to have.
+
+   - Quit gnuplot.
+
+   - Generate EPS files by running Metapost on the output of gnuplot:
+        mpost figure.mp  OR  mp figure.mp
+
+   The name of the Metapost program depends on the system, typically
+'mpost' for a Unix machine and 'mp' on many others.  Metapost will
+generate one EPS file for each picture.
+
+   - To include your pictures in your document you can use the graphics
+package in LaTeX or epsf.tex in plainTeX:
+        \\usepackage{graphics} % LaTeX
+        \\input epsf.tex       % plainTeX
+
+   If you use a driver other than dvips for converting TeX DVI output to
+PS, you may need to add the following line in your LaTeX document:
+        \\DeclareGraphicsRule{*}{eps}{*}{}
+
+   Each picture you made is in a separate file.  The first picture is
+in, e.g., figure.0, the second in figure.1, and so on....  To place the
+third picture in your document, for example, all you have to do is:
+        \\includegraphics{figure.2} % LaTeX
+        \\epsfbox{figure.2}         % plainTeX
+
+
+   The advantage, if any, of the mp terminal over a postscript terminal
+is editable output.  Considerable effort went into making this output as
+clean as possible.  For those knowledgeable in the Metapost language,
+the default line types and colors can be changed by editing the arrays
+'lt[]' and 'col[]'.  The choice of solid vs dashed lines, and color vs
+black lines can be change by changing the values assigned to the
+booleans 'dashedlines' and 'colorlines'.  If the default 'tex' option
+was in effect, global changes to the text of labels can be achieved by
+editing the 'vebatimtex...etex' block.  In particular, a LaTeX preamble
+can be added if desired, and then LaTeX's built-in size changing
+commands can be used for maximum flexibility.  Be sure to set the
+appropriate MP configuration variable to force Metapost to run LaTeX
+instead of plainTeX."
+
+
+File: gnuplot.info,  Node: mif,  Next: pbm,  Prev: mp,  Up: complete_list_of_terminals
+
+4.1.35 mif
+----------
+
+Note: Legacy terminal.  The 'mif' terminal driver produces Frame Maker
+MIF format version 3.00.  It plots in MIF Frames with the size 15*10 cm,
+and plot primitives with the same pen will be grouped in the same MIF
+group.  Plot primitives in a 'gnuplot' page will be plotted in a MIF
+Frame, and several MIF Frames are collected in one large MIF Frame.  The
+MIF font used for text is "Times".
+
+   Several options may be set in the MIF 3.00 driver.
+
+   Syntax:
+           set terminal mif {color | colour | monochrome} {polyline | vectors}
+                            {help | ?}
+
+
+   'colour' plots lines with line types >= 0 in colour (MIF sep.  2-7)
+and *note monochrome:: plots all line types in black (MIF sep.  0).
+'polyline' plots curves as continuous curves and *note vectors:: plots
+curves as collections of vectors.  *note help:: and '?'  print online
+help on standard error output--both print a short description of the
+usage; *note help:: also lists the options.
+
+   Examples:
+           set term mif colour polylines    # defaults
+           set term mif                     # defaults
+           set term mif vectors
+           set term mif help"
+
+
+
+File: gnuplot.info,  Node: pbm,  Next: dospc,  Prev: mif,  Up: complete_list_of_terminals
+
+4.1.36 pbm
+----------
+
+Note: only available if gnuplot is configured -with-bitmap-terminals.
+Syntax:
+           set terminal pbm {<fontsize>} {<mode>} {size <x>,<y>}
+
+
+   where <fontsize> is 'small', 'medium', or 'large' and <mode> is *note
+monochrome::, *note gray:: or 'color'.  The default plot size is 640
+pixels wide and 480 pixels high.  The output size is white-space padded
+to the nearest multiple of 8 pixels on both x and y.  This empty space
+may be cropped later if needed.
+
+   The output of the 'pbm' driver depends upon <mode>: *note
+monochrome:: produces a portable bitmap (one bit per pixel), *note
+gray:: a portable graymap (three bits per pixel) and 'color' a portable
+pixmap (color, four bits per pixel).
+
+   The output of this driver can be used with various image conversion
+and manipulation utilities provided by NETPBM. Based on Jef Poskanzer's
+PBMPLUS package, NETPBM provides programs to convert the above PBM
+formats to GIF, TIFF, MacPaint, Macintosh PICT, PCX, X11 bitmap and many
+others.  Complete information is available at
+http://netpbm.sourceforge.net/.
+
+   Examples:
+           set terminal pbm small monochrome                # defaults
+           set terminal pbm color medium size 800,600
+           set output '| pnmrotate 45 | pnmtopng > tilted.png'  # uses NETPBM"
+
+
+
+File: gnuplot.info,  Node: dospc,  Next: pdf,  Prev: pbm,  Up: complete_list_of_terminals
+
+4.1.37 dospc
+------------
+
+Note: legacy terminal.  The 'dospc' interactive terminal supports PCs
+with arbitrary graphics boards, which will be automatically detected.
+It uses the OpenWatcom graphics library.
+
+   Syntax:
+           set terminal dospc
+               {{no}{enhanced}}
+               {fontscale <scale>} {pointsize <scale>} {linewidth <scale}
+               {background <rgbcolor>}
+
+
+   Line widths, and point and font sizes can be scaled using the
+'linewidth', 'pointscale', or 'fontscale' options, respectively.
+
+   'background' sets the background color (default: black).  It is only
+supported with adapters with 16 or more colors.
+
+   {'no'}'enhanced' toggles enhanced text mode features like sub- and
+superscripts, see 'enhanced text' for more information.
+
+   To select a particular (S)VGA graphics mode, set the environment
+variable PCTRM to one of S640, S800, S1024, S1280, or S1600.  Only 256
+color SVGA modes are supported at this time.  For other adapters the
+resolution will be selected automatically.
+
+   Limitations: This terminal supports a maximum of 256 colors.
+Transparency is not available.  Thick lines are approximated very
+crudely, so expect ugly output for non-vertical or non-horizontal
+lines."
+
+
+File: gnuplot.info,  Node: pdf,  Next: pstricks,  Prev: dospc,  Up: complete_list_of_terminals
+
+4.1.38 pdf
+----------
+
+[DEPRECATED] This terminal uses the non-free library PDFlib (GmbH
+Munchen)" to produce files in Portable Document Format.  Unless you have
+a commercial license for PDFlib and need some special feature it
+provides you would do better to use the cairo pdf terminal instead.
+Gnuplot can also export PDF files from wxt or qt interactive terminal
+sessions.
+
+   Syntax:
+           set terminal pdf {monochrome|color|colour}
+                            {{no}enhanced}
+                            {fname "<font>"} {fsize <fontsize>}
+                            {font "<fontname>{,<fontsize>}"} {fontscale <scale>}
+                            {linewidth <lw>} {rounded|butt}
+                            {dl <dashlength>}}
+                            {size <XX>{unit},<YY>{unit}}
+
+
+   The default is to use a different color for each line type.
+Selecting 'monochome' will use black for all linetypes, Even in in mono
+mode you can still use explicit colors for filled areas or linestyles.
+
+   where <font> is the name of the default font to use (default
+Helvetica) and <fontsize> is the font size (in points, default 12).  For
+help on which fonts are available or how to install new ones, please see
+the documentation for your local installation of pdflib.
+
+   The 'enhanced' option enables enhanced text processing features
+(subscripts, superscripts and mixed fonts).  See 'enhanced'.
+
+   The width of all lines in the plot can be increased by the factor <n>
+specified in 'linewidth'.  Similarly 'dashlength' is a multiplier for
+the default dash spacing.
+
+   'rounded' sets line caps and line joins to be rounded; 'butt' is the
+default, butt caps and mitered joins.
+
+   The default size for PDF output is 5 inches by 3 inches.  The *note
+size:: option changes this to whatever the user requests.  By default
+the X and Y sizes are taken to be in inches, but other units are
+possible (currently only cm).
+
+   * does not work.
+
+
+File: gnuplot.info,  Node: pstricks,  Next: qms,  Prev: pdf,  Up: complete_list_of_terminals
+
+4.1.39 pstricks
+---------------
+
+The 'pstricks' driver is intended for use with the "pstricks.sty" macro
+package for TeX or LaTeX. You need "pstricks.sty", and, of course, a
+printer that understands PostScript, or a converter such as Ghostscript.
+
+   PSTricks is available at http://tug.org/PSTricks/.
+(http://tug.org/PSTricks/) This driver definitely does not come close to
+using the full capability of the PSTricks package.
+
+   Syntax:
+           set terminal pstricks
+                          {unit | size <XX>{unit},<YY>{unit}}
+                          {standalone | input}
+                          {blacktext | colortext | colourtext}
+                          {linewidth <lw>} {rounded | butt}
+                          {pointscale <ps>}
+                          {psarrows | gparrows}
+                          {background <rgbcolor>}
+                          {pstricks | pdftricks2}
+
+
+   The 'unit' option produces a plot with internal dimensions 1x1.  The
+default is a plot of 'size 5in,3in'.
+
+   'standalone' produces a LaTeX file with possibly multiple plots,
+ready to be compiled.  The default is 'input' to produce a TeX file
+which can be included.
+
+   'blacktext' forces all text to be written in black.  'colortext'
+enables colored text.  The default is 'blacktext'.
+
+   'rounded' sets line caps and line joins to be rounded.  'butt' sets
+butt caps and mitered joins and is the default.
+
+   'linewidth' and 'pointscale' scale the width of lines and the size of
+point symbols, respectively.
+
+   'psarrows' draws 'arrow's using PSTricks commands which are shorter
+but do not offer all options.  'gparrows' selects drawing arrows using
+gnuplot's own routine for full functionality instead.
+
+   With the option 'pdftricks2' you can create output for the
+'pdftricks2' macro package, which can be used with pdflatex/lualatex.
+Otherwise, output for the 'pstricks' package with traditional tex/latex
+or xelatex is produced.
+
+   The old 'hacktext' option has been replaced by the new default format
+(%h), see 'format specifiers'.
+
+   Transparency requires support by Ghostscript or conversion to PDF."
+
+
+File: gnuplot.info,  Node: qms,  Next: regis,  Prev: pstricks,  Up: complete_list_of_terminals
+
+4.1.40 qms
+----------
+
+The 'qms' terminal driver supports the QMS/QUIC Laser printer, the
+Talaris 1200 and others.  It has no options."
+
+
+File: gnuplot.info,  Node: regis,  Next: svg,  Prev: qms,  Up: complete_list_of_terminals
+
+4.1.41 regis
+------------
+
+Note: legacy terminal.  The 'regis' terminal device generates output in
+the REGIS graphics language.  It has the option of using 4 (the default)
+or 16 colors.
+
+   Syntax:
+           set terminal regis {4 | 16}"
+
+
+
+File: gnuplot.info,  Node: svg,  Next: tek410x,  Prev: regis,  Up: complete_list_of_terminals
+
+4.1.42 svg
+----------
+
+This terminal produces files in the W3C Scalable Vector Graphics format.
+
+   Syntax:
+           set terminal svg {size <x>,<y> {|fixed|dynamic}}
+                            {mouse} {standalone | jsdir <dirname>}
+                            {name <plotname>}
+                            {font "<fontname>{,<fontsize>}"} {{no}enhanced}
+                            {fontscale <multiplier>}
+                            {rounded|butt|square} {solid|dashed} {linewidth <lw>}
+                            {background <rgb_color>}
+
+
+   where <x> and <y> are the size of the SVG plot to generate, 'dynamic'
+allows a svg-viewer to resize plot, whereas the default setting,
+'fixed', will request an absolute size.
+
+   'linewidth <w>' increases the width of all lines used in the figure
+by a factor of <w>.
+
+   <font> is the name of the default font to use (default Arial) and
+<fontsize> is the font size (in points, default 12).  SVG viewing
+programs may substitute other fonts when the file is displayed.
+
+   The enhanced text mode syntax is shared with other gnuplot terminal
+types.  See 'enhanced' for more details.
+
+   The 'mouse' option tells gnuplot to add support for mouse tracking
+and for toggling individual plots on/off by clicking on the
+corresponding key entry.  By default this is done by including a link
+that points to a script in a local directory, usually
+/usr/local/share/gnuplot/<version>/js.  You can change this by using the
+'jsdir' option to specify either a different local directory or a
+general URL. The latter is usually appropriate if you are embedding the
+svg into a web page.  Alternatively, the 'standalone' option embeds the
+mousing code in the svg document itself rather than linking to an
+external resource.
+
+   When an SVG file will be used in conjunction with external files,
+e.g.  if it is referenced by javascript code in a web page or parent
+document, then a unique name is required to avoid potential conflicting
+references to other SVG plots.  Use the *note name:: option to ensure
+uniqueness.
+
+
+File: gnuplot.info,  Node: tek410x,  Next: tek40,  Prev: svg,  Up: complete_list_of_terminals
+
+4.1.43 tek410x
+--------------
+
+The 'tek410x' terminal driver supports the 410x and 420x family of
+Tektronix terminals.  It has no options."
+
+
+File: gnuplot.info,  Node: tek40,  Next: texdraw,  Prev: tek410x,  Up: complete_list_of_terminals
+
+4.1.44 tek40
+------------
+
+Syntax:
+        set terminal sixeltek {<fontsize>} {mono|color|colors <n>} {size <x>,<y>}
+                              {animate}
+
+
+   The 'sixel' output format was originally used by DEC terminals and
+printers.  This driver supports palette images with a maximum of 256
+colors.  The default is 16 which can be changed using the 'colors'
+option.
+
+   The font size can be specified as 'small', 'medium' or 'large'.
+
+   'anchor' causes each new plot to be anchored at the top left of the
+window.  'scroll' intead draws each plot at the current cursor position
+and allows it to scroll with the text.
+
+   For use with xterm, xterm must be compiled/configured with
+"-enable-sixel-graphics" and started with "-ti 340" on the command line.
+
+   Note that gnuplot also supports another sixel output terminal,
+'sixelgd', that offers more options and features."
+
+   This family of terminal drivers supports a variety of VT-like
+terminals.  'tek40xx' supports Tektronix 4010 and others as well as most
+TEK emulators.  'vttek' supports VT-like tek40xx terminal emulators.
+The following are present only if selected when gnuplot is built:
+'kc-tek40xx' supports MS-DOS Kermit Tek4010 terminal emulators in color;
+'km-tek40xx' supports them in monochrome.  'selanar' supports Selanar
+graphics.  'bitgraph' supports BBN Bitgraph terminals.  None have any
+options."
+
+
+File: gnuplot.info,  Node: texdraw,  Next: tgif,  Prev: tek40,  Up: complete_list_of_terminals
+
+4.1.45 texdraw
+--------------
+
+The 'texdraw' terminal driver supports the (La)TeX texdraw environment.
+It is intended for use with the texdraw package, see
+https://www.ctan.org/tex-archive/graphics/texdraw/ .
+
+           set terminal texdraw
+                          {size <XX>{unit},<YY>{unit}}
+                          {standalone | input}
+                          {blacktext | colortext | colourtext}
+                          {linewidth <lw>} {rounded | butt}
+                          {pointscale <ps>}
+                          {psarrows | gparrows} {texpoints | gppoints}
+                          {background <rgbcolor>}
+
+
+   Note: Graphics are in grayscale only.  Text is always black.  Boxes
+and polygons are filled using solid gray levels only.  Patterns are not
+available.
+
+   Points, among other things, are drawn using the LaTeX commands
+"\\Diamond" and "\\Box".  These commands no longer belong to the LaTeX2e
+core; they are included in the latexsym package, which is part of the
+base distribution and thus part of any LaTeX implementation.  Please do
+not forget to use this package.  Other point types use symbols from the
+amssymb package.  For compatibility with plain TeX you need to specify
+the 'gppoints' option.
+
+   'standalone' produces a LaTeX file with possibly multiple plots,
+ready to be compiled.  The default is 'input' to produce a TeX file
+which can be included.
+
+   'blacktext' forces all text to be written in black.  'colortext'
+enables "colored" text.  The default is 'blacktext' and "color" means
+grayscale really.
+
+   'rounded' sets line caps and line joins to be rounded; 'butt' sets
+butt caps and mitered joins and is the default.
+
+   'linewidth' and 'pointscale' scale the width of lines and the size of
+point symbols, respectively.  'pointscale' only applies to 'gppoints'.
+
+   'psarrows' draws 'arrow's using TeXdraw commands which are shorter
+but do not offer all options.  'gparrows' selects drawing arrows using
+gnuplot's own routine for full functionality instead.  Similarly,
+'texpoints', and 'gppoints' select LaTeX symbols or gnuplot's point
+drawing routines."
+
+
+File: gnuplot.info,  Node: tgif,  Next: tkcanvas,  Prev: texdraw,  Up: complete_list_of_terminals
+
+4.1.46 tgif
+-----------
+
+Legacy terminal (present only if gnuplot was configured -with-tgif).
+Tgif is/was an Xlib based interactive 2-D vector graphics drawing tool
+also capable of importing and marking up bitmap images.
+
+   The 'tgif' driver supports a choice of font and font size and
+multiple graphs on the page.  The proportions of the axes are not
+changed.
+
+   Syntax:
+           set terminal tgif {portrait | landscape | default} {<[x,y]>}
+                             {monochrome | color}
+                             {{linewidth | lw} <LW>}
+                             {solid | dashed}
+                             {font "<fontname>{,<fontsize>}"}
+
+
+   where <[x,y]> specifies the number of graphs in the x and y
+directions on the page, 'color' enables color, 'linewidth' scales all
+linewidths by <LW>, "<fontname>" is the name of a valid PostScript font,
+and <fontsize> specifies the size of the PostScript font.  'defaults'
+sets all options to their defaults: 'portrait', '[1,1]', 'color',
+'linewidth 1.0', 'dashed', '"Helvetica,18"'.
+
+   The 'solid' option is usually preferred if lines are colored, as they
+often are in the editor.  Hardcopy will be black-and-white, so 'dashed'
+should be chosen for that.
+
+   Multiplot is implemented in two different ways.
+
+   The first multiplot implementation is the standard gnuplot multiplot
+feature:
+
+           set terminal tgif
+           set output "file.obj"
+           set multiplot
+           set origin x01,y01
+           set size  xs,ys
+           plot ...
+                ...
+           set origin x02,y02
+           plot ...
+           unset multiplot
+
+
+   See *note multiplot:: for further information.
+
+   The second version is the [x,y] option for the driver itself.  The
+advantage of this implementation is that everything is scaled and placed
+automatically without the need for setting origins and sizes; the graphs
+keep their natural x/y proportions of 3/2 (or whatever is fixed by *note
+size::).
+
+   If both multiplot methods are selected, the standard method is chosen
+and a warning message is given.
+
+   Examples of single plots (or standard multiplot):
+           set terminal tgif                  # defaults
+           set terminal tgif "Times-Roman,24"
+           set terminal tgif landscape
+           set terminal tgif landscape solid
+
+
+   Examples using the built-in multiplot mechanism:
+           set terminal tgif portrait [2,4]  # portrait; 2 plots in the x-
+                                             # and 4 in the y-direction
+           set terminal tgif [1,2]           # portrait; 1 plot in the x-
+                                             # and 2 in the y-direction
+           set terminal tgif landscape [3,3] # landscape; 3 plots in both
+                                             # directions"
+
+
+
+File: gnuplot.info,  Node: tkcanvas,  Next: tpic,  Prev: tgif,  Up: complete_list_of_terminals
+
+4.1.47 tkcanvas
+---------------
+
+This terminal driver generates Tk canvas widget commands in one of the
+following scripting languages: Tcl (default), Perl, Python, Ruby, or
+REXX.
+
+   Syntax:
+           set terminal tkcanvas {tcl | perl | perltkx | python | ruby | rexx}
+                                 {standalone | input}
+                                 {interactive}
+                                 {rounded | butt}
+                                 {nobackground | background <rgb color>}
+                                 {{no}rottext}
+                                 {size <width>,<height>}
+                                 {{no}enhanced}
+                                 {externalimages | pixels}
+
+
+   Execute the following sequence of Tcl/Tk commands to display the
+result:
+
+           package require Tk
+           # the following two lines are only required to support external images
+           package require img::png
+           source resize.tcl
+           source plot.tcl
+           canvas .c -width 800 -height 600
+           pack .c
+           gnuplot .c
+
+
+   Or, for Perl/Tk use a program like this:
+
+           use Tk;
+           my $top = MainWindow->new;
+           my $c = $top->Canvas(-width => 800, -height => 600)->pack;
+           my $gnuplot = do "plot.pl";
+           $gnuplot->($c);
+           MainLoop;
+
+
+   Or, for Perl/Tkx use a program like this:
+
+           use Tkx;
+           my $top = Tkx::widget->new(".");
+           my $c = $top->new_tk__canvas(-width => 800, -height => 600);
+           $c->g_pack;
+           my $gnuplot = do "plot.pl";
+           $gnuplot->($c);
+           Tkx::MainLoop();
+
+
+   Or, for Python/Tkinter use a program like this:
+
+           from tkinter import *
+           from tkinter import font
+           root = Tk()
+           c = Canvas(root, width=800, height=600)
+           c.pack()
+           exec(open('plot.py').read())
+           gnuplot(c)
+           root.mainloop()
+
+
+   Or, for Ruby/Tk use a program like this:
+
+           require 'tk'
+           root = TkRoot.new { title 'Ruby/Tk' }
+           c = TkCanvas.new(root, 'width'=>800, 'height'=>600) { pack  { } }
+           load('plot.rb')
+           gnuplot(c)
+           Tk.mainloop
+
+
+   Or, for Rexx/Tk use a program like this:
+
+           /**/
+           call RxFuncAdd 'TkLoadFuncs', 'rexxtk', 'TkLoadFuncs'
+           call TkLoadFuncs
+           cv = TkCanvas('.c', '-width', 800, '-height', 600)
+           call TkPack cv
+           call 'plot.rex' cv
+           do forever
+               cmd = TkWait()
+               if cmd = 'AWinClose' then leave
+               interpret 'call' cmd
+           end
+
+
+   The code generated by 'gnuplot' (in the above examples, this code is
+written to "plot.<ext>") contains the following procedures:
+
+   gnuplot(canvas)
+        takes the name of a canvas as its argument.
+        When called, it clears the canvas, finds the size of the canvas and
+        draws the plot in it, scaled to fit.
+
+
+   gnuplot_plotarea()
+        returns a list containing the borders of the plotting area
+        (xleft, xright, ytop, ybot) in canvas screen coordinates."
+        It works only for 2-dimensional plotting (`plot`).
+
+
+   gnuplot_axisranges()
+        returns the ranges of the two axes in plot coordinates
+        (x1min, x1max, y1min, y1max, x2min, x2max, y2min, y2max).
+        It works only for 2-dimensional plotting (`plot`).
+
+
+   You can create self-contained, minimal scripts using the 'standalone'
+option.  The default is 'input' which creates scripts which have to be
+source'd (or loaded or called or whatever the adequate term is for the
+language selected).
+
+   If the 'interactive' option is specified, mouse clicking on a line
+segment will print the coordinates of its midpoint to stdout.  The user
+can supersede this behavior by supplying a procedure
+user_gnuplot_coordinates which takes the following arguments:
+       win id x1s y1s x2s y2s x1e y1e x2e y2e x1m y1m x2m y2m,
+
+   i.e.  the name of the canvas and the id of the line segment followed
+by the coordinates of its start and end point in the two possible axis
+ranges; the coordinates of the midpoint are only filled for logarithmic
+axes.
+
+   By default the canvas is 'transparent', but an explicit background
+color can be set with the 'background' option.
+
+   'rounded' sets line caps and line joins to be rounded; 'butt' is the
+default: butt caps and mitered joins.
+
+   Text at arbitrary angles can be activated with the 'rottext' option,
+which requires Tcl/Tk 8.6 or later.  The default is 'norottext'.
+
+   The *note size:: option tries to optimize the tic and font sizes for
+the given canvas size.  By default an output size of 800 x 600 pixels is
+assumed.
+
+   'enhanced' selects 'enhanced text' processing (default), but is
+currently only available for Tcl.
+
+   The 'pixels' (default) option selects the failsafe pixel-by-pixel
+image handler, see also 'image pixels'.  The 'externalimages' option
+saves images as external png images, which are later loaded and scaled
+by the tkcanvas code.  This option is only available for Tcl and display
+may be slow in some situations since the Tk image handler does not
+provide arbitrary scaling.  Scripts need to source the provided
+rescale.tcl.
+
+   Interactive mode is not yet implemented for Python/Tk and Rexx/Tk.
+Interactive mode for Ruby/Tk does not yet support
+user_gnuplot_coordinates."
+
+
+File: gnuplot.info,  Node: tpic,  Next: windows,  Prev: tkcanvas,  Up: complete_list_of_terminals
+
+4.1.48 tpic
+-----------
+
+Note: Legacy terminal (not built by default).  The latex, emtex, eepic,
+and tpic terminals in older versions of gnuplot provided minimal support
+for graphics styles beyond simple lines and points.  They have been
+directly superseded by the 'pict2e' terminal.  For more capable
+TeX/LaTeX compatible terminal types see 'cairolatex', 'context',
+'epslatex', 'mp', 'pstricks', and 'tikz'.
+
+   The 'tpic' terminal driver supports the LaTeX picture environment
+with tpic \\specials.  Options are the point size, line width, and
+dot-dash interval.
+
+   Syntax:
+           set terminal tpic <pointsize> <linewidth> <interval>
+
+
+   where *note pointsize:: and 'linewidth' are integers in milli-inches
+and 'interval' is a float in inches.  If a non-positive value is
+specified, the default is chosen: pointsize = 40, linewidth = 6,
+interval = 0.1.
+
+   All drivers for LaTeX offer a special way of controlling text
+positioning: If any text string begins with '{', you also need to
+include a '}' at the end of the text, and the whole text will be
+centered both horizontally and vertically by LaTeX. -- If the text
+string begins with '[', you need to continue it with: a position
+specification (up to two out of t,b,l,r), ']{', the text itself, and
+finally, '}'.  The text itself may be anything LaTeX can typeset as an
+LR-box.  \\rule{}{}'s may help for best positioning.
+
+   Examples: About label positioning: Use gnuplot defaults (mostly
+sensible, but sometimes not really best):
+            set title '\\LaTeX\\ -- $ \\gamma $'
+
+   Force centering both horizontally and vertically:
+            set label '{\\LaTeX\\ -- $ \\gamma $}' at 0,0
+
+   Specify own positioning (top here):
+            set xlabel '[t]{\\LaTeX\\ -- $ \\gamma $}'
+
+   The other label - account for long ticlabels:
+            set ylabel '[r]{\\LaTeX\\ -- $ \\gamma $\\rule{7mm}{0pt}}'"
+
+
+
+File: gnuplot.info,  Node: windows,  Next: wxt,  Prev: tpic,  Up: complete_list_of_terminals
+
+4.1.49 windows
+--------------
+
+The 'windows' terminal is a fast interactive terminal driver that uses
+the Windows GDI to draw and write text.  The cross-platform 'terminal
+wxt' and 'terminal qt' are also supported on Windows.
+
+   Syntax:
+           set terminal windows {<n>}
+                                {color | monochrome}
+                                {solid | dashed}
+                                {rounded | butt}
+                                {enhanced | noenhanced}
+                                {font <fontspec>}
+                                {fontscale <scale>}
+                                {linewidth <scale>}
+                                {pointscale <scale>}
+                                {background <rgb color>}
+                                {title "Plot Window Title"}
+                                {{size | wsize} <width>,<height>}
+                                {position <x>,<y>}
+                                {docked {layout <rows>,<cols>} | standalone}
+                                {close}
+
+
+   Multiple plot windows are supported: 'set terminal win <n>' directs
+the output to plot window number n.
+
+   'color' and *note monochrome:: select colored or mono output,
+'dashed' and 'solid' select dashed or solid lines.  Note that 'color'
+defaults to 'solid', whereas *note monochrome:: defaults to 'dashed'.
+'rounded' sets line caps and line joins to be rounded; 'butt' is the
+default, butt caps and mitered joins.  'enhanced' enables enhanced text
+mode features (subscripts, superscripts and mixed fonts, see 'enhanced
+text' for more information).  '<fontspec>' is in the format
+"<fontface>,<fontsize>", where "<fontface>" is the name of a valid
+Windows font, and <fontsize> is the size of the font in points and both
+components are optional.  Note that in previous versions of gnuplot the
+'font' statement could be left out and <fontsize> could be given as a
+number without double quotes.  This is no longer supported.
+'linewidth', 'fontscale', 'pointscale' can be used to scale the width of
+lines, the size of text, or the size of the point symbols.  *note
+title:: changes the title of the graph window.  *note size:: defines the
+width and height of the window's drawing area in pixels, 'wsize' defines
+the actual size of the window itself and *note position:: defines the
+origin of the window i.e.  the position of the top left corner on the
+screen (again in pixel).  These options override any default settings
+from the 'wgnuplot.ini' file.
+
+   'docked' embeds the graph window in the wgnuplot text window and the
+*note size:: and *note position:: options are ignored.  Note that
+'docked' is not available for console-mode gnuplot.  Setting this option
+changes the default for new" windows.  The initial default is
+'standalone'.  The 'layout' option allows to reserve a minimal number of
+columns and rows for graphs in docked mode.  If there are more graphs
+than fit the given layout, additional rows will be added.  Graphs are
+sorted by the numerical id, filling rows first.
+
+   Other options may be changed using the 'graph-menu' or the
+initialization file 'wgnuplot.ini'.
+
+   /* FIXME: Move to persist section */ The Windows version normally
+terminates immediately as soon as the end of any files given as command
+line arguments is reached (i.e.  in non-interactive mode), unless you
+specify '-' as the last command line option.  It will also not show the
+text-window at all, in this mode, only the plot.  By giving the optional
+argument '-persist' (same as for gnuplot under x11; former Windows-only
+options '/noend' or '-noend' are still accepted as well), will not close
+gnuplot.  Contrary to gnuplot on other operating systems, gnuplot's
+interactive command line is accessible after the -persist option.
+
+   The plot window remains open when the gnuplot terminal is changed
+with a 'set term' command.  The plot window can be closed with 'set term
+windows close'.
+
+   'gnuplot' supports different methods to create printed output on
+Windows, see 'windows printing'.  The windows terminal supports data
+exchange with other programs via clipboard and EMF files, see
+'graph-menu'.  You can also use the 'terminal emf' to create EMF files.
+
+* Menu:
+
+* graph-menu::
+* printing::
+* text-menu"::
+* wgnuplot.mnu"::
+* wgnuplot.ini::
+
+
+File: gnuplot.info,  Node: graph-menu,  Next: printing,  Prev: windows,  Up: windows
+
+4.1.49.1 graph-menu
+...................
+
+The 'gnuplot graph' window has the following options on a pop-up menu
+accessed by pressing the right mouse button(*) or selecting 'Options'
+from the system menu or the toolbar:
+
+   'Copy to Clipboard' copies a bitmap and an enhanced metafile picture.
+
+   'Save as EMF...' allows the user to save the current graph window as
+enhanced metafile (EMF or EMF+).
+
+   'Save as Bitmap...'  allows the user to save a copy of the graph as
+bitmap file.
+
+   'Print...'  prints the graphics windows using a Windows printer
+driver and allows selection of the printer and scaling of the output."
+See also 'windows printing'.
+
+   'Bring to Top' when checked raises the graph window to the top after
+every plot.
+
+   'Color' when checked enables color output.  When unchecked it forces
+all grayscale output.  This is e.g.  useful to test appearance of
+monochrome printouts.
+
+   'GDI backend' draws to the screen using Windows GDI. This is the
+classical windows terminal, which is fast, but lacks many features such
+as anti-aliasing, oversampling and full transparency support.  It is now
+deprecated.  The 'GDI backend' which uses the classic GDI API is
+deprecated and has been disabled in this version.
+
+   'GDI+ backend' draws to the screen using the GDI+ Windows API. It
+supports full antialiasing, oversampling, transparency and custom dash
+patterns.  This was the default in versions 5.0 and 5.2.
+
+   'Direct2D backend' uses Direct2D & DirectWrite APIs to draw.  It uses
+graphic card acceleration and is hence typically much faster.  Since
+Direct2D can" not create EMF data, saving and copying to clipboard of
+EMF data fall back" to GDI+ while bitmap data is generated by D2d.  This
+is the recommended and default backend since version 5.3.
+
+   'Oversampling' draws diagonal lines at fractional pixel positions to
+avoid "wobbling" effects.  Vertical or horizontal lines are still
+snapped to integer pixel positions to avoid blurry lines.
+
+   'Antialiasing' enables smoothing of lines and edges.  Note that this
+slows down drawing.  *note polygons:: is enabled by default but might
+slow down drawing with the GDI+ backend.
+
+   'Fast rotation' switches antialiasing temporarily off while rotating
+the graph with the mouse.  This speeds up drawing considerably at the
+expense of an additional redraw after releasing the mouse button.
+
+   'Background...'  sets the window background color.
+
+   'Choose Font...'  selects the font used in the graphics window.
+
+   'Line Styles...'  allows customization of the line colors and styles.
+
+   'Update wgnuplot.ini' saves the current window locations, window
+sizes, text window font, text window font size, graph window font, graph
+window font size, background color to the initialization file
+'wgnuplot.ini'.
+
+   (*) Note that this menu is only available by pressing the right mouse
+button with 'unset mouse'.
+
+
+File: gnuplot.info,  Node: printing,  Next: text-menu",  Prev: graph-menu,  Up: windows
+
+4.1.49.2 printing
+.................
+
+In order of preference, graphs may be printed in the following ways:
+
+   '1.'  Use the 'gnuplot' command *note terminal:: to select a printer
+and *note output:: to redirect output to a file.
+
+   '2.'  Select the 'Print...'  command from the 'gnuplot graph' window.
+An extra command 'screendump' does this from the text window.
+
+   '3.'  If 'set output "PRN"' is used, output will go to a temporary
+file.  When you exit from 'gnuplot' or when you change the output with
+another *note output:: command, a dialog box will appear for you to
+select a printer port.  If you choose OK, the output will be printed on
+the selected port, passing unmodified through the print manager.  It is
+possible to accidentally (or deliberately) send printer output meant for
+one printer to an incompatible printer.
+
+
+File: gnuplot.info,  Node: text-menu",  Next: wgnuplot.mnu",  Prev: printing,  Up: windows
+
+4.1.49.3 text-menu", /* FIXME: this is not really related to the windows driver, but the windows platform */
+............................................................................................................
+
+The 'gnuplot text' window has the following options on a pop-up menu
+accessed by pressing the right mouse button or selecting 'Options' from
+the system menu:
+
+   'Copy to Clipboard' copies marked text to the clipboard.
+
+   'Paste' copies text from the clipboard as if typed by the user.
+
+   'Choose Font...'  selects the font used in the text window.
+
+   'System Colors' when selected makes the text window honor the System
+Colors set using the Control Panel.  When unselected, text is black or
+blue on a white background.
+
+   'Wrap long lines' when selected lines longer than the current window
+width are wrapped.
+
+   'Update wgnuplot.ini' saves the current settings to the
+initialisation file 'wgnuplot.ini', which is located in the user's
+application data directory.
+
+
+File: gnuplot.info,  Node: wgnuplot.mnu",  Next: wgnuplot.ini,  Prev: text-menu",  Up: windows
+
+4.1.49.4 wgnuplot.mnu", /* FIXME: this is not really related to the windows driver, but the windows platform */
+...............................................................................................................
+
+If the menu file 'wgnuplot.mnu' is found in the same directory as
+'gnuplot', then the menu specified in 'wgnuplot.mnu' will be loaded.
+Menu commands:
+
+      [Menu]      starts a new menu with the name on the following line.
+      [EndMenu]   ends the current menu.
+      [--]        inserts a horizontal menu separator.
+      [|]         inserts a vertical menu separator.
+      [Button]    puts the next macro on a push button instead of a menu.
+
+
+   Macros take two lines with the macro name (menu entry) on the first
+line and the macro on the second line.  Leading spaces are ignored.
+Macro commands:
+
+      [INPUT]     Input string with prompt terminated by [EOS] or {ENTER}
+      [EOS]       End Of String terminator. Generates no output.
+      [OPEN]      Get name of a file to open, with the title of the dialog
+                  terminated by [EOS], followed by a default filename terminated
+                  by [EOS] or {ENTER}.
+      [SAVE]      Get name of a file to save.  Parameters like [OPEN]
+      [DIRECTORY] Get name of a directory, with the title of the dialog
+                  terminated by [EOS] or {ENTER}
+
+
+   Macro character substitutions:
+
+      {ENTER}     Carriage Return '\\r'
+      {TAB}       Tab '\\011'
+      {ESC}       Escape '\\033'
+      {^A}        '\\001'
+      ...
+      {^_}        '\\031'
+
+
+   Macros are limited to 256 characters after expansion.
+
+
+File: gnuplot.info,  Node: wgnuplot.ini,  Prev: wgnuplot.mnu",  Up: windows
+
+4.1.49.5 wgnuplot.ini
+.....................
+
+The Windows text window and the 'windows' terminal will read some of
+their options from the '[WGNUPLOT]' section of 'wgnuplot.ini'.  This
+file is located in the user's application data directory.  Here's a
+sample 'wgnuplot.ini' file:
+
+           [WGNUPLOT]
+           TextOrigin=0 0
+           TextSize=640 150
+           TextFont=Consolas,9
+           TextWrap=1
+           TextLines=400
+           TextMaximized=0
+           SysColors=0
+           GraphOrigin=0 150
+           GraphSize=640 330
+           GraphFont=Tahoma,10
+           GraphColor=1
+           GraphToTop=1
+           GraphGDI+=1
+           GraphD2D=0
+           GraphGDI+Oversampling=1
+           GraphAntialiasing=1
+           GraphPolygonAA=1
+           GraphFastRotation=1
+           GraphBackground=255 255 255
+           DockVerticalTextFrac=350
+           DockHorizontalTextFrac=400
+           Border=0 0 0 0 0
+           Axis=192 192 192 2 2
+           Line1=0 0 255 0 0
+           Line2=0 255 0 0 1
+           Line3=255 0 0 0 2
+           Line4=255 0 255 0 3
+           Line5=0 0 128 0 4
+
+
+   These settings apply to the wgnuplot text-window only."
+
+   The 'TextOrigin' and 'TextSize' entries specify the location and size
+of the text window.  If 'TextMaximized' is non-zero, the window will be
+maximized.
+
+   The 'TextFont' entry specifies the text window font and size.
+
+   The 'TextWrap' entry selects wrapping of long text lines.
+
+   The 'TextLines' entry specifies the number of (unwrapped) lines the
+internal buffer of the text window can hold.  This value currently
+cannot be changed from within wgnuplot.
+
+   See 'text-menu'.
+
+   'DockVerticalTextFrac' and 'DockHorizontalTextFrac' set the fraction
+of the window reserved for the text window in permille of the vertical
+or horizontal layout.
+
+   The 'GraphFont' entry specifies the font name and size in points.
+
+   The five numbers given in the 'Border', 'Axis' and 'Line' entries are
+the 'Red' intensity (0-255), 'Green' intensity, 'Blue' intensity, 'Color
+Linestyle' and 'Mono Linestyle'.  'Linestyles' are 0=SOLID, 1=DASH,
+2=DOT, 3=DASHDOT, 4=DASHDOTDOT. In the sample 'wgnuplot.ini' file above,
+Line 2 is a green solid line in color mode, or a dashed line in
+monochrome mode.  The default line width is 1 pixel.  If 'Linestyle' is
+negative, it specifies the width of a SOLID line in pixels.  Line1 and
+any linestyle used with the 'points' style must be SOLID with unit
+width.
+
+   See 'graph-menu'."
+
+
+File: gnuplot.info,  Node: wxt,  Next: x11,  Prev: windows,  Up: complete_list_of_terminals
+
+4.1.50 wxt
+----------
+
+The 'wxt' terminal device generates output in a separate window.  The
+window is created by the wxWidgets library, where the 'wxt' comes from.
+The actual drawing is done via cairo, a 2D graphics library, and pango,
+a library for laying out and rendering text.
+
+   Syntax:
+             set term wxt {<n>}
+                          {size <width>,<height>} {position <x>,<y>}
+                          {background <rgb_color> | nobackground}
+                          {{no}enhanced}
+                          {font <font>} {fontscale <scale>}
+                          {title "title"}
+                          {linewidth <lw>} {butt|rounded|square}
+                          {dashlength <dl>}
+                          {{no}persist}
+                          {{no}raise}
+                          {{no}ctrl}
+                          {close}
+
+
+   Multiple plot windows are supported: 'set terminal wxt <n>' directs
+the output to plot window number n.
+
+   The default window title is based on the window number.  This title
+can also be specified with the keyword "title".
+
+   Plot windows remain open even when the 'gnuplot' driver is changed to
+a different device.  A plot window can be closed by pressing the letter
+'q' while that window has input focus, by choosing 'close' from a window
+manager menu, or with 'set term wxt <n> close'.
+
+   The size of the plot area is given in pixels, it defaults to 640x384.
+In addition to that, the actual size of the window also includes the
+space reserved for the toolbar and the status bar.  When you resize a
+window, the plot is immediately scaled to fit in the new size of the
+window.  Unlike other interactive terminals, the 'wxt' terminal scales
+the whole plot, including fonts and linewidths, and keeps its global
+aspect ratio constant, leaving an empty space painted in gray.  If you
+type *note replot::, click the *note replot:: icon in the terminal
+toolbar or type a new 'plot' command, the new plot will completely fit
+in the window and the font size and the linewidths will be reset to
+their defaults.
+
+   The position option can be used to set the position of the plot
+window.  The position option only applies to the first plot after the
+'set term' command.
+
+   The active plot window (the one selected by 'set term wxt <n>') is
+interactive.  Its behaviour is shared with other terminal types.  See
+'mouse' for details.  It also has some extra icons, which are supposed
+to be self-explanatory.
+
+   This terminal supports an enhanced text mode, which allows font and
+other formatting commands (subscripts, superscripts, etc.)  to be
+embedded in labels and other text strings.  The enhanced text mode
+syntax is shared with other gnuplot terminal types.  See 'enhanced' for
+more details.
+
+   <font> is in the format "FontFace,FontSize", i.e.  the face and the
+size comma-separated in a single string.  FontFace is a usual font face
+name, such as \'Arial\'.  If you do not provide FontFace, the wxt
+terminal will use \'Sans\'.  FontSize is the font size, in points.  If
+you do not provide it, the wxt terminal will use a size of 10 points.
+        For example :
+           set term wxt font "Arial,12"
+           set term wxt font "Arial" # to change the font face only
+           set term wxt font ",12" # to change the font size only
+           set term wxt font "" # to reset the font name and size
+
+
+   The fonts are retrieved from the usual fonts subsystems.  Under
+Windows, those fonts are to be found and configured in the entry "Fonts"
+of the control panel.  Under UNIX, they are handled by "fontconfig".
+
+   Pango, the library used to layout the text, is based on utf-8.  Thus,
+the wxt terminal has to convert from your encoding to utf-8.  The
+default input encoding is based on your \'locale\'.  If you want to use
+another encoding, make sure gnuplot knows which one you are using.  See
+*note encoding:: for more details.
+
+   Pango may give unexpected results with fonts that do not respect the
+unicode mapping.  With the Symbol font, for example, the wxt terminal
+will use the map provided by http://www.unicode.org/ to translate
+character codes to unicode.  Pango will do its best to find a font
+containing this character, looking for your Symbol font, or other fonts
+with a broad unicode coverage, like the DejaVu fonts.  Note that "the
+Symbol font" is to be understood as the Adobe Symbol font, distributed
+with Acrobat Reader as "SY______.PFB". Alternatively, the OpenSymbol
+font, distributed with OpenOffice.org as "opens___.ttf", offers the same
+characters.  Microsoft has distributed a Symbol font ("symbol.ttf"), but
+it has a different character set with several missing or moved
+mathematic characters.  If you experience problems with your default
+setup (if the demo enhancedtext.dem is not displayed properly for
+example), you probably have to install one of the Adobe or OpenOffice
+Symbol fonts, and remove the Microsoft one.  Other non-conform fonts,
+such as "wingdings" have been observed working.
+
+   The rendering of the plot can be altered with a dialog available from
+the toolbar.  To obtain the best output possible, the rendering involves
+three mechanisms : antialiasing, oversampling and hinting.  Antialiasing
+allows to display non-horizontal and non-vertical lines smoother.
+Oversampling combined with antialiasing provides subpixel accuracy, so
+that gnuplot can draw a line from non-integer coordinates.  This avoids
+wobbling effects on diagonal lines ('plot x' for example).  Hinting
+avoids the blur on horizontal and vertical lines caused by oversampling.
+The terminal will snap these lines to integer coordinates so that a
+one-pixel-wide line will actually be drawn on one and only one pixel.
+
+   By default, the window is raised to the top of your desktop when a
+plot is drawn.  This can be controlled with the keyword "raise".  The
+keyword "persist" will prevent gnuplot from exiting before you
+explicitly close all the plot windows.  Finally, by default the key
+<space> raises the gnuplot console window, and 'q' closes the plot
+window.  The keyword "ctrl" allows you to replace those bindings by
+<ctrl>+<space> and <ctrl>+'q', respectively.  These three keywords
+(raise, persist and ctrl) can also be set and remembered between
+sessions through the configuration dialog."
+
+
+File: gnuplot.info,  Node: x11,  Next: xlib,  Prev: wxt,  Up: complete_list_of_terminals
+
+4.1.51 x11
+----------
+
+Syntax:
+        set terminal x11 {<n> | window "<string>"}
+                         {title "<string>"}
+                         {{no}enhanced} {font <fontspec>}
+                         {linewidth LW}
+                         {{no}persist} {{no}raise} {{no}ctrlq}
+                         {{no}replotonresize}
+                         {close}
+                         {size XX,YY} {position XX,YY}
+        set terminal x11 {reset}
+
+
+   Multiple plot windows are supported: 'set terminal x11 <n>' directs
+the output to plot window number n.  If n is not 0, the terminal number
+will be appended to the window title (unless a title has been supplied
+manually) and the icon will be labeled 'Gnuplot <n>'.  The active window
+may be distinguished by a change in cursor (from default to crosshair).
+
+   The 'x11' terminal can connect to X windows previously created by an
+outside application via the option 'window' followed by a string
+containing the X ID for the window in hexadecimal format.  Gnuplot uses
+that external X window as a container since X does not allow for
+multiple clients selecting the ButtonPress event.  In this way,
+gnuplot's mouse features work within the contained plot window.
+
+        set term x11 window "220001e"
+
+
+   The x11 terminal supports enhanced text mode (see 'enhanced'),
+subject to the available fonts.  In order for font size commands
+embedded in text to have any effect, the default x11 font must be
+scalable.  Thus the first example below will work as expected, but the
+second will not.
+
+        set term x11 enhanced font "arial,15"
+        set title '{/=20 Big} Medium {/=5 Small}'
+
+
+        set term x11 enhanced font "terminal-14"
+        set title '{/=20 Big} Medium {/=5 Small}'
+
+
+   Plot windows remain open even when the 'gnuplot' driver is changed to
+a different device.  A plot window can be closed by pressing the letter
+q while that window has input focus, or by choosing 'close' from a
+window manager menu.  All plot windows can be closed by specifying *note
+reset::, which actually terminates the subprocess which maintains the
+windows (unless '-persist' was specified).  The 'close' command can be
+used to close individual plot windows by number.  However, after a *note
+reset::, those plot windows left due to persist cannot be closed with
+the command 'close'.  A 'close' without a number closes the current
+active plot window.
+
+   The gnuplot outboard driver, gnuplot_x11, is searched in a default
+place chosen when the program is compiled.  You can override that by
+defining the environment variable GNUPLOT_DRIVER_DIR to point to a
+different location.
+
+   Plot windows will automatically be closed at the end of the session
+unless the '-persist' option was given.
+
+   The options 'persist' and *note raise:: are unset by default, which
+means that the defaults (persist == no and raise == yes) or the command
+line options -persist / -raise or the Xresources are taken.  If
+[no]persist or [no]raise are specified, they will override command line
+options and Xresources.  Setting one of these options takes place
+immediately, so the behaviour of an already running driver can be
+modified.  If the window does not get raised, see discussion in *note
+raise::.
+
+   The option 'replotonresize' (active by default) replots the data when
+the plot window is resized.  Without this option, the even-aspect-ratio
+scaling may result in the plot filling only part of the window after
+resizing.  With this option, gnuplot does a full replot on each resize
+event, resulting in better space utilization.  This option is generally
+desirable, unless the potentially CPU-intensive replotting during
+resizing is a concern.  Replots can be manually initiated with hotkey
+'e' or the 'replot' command.
+      "
+
+   The option 'title "<title name>"' will supply the title name of the
+window for the current plot window or plot window <n> if a number is
+given.  Where (or if) this title is shown depends on your X window
+manager.
+
+   The size option can be used to set the size of the plot window.  The
+size option will only apply to newly created windows.
+
+   The position option can be used to set the position of the plot
+window.  The position option will only apply to newly created windows.
+
+   The size or aspect ratio of a plot may be changed by resizing the
+'gnuplot' window.
+
+   Linewidths and pointsizes may be changed from within 'gnuplot' with
+'set linestyle'.
+
+   For terminal type 'x11', 'gnuplot' accepts (when initialized) the
+standard X Toolkit options and resources such as geometry, font, and
+name from the command line arguments or a configuration file.  See the
+X(1) man page (or its equivalent) for a description of such options.
+
+   A number of other 'gnuplot' options are available for the 'x11'
+terminal.  These may be specified either as command-line options when
+'gnuplot' is invoked or as resources in the configuration file
+".Xdefaults".  They are set upon initialization and cannot be altered
+during a 'gnuplot' session.  (except 'persist' and *note raise::)
+
+* Menu:
+
+* x11_fonts::
+* command-line_options_::
+* color_resources_::
+* grayscale_resources_::
+* line_resources_::
+* x11_pm3d_resources::
+* x11_other_resources::
+
+
+File: gnuplot.info,  Node: x11_fonts,  Next: command-line_options_,  Prev: x11,  Up: x11
+
+4.1.51.1 x11_fonts
+..................
+
+Upon initial startup, the default font is taken from the X11 resources
+as set in the system or user .Xdefaults file or on the command line.
+
+   Example:
+           gnuplot*font: lucidasans-bold-12
+
+   A new default font may be specified to the x11 driver from inside
+gnuplot using
+          `set term x11 font "<fontspec>"`
+
+   The driver first queries the X-server for a font of the exact name
+given.  If this query fails, then it tries to interpret <fontspec> as
+"<font>,<size>,<slant>,<weight>" and to construct a full X11 font name
+of the form
+           -*-<font>-<weight>-<s>-*-*-<size>-*-*-*-*-*-<encoding>
+
+
+      <font> is the base name of the font (e.g. Times or Symbol)
+      <size> is the point size (defaults to 12 if not specified)
+      <s> is 'i' if <slant>=="italic" 'o' if <slant>=="oblique" 'r' otherwise
+      <weight> is 'medium' or 'bold' if explicitly requested, otherwise '*'
+      <encoding> is set based on the current character set.
+
+   So 'set term x11 font "arial,15,italic"' will be translated to
+-*-arial-*-i-*-*-15-*-*-*-*-*-iso8859-1 (assuming default encoding).
+The <size>, <slant>, and <weight> specifications are all optional.  If
+you do not specify <slant> or <weight> then you will get whatever font
+variant the font server offers first.  You may set a default encoding
+via the corresponding X11 resource.  E.g.
+           gnuplot*encoding: iso8859-15
+
+   The driver also recognizes some common PostScript font names and
+replaces them with possible X11 or TrueType equivalents.  This same
+sequence is used to process font requests from 'set label'.
+
+   If your gnuplot was built with configuration option
+-enable-x11-mbfonts, you can specify multi-byte fonts by using the
+prefix "mbfont:" on the font name.  An additional font may be given,
+separated by a semicolon.  Since multi-byte font encodings are
+interpreted according to the locale setting, you must make sure that the
+environmental variable LC_CTYPE is set to some appropriate locale value
+such as ja_JP.eucJP, ko_KR.EUC, or zh_CN.EUC.
+
+   Example:
+           set term x11 font 'mbfont:kana14;k14'
+                 # 'kana14' and 'k14' are Japanese X11 font aliases, and ';'
+                 # is the separator of font names.
+           set term x11 font 'mbfont:fixed,16,r,medium'
+                 # <font>,<size>,<slant>,<weight> form is also usable.
+           set title '(mb strings)' font 'mbfont:*-fixed-medium-r-normal--14-*'
+
+
+   The same syntax applies to the default font in Xresources settings,
+for example,
+           gnuplot*font: \\
+               mbfont:-misc-fixed-medium-r-normal--14-*-*-*-c-*-jisx0208.1983-0
+
+
+   If gnuplot is built with -enable-x11-mbfonts, you can use two special
+PostScript font names 'Ryumin-Light-*' and 'GothicBBB-Medium-*'
+(standard Japanese PS fonts) without the prefix "mbfont:".
+
+
+File: gnuplot.info,  Node: command-line_options_,  Next: color_resources_,  Prev: x11_fonts,  Up: x11
+
+4.1.51.2 command-line_options
+.............................
+
+In addition to the X Toolkit options, the following options may be
+specified on the command line when starting 'gnuplot' or as resources in
+your ".Xdefaults" file (note that *note raise:: and 'persist' can be
+overridden later by 'set term x11 [no]raise [no]persist)':
+
+      `-mono`     forces monochrome rendering on color displays.
+      `-gray`     requests grayscale rendering on grayscale or color displays.
+                  (Grayscale displays receive monochrome rendering by default.)
+      `-clear`    requests that the window be cleared momentarily before a
+                  new plot is displayed.
+      `-tvtwm`    requests that geometry specifications for position of the
+                  window be made relative to the currently displayed portion
+                  of the virtual root.
+      `-raise`    raises plot window after each plot
+      `-noraise`  does not raise plot window after each plot
+      `-ctrlq   ` closes window on ctrl-q rather than q
+      `-persist`  plot windows survive after main gnuplot program exits
+
+
+   The options are shown above in their command-line syntax.  When
+entered as resources in ".Xdefaults", they require a different syntax.
+
+   Example:
+           gnuplot*gray:  on
+           gnuplot*ctrlq: on
+
+
+   'gnuplot' also provides a command line option ('-pointsize <v>') and
+a resource, 'gnuplot*pointsize: <v>', to control the size of points
+plotted with the 'points' plotting style.  The value 'v' is a real
+number (greater than 0 and less than or equal to ten) used as a scaling
+factor for point sizes.  For example, '-pointsize 2' uses points twice
+the default size, and '-pointsize 0.5' uses points half the normal size.
+
+   The '-ctrlq' switch changes the hot-key that closes a plot window
+from 'q' to '<ctrl>q'.  This is useful is you are using the
+keystroke-capture feature 'pause mouse keystroke', since it allows the
+character 'q' to be captured just as all other alphanumeric characters.
+The '-ctrlq' switch similarly replaces the <space> hot-key with
+<ctrl><space> for the same reason.
+
+
+File: gnuplot.info,  Node: color_resources_,  Next: grayscale_resources_,  Prev: command-line_options_,  Up: x11
+
+4.1.51.3 color_resources
+........................
+
+NB: THIS SECTION IS LARGELY IRRELEVANT IN GNUPLOT VERSION 5 The X11
+terminal honors the following resources (shown here with their default
+values) or the greyscale resources.  The values may be color names as
+listed in the X11 rgb.txt file on your system, hexadecimal RGB color
+specifications (see X11 documentation), or a color name followed by a
+comma and an 'intensity' value from 0 to 1.  For example, 'blue, 0.5'
+means a half intensity blue.
+
+      gnuplot*background:  white
+      gnuplot*textColor:   black
+      gnuplot*borderColor: black
+      gnuplot*axisColor:   black
+      gnuplot*line1Color:  red
+      gnuplot*line2Color:  green
+      gnuplot*line3Color:  blue
+      gnuplot*line4Color:  magenta
+      gnuplot*line5Color:  cyan
+      gnuplot*line6Color:  sienna
+      gnuplot*line7Color:  orange
+      gnuplot*line8Color:  coral
+
+
+   The command-line syntax for these is simple only for background,
+which maps directly to the usual X11 toolkit option "-bg".  All others
+can only be set on the command line by use of the generic "-xrm"
+resource override option
+
+   Examples:
+
+           gnuplot -background coral
+
+   to change the background color.
+
+           gnuplot -xrm 'gnuplot*line1Color:blue'
+
+   to override the first linetype color.
+
+
+File: gnuplot.info,  Node: grayscale_resources_,  Next: line_resources_,  Prev: color_resources_,  Up: x11
+
+4.1.51.4 grayscale_resources
+............................
+
+When '-gray' is selected, 'gnuplot' honors the following resources for
+grayscale or color displays (shown here with their default values).
+Note that the default background is black.
+
+      gnuplot*background: black
+      gnuplot*textGray:   white
+      gnuplot*borderGray: gray50
+      gnuplot*axisGray:   gray50
+      gnuplot*line1Gray:  gray100
+      gnuplot*line2Gray:  gray60
+      gnuplot*line3Gray:  gray80
+      gnuplot*line4Gray:  gray40
+      gnuplot*line5Gray:  gray90
+      gnuplot*line6Gray:  gray50
+      gnuplot*line7Gray:  gray70
+      gnuplot*line8Gray:  gray30
+
+
+
+File: gnuplot.info,  Node: line_resources_,  Next: x11_pm3d_resources,  Prev: grayscale_resources_,  Up: x11
+
+4.1.51.5 line_resources
+.......................
+
+NB: THIS SECTION IS LARGELY IRRELEVANT IN GNUPLOT VERSION 5 'gnuplot'
+honors the following resources for setting the width (in pixels) of plot
+lines (shown here with their default values.)  0 or 1 means a minimal
+width line of 1 pixel width.  A value of 2 or 3 may improve the
+appearance of some plots.
+
+      gnuplot*borderWidth: 1
+      gnuplot*axisWidth:   0
+      gnuplot*line1Width:  0
+      gnuplot*line2Width:  0
+      gnuplot*line3Width:  0
+      gnuplot*line4Width:  0
+      gnuplot*line5Width:  0
+      gnuplot*line6Width:  0
+      gnuplot*line7Width:  0
+      gnuplot*line8Width:  0
+
+
+   'gnuplot' honors the following resources for setting the dash style
+used for plotting lines.  0 means a solid line.  A two-digit number 'jk'
+('j' and 'k' are >= 1 and <= 9) means a dashed line with a repeated
+pattern of 'j' pixels on followed by 'k' pixels off.  For example, '16'
+is a dotted line with one pixel on followed by six pixels off.  More
+elaborate on/off patterns can be specified with a four-digit value.  For
+example, '4441' is four on, four off, four on, one off.  The default
+values shown below are for monochrome displays or monochrome rendering
+on color or grayscale displays.  Color displays default to dashed:off
+
+      gnuplot*dashed:       off
+      gnuplot*borderDashes:   0
+      gnuplot*axisDashes:    16
+      gnuplot*line1Dashes:    0
+      gnuplot*line2Dashes:   42
+      gnuplot*line3Dashes:   13
+      gnuplot*line4Dashes:   44
+      gnuplot*line5Dashes:   15
+      gnuplot*line6Dashes: 4441
+      gnuplot*line7Dashes:   42
+      gnuplot*line8Dashes:   13
+
+
+   , "
+
+
+File: gnuplot.info,  Node: x11_pm3d_resources,  Next: x11_other_resources,  Prev: line_resources_,  Up: x11
+
+4.1.51.6 x11 pm3d_resources
+...........................
+
+NB: THIS SECTION IS LARGELY IRRELEVANT IN GNUPLOT VERSION 5
+
+   By default 'gnuplot' uses the default visual of the screen.  The
+number of colors which can be allocated depends on the visual class
+chosen.  On a visual class with a depth > 12bit, gnuplot starts with a
+maximal number of 0x200 colors.  On a visual class with a depth > 8bit
+(but <= 12 bit) the maximal number of colors is 0x100, on <= 8bit
+displays the maximum number of colors is 240 (16 are left for line
+colors).
+
+   Gnuplot first starts to allocate the maximal number of colors as
+stated above.  If this fails, the number of colors is reduced by the
+factor 2 until gnuplot gets all colors which are requested.  If dividing
+*note maxcolors:: by 2 repeatedly results in a number which is smaller
+than 'mincolors' 'gnuplot' tries to install a private colormap.  In this
+case the window manager is responsible for swapping colormaps when the
+pointer is moved in and out the x11 driver's window.
+
+   The default for 'mincolors' is maxcolors / (num_colormaps > 1 ?  2 :
+8), where num_colormaps is the number of colormaps which are currently
+used by gnuplot (usually 1, if only one x11 window is open).
+
+
+File: gnuplot.info,  Node: x11_other_resources,  Prev: x11_pm3d_resources,  Up: x11
+
+4.1.51.7 x11 other_resources
+............................
+
+By default the contents of the current plot window are exported to the
+X11 clipboard in response to X events in the window.  Setting the
+resource 'gnuplot*exportselection' to 'off' or 'false' will disable
+this.
+
+   By default text rotation is done using a method that is fast, but can
+corrupt nearby colors depending on the background.  If this is a
+problem, you can set the resource 'gnuplot.fastrotate' to 'off'
+
+      gnuplot*exportselection:  off
+      gnuplot*fastrotate:  on
+      gnuplot*ctrlq:  off
+
+
+
+File: gnuplot.info,  Node: xlib,  Prev: x11,  Up: complete_list_of_terminals
+
+4.1.52 xlib
+-----------
+
+The 'xlib' terminal driver supports the X11 Windows System.  It
+generates gnuplot_x11 commands, but sends them to the output file
+specified by 'set output '<filename>''.  'set term x11' is equivalent to
+'set output "|gnuplot_x11 -noevents"; set term xlib'.  'xlib' takes the
+same set of options as 'x11'."
+
+
+File: gnuplot.info,  Node: Concept_Index,  Next: Command_Index,  Prev: Terminal_types,  Up: Top
+
+Concept Index
+*************
+
+[index]
+* Menu:
+
+* '+':                                   special-filenames.   (line   6)
+* '++':                                  special-filenames.   (line   6)
+* '-':                                   special-filenames.   (line   6)
+* .gnuplot:                              Start-up_(initialization).
+                                                              (line   6)
+* 3D:                                    3D_plots.            (line   6)
+* ?:                                     cbrt.                (line   6)
+* ? <1>:                                 exp.                 (line   7)
+* ? <2>:                                 exp.                 (line   9)
+* ? <3>:                                 gamma.               (line   9)
+* ? <4>:                                 inverf.              (line   7)
+* ? <5>:                                 imag.                (line   7)
+* ? <6>:                                 invnorm.             (line  10)
+* ? <7>:                                 invnorm.             (line   9)
+* ? <8>:                                 real.                (line   6)
+* ? <9>:                                 sqrt.                (line   8)
+* ? <10>:                                tanh.                (line   7)
+* ? <11>:                                voigt.               (line  10)
+* ? <12>:                                erfi.                (line   7)
+* ? <13>:                                erfi.                (line   8)
+* ? <14>:                                words.               (line   9)
+* ? <15>:                                words.               (line   9)
+* ? <16>:                                words.               (line   9)
+* ? <17>:                                words.               (line  11)
+* ? <18>:                                words.               (line  15)
+* ? <19>:                                words.               (line  19)
+* ? <20>:                                words.               (line  23)
+* ? <21>:                                words.               (line  27)
+* ? <22>:                                words.               (line  31)
+* ? <23>:                                words.               (line  33)
+* ? <24>:                                words.               (line  35)
+* ? <25>:                                words.               (line  38)
+* ? <26>:                                words.               (line  40)
+* ? <27>:                                words.               (line  40)
+* ? <28>:                                words.               (line  40)
+* ? <29>:                                words.               (line  39)
+* ? <30>:                                hsv2rgb.             (line   7)
+* ? <31>:                                rgbcolor.            (line  11)
+* ? <32>:                                rgbcolor.            (line  13)
+* ? <33>:                                rgbcolor.            (line  12)
+* abs:                                   abs.                 (line   6)
+* acos:                                  acos.                (line   6)
+* acosh:                                 acosh.               (line   6)
+* acsplines:                             smooth.              (line  61)
+* Ai:                                    Complex_Airy_functions.
+                                                              (line   6)
+* aifm:                                  aifm.                (line   6)
+* airy:                                  airy.                (line   6)
+* alpha channel:                         rgbcolor.            (line   6)
+* alpha channel <1>:                     image.               (line  57)
+* alpha channel <2>:                     colormap.            (line   6)
+* Amos:                                  Special_functions_with_complex_arguments.
+                                                              (line   6)
+* angles:                                angles.              (line   6)
+* animation:                             Animation.           (line   6)
+* aqua:                                  aqua.                (line   6)
+* arg:                                   arg.                 (line   6)
+* argv:                                  ARGV[_].             (line   6)
+* ARGV:                                  ARGV[_].             (line   6)
+* arrays:                                arrays.              (line   6)
+* arrow:                                 arrow.               (line   6)
+* arrows:                                arrows.              (line   6)
+* arrowstyle:                            set_style_arrow.     (line   6)
+* asin:                                  asin.                (line   6)
+* asinh:                                 asinh.               (line   6)
+* atan:                                  atan.                (line   6)
+* atan2:                                 atan2.               (line   6)
+* atanh:                                 atanh.               (line   6)
+* automated:                             automated_iteration_over_multiple_columns.
+                                                              (line   6)
+* autoscale:                             autoscale.           (line   6)
+* autotitle:                             key_autotitle.       (line   6)
+* avs:                                   filetype.            (line  21)
+* axes:                                  Coordinates.         (line   6)
+* axes <1>:                              Plotting.            (line  30)
+* axes <2>:                              axes.                (line   6)
+* azimuth:                               azimuth.             (line   6)
+* back:                                  layers.              (line   6)
+* background:                            background_color.    (line   6)
+* background <1>:                        special_linetypes.   (line   6)
+* backquotes:                            Substitution_of_system_commands_in_backquotes.
+                                                              (line   6)
+* bars:                                  errorbars.           (line   6)
+* batch/interactive:                     Batch/Interactive_Operation.
+                                                              (line   6)
+* be:                                    be.                  (line   6)
+* BE:                                    be.                  (line   6)
+* beeswarm:                              Bee_swarm_plots.     (line   6)
+* beeswarm <1>:                          jitter.              (line   6)
+* behind:                                layers.              (line   6)
+* besi0:                                 besi0.               (line   6)
+* besi1:                                 besi1.               (line   6)
+* besin:                                 besin.               (line   6)
+* besj0:                                 besj0.               (line   6)
+* besj1:                                 besj1.               (line   6)
+* besjn:                                 besjn.               (line   6)
+* BesselH1:                              Complex_Bessel_functions.
+                                                              (line  26)
+* BesselH2:                              Complex_Bessel_functions.
+                                                              (line  26)
+* BesselI:                               Complex_Bessel_functions.
+                                                              (line  16)
+* BesselJ:                               Complex_Bessel_functions.
+                                                              (line   6)
+* BesselK:                               Complex_Bessel_functions.
+                                                              (line  21)
+* BesselY:                               Complex_Bessel_functions.
+                                                              (line  11)
+* besy0:                                 besy0.               (line   6)
+* besy1:                                 besy1.               (line   6)
+* besyn:                                 besyn.               (line   6)
+* bezier:                                smooth.              (line  98)
+* bgnd:                                  colorspec.           (line  67)
+* bgnd <1>:                              background_color.    (line   6)
+* bgnd <2>:                              special_linetypes.   (line   6)
+* Bi:                                    Complex_Airy_functions.
+                                                              (line   6)
+* binary:                                binary.              (line   6)
+* bind:                                  bind.                (line   6)
+* bind <1>:                              reset.               (line  37)
+* bind <2>:                              bind_.               (line   6)
+* bins:                                  filters.             (line  15)
+* bitgraph:                              tek40.               (line  26)
+* bitwise operators:                     Binary.              (line  34)
+* black:                                 colorspec.           (line  69)
+* black <1>:                             special_linetypes.   (line   6)
+* block:                                 Glossary.            (line   6)
+* bmargin:                               bmargin.             (line   6)
+* bold:                                  Enhanced_text_mode.  (line   6)
+* border:                                fill_properties.     (line   6)
+* border <1>:                            border.              (line   6)
+* border <2>:                            set_style_fill.      (line  50)
+* boxdepth:                              boxdepth.            (line   6)
+* boxed:                                 set_style_textbox.   (line   6)
+* boxerrorbars:                          boxerrorbars.        (line   6)
+* boxes:                                 boxes.               (line   6)
+* boxplot:                               boxplot.             (line   6)
+* boxwidth:                              boxwidth.            (line   6)
+* boxxyerror:                            boxxyerror.          (line   6)
+* branch:                                multi-branch.        (line   6)
+* break:                                 Break.               (line   6)
+* broken axis:                           nonlinear.           (line  59)
+* bugs:                                  Seeking-assistance_/_Bugs.
+                                                              (line   6)
+* call:                                  call.                (line   6)
+* candlesticks:                          candlesticks.        (line   6)
+* canvas:                                Canvas_size.         (line   6)
+* canvas terminal:                       canvas.              (line   6)
+* cardinality:                           Unary.               (line  17)
+* cardinality <1>:                       Unary.               (line  24)
+* cardinality <2>:                       arrays.              (line   6)
+* cbdata:                                cbdata.              (line   6)
+* cbdtics:                               cbdtics.             (line   6)
+* cblabel:                               cblabel.             (line   6)
+* cbmtics:                               cbmtics.             (line   6)
+* cbrange:                               cbrange.             (line   6)
+* cbrt:                                  cbrt.                (line   6)
+* cbtics:                                cbtics.              (line   6)
+* cd:                                    cd.                  (line   6)
+* cdawson:                               cdawson.             (line   6)
+* ceil:                                  integer_conversion_functions_(int_floor_ceil_round).
+                                                              (line  36)
+* center:                                keywords.            (line  81)
+* cerf:                                  cerf.                (line   6)
+* cgm:                                   cgm.                 (line   6)
+* chi_shapes:                            chi_shapes.          (line   6)
+* circle:                                circle.              (line   6)
+* circles:                               circles.             (line   6)
+* clabel:                                clabel.              (line   6)
+* clear:                                 clear.               (line   6)
+* clip:                                  clip.                (line   6)
+* clip1in:                               clipping.            (line   6)
+* clip4in:                               clipping.            (line   6)
+* clipcb:                                clipping.            (line   6)
+* CMY:                                   Color_model.         (line   6)
+* cnormal:                               smooth.              (line 208)
+* cntrlabel:                             cntrlabel.           (line   6)
+* cntrparam:                             cntrparam.           (line   6)
+* colorbox:                              color_box.           (line   6)
+* colormap:                              colormap.            (line   6)
+* colornames:                            colornames.          (line   6)
+* colors:                                linetypes.           (line   6)
+* colors <1>:                            colorspec.           (line   6)
+* colors <2>:                            rgbformulae.         (line   6)
+* colors <3>:                            defined.             (line   6)
+* colorsequence:                         colorsequence.       (line   6)
+* colorspec:                             colorspec.           (line   6)
+* column:                                using_specifier_functions.
+                                                              (line  15)
+* column <1>:                            using.               (line  31)
+* columnhead:                            using_specifier_functions.
+                                                              (line  23)
+* columnheader:                          Datastrings.         (line  34)
+* columnheader <1>:                      using.               (line  33)
+* columnheader <2>:                      title.               (line   6)
+* columnheader <3>:                      key_autotitle.       (line   9)
+* columnheader <4>:                      name.                (line  16)
+* columnheaders:                         columnheaders.       (line   6)
+* columnheaders <1>:                     set_datafile_columnheaders.
+                                                              (line   6)
+* command-line-editing:                  Command-line-editing.
+                                                              (line   6)
+* command-line-options:                  command_line_options.
+                                                              (line   6)
+* commands:                              Commands.            (line   6)
+* comments:                              Comments.            (line   6)
+* commentschars:                         set_datafile_commentschars.
+                                                              (line   6)
+* complex:                               Complex_values.      (line   6)
+* concavehull:                           filters.             (line  96)
+* conj:                                  conj.                (line   6)
+* constants:                             Constants.           (line   6)
+* context:                               context.             (line   6)
+* continue:                              Continue.            (line   6)
+* contour:                               contour.             (line   6)
+* contourfill:                           contourfill.         (line   6)
+* contours:                              contour.             (line   6)
+* convexhull:                            filters.             (line  66)
+* coordinates:                           Coordinates.         (line   6)
+* copyright:                             Copyright.           (line   6)
+* corel:                                 corel.               (line   6)
+* cornerpoles:                           cornerpoles.         (line   6)
+* corners2color:                         corners2color.       (line   6)
+* cos:                                   cos.                 (line   6)
+* cosh:                                  cosh.                (line   6)
+* counting_words:                        Counting_and_extracting_words.
+                                                              (line   6)
+* csplines:                              smooth.              (line 107)
+* csv:                                   plot_with_table.     (line  32)
+* cubehelix:                             cubehelix.           (line   6)
+* cumulative:                            smooth.              (line 199)
+* cycle:                                 linetype.            (line  48)
+* dashtype:                              dashtype.            (line   6)
+* dashtype <1>:                          dashtype.            (line   6)
+* data:                                  data.                (line   6)
+* data-file:                             data.                (line   6)
+* datablocks:                            inline_data_and_datablocks.
+                                                              (line   6)
+* datafile:                              data.                (line   6)
+* datastrings:                           Datastrings.         (line   6)
+* date_specifiers:                       time/date_specifiers.
+                                                              (line   6)
+* Dawson's integral:                     cdawson.             (line   6)
+* debug:                                 debug.               (line   6)
+* decimalsign:                           decimalsign.         (line   6)
+* degrees:                               angles.              (line   6)
+* demos:                                 Demos_and_Online_Examples.
+                                                              (line   6)
+* depthorder:                            scanorder.           (line   6)
+* dgrid3d:                               dgrid3d.             (line   6)
+* division:                              Expressions.         (line   6)
+* do:                                    Do.                  (line   6)
+* dospc:                                 dospc.               (line   6)
+* dots:                                  dots.                (line   6)
+* dpu414:                                epson_180dpi.        (line   6)
+* dumb:                                  dumb.                (line   6)
+* dummy:                                 dummy.               (line   6)
+* dx:                                    keywords.            (line  45)
+* dxf:                                   dxf.                 (line   6)
+* dxy800a:                               dxy800a.             (line   6)
+* dy:                                    keywords.            (line  45)
+* edf:                                   filetype.            (line  29)
+* editing:                               Command-line-editing.
+                                                              (line   6)
+* eepic:                                 eepic.               (line   6)
+* ehf:                                   filetype.            (line  29)
+* ellipse:                               ellipse.             (line   6)
+* ellipses:                              ellipses.            (line   6)
+* elliptic:                              elliptic_integrals.  (line   6)
+* elliptic integrals:                    elliptic_integrals.  (line   6)
+* EllipticE:                             EllipticK.           (line   7)
+* EllipticK:                             cosh.                (line   7)
+* EllipticPi:                            EllipticE.           (line   7)
+* emf:                                   emf.                 (line   6)
+* emtex:                                 latex.               (line   6)
+* encoding:                              encoding.            (line   6)
+* encodings:                             encoding.            (line   6)
+* enhanced:                              Enhanced_text_mode.  (line   6)
+* environment:                           Environment.         (line   6)
+* epidemiological week:                  Time_functions.      (line  48)
+* epidemiological week <1>:              Time_functions.      (line  99)
+* epoch:                                 Time_functions.      (line  30)
+* eps:                                   postscript__(also_encapsulated_postscript_*.eps).
+                                                              (line   6)
+* epscairo:                              epscairo.            (line   6)
+* epson_180dpi:                          epson_180dpi.        (line   6)
+* epson_60dpi:                           epson_180dpi.        (line   6)
+* epson_lx800:                           epson_180dpi.        (line   6)
+* equal_axes:                            equal_axes.          (line   6)
+* erf:                                   erf.                 (line   6)
+* erfc:                                  erfc.                (line   6)
+* erfi:                                  erfi.                (line   6)
+* error state:                           Gnuplot-defined_variables.
+                                                              (line  24)
+* error state <1>:                       reset.               (line  34)
+* errorbars:                             yerrorbars.          (line   6)
+* errorbars <1>:                         errorbars.           (line   6)
+* errorlines:                            yerrorlines.         (line   6)
+* errors:                                Gnuplot-defined_variables.
+                                                              (line  24)
+* evaluate:                              evaluate.            (line   6)
+* every:                                 every.               (line   6)
+* example:                               example_datafile.    (line   6)
+* examples:                              Demos_and_Online_Examples.
+                                                              (line   6)
+* excl:                                  excl.                (line   6)
+* exists:                                exists.              (line   6)
+* exists <1>:                            Substitution_of_string_variables_as_macros.
+                                                              (line   6)
+* exit:                                  exit.                (line   6)
+* exp:                                   exp.                 (line   6)
+* expint:                                Expint.              (line   6)
+* exponentiation:                        Binary.              (line  34)
+* expressions:                           Expressions.         (line   6)
+* factorial:                             Unary.               (line  17)
+* faddeeva:                              faddeeva.            (line   6)
+* faq:                                   Seeking-assistance_/_Bugs.
+                                                              (line   6)
+* FAQ:                                   Seeking-assistance_/_Bugs.
+                                                              (line   6)
+* fc:                                    set_style_fill.      (line  39)
+* fenceplots:                            Fence_plots.         (line   6)
+* fig:                                   fig.                 (line   6)
+* file:                                  data.                (line   6)
+* filetype:                              filetype.            (line   6)
+* fillcolor:                             colorspec.           (line   6)
+* fillcolor <1>:                         set_style_fill.      (line  39)
+* filledcurves:                          filledcurves.        (line   6)
+* fillsteps:                             fillsteps.           (line   6)
+* fillstyle:                             set_style_fill.      (line   6)
+* filter:                                using.               (line 109)
+* filter <1>:                            stats_(Statistical_Summary).
+                                                              (line   6)
+* filters:                               filters.             (line   6)
+* financebars:                           financebars.         (line   6)
+* fit:                                   fit.                 (line   6)
+* fitting:                               short_introduction.  (line   6)
+* FIT_LOG:                               control.             (line   6)
+* fit_parameters:                        adjustable_parameters.
+                                                              (line   6)
+* FIT_SCRIPT:                            control.             (line   6)
+* fix:                                   noextend.            (line   6)
+* flipx:                                 keywords.            (line  60)
+* flipy:                                 keywords.            (line  60)
+* flipz:                                 keywords.            (line  60)
+* floating point exceptions:             set_datafile_nofpe_trap.
+                                                              (line   6)
+* floor:                                 integer_conversion_functions_(int_floor_ceil_round).
+                                                              (line  32)
+* flush:                                 scanorder.           (line   6)
+* fnormal:                               smooth.              (line 188)
+* fontconfig:                            cairo_(pdfcairo.     (line   6)
+* fontpath:                              fontpath.            (line   6)
+* fonts:                                 Fonts.               (line   6)
+* fonts <1>:                             cairo_(pdfcairo.     (line   6)
+* fonts <2>:                             gd_(png.             (line   6)
+* fonts <3>:                             postscript__(also_encapsulated_postscript_*.eps).
+                                                              (line   6)
+* fonts <4>:                             x11_fonts.           (line   6)
+* for:                                   for.                 (line   6)
+* format:                                format__.            (line   6)
+* format_specifiers:                     format_specifiers.   (line   6)
+* fortran:                               set_datafile_fortran.
+                                                              (line   6)
+* fpe_trap:                              set_datafile_nofpe_trap.
+                                                              (line   6)
+* frequency:                             smooth.              (line 173)
+* FresnelC:                              Fresnel_integrals_FresnelC(x)_and_FresnelS(x).
+                                                              (line   6)
+* FresnelS:                              Fresnel_integrals_FresnelC(x)_and_FresnelS(x).
+                                                              (line   6)
+* front:                                 layers.              (line   6)
+* fsteps:                                fsteps.              (line   6)
+* ftriangles:                            scanorder.           (line   6)
+* functionblocks:                        function_blocks.     (line   6)
+* functions:                             functions.           (line   6)
+* gamma:                                 Gamma.               (line   6)
+* gamma-correction:                      gamma_correction.    (line   6)
+* gd:                                    gd_(png.             (line   6)
+* geographic:                            geographic.          (line   6)
+* geomean:                               corners2color.       (line   6)
+* ggi:                                   ggi.                 (line   6)
+* gif:                                   gd_(png.             (line   6)
+* global:                                Scope_of_variables.  (line   6)
+* glossary:                              Glossary.            (line   6)
+* gnuplot:                               Gnuplot.             (line   6)
+* gnuplot-defined:                       Gnuplot-defined_variables.
+                                                              (line   6)
+* gnuplotrc:                             Start-up_(initialization).
+                                                              (line   6)
+* gpic:                                  gpic.                (line   6)
+* gprintf:                               gprintf_.            (line   6)
+* GPVAL:                                 Gnuplot-defined_variables.
+                                                              (line   6)
+* gpval:                                 Gnuplot-defined_variables.
+                                                              (line   6)
+* gradient:                              pixmap_from_colormap.
+                                                              (line   6)
+* graph-menu:                            graph-menu.          (line   6)
+* grass:                                 grass.               (line   6)
+* grayscale_resources:                   grayscale_resources_.
+                                                              (line   6)
+* grid:                                  grid.                (line   6)
+* GridDistance:                          vfill.               (line   6)
+* GridDistance <1>:                      vfill.               (line   6)
+* grid_data:                             grid_data.           (line   6)
+* Hankel:                                Complex_Bessel_functions.
+                                                              (line  26)
+* harmean:                               corners2color.       (line   6)
+* heatmaps:                              heatmaps.            (line   6)
+* heatmaps <1>:                          image_pixels.        (line   6)
+* help:                                  help.                (line   6)
+* help-desk:                             Seeking-assistance_/_Bugs.
+                                                              (line   6)
+* hexadecimal:                           Constants.           (line   6)
+* hidden3d:                              hidden3d.            (line   6)
+* histeps:                               histeps.             (line   6)
+* histogram:                             smooth.              (line 173)
+* histograms:                            histograms.          (line   6)
+* history:                               history.             (line   6)
+* hotkey:                                bind.                (line   6)
+* hotkeys:                               bind.                (line   6)
+* hp2623a:                               hp2623a.             (line   6)
+* hp2648:                                hp2648.              (line   6)
+* hp500c:                                hp500c.              (line   6)
+* hpdj:                                  hpljii.              (line   6)
+* hpgl:                                  hpgl.                (line   6)
+* hpljii:                                hpljii.              (line   6)
+* hppj:                                  hppj.                (line   6)
+* hsteps:                                hsteps.              (line   6)
+* hsv:                                   hsv2rgb.             (line   6)
+* HSV:                                   Color_model.         (line   6)
+* hsv2rgb:                               hsv2rgb.             (line   6)
+* hypertext:                             hypertext.           (line   6)
+* ibeta:                                 Ibeta.               (line   6)
+* if:                                    if.                  (line   6)
+* igamma:                                Igamma.              (line   6)
+* imag:                                  imag.                (line   6)
+* image:                                 image.               (line   6)
+* imagen:                                imagen.              (line   6)
+* import:                                import.              (line   6)
+* impulses:                              impulses.            (line   6)
+* index:                                 Array_indexing.      (line   6)
+* index <1>:                             index.               (line   6)
+* initialization:                        Start-up_(initialization).
+                                                              (line   6)
+* inline:                                inline_data_and_datablocks.
+                                                              (line   6)
+* inset:                                 Plotting.            (line  15)
+* inset <1>:                             clear.               (line   6)
+* inset <2>:                             clear.               (line   6)
+* inset <3>:                             multiplot.           (line  28)
+* int:                                   integer_conversion_functions_(int_floor_ceil_round).
+                                                              (line  26)
+* integer:                               integer_conversion_functions_(int_floor_ceil_round).
+                                                              (line   6)
+* interval:                              set_style_line.      (line   6)
+* introduction:                          Introduction.        (line   6)
+* inverf:                                inverf.              (line   6)
+* invibeta:                              Invibeta.            (line   6)
+* invigamma:                             Invigamma.           (line   6)
+* invnorm:                               invnorm.             (line   6)
+* isosamples:                            isosamples.          (line   6)
+* isosurface:                            isosurface.          (line   6)
+* isotropic:                             isotropic.           (line   6)
+* italic:                                Enhanced_text_mode.  (line   6)
+* iterate:                               iteration.           (line   6)
+* iteration:                             iteration.           (line   6)
+* iteration <1>:                         for_loops_in_plot_command.
+                                                              (line   6)
+* iteration <2>:                         set-show.            (line  19)
+* iteration <3>:                         unset.               (line   6)
+* iteration-specifier:                   iteration.           (line  23)
+* jitter:                                Bee_swarm_plots.     (line   6)
+* jitter <1>:                            jitter.              (line   6)
+* join:                                  Counting_and_extracting_words.
+                                                              (line  61)
+* join <1>:                              Counting_and_extracting_words.
+                                                              (line  61)
+* jpeg:                                  gd_(png.             (line   6)
+* kc-tek40xx:                            tek40.               (line   6)
+* kdensity:                              smooth.              (line 220)
+* kdensity <1>:                          dgrid3d.             (line   6)
+* keepfix:                               noextend.            (line   6)
+* key:                                   key_.                (line   6)
+* keyentry:                              extra_key_entries.   (line   6)
+* km-tek40xx:                            tek40.               (line   6)
+* kyo:                                   kyo.                 (line   6)
+* label:                                 label.               (line   6)
+* labels:                                labels.              (line   6)
+* labels <1>:                            mouse.               (line  51)
+* lambertw:                              lambertw.            (line   6)
+* LambertW:                              LambertW.            (line   6)
+* latex:                                 latex.               (line   6)
+* layers:                                layers.              (line   6)
+* layout:                                multiplot.           (line   6)
+* lc:                                    colorspec.           (line   6)
+* least-squares:                         fit.                 (line   6)
+* legend:                                key_.                (line   6)
+* legend <1>:                            multiple_keys.       (line   6)
+* lgamma:                                lgamma.              (line   6)
+* libcerf:                               Special_functions_with_complex_arguments.
+                                                              (line   6)
+* libopenspecfun:                        Special_functions_with_complex_arguments.
+                                                              (line   6)
+* license:                               Copyright.           (line   6)
+* lighting:                              lighting.            (line   6)
+* line-editing:                          Command-line-editing.
+                                                              (line   6)
+* linecolor:                             colorspec.           (line   6)
+* lines:                                 lines.               (line   6)
+* linespoints:                           linespoints.         (line   6)
+* linespoints <1>:                       set_style_line.      (line   6)
+* linestyle:                             set_style_line.      (line   6)
+* linetypes:                             linetypes.           (line   6)
+* linewidth:                             set_style_line.      (line   6)
+* linewidth <1>:                         set_style_line.      (line   6)
+* link:                                  link.                (line   6)
+* lmargin:                               lmargin.             (line   6)
+* lnGamma:                               lnGamma.             (line   6)
+* load:                                  load.                (line   6)
+* loadpath:                              loadpath.            (line   6)
+* local:                                 Scope_of_variables.  (line   6)
+* local <1>:                             local.               (line   6)
+* locale:                                decimalsign.         (line   6)
+* locale <1>:                            locale.              (line   6)
+* log:                                   log.                 (line   6)
+* log10:                                 log10.               (line   6)
+* logit:                                 nonlinear.           (line  47)
+* logscale:                              logscale.            (line   6)
+* logscale <1>:                          xtics_logscale.      (line   6)
+* lower:                                 raise.               (line   6)
+* lp:                                    linespoints.         (line   6)
+* lua:                                   lua.                 (line   6)
+* macros:                                Substitution_of_string_variables_as_macros.
+                                                              (line   6)
+* map:                                   deprecated_options.  (line   6)
+* mapping:                               mapping.             (line   6)
+* margins:                               margin.              (line   6)
+* markup:                                Enhanced_text_mode.  (line   6)
+* Marquardt:                             fit.                 (line   6)
+* mask:                                  filters.             (line 143)
+* masking:                               masking.             (line   6)
+* matrix:                                matrix.              (line   6)
+* max:                                   corners2color.       (line   6)
+* mcsplines:                             smooth.              (line 129)
+* mean:                                  corners2color.       (line   6)
+* median:                                corners2color.       (line   6)
+* metafont:                              mf.                  (line   6)
+* metapost:                              mp.                  (line   6)
+* mf:                                    mf.                  (line   6)
+* micro:                                 micro.               (line   6)
+* mif:                                   mif.                 (line   6)
+* min:                                   corners2color.       (line   6)
+* minussign:                             minussign.           (line   6)
+* missing:                               set_datafile_missing.
+                                                              (line   6)
+* mixing_macros_backquotes:              String_variables.    (line   6)
+* modulo:                                Binary.              (line  34)
+* modulus:                               abs.                 (line   9)
+* monochrome:                            monochrome.          (line   6)
+* mouse:                                 mouse.               (line   6)
+* mouseformat:                           mouseformat.         (line   6)
+* mousewheel:                            scrolling.           (line   6)
+* mousing:                               mouse.               (line   6)
+* mp:                                    mp.                  (line   6)
+* mttics:                                mttics.              (line   6)
+* multi-branch:                          multi-branch.        (line   6)
+* multiplot:                             Plotting.            (line  15)
+* multiplot <1>:                         multiplot.           (line   6)
+* mx2tics:                               mx2tics.             (line   6)
+* mxtics:                                mxtics.              (line   6)
+* my2tics:                               my2tics.             (line   6)
+* mytics:                                mytics.              (line   6)
+* mztics:                                mztics.              (line   6)
+* NaN:                                   Expressions.         (line  25)
+* NaN <1>:                               User-defined_variables_and_functions.
+                                                              (line  43)
+* NaN <2>:                               using.               (line 109)
+* nec_cp6:                               epson_180dpi.        (line   6)
+* negation:                              Unary.               (line  17)
+* new:                                   New_features_in_version_6.
+                                                              (line   6)
+* newhistogram:                          newhistogram.        (line   6)
+* newspiderplot:                         newspiderplot.       (line   6)
+* noarrow:                               arrow.               (line   6)
+* noautoscale:                           autoscale.           (line   6)
+* noborder:                              border.              (line   6)
+* nocbdtics:                             cbdtics.             (line   6)
+* nocbmtics:                             cbmtics.             (line   6)
+* nocbtics:                              cbtics.              (line   6)
+* noclipcb:                              clipping.            (line   6)
+* nocontour:                             contour.             (line   6)
+* nodgrid3d:                             dgrid3d.             (line   6)
+* nodraw:                                special_linetypes.   (line   6)
+* noextend:                              noextend.            (line   6)
+* nofpe_trap:                            set_datafile_nofpe_trap.
+                                                              (line   6)
+* nogrid:                                dgrid3d.             (line   6)
+* nohidden3d:                            hidden3d.            (line   6)
+* nokey:                                 key_.                (line   6)
+* nolabel:                               label.               (line   6)
+* nologscale:                            logscale.            (line   6)
+* nomouse:                               mouse.               (line   6)
+* nomttics:                              mttics.              (line   6)
+* nomultiplot:                           multiplot.           (line   6)
+* nomx2tics:                             mx2tics.             (line   6)
+* nomxtics:                              mxtics.              (line   6)
+* nomy2tics:                             my2tics.             (line   6)
+* nomytics:                              mytics.              (line   6)
+* nomztics:                              mztics.              (line   6)
+* nonlinear:                             nonlinear.           (line   6)
+* nonuniform:                            matrix.              (line  65)
+* nooffsets:                             offsets.             (line   6)
+* noparametric:                          parametric_.         (line   6)
+* nopolar:                               polar.               (line   6)
+* norm:                                  abs.                 (line   9)
+* norm <1>:                              norm.                (line   6)
+* nosurface:                             surface_.            (line   6)
+* notimestamp:                           timestamp.           (line   6)
+* nox2dtics:                             x2dtics.             (line   6)
+* nox2mtics:                             x2mtics.             (line   6)
+* nox2tics:                              x2tics.              (line   6)
+* nox2zeroaxis:                          x2zeroaxis.          (line   6)
+* noxdtics:                              xdtics.              (line   6)
+* noxmtics:                              xmtics.              (line   6)
+* noxtics:                               xtics.               (line   6)
+* noxzeroaxis:                           xzeroaxis.           (line   6)
+* noy2dtics:                             y2dtics.             (line   6)
+* noy2mtics:                             y2mtics.             (line   6)
+* noy2tics:                              y2tics.              (line   6)
+* noy2zeroaxis:                          y2zeroaxis.          (line   6)
+* noydtics:                              ydtics.              (line   6)
+* noymtics:                              ymtics.              (line   6)
+* noytics:                               ytics.               (line   6)
+* noyzeroaxis:                           yzeroaxis.           (line   6)
+* nozdtics:                              zdtics.              (line   6)
+* nozmtics:                              zmtics.              (line   6)
+* noztics:                               ztics.               (line   6)
+* nozzeroaxis:                           zzeroaxis.           (line   6)
+* objects:                               object.              (line   6)
+* octal:                                 Constants.           (line   6)
+* offsets:                               offsets.             (line   6)
+* okidata:                               epson_180dpi.        (line   6)
+* one's complement:                      Unary.               (line  17)
+* operator precedence:                   Unary.               (line  17)
+* operators:                             operators.           (line   6)
+* origin:                                origin.              (line   6)
+* output:                                output.              (line   6)
+* overflow:                              overflow.            (line   6)
+* palette:                               palette.             (line   6)
+* palette <1>:                           colormap.            (line   6)
+* palette <2>:                           palette__.           (line   6)
+* palette <3>:                           show_palette.        (line   6)
+* parallel:                              parallelaxes.        (line   6)
+* parallelaxes:                          parallelaxes.        (line   6)
+* parametric:                            parametric_.         (line   6)
+* path:                                  smooth.              (line 138)
+* pause:                                 pause.               (line   6)
+* paxis:                                 paxis.               (line   6)
+* pbm:                                   pbm.                 (line   6)
+* pdf:                                   cairo_(pdfcairo.     (line   6)
+* pdf <1>:                               pdf.                 (line   6)
+* perpendicular:                         keywords.            (line 107)
+* persist:                               Persist.             (line   6)
+* pi:                                    User-defined_variables_and_functions.
+                                                              (line  43)
+* piechart:                              circles.             (line  55)
+* piped-data:                            piped-data.          (line   6)
+* pipes:                                 piped-data.          (line   6)
+* pipes <1>:                             piped-data.          (line   6)
+* pixels:                                image_pixels.        (line   6)
+* pixmap:                                pixmap.              (line   6)
+* plot:                                  plot.                (line   6)
+* plot styles:                           Plotting_styles.     (line   6)
+* plotting:                              Plotting.            (line   6)
+* plugins:                               Plugins.             (line   6)
+* plugins <1>:                           import.              (line   6)
+* pm3d:                                  pm3d.                (line   6)
+* png:                                   cairo_(pdfcairo.     (line   6)
+* png <1>:                               gd_(png.             (line   6)
+* png <2>:                               png_.                (line   6)
+* pointinterval:                         linespoints.         (line   6)
+* pointinterval <1>:                     set_style_line.      (line   6)
+* pointintervalbox:                      pointintervalbox.    (line   6)
+* pointnumber:                           linespoints.         (line   6)
+* pointnumber <1>:                       set_style_line.      (line   6)
+* points:                                points.              (line   6)
+* pointsize:                             pointsize.           (line   6)
+* pointtype:                             points.              (line   6)
+* polar:                                 Polar_plots.         (line   6)
+* polar <1>:                             polar.               (line   6)
+* polygon:                               polygon.             (line   6)
+* polygons:                              polygons.            (line   6)
+* pop:                                   terminal.            (line   6)
+* postscript:                            postscript__(also_encapsulated_postscript_*.eps).
+                                                              (line   6)
+* precision:                             integer_conversion_functions_(int_floor_ceil_round).
+                                                              (line   6)
+* prescribe:                             kyo.                 (line   6)
+* print:                                 print.               (line   6)
+* printerr:                              printerr.            (line   6)
+* printing:                              printing.            (line   6)
+* projection:                            projection.          (line   6)
+* psdir:                                 psdir.               (line   6)
+* pseudo-mousing:                        pseudo-mousing_during_pause.
+                                                              (line   6)
+* pseudocolumns:                         using.               (line 147)
+* pseudofiles:                           special-filenames.   (line   6)
+* pstricks:                              pstricks.            (line   6)
+* punctuation:                           Syntax.              (line   6)
+* push:                                  terminal.            (line   6)
+* pwd:                                   pwd.                 (line   6)
+* qms:                                   qms.                 (line   6)
+* quit:                                  quit.                (line   6)
+* quotes:                                quote_marks.         (line   6)
+* raise:                                 raise.               (line   6)
+* rand:                                  rand.                (line   6)
+* rand <1>:                              Random_number_generator.
+                                                              (line   6)
+* random:                                Random_number_generator.
+                                                              (line   6)
+* range-frame:                           xtics_rangelimited.  (line   6)
+* rangelimited:                          xtics_rangelimited.  (line   6)
+* ranges:                                ranges.              (line   6)
+* ratio:                                 size.                (line   6)
+* raxis:                                 raxis.               (line   6)
+* real:                                  real.                (line   6)
+* record:                                Glossary.            (line   6)
+* rectangle:                             rectangle.           (line   6)
+* refresh:                               refresh.             (line   6)
+* regis:                                 regis.               (line   6)
+* remultiplot:                           remultiplot.         (line   6)
+* replot:                                replot.              (line   6)
+* reread:                                reread.              (line   6)
+* reset:                                 reset.               (line   6)
+* restore:                               xrange.              (line   6)
+* return:                                return.              (line   6)
+* RGB:                                   Color_model.         (line   6)
+* rgbalpha:                              image.               (line   6)
+* rgbcolor:                              rgbcolor.            (line   6)
+* rgbformulae:                           rgbformulae.         (line   6)
+* rgbimage:                              image.               (line   6)
+* rgbimage <1>:                          rgbmax.              (line   6)
+* rgbmax:                                rgbmax.              (line   6)
+* Riemann:                               zeta.                (line   6)
+* rlabel:                                rlabel.              (line   6)
+* rmargin:                               rmargin.             (line   6)
+* rms:                                   corners2color.       (line   6)
+* rotate:                                keywords.            (line  88)
+* round:                                 integer_conversion_functions_(int_floor_ceil_round).
+                                                              (line  40)
+* rrange:                                rrange.              (line   6)
+* rtics:                                 rtics.               (line   6)
+* sample:                                sampling.            (line   6)
+* samples:                               samples.             (line   6)
+* sampling:                              sampling.            (line   6)
+* save:                                  save.                (line   6)
+* sbezier:                               smooth.              (line 153)
+* scan:                                  keywords.            (line  12)
+* scansautomatic:                        scanorder.           (line   6)
+* scansbackward:                         scanorder.           (line   6)
+* scansforward:                          scanorder.           (line   6)
+* scope:                                 iteration.           (line  38)
+* scope <1>:                             Scope_of_variables.  (line   6)
+* screen:                                Glossary.            (line   6)
+* screendump:                            printing.            (line   6)
+* scrolling:                             scrolling.           (line   6)
+* sectors:                               sectors.             (line   6)
+* seeking-assistance:                    Seeking-assistance_/_Bugs.
+                                                              (line   6)
+* selanar:                               tek40.               (line   6)
+* separator:                             set_datafile_separator.
+                                                              (line   6)
+* session:                               reset.               (line  28)
+* set:                                   set-show.            (line   6)
+* sgn:                                   sgn.                 (line   6)
+* sharpen:                               filters.             (line 151)
+* shell:                                 shell.               (line   6)
+* show:                                  set-show.            (line   6)
+* sin:                                   sin.                 (line   6)
+* sinh:                                  sinh.                (line   6)
+* sixel:                                 gd_(png.             (line   6)
+* sixeltek:                              tek40.               (line   6)
+* size:                                  size.                (line   6)
+* sjis:                                  encoding.            (line   6)
+* SJIS:                                  encoding.            (line   6)
+* skip:                                  example_datafile.    (line  24)
+* skip <1>:                              skip_.               (line   6)
+* slice:                                 Array_functions.     (line   6)
+* smooth:                                smooth.              (line   6)
+* sparse:                                matrix.              (line 101)
+* special-filenames:                     special-filenames.   (line   6)
+* special_filenames:                     special-filenames.   (line   6)
+* special_functions:                     Special_functions_with_complex_arguments.
+                                                              (line   6)
+* special_linetypes:                     special_linetypes.   (line   6)
+* specify:                               Syntax.              (line   6)
+* spiderplot:                            spiderplot.          (line   6)
+* splines:                               smooth.              (line   6)
+* split:                                 Counting_and_extracting_words.
+                                                              (line  35)
+* split <1>:                             Counting_and_extracting_words.
+                                                              (line  35)
+* split <2>:                             Array_functions.     (line   6)
+* splot:                                 splot.               (line   6)
+* spotlight:                             lighting.            (line   6)
+* sprintf:                               sprintf.             (line   6)
+* sqrt:                                  sqrt.                (line   6)
+* square:                                size.                (line   6)
+* square <1>:                            size.                (line  45)
+* starc:                                 epson_180dpi.        (line   6)
+* start:                                 Start-up_(initialization).
+                                                              (line   6)
+* start-up:                              Start-up_(initialization).
+                                                              (line   6)
+* starting_values:                       starting_values.     (line   6)
+* startup:                               Start-up_(initialization).
+                                                              (line   6)
+* statistical_overview:                  statistical_overview.
+                                                              (line   6)
+* statistics:                            stats_(Statistical_Summary).
+                                                              (line   6)
+* stats:                                 stats_(Statistical_Summary).
+                                                              (line   6)
+* steps:                                 steps.               (line   6)
+* strcol:                                using_specifier_functions.
+                                                              (line  34)
+* strftime:                              strftime.            (line   6)
+* string:                                String_constants.    (line   6)
+* string operators:                      Binary.              (line  34)
+* stringcolumn:                          using_specifier_functions.
+                                                              (line  34)
+* strings:                               String_constants.    (line   6)
+* strlen:                                strlen.              (line   6)
+* strptime:                              strptime.            (line   6)
+* strstrt:                               strstrt.             (line   6)
+* style:                                 with.                (line   6)
+* subfigures:                            Plotting.            (line  15)
+* substitution:                          Substitution_and_Command_line_macros.
+                                                              (line   6)
+* substr:                                substr.              (line   6)
+* substring:                             substr.              (line   6)
+* substrings:                            substrings.          (line   6)
+* summation:                             summation.           (line   6)
+* surface:                               surface_plots.       (line   6)
+* surface <1>:                           surface_.            (line   6)
+* svg:                                   svg.                 (line   6)
+* svga:                                  svga.                (line   6)
+* SynchrotronF:                          Synchrotron_function.
+                                                              (line   6)
+* syntax:                                Syntax.              (line   6)
+* system:                                system.              (line   6)
+* system <1>:                            system_.             (line   6)
+* table:                                 table.               (line   6)
+* tan:                                   tan.                 (line   6)
+* tandy_60dpi:                           epson_180dpi.        (line   6)
+* tanh:                                  tanh.                (line   6)
+* tc:                                    colorspec.           (line   6)
+* tek40:                                 tek40.               (line   6)
+* tek410x:                               tek410x.             (line   6)
+* term:                                  complete_list_of_terminals.
+                                                              (line   6)
+* terminal:                              Glossary.            (line   6)
+* terminal <1>:                          complete_list_of_terminals.
+                                                              (line   6)
+* termoption:                            termoption.          (line   6)
+* ternary:                               Ternary.             (line   6)
+* test:                                  test.                (line   6)
+* texdraw:                               texdraw.             (line   6)
+* text-menu:                             text-menu".          (line   6)
+* textbox:                               set_style_textbox.   (line   6)
+* textcolor:                             colorspec.           (line   6)
+* text_markup:                           Enhanced_text_mode.  (line   6)
+* tgif:                                  tgif.                (line   6)
+* theta:                                 theta.               (line   6)
+* tics:                                  tics.                (line   6)
+* ticscale:                              ticscale.            (line   6)
+* ticslevel:                             ticslevel.           (line   6)
+* time:                                  Time_functions.      (line   8)
+* time/date:                             Time/Date_data.      (line   6)
+* timecolumn:                            Time_functions.      (line  21)
+* timefmt:                               timefmt.             (line   6)
+* timestamp:                             timestamp.           (line   6)
+* time_specifiers:                       time/date_specifiers.
+                                                              (line   6)
+* tips:                                  tips.                (line   6)
+* title:                                 title_.              (line   6)
+* tkcanvas:                              tkcanvas.            (line   6)
+* tmargin:                               tmargin.             (line   6)
+* tm_hour:                               words.               (line   9)
+* tm_mday:                               words.               (line  13)
+* tm_min:                                words.               (line  17)
+* tm_mon:                                words.               (line  21)
+* tm_sec:                                words.               (line  25)
+* tm_wday:                               words.               (line  29)
+* tm_week:                               Time_functions.      (line  48)
+* tm_yday:                               words.               (line  33)
+* tm_year:                               words.               (line  37)
+* toggle:                                toggle.              (line   6)
+* tpic:                                  tpic.                (line   6)
+* trange:                                trange.              (line   6)
+* transparency:                          transparency.        (line   6)
+* transparency <1>:                      colormap.            (line   6)
+* transparent:                           set_style_fill.      (line  70)
+* transpose:                             keywords.            (line  37)
+* trim:                                  trim.                (line   6)
+* trim <1>:                              Counting_and_extracting_words.
+                                                              (line  71)
+* trim <2>:                              Counting_and_extracting_words.
+                                                              (line  71)
+* ttics:                                 ttics.               (line   6)
+* uigamma:                               uigamma.             (line   6)
+* unary:                                 Unary.               (line   6)
+* undefine:                              undefine.            (line   6)
+* unicode:                               escape_sequences.    (line   6)
+* uniform:                               matrix.              (line  31)
+* unique:                                smooth.              (line 158)
+* unset:                                 unset.               (line   6)
+* unwrap:                                smooth.              (line 165)
+* update:                                update.              (line   6)
+* urange:                                urange.              (line   6)
+* user-defined:                          User-defined_variables_and_functions.
+                                                              (line   6)
+* using:                                 using.               (line   6)
+* UTF-8:                                 encoding.            (line   6)
+* utf8:                                  string_encoding.     (line   6)
+* utf8 <1>:                              encoding.            (line   6)
+* v6_changes:                            Plot_style_details.  (line   6)
+* valid:                                 using_specifier_functions.
+                                                              (line  43)
+* value:                                 value.               (line   6)
+* variable:                              variable_point_properties.
+                                                              (line   6)
+* variable <1>:                          variable_point_properties.
+                                                              (line   6)
+* variables:                             User-defined_variables_and_functions.
+                                                              (line   6)
+* vclear:                                vclear.              (line   6)
+* vectors:                               vectors.             (line   6)
+* version:                               New_features_in_version_6.
+                                                              (line   6)
+* version_5:                             Brief_summary_of_features_introduced_in_version_5.
+                                                              (line   6)
+* vfill:                                 vfill.               (line   6)
+* vgfill:                                vfill.               (line   6)
+* vgrid:                                 vgrid.               (line   6)
+* view:                                  view.                (line   6)
+* viridis:                               viridis.             (line   6)
+* voigt:                                 voigt.               (line   6)
+* volatile:                              volatile.            (line   6)
+* voxel:                                 voxel.               (line   6)
+* voxel-grids:                           voxel-grid.          (line   6)
+* VoxelDistance:                         vfill.               (line   6)
+* VoxelDistance <1>:                     vfill.               (line   6)
+* VP:                                    Voigt_Profile.       (line   6)
+* VP_fwhm:                               Voigt_Profile.       (line   6)
+* vrange:                                vrange.              (line   6)
+* vttek:                                 tek40.               (line   6)
+* vxrange:                               vxrange.             (line   6)
+* vyrange:                               vyrange.             (line   6)
+* vzrange:                               vzrange.             (line   6)
+* walls:                                 walls.               (line   6)
+* warn:                                  warn.                (line   6)
+* watch:                                 Watchpoints_.        (line   6)
+* watchpoints:                           Watchpoints_.        (line   6)
+* waterfallplots:                        3D_waterfall_plots.  (line   6)
+* weekdate_cdc:                          Time_functions.      (line  99)
+* weekdate_iso:                          Time_functions.      (line  73)
+* wgnuplot.ini:                          wgnuplot.ini.        (line   6)
+* wgnuplot.mnu:                          wgnuplot.mnu".       (line   6)
+* while:                                 While.               (line   6)
+* windows:                               windows.             (line   6)
+* windrose:                              sectors.             (line   6)
+* with:                                  with.                (line   6)
+* word:                                  word.                (line   6)
+* word <1>:                              Counting_and_extracting_words.
+                                                              (line   6)
+* words:                                 words.               (line   6)
+* words <1>:                             Counting_and_extracting_words.
+                                                              (line   6)
+* writeback:                             xrange.              (line   6)
+* wxt:                                   cairo_(pdfcairo.     (line   6)
+* wxt <1>:                               wxt.                 (line   6)
+* X resources:                           x11.                 (line 108)
+* X resources <1>:                       command-line_options_.
+                                                              (line  25)
+* X resources <2>:                       color_resources_.    (line   6)
+* X resources <3>:                       grayscale_resources_.
+                                                              (line   6)
+* X resources <4>:                       line_resources_.     (line   6)
+* X resources <5>:                       x11_pm3d_resources.  (line   6)
+* X resources <6>:                       x11_other_resources. (line   6)
+* x11:                                   x11.                 (line   6)
+* X11:                                   x11.                 (line   6)
+* x11_fonts:                             x11_fonts.           (line   6)
+* x2data:                                x2data.              (line   6)
+* x2dtics:                               x2dtics.             (line   6)
+* x2label:                               x2label.             (line   6)
+* x2mtics:                               x2mtics.             (line   6)
+* x2range:                               x2range.             (line   6)
+* x2tics:                                x2tics.              (line   6)
+* x2zeroaxis:                            x2zeroaxis.          (line   6)
+* xdata:                                 xdata.               (line   6)
+* xdtics:                                xdtics.              (line   6)
+* xerrorbars:                            xerrorbars.          (line   6)
+* xerrorlines:                           xerrorlines.         (line   6)
+* xfig:                                  fig.                 (line   6)
+* xlabel:                                xlabel.              (line   6)
+* xlib:                                  xlib.                (line   6)
+* xmtics:                                xmtics.              (line   6)
+* xrange:                                xrange.              (line   6)
+* xterm:                                 tek40.               (line   6)
+* xticlabels:                            using.               (line 194)
+* xtics:                                 xtics.               (line   6)
+* xyerrorbars:                           xyerrorbars.         (line   6)
+* xyerrorlines:                          xyerrorlines.        (line   6)
+* xyplane:                               xyplane.             (line   6)
+* xzeroaxis:                             xzeroaxis.           (line   6)
+* y2data:                                y2data.              (line   6)
+* y2dtics:                               y2dtics.             (line   6)
+* y2label:                               y2label.             (line   6)
+* y2mtics:                               y2mtics.             (line   6)
+* y2range:                               y2range.             (line   6)
+* y2tics:                                y2tics.              (line   6)
+* y2zeroaxis:                            y2zeroaxis.          (line   6)
+* ydata:                                 ydata.               (line   6)
+* ydtics:                                ydtics.              (line   6)
+* yerrorbars:                            yerrorbars.          (line   6)
+* yerrorlines:                           yerrorlines.         (line   6)
+* ylabel:                                ylabel.              (line   6)
+* ymtics:                                ymtics.              (line   6)
+* yrange:                                yrange.              (line   6)
+* ytics:                                 ytics.               (line   6)
+* yzeroaxis:                             yzeroaxis.           (line   6)
+* zclip:                                 with_pm3d_(pm3d_explicit).
+                                                              (line   6)
+* zdata:                                 zdata.               (line   6)
+* zdtics:                                zdtics.              (line   6)
+* zero:                                  zero.                (line   6)
+* zeroaxis:                              zeroaxis.            (line   6)
+* zerrorfill:                            Fence_plots.         (line   6)
+* zerrorfill <1>:                        Zerrorfill.          (line   6)
+* zeta:                                  zeta.                (line   6)
+* zlabel:                                zlabel.              (line   6)
+* zmtics:                                zmtics.              (line   6)
+* zoom:                                  zoom.                (line   6)
+* zrange:                                zrange.              (line   6)
+* zsort:                                 filters.             (line 173)
+* ztics:                                 ztics.               (line   6)
+* zzeroaxis:                             zzeroaxis.           (line   6)
+
+
+File: gnuplot.info,  Node: Command_Index,  Next: Options_Index,  Prev: Concept_Index,  Up: Top
+
+Command Index
+*************
+
+[index]
+* Menu:
+
+* call:                                  call.                  (line 6)
+* cd:                                    cd.                    (line 6)
+* clear:                                 clear.                 (line 6)
+* evaluate:                              evaluate.              (line 6)
+* exit:                                  exit.                  (line 6)
+* fit:                                   fit.                   (line 6)
+* for:                                   for.                   (line 6)
+* help:                                  help.                  (line 6)
+* history:                               history.               (line 6)
+* if:                                    if.                    (line 6)
+* import:                                import.                (line 6)
+* load:                                  load.                  (line 6)
+* local:                                 Scope_of_variables.    (line 6)
+* local <1>:                             local.                 (line 6)
+* lower:                                 raise.                 (line 6)
+* pause:                                 pause.                 (line 6)
+* plot:                                  plot.                  (line 6)
+* print:                                 print.                 (line 6)
+* printerr:                              printerr.              (line 6)
+* pwd:                                   pwd.                   (line 6)
+* quit:                                  quit.                  (line 6)
+* raise:                                 raise.                 (line 6)
+* refresh:                               refresh.               (line 6)
+* remultiplot:                           remultiplot.           (line 6)
+* replot:                                replot.                (line 6)
+* reread:                                reread.                (line 6)
+* reset:                                 reset.                 (line 6)
+* return:                                return.                (line 6)
+* save:                                  save.                  (line 6)
+* shell:                                 shell.                 (line 6)
+* show:                                  set-show.              (line 6)
+* splot:                                 splot.                 (line 6)
+* system:                                system.                (line 6)
+* system <1>:                            system_.               (line 6)
+* test:                                  test.                  (line 6)
+* toggle:                                toggle.                (line 6)
+* undefine:                              undefine.              (line 6)
+* unset:                                 unset.                 (line 6)
+* update:                                update.                (line 6)
+* vclear:                                vclear.                (line 6)
+* vfill:                                 vfill.                 (line 6)
+* warn:                                  warn.                  (line 6)
+
+
+File: gnuplot.info,  Node: Options_Index,  Next: Function_Index,  Prev: Command_Index,  Up: Top
+
+Options Index
+*************
+
+[index]
+* Menu:
+
+* angles:                                angles.               (line  6)
+* arrow:                                 arrow.                (line  6)
+* autoscale:                             autoscale.            (line  6)
+* bind:                                  bind.                 (line  6)
+* bind <1>:                              reset.                (line 37)
+* bind <2>:                              bind_.                (line  6)
+* bmargin:                               bmargin.              (line  6)
+* border:                                fill_properties.      (line  6)
+* border <1>:                            border.               (line  6)
+* border <2>:                            set_style_fill.       (line 50)
+* boxdepth:                              boxdepth.             (line  6)
+* boxwidth:                              boxwidth.             (line  6)
+* cbdata:                                cbdata.               (line  6)
+* cbdtics:                               cbdtics.              (line  6)
+* cblabel:                               cblabel.              (line  6)
+* cbmtics:                               cbmtics.              (line  6)
+* cbrange:                               cbrange.              (line  6)
+* cbtics:                                cbtics.               (line  6)
+* chi_shapes:                            chi_shapes.           (line  6)
+* clabel:                                clabel.               (line  6)
+* clip:                                  clip.                 (line  6)
+* cntrlabel:                             cntrlabel.            (line  6)
+* cntrparam:                             cntrparam.            (line  6)
+* colormap:                              colormap.             (line  6)
+* colornames:                            colornames.           (line  6)
+* colorsequence:                         colorsequence.        (line  6)
+* contour:                               contour.              (line  6)
+* contourfill:                           contourfill.          (line  6)
+* cornerpoles:                           cornerpoles.          (line  6)
+* dashtype:                              dashtype.             (line  6)
+* dashtype <1>:                          dashtype.             (line  6)
+* datafile:                              data.                 (line  6)
+* decimalsign:                           decimalsign.          (line  6)
+* dgrid3d:                               dgrid3d.              (line  6)
+* dummy:                                 dummy.                (line  6)
+* encoding:                              encoding.             (line  6)
+* errorbars:                             yerrorbars.           (line  6)
+* errorbars <1>:                         errorbars.            (line  6)
+* fontpath:                              fontpath.             (line  6)
+* format:                                format__.             (line  6)
+* grid:                                  grid.                 (line  6)
+* hidden3d:                              hidden3d.             (line  6)
+* isosamples:                            isosamples.           (line  6)
+* isosurface:                            isosurface.           (line  6)
+* isotropic:                             isotropic.            (line  6)
+* jitter:                                Bee_swarm_plots.      (line  6)
+* jitter <1>:                            jitter.               (line  6)
+* key:                                   key_.                 (line  6)
+* label:                                 label.                (line  6)
+* link:                                  link.                 (line  6)
+* lmargin:                               lmargin.              (line  6)
+* loadpath:                              loadpath.             (line  6)
+* locale:                                decimalsign.          (line  6)
+* locale <1>:                            locale.               (line  6)
+* logscale:                              logscale.             (line  6)
+* logscale <1>:                          xtics_logscale.       (line  6)
+* macros:                                Substitution_of_string_variables_as_macros.
+                                                               (line  6)
+* mapping:                               mapping.              (line  6)
+* micro:                                 micro.                (line  6)
+* minussign:                             minussign.            (line  6)
+* monochrome:                            monochrome.           (line  6)
+* mouse:                                 mouse.                (line  6)
+* mttics:                                mttics.               (line  6)
+* multiplot:                             Plotting.             (line 15)
+* multiplot <1>:                         multiplot.            (line  6)
+* mx2tics:                               mx2tics.              (line  6)
+* mxtics:                                mxtics.               (line  6)
+* my2tics:                               my2tics.              (line  6)
+* mytics:                                mytics.               (line  6)
+* mztics:                                mztics.               (line  6)
+* nonlinear:                             nonlinear.            (line  6)
+* offsets:                               offsets.              (line  6)
+* origin:                                origin.               (line  6)
+* output:                                output.               (line  6)
+* overflow:                              overflow.             (line  6)
+* palette:                               palette.              (line  6)
+* palette <1>:                           colormap.             (line  6)
+* palette <2>:                           palette__.            (line  6)
+* palette <3>:                           show_palette.         (line  6)
+* parametric:                            parametric_.          (line  6)
+* paxis:                                 paxis.                (line  6)
+* pixmap:                                pixmap.               (line  6)
+* pm3d:                                  pm3d.                 (line  6)
+* pointintervalbox:                      pointintervalbox.     (line  6)
+* pointsize:                             pointsize.            (line  6)
+* polar:                                 Polar_plots.          (line  6)
+* polar <1>:                             polar.                (line  6)
+* psdir:                                 psdir.                (line  6)
+* raxis:                                 raxis.                (line  6)
+* rgbmax:                                rgbmax.               (line  6)
+* rlabel:                                rlabel.               (line  6)
+* rmargin:                               rmargin.              (line  6)
+* rrange:                                rrange.               (line  6)
+* rtics:                                 rtics.                (line  6)
+* samples:                               samples.              (line  6)
+* size:                                  size.                 (line  6)
+* spiderplot:                            spiderplot.           (line  6)
+* style:                                 with.                 (line  6)
+* surface:                               surface_plots.        (line  6)
+* surface <1>:                           surface_.             (line  6)
+* table:                                 table.                (line  6)
+* terminal:                              Glossary.             (line  6)
+* terminal <1>:                          complete_list_of_terminals.
+                                                               (line  6)
+* termoption:                            termoption.           (line  6)
+* theta:                                 theta.                (line  6)
+* tics:                                  tics.                 (line  6)
+* ticscale:                              ticscale.             (line  6)
+* ticslevel:                             ticslevel.            (line  6)
+* timefmt:                               timefmt.              (line  6)
+* timestamp:                             timestamp.            (line  6)
+* title:                                 title_.               (line  6)
+* tmargin:                               tmargin.              (line  6)
+* trange:                                trange.               (line  6)
+* ttics:                                 ttics.                (line  6)
+* urange:                                urange.               (line  6)
+* version:                               New_features_in_version_6.
+                                                               (line  6)
+* vgrid:                                 vgrid.                (line  6)
+* view:                                  view.                 (line  6)
+* vrange:                                vrange.               (line  6)
+* vxrange:                               vxrange.              (line  6)
+* vyrange:                               vyrange.              (line  6)
+* vzrange:                               vzrange.              (line  6)
+* walls:                                 walls.                (line  6)
+* watchpoints:                           Watchpoints_.         (line  6)
+* x2data:                                x2data.               (line  6)
+* x2dtics:                               x2dtics.              (line  6)
+* x2label:                               x2label.              (line  6)
+* x2mtics:                               x2mtics.              (line  6)
+* x2range:                               x2range.              (line  6)
+* x2tics:                                x2tics.               (line  6)
+* x2zeroaxis:                            x2zeroaxis.           (line  6)
+* xdata:                                 xdata.                (line  6)
+* xdtics:                                xdtics.               (line  6)
+* xlabel:                                xlabel.               (line  6)
+* xmtics:                                xmtics.               (line  6)
+* xrange:                                xrange.               (line  6)
+* xtics:                                 xtics.                (line  6)
+* xyplane:                               xyplane.              (line  6)
+* xzeroaxis:                             xzeroaxis.            (line  6)
+* y2data:                                y2data.               (line  6)
+* y2dtics:                               y2dtics.              (line  6)
+* y2label:                               y2label.              (line  6)
+* y2mtics:                               y2mtics.              (line  6)
+* y2range:                               y2range.              (line  6)
+* y2tics:                                y2tics.               (line  6)
+* y2zeroaxis:                            y2zeroaxis.           (line  6)
+* ydata:                                 ydata.                (line  6)
+* ydtics:                                ydtics.               (line  6)
+* ylabel:                                ylabel.               (line  6)
+* ymtics:                                ymtics.               (line  6)
+* yrange:                                yrange.               (line  6)
+* ytics:                                 ytics.                (line  6)
+* yzeroaxis:                             yzeroaxis.            (line  6)
+* zdata:                                 zdata.                (line  6)
+* zdtics:                                zdtics.               (line  6)
+* zero:                                  zero.                 (line  6)
+* zeroaxis:                              zeroaxis.             (line  6)
+* zlabel:                                zlabel.               (line  6)
+* zmtics:                                zmtics.               (line  6)
+* zrange:                                zrange.               (line  6)
+* ztics:                                 ztics.                (line  6)
+* zzeroaxis:                             zzeroaxis.            (line  6)
+
+
+File: gnuplot.info,  Node: Function_Index,  Next: Terminal_Index,  Prev: Options_Index,  Up: Top
+
+Function Index
+**************
+
+[index]
+* Menu:
+
+* abs:                                   abs.                  (line  6)
+* acos:                                  acos.                 (line  6)
+* acosh:                                 acosh.                (line  6)
+* airy:                                  airy.                 (line  6)
+* arg:                                   arg.                  (line  6)
+* asin:                                  asin.                 (line  6)
+* asinh:                                 asinh.                (line  6)
+* atan:                                  atan.                 (line  6)
+* atan2:                                 atan2.                (line  6)
+* atanh:                                 atanh.                (line  6)
+* besi0:                                 besi0.                (line  6)
+* besi1:                                 besi1.                (line  6)
+* besin:                                 besin.                (line  6)
+* besj0:                                 besj0.                (line  6)
+* besj1:                                 besj1.                (line  6)
+* besjn:                                 besjn.                (line  6)
+* besy0:                                 besy0.                (line  6)
+* besy1:                                 besy1.                (line  6)
+* besyn:                                 besyn.                (line  6)
+* cbrt:                                  cbrt.                 (line  6)
+* cdawson:                               cdawson.              (line  6)
+* cerf:                                  cerf.                 (line  6)
+* conj:                                  conj.                 (line  6)
+* cos:                                   cos.                  (line  6)
+* cosh:                                  cosh.                 (line  6)
+* elliptic integrals:                    elliptic_integrals.   (line  6)
+* EllipticE:                             EllipticK.            (line  7)
+* EllipticK:                             cosh.                 (line  7)
+* EllipticPi:                            EllipticE.            (line  7)
+* erf:                                   erf.                  (line  6)
+* erfc:                                  erfc.                 (line  6)
+* erfi:                                  erfi.                 (line  6)
+* exists:                                exists.               (line  6)
+* exists <1>:                            Substitution_of_string_variables_as_macros.
+                                                               (line  6)
+* exp:                                   exp.                  (line  6)
+* faddeeva:                              faddeeva.             (line  6)
+* gamma:                                 Gamma.                (line  6)
+* gprintf:                               gprintf_.             (line  6)
+* hsv2rgb:                               hsv2rgb.              (line  6)
+* imag:                                  imag.                 (line  6)
+* inverf:                                inverf.               (line  6)
+* invnorm:                               invnorm.              (line  6)
+* join:                                  Counting_and_extracting_words.
+                                                               (line 61)
+* join <1>:                              Counting_and_extracting_words.
+                                                               (line 61)
+* lambertw:                              lambertw.             (line  6)
+* LambertW:                              LambertW.             (line  6)
+* lgamma:                                lgamma.               (line  6)
+* lnGamma:                               lnGamma.              (line  6)
+* log:                                   log.                  (line  6)
+* log10:                                 log10.                (line  6)
+* norm:                                  abs.                  (line  9)
+* norm <1>:                              norm.                 (line  6)
+* rand:                                  rand.                 (line  6)
+* rand <1>:                              Random_number_generator.
+                                                               (line  6)
+* real:                                  real.                 (line  6)
+* rgbcolor:                              rgbcolor.             (line  6)
+* sgn:                                   sgn.                  (line  6)
+* sin:                                   sin.                  (line  6)
+* sinh:                                  sinh.                 (line  6)
+* split:                                 Counting_and_extracting_words.
+                                                               (line 35)
+* split <1>:                             Counting_and_extracting_words.
+                                                               (line 35)
+* split <2>:                             Array_functions.      (line  6)
+* sprintf:                               sprintf.              (line  6)
+* sqrt:                                  sqrt.                 (line  6)
+* strftime:                              strftime.             (line  6)
+* strlen:                                strlen.               (line  6)
+* strptime:                              strptime.             (line  6)
+* strstrt:                               strstrt.              (line  6)
+* substr:                                substr.               (line  6)
+* tan:                                   tan.                  (line  6)
+* tanh:                                  tanh.                 (line  6)
+* trim:                                  trim.                 (line  6)
+* trim <1>:                              Counting_and_extracting_words.
+                                                               (line 71)
+* trim <2>:                              Counting_and_extracting_words.
+                                                               (line 71)
+* uigamma:                               uigamma.              (line  6)
+* value:                                 value.                (line  6)
+* voigt:                                 voigt.                (line  6)
+* voxel:                                 voxel.                (line  6)
+* word:                                  word.                 (line  6)
+* word <1>:                              Counting_and_extracting_words.
+                                                               (line  6)
+* words:                                 words.                (line  6)
+* words <1>:                             Counting_and_extracting_words.
+                                                               (line  6)
+* zeta:                                  zeta.                 (line  6)
+
+
+File: gnuplot.info,  Node: Terminal_Index,  Prev: Function_Index,  Up: Top
+
+Terminal Index
+**************
+
+[index]
+* Menu:
+
+* aqua:                                  aqua.                  (line 6)
+* cgm:                                   cgm.                   (line 6)
+* context:                               context.               (line 6)
+* corel:                                 corel.                 (line 6)
+* debug:                                 debug.                 (line 6)
+* dospc:                                 dospc.                 (line 6)
+* dpu414:                                epson_180dpi.          (line 6)
+* dumb:                                  dumb.                  (line 6)
+* dxf:                                   dxf.                   (line 6)
+* dxy800a:                               dxy800a.               (line 6)
+* eepic:                                 eepic.                 (line 6)
+* emf:                                   emf.                   (line 6)
+* emtex:                                 latex.                 (line 6)
+* epscairo:                              epscairo.              (line 6)
+* excl:                                  excl.                  (line 6)
+* ggi:                                   ggi.                   (line 6)
+* gpic:                                  gpic.                  (line 6)
+* graph-menu:                            graph-menu.            (line 6)
+* grass:                                 grass.                 (line 6)
+* hp2623a:                               hp2623a.               (line 6)
+* hp2648:                                hp2648.                (line 6)
+* hp500c:                                hp500c.                (line 6)
+* hpdj:                                  hpljii.                (line 6)
+* hpgl:                                  hpgl.                  (line 6)
+* hpljii:                                hpljii.                (line 6)
+* hppj:                                  hppj.                  (line 6)
+* imagen:                                imagen.                (line 6)
+* kc-tek40xx:                            tek40.                 (line 6)
+* kyo:                                   kyo.                   (line 6)
+* latex:                                 latex.                 (line 6)
+* lua:                                   lua.                   (line 6)
+* mif:                                   mif.                   (line 6)
+* okidata:                               epson_180dpi.          (line 6)
+* pbm:                                   pbm.                   (line 6)
+* pdf:                                   cairo_(pdfcairo.       (line 6)
+* pdf <1>:                               pdf.                   (line 6)
+* png:                                   cairo_(pdfcairo.       (line 6)
+* png <1>:                               gd_(png.               (line 6)
+* png <2>:                               png_.                  (line 6)
+* prescribe:                             kyo.                   (line 6)
+* pstricks:                              pstricks.              (line 6)
+* qms:                                   qms.                   (line 6)
+* regis:                                 regis.                 (line 6)
+* sixeltek:                              tek40.                 (line 6)
+* starc:                                 epson_180dpi.          (line 6)
+* svg:                                   svg.                   (line 6)
+* svga:                                  svga.                  (line 6)
+* tek40:                                 tek40.                 (line 6)
+* tek410x:                               tek410x.               (line 6)
+* texdraw:                               texdraw.               (line 6)
+* text-menu:                             text-menu".            (line 6)
+* tgif:                                  tgif.                  (line 6)
+* tkcanvas:                              tkcanvas.              (line 6)
+* tpic:                                  tpic.                  (line 6)
+* vttek:                                 tek40.                 (line 6)
+* wgnuplot.ini:                          wgnuplot.ini.          (line 6)
+* wgnuplot.mnu:                          wgnuplot.mnu".         (line 6)
+* windows:                               windows.               (line 6)
+* wxt:                                   cairo_(pdfcairo.       (line 6)
+* wxt <1>:                               wxt.                   (line 6)
+* xlib:                                  xlib.                  (line 6)
+* xterm:                                 tek40.                 (line 6)
+
+
+
+Tag Table:
+Node: Top204
+Node: Gnuplot1159
+Node: Copyright2047
+Node: Introduction4132
+Node: Seeking-assistance_/_Bugs8334
+Node: New_features_in_version_69953
+Node: Function_blocks_and_scoped_variables11134
+Node: Special_and_complex-valued_functions13216
+Node: New_plot_styles15597
+Node: Hulls17936
+Node: Named_palettes19437
+Node: New_data_formats20354
+Node: New_built-in_functions_and_array_operations21053
+Node: Program_control_flow22359
+Node: Multiplots23410
+Node: New_terminals_and_terminal_options25356
+Node: Watchpoints26691
+Node: Week-date_time_support27540
+Node: Other_new_features28539
+Node: Brief_summary_of_features_introduced_in_version_531098
+Node: Features_introduced_in_5.431455
+Node: Features_introduced_in_5.232773
+Node: Features_introduced_in_5.033533
+Node: Differences_between_versions_5_and_634309
+Node: Plot_style_details34783
+Node: Deprecated_syntax35592
+Node: Demos_and_Online_Examples37049
+Node: Batch/Interactive_Operation37679
+Node: command_line_options38445
+Node: Examples39402
+Node: Canvas_size40200
+Node: Command-line-editing41527
+Node: Comments43018
+Node: Coordinates43529
+Node: Datastrings45863
+Node: Enhanced_text_mode47874
+Node: escape_sequences52446
+Node: Environment53802
+Node: Expressions56084
+Node: Complex_values58482
+Node: Constants60397
+Node: Functions61885
+Node: abs63508
+Node: acos63922
+Node: acosh64192
+Node: airy64434
+Node: arg64780
+Node: asin64998
+Node: asinh65262
+Node: atan65501
+Node: atan265775
+Node: atanh66118
+Node: besj066365
+Node: besj166607
+Node: besjn66849
+Node: besy067038
+Node: besy167280
+Node: besyn67522
+Node: besi067711
+Node: besi167946
+Node: besin68181
+Node: cbrt68382
+Node: conj68689
+Node: cos68879
+Node: cosh69125
+Node: EllipticK69360
+Node: EllipticE69619
+Node: EllipticPi69885
+Node: erf70149
+Node: erfc70484
+Node: exp70814
+Node: gamma71161
+Node: inverf71509
+Node: imag71751
+Node: invnorm72025
+Node: lambertw72297
+Node: lgamma72620
+Node: lngamma72962
+Node: log73375
+Node: log1073585
+Node: norm73769
+Node: rand74045
+Node: real74263
+Node: sgn74549
+Node: Sign74849
+Node: sin75070
+Node: sinh75320
+Node: sqrt75548
+Node: tan75804
+Node: tanh76057
+Node: voigt76289
+Node: cerf76721
+Node: cdawson76931
+Node: faddeeva77212
+Node: erfi77545
+Node: Voigt_Profile77750
+Node: gprintf78104
+Node: sprintf78477
+Node: strlen78947
+Node: strstrt79505
+Node: substr80017
+Node: split80377
+Node: join81020
+Node: strftime81374
+Node: strptime81657
+Node: system81970
+Node: trim82400
+Node: word82784
+Node: words83011
+Node: exists84485
+Node: hsv2rgb84788
+Node: palette85013
+Node: rgbcolor85268
+Node: voxel85791
+Node: integer_conversion_functions_(int_floor_ceil_round)86236
+Node: elliptic_integrals88359
+Node: Complex_Airy_functions89487
+Node: Complex_Bessel_functions89933
+Node: Expint91410
+Node: Fresnel_integrals_FresnelC(x)_and_FresnelS(x)92131
+Node: Gamma92586
+Node: Igamma92962
+Node: Invigamma94169
+Node: Ibeta94602
+Node: Invibeta95049
+Node: LambertW95477
+Node: lnGamma95989
+Node: Random_number_generator96431
+Node: Special_functions_with_complex_arguments97360
+Node: Synchrotron_function98677
+Node: Time_functions99211
+Node: uigamma104093
+Node: using_specifier_functions104565
+Node: value107110
+Node: Counting_and_extracting_words107746
+Node: zeta110976
+Node: operators111487
+Node: Unary112092
+Node: Binary113108
+Node: Ternary115098
+Node: summation116567
+Node: Gnuplot-defined_variables117559
+Node: User-defined_variables_and_functions119585
+Node: arrays122086
+Node: Array_functions124052
+Node: Array_indexing124929
+Node: Fonts125663
+Node: cairo_(pdfcairo126659
+Node: gd_(png127380
+Node: postscript__(also_encapsulated_postscript_*.eps)129107
+Node: Glossary130922
+Node: inline_data_and_datablocks132259
+Node: iteration133719
+Node: linetypes135506
+Node: colorspec138044
+Node: background_color141332
+Node: linecolor_variable142047
+Node: palette_143251
+Node: rgbcolor_variable144596
+Node: dashtype145661
+Node: linestyles_vs_linetypes147852
+Node: special_linetypes148823
+Node: layers149898
+Node: mouse_input151358
+Node: bind152037
+Node: bind_space155285
+Node: Mouse_variables155715
+Node: Persist157404
+Node: Plotting158569
+Node: Plugins161244
+Node: Scope_of_variables162794
+Node: Start-up_(initialization)164973
+Node: String_constants165701
+Node: substrings167207
+Node: string_operators168096
+Node: string_functions168508
+Node: string_encoding168981
+Node: Substitution_and_Command_line_macros169460
+Node: Substitution_of_system_commands_in_backquotes170053
+Node: Substitution_of_string_variables_as_macros171247
+Node: String_variables173413
+Node: Syntax174951
+Node: quote_marks177107
+Node: Time/Date_data178842
+Node: Watchpoints_182491
+Node: watch_mouse185559
+Node: watch_labels186290
+Node: Plotting_styles186866
+Node: arrows188493
+Node: arrowstyle_variable189677
+Node: Bee_swarm_plots190366
+Node: boxerrorbars191038
+Node: boxes192673
+Node: 2D_boxes193543
+Node: 3D_boxes195056
+Node: boxplot196757
+Node: boxxyerror200822
+Node: candlesticks202032
+Node: circles205138
+Node: contourfill207448
+Node: dots208637
+Node: ellipses209179
+Node: filledcurves211759
+Node: above/below213854
+Node: 3D_waterfall_plots214689
+Node: fill_properties215572
+Node: financebars216282
+Node: fillsteps217268
+Node: fsteps218047
+Node: histeps218800
+Node: heatmaps219771
+Node: histograms222328
+Node: newhistogram229718
+Node: automated_iteration_over_multiple_columns232072
+Node: histogram_color_assignments232659
+Node: hsteps234798
+Node: offset239000
+Node: missing_data239798
+Node: image240445
+Node: transparency244142
+Node: image_pixels244762
+Node: impulses245543
+Node: labels246218
+Node: lines248651
+Node: linespoints249340
+Node: masking250584
+Node: parallelaxes252633
+Node: Polar_plots253930
+Node: points254912
+Node: variable_point_properties256059
+Node: polygons257488
+Node: rgbalpha259858
+Node: rgbimage259996
+Node: sectors260133
+Node: spiderplot262927
+Node: newspiderplot264952
+Node: steps265548
+Node: surface266378
+Node: vectors267300
+Node: xerrorbars268992
+Node: xyerrorbars269986
+Node: xerrorlines271391
+Node: xyerrorlines272205
+Node: yerrorbars273424
+Node: yerrorlines274486
+Node: 3D_plots275351
+Node: surface_plots275919
+Node: 2D_projection_(set_view_map)276744
+Node: PM3D_plots277267
+Node: Fence_plots278039
+Node: isosurface278751
+Node: Zerrorfill279728
+Node: Animation281676
+Node: Commands282582
+Node: Break283794
+Node: cd284200
+Node: call284777
+Node: ARGV[_]286245
+Node: Example287409
+Node: clear288560
+Node: Continue289304
+Node: Do289714
+Node: evaluate290552
+Node: exit291447
+Node: fit292785
+Node: adjustable_parameters301953
+Node: short_introduction303247
+Node: error_estimates307378
+Node: statistical_overview308317
+Node: practical_guidelines312383
+Node: control316365
+Node: error_recovery317305
+Node: multi-branch318237
+Node: starting_values319523
+Node: time_data321192
+Node: tips322732
+Node: function_blocks325906
+Node: help330134
+Node: history330917
+Node: if332210
+Node: for333587
+Node: import334628
+Node: load335816
+Node: local337403
+Node: lower339069
+Node: pause339191
+Node: pause_mouse_close341888
+Node: pseudo-mousing_during_pause342861
+Node: plot343637
+Node: axes345806
+Node: binary346307
+Node: general349213
+Node: array351006
+Node: record351779
+Node: skip352819
+Node: format353430
+Node: blank354515
+Node: endian355298
+Node: filetype356156
+Node: keywords357872
+Node: data363315
+Node: columnheaders368536
+Node: csv_files369192
+Node: every369954
+Node: example_datafile371948
+Node: filters374015
+Node: index382365
+Node: skip_384581
+Node: smooth385129
+Node: special-filenames396419
+Node: piped-data400420
+Node: using401709
+Node: volatile412101
+Node: functions412483
+Node: parametric413229
+Node: ranges414266
+Node: sampling416829
+Node: 1D_sampling_(x_or_t_axis)417032
+Node: 2D_sampling_(u_and_v_axes)419087
+Node: for_loops_in_plot_command420469
+Node: title423418
+Node: with426455
+Node: print433496
+Node: printerr434643
+Node: pwd435041
+Node: quit435396
+Node: raise435569
+Node: refresh436283
+Node: remultiplot437212
+Node: replot437804
+Node: reread439675
+Node: reset440245
+Node: return441743
+Node: save442364
+Node: set-show444436
+Node: angles447045
+Node: arrow448651
+Node: autoscale452869
+Node: noextend455360
+Node: examples456197
+Node: polar_mode457134
+Node: bind_457655
+Node: bmargin457839
+Node: border458057
+Node: boxwidth462524
+Node: boxdepth464157
+Node: chi_shapes464626
+Node: color465379
+Node: colormap466002
+Node: colorsequence467518
+Node: clabel468443
+Node: clip468756
+Node: cntrlabel470899
+Node: cntrparam472437
+Node: Examples_477479
+Node: color_box479127
+Node: colornames481730
+Node: contour482413
+Node: cornerpoles485236
+Node: contourfill_485530
+Node: dashtype_487046
+Node: datafile487853
+Node: set_datafile_columnheaders488586
+Node: set_datafile_fortran489257
+Node: set_datafile_nofpe_trap489793
+Node: set_datafile_missing490319
+Node: set_datafile_separator492308
+Node: set_datafile_commentschars493243
+Node: set_datafile_binary494166
+Node: decimalsign494921
+Node: dgrid3d497335
+Node: dummy502391
+Node: encoding503393
+Node: errorbars505538
+Node: fit_506716
+Node: fontpath511678
+Node: format__512903
+Node: gprintf_514711
+Node: format_specifiers515301
+Node: time/date_specifiers518774
+Node: grid522970
+Node: hidden3d525770
+Node: history_532654
+Node: isosamples533672
+Node: isosurface_535153
+Node: isotropic535945
+Node: jitter536577
+Node: key_538902
+Node: 3D_key542485
+Node: key_examples543343
+Node: extra_key_entries544022
+Node: key_autotitle545667
+Node: key_layout547090
+Node: key_placement550121
+Node: key_offset553449
+Node: key_samples553820
+Node: multiple_keys555284
+Node: label556116
+Node: examples_561390
+Node: hypertext563248
+Node: linetype565044
+Node: link567607
+Node: lmargin568879
+Node: loadpath569098
+Node: locale570178
+Node: logscale570855
+Node: macros571785
+Node: mapping572121
+Node: margin573959
+Node: micro575894
+Node: minussign576617
+Node: monochrome578431
+Node: mouse579604
+Node: doubleclick583140
+Node: format___583519
+Node: mouseformat583910
+Node: scrolling585483
+Node: zoom586403
+Node: mttics587302
+Node: multiplot587534
+Node: mx2tics593892
+Node: mxtics594113
+Node: mxtics_time596635
+Node: my2tics597676
+Node: mytics597901
+Node: mztics598108
+Node: nonlinear598317
+Node: object600672
+Node: rectangle603158
+Node: ellipse604608
+Node: circle606920
+Node: polygon608164
+Node: offsets609430
+Node: origin611064
+Node: output611480
+Node: overflow612842
+Node: float614649
+Node: NaN615132
+Node: undefined615546
+Node: affected_operations615983
+Node: palette__616719
+Node: rgbformulae620063
+Node: defined621279
+Node: functions_624053
+Node: gray624951
+Node: cubehelix625257
+Node: viridis626141
+Node: colormap_626766
+Node: file627137
+Node: gamma_correction628716
+Node: maxcolors629864
+Node: Color_model630811
+Node: postscript631905
+Node: parametric_633084
+Node: paxis635302
+Node: pixmap636349
+Node: pixmap_from_colormap638805
+Node: pm3d639511
+Node: with_pm3d_(pm3d_explicit)641749
+Node: pm3d_implicit643251
+Node: algorithm644608
+Node: lighting647124
+Node: position648989
+Node: scanorder650031
+Node: clipping652060
+Node: color_assignment653192
+Node: corners2color654447
+Node: border_655679
+Node: fillcolor656449
+Node: interpolate657831
+Node: deprecated_options658852
+Node: pointintervalbox659212
+Node: pointsize659913
+Node: polar660506
+Node: polar_grid662687
+Node: print_664805
+Node: psdir665693
+Node: raxis666329
+Node: rgbmax666898
+Node: rlabel667447
+Node: rmargin667720
+Node: rrange667940
+Node: rtics668625
+Node: samples669006
+Node: size670348
+Node: spiderplot_673078
+Node: style673720
+Node: set_style_arrow675255
+Node: boxplot_679276
+Node: set_style_data683117
+Node: set_style_fill683538
+Node: set_style_function687403
+Node: set_style_histogram687814
+Node: set_style_increment688017
+Node: set_style_line688648
+Node: set_style_circle693672
+Node: set_style_rectangle694455
+Node: set_style_ellipse695329
+Node: set_style_parallelaxis697436
+Node: set_style_spiderplot697842
+Node: set_style_textbox698789
+Node: set_style_watchpoint699973
+Node: surface_701046
+Node: table702339
+Node: plot_with_table703916
+Node: terminal705862
+Node: termoption707562
+Node: theta708251
+Node: tics708829
+Node: ticslevel712636
+Node: ticscale712793
+Node: timestamp712993
+Node: timefmt714136
+Node: title_717380
+Node: tmargin718976
+Node: trange719194
+Node: ttics719992
+Node: urange720760
+Node: version721172
+Node: vgrid721765
+Node: view722983
+Node: azimuth724924
+Node: equal_axes725618
+Node: projection726235
+Node: vrange727102
+Node: vxrange727513
+Node: vyrange728043
+Node: vzrange728184
+Node: walls728323
+Node: watchpoints729226
+Node: x2data730691
+Node: x2dtics730927
+Node: x2label731170
+Node: x2mtics731384
+Node: x2range731630
+Node: x2tics731930
+Node: x2zeroaxis732167
+Node: xdata732426
+Node: time_733067
+Node: xdtics734378
+Node: xlabel734992
+Node: xmtics738224
+Node: xrange738855
+Node: examples__743087
+Node: extend743981
+Node: xtics744161
+Node: xtics_series749115
+Node: xtics_list750759
+Node: xtics_timedata752916
+Node: geographic755148
+Node: xtics_logscale756616
+Node: xtics_rangelimited757658
+Node: xyplane758662
+Node: xzeroaxis759710
+Node: y2data759932
+Node: y2dtics760166
+Node: y2label760416
+Node: y2mtics760637
+Node: y2range760890
+Node: y2tics761190
+Node: y2zeroaxis761434
+Node: ydata761700
+Node: ydtics761916
+Node: ylabel762146
+Node: ymtics762334
+Node: yrange762567
+Node: ytics762811
+Node: yzeroaxis763034
+Node: zdata763253
+Node: zdtics763466
+Node: zzeroaxis763699
+Node: cbdata764019
+Node: cbdtics764219
+Node: zero764460
+Node: zeroaxis765136
+Node: zlabel766508
+Node: zmtics766698
+Node: zrange766931
+Node: ztics767227
+Node: cblabel767448
+Node: cbmtics767647
+Node: cbrange767894
+Node: cbtics768573
+Node: shell768792
+Node: show769470
+Node: show_colornames770002
+Node: show_functions770340
+Node: show_palette770931
+Node: show_palette_gradient771489
+Node: show_palette_palette771888
+Node: show_palette_rgbformulae773494
+Node: show_plot773807
+Node: show_variables774339
+Node: splot774895
+Node: data-file777479
+Node: matrix779739
+Node: example_datafile_786879
+Node: grid_data788218
+Node: splot_surfaces789986
+Node: voxel-grid791381
+Node: stats_(Statistical_Summary)792660
+Node: name798537
+Node: test_for_existence_of_a_file799427
+Node: voxelgrid800108
+Node: system_800922
+Node: test801928
+Node: toggle802671
+Node: undefine803377
+Node: unset804287
+Node: linetype_804880
+Node: monochrome_805319
+Node: output_805535
+Node: terminal_805996
+Node: warnings806613
+Node: update807129
+Node: vclear807295
+Node: vfill807564
+Node: warn809804
+Node: While810232
+Node: Terminal_types810604
+Node: complete_list_of_terminals810774
+Node: aifm812212
+Node: aqua812632
+Node: be813852
+Node: command-line_options816011
+Node: monochrome_options817495
+Node: color_resources817839
+Node: grayscale_resources818905
+Node: line_resources819648
+Node: epscairo821366
+Node: canvas821704
+Node: cgm825377
+Node: cgm_font827493
+Node: cgm_fontsize830387
+Node: cgm_linewidth830821
+Node: cgm_rotate831152
+Node: cgm_solid831795
+Node: cgm_size832211
+Node: cgm_width832469
+Node: cgm_nofontlist833321
+Node: context834132
+Node: Requirements839824
+Node: Calling_gnuplot_from_ConTeXt840427
+Node: corel841047
+Node: debug841525
+Node: svga841792
+Node: dumb843080
+Node: dxf846741
+Node: dxy800a847285
+Node: eepic847517
+Node: emf851862
+Node: epson_180dpi853365
+Node: excl854836
+Node: fig855106
+Node: png_857732
+Node: examples____860417
+Node: ggi860959
+Node: gpic862071
+Node: grass863941
+Node: hp2623a864357
+Node: hp2648864577
+Node: hp500c864806
+Node: hpgl865446
+Node: hpljii866526
+Node: hppj867214
+Node: imagen867653
+Node: kyo868367
+Node: latex868716
+Node: lua871926
+Node: mf872901
+Node: METAFONT_Instructions874278
+Node: mp877741
+Node: Metapost_Instructions884537
+Node: mif886945
+Node: pbm888217
+Node: dospc889615
+Node: pdf890941
+Node: pstricks892977
+Node: qms895186
+Node: regis895421
+Node: svg895754
+Node: tek410x897898
+Node: tek40898136
+Node: texdraw899613
+Node: tgif901824
+Node: tkcanvas904720
+Node: tpic910190
+Node: windows912164
+Node: graph-menu916544
+Node: printing919509
+Node: text-menu"920432
+Node: wgnuplot.mnu"921516
+Node: wgnuplot.ini923231
+Node: wxt925796
+Node: x11932174
+Node: x11_fonts937468
+Node: command-line_options_940422
+Node: color_resources_942640
+Node: grayscale_resources_944064
+Node: line_resources_944813
+Node: x11_pm3d_resources946569
+Node: x11_other_resources947903
+Node: xlib948558
+Node: Concept_Index948970
+Node: Command_Index1025750
+Node: Options_Index1028965
+Node: Function_Index1041163
+Node: Terminal_Index1048102
+
+End Tag Table
+
+
+Local Variables:
+coding: utf-8
+End: