Раздел: Лицензионное соглашение, След.:Введение, Пред.:gnuplot, Вверх:gnuplot
gnuplot Лицензионное соглашение | >> Введение | Вверх ^ : gnuplot
>

Лицензионное соглашение

      Copyright (C) 1986 - 1993, 1998   Thomas Williams, Colin Kelley

Настоящее соглашение разрешает использовать, копировать и распространять эту программу и ее документацию для любых целей с оплатой или без, с условием, что приведенное выше уведомление об авторских правах будет присутствовать во всех копиях, и что данное уведомление об авторских правах и данное соглашение будет присутствовать в сопровождающей документации.

Настоящее соглашение разрешает изменять программу, но не дает права распространять полный модифицированный исходный код. Модификации должны распространяться как патчи к официальным версиям. Разрешается распространять бинарные файлы, скомпилированные из модифицированных исходников, с условием, что вы

  1. распространяете соответствующие отличия от официальной версии
     в форме патч-файла вместе с бинарными файлами релиза,
  2. добавляете специальный идентификатор к номеру версии официального релиза, 
     чтобы отделить свою версию,
  3. предоставляете ваше имя и адрес для прямых контактов для поддержки
     вашей модифицированной версии,
  4. сохраняете нашу контактную информацию в отношении использования
     базовой версии программы.

Разрешается распространять официальную версию исходного кода с соответствующими модификациями в виде патч-файла в соответствии с пунктами 2 - 4 о распространении бинарных файлов.

Это программное обеспечение предоставляется в виде "как есть" без каких-либо гарантий в пределах применимых законов.

     АВТОРЫ:

      Исходная программа:
         Thomas Williams,  Colin Kelley.

      Gnuplot 2.0 дополнения:
         Russell Lang, Dave Kotz, John Campbell.

      Gnuplot 3.0 дополнения:
         Gershon Elber и многие другие.

Введение

gnuplot - интерактивная программа для построения графиков функций и данных, управляемая командами. Синтаксис программы регистрозависимый (имена команд и функций, написанные в нижнем регистре не эквивалентны, написанным в ВЕРХНЕМ РЕГИСТРЕ). Все имена команд могут быть сокращены настолько, насколько сокращение останется однозначным. В строке может быть любое количество команд (за исключением того, что load или call должна быть последней командой), разделенных точкой с запятой (;). Строки отделяются одинарными или двойными кавычками, т.е.

      load "filename"
      cd 'dir'

хотя есть некоторые тонкие отличия (см. Синтаксис подробнее).

Любые аргументы в командной строке считаются именами файлов, содержащих команды gnuplot, исключая стандартные аргументы X11, которые обрабатываются первыми. Каждый файл загружается командой load в указанном порядке. gnuplot завершает работу после обработки последнего файла. Когда ни одного файла для загрузки не указаны, gnuplot запускается в интерактивном режиме. Специальное имя файла "-" используется для обозначения стандартного входного потока. См. Пакетный/интерактивный режим подробнее.

Многие команды gnuplot имеют многочисленные опции. Эти опции должны появляться в правильном порядке, хотя лишние опции могут быть опущены в большинстве случаев. Поэтому, если полная команда "command a b c", то "command a c" будет работать, а "command c a" - нет.

Команды могут распространяться на несколько строк, если заканчивать каждую строку, кроме последней, обратным слэшем (). Обратный слэш должен быть ПОСЛЕДНИМ символом в каждой строке. Обратный слэш в конце строки дает эффект, как-будто и обратный слэш и перевод новой строки отсутствуют. То есть не подразумевается ни вставка пробельного символа взамен, ни завершение комментария. Поэтому символ комментария в начале строки, разбитой обратными слэшами, обращает в комментарий ее всю (см. Комментарии). Однако заметьте, что если возникает ошибка где-то в многострочной команде, синтаксический анализатор gnuplot может не определить точно ее местонахождение и в этом случае не обязательно укажет на нужную из строк.

В этом документе фигурные скобки ({}) обозначают возможный аргумент, а вертикальная черта (|) отделяет взаимоисключающие варианты. Ключевые слова gnuplot или темы help выделяются обратными кавычками или `жирным шрифтом` (где возможно). Угловые скобки () используются для обозначения подставляемых лексем. Во многих случаях будет принято значение лексемы по умолчанию, если лексема пропущена, но эти случаи не всегда отмечены фигурными скобками вокруг угловых.

Для быстрого вызова справки по любой теме наберите help и следом название темы, или просто help или `?` для вызова меню справки по доступным темам.

Новоявленному пользователю gnuplot необходимо начать с чтения раздела Построение графиков (в интерактивном режиме наберите `help plotting` в командной строке). Simple Plots Demo

Обращение за помощью

Есть список рассылки для пользователей gnuplot. Однако, обратите внимание, что группа новостей

      comp.graphics.apps.gnuplot

идентична списку рассылки (и то, и другое содержит одинаковый набор сообщений). Мы предпочитаем, если вы читаете группу новостей, чем подписываетесь на рассылку. Административные запросы должны направляться на

      [email protected]

Пошлите сообщение с телом (не с темой) состоящей из одного слова "help" (без кавычек), если хотите знать об этом подробнее.

Адрес для членов списка рассылки:

      [email protected]

Сообщения об ошибках и предложения в сотрудничестве должны направляться на

      [email protected]

Список для интересующихся бета-тестеров:

      [email protected]

Есть также WWW страница с обновляющейся информацией, включая известные баги: http://www.cs.dartmouth.edu/gnuplot_info.html

Перед тем как обращаться за помощью, посмотрите FAQ (Frequently Asked Questions) list. Если у вас нет копии ЧАВО, вы можете получить ее по электронной почте с адреса Majordomo указанного выше или с ftp:

      ftp://ftp.ucc.ie/pub/gnuplot/faq,
      ftp://ftp.gnuplot.vt.edu/pub/gnuplot/faq,

or see the WWW gnuplot page.

Когда вы посылаете вопрос, пожалуйста включайте все детали о версии gnuplot, машине и операционной системе. Может быть полезен НЕБОЛЬШОЙ скрипт, демонстрирующий проблему. Графики функций предпочтительнее графиков данных. Если вы пишете в info-gnuplot, убедитесь, что вы подписаны на рассылку, чтобы те, кто использует группу новостей, могли вам написать ответ. На WWW сайте есть форма для таких запросов.

Что нового в версии 3.7

Gnuplot 3.7 содержит много новых фич (особенностей). В этом разделе приведен неполный список и ссылки на новые пункты в произвольном порядке.

1. В `fit f(x) 'file' via` используется метод Marquardt-Levenberg для интерполяции данных. (Это немного отличается от `gnufit` патча, доступного для 3.5.)

2. Значительно расширена команда using. См. using.

3. timefmt позволяет использовать даты как входные и выходные для построения временных рядов. См. `Time/Date data` и timedat.dem.

4. Многострочные надписи и выбор шрифта в некоторых графических драйверах.

5. Промежуточные деления шкалы (без меток). См. mxtics.

6. Команда key для перемещения легенды по странице (даже вне области графика), заголовок легенды, рамка вокруг легенды и др. См. key.

7. Несколько областей построения на одной логической странице - команда multiplot.

8. Улучшенный (enhanced) драйвер `postscript`: смена шрифта, верхние/нижние индексы. (Это был отдельный драйвер (`enhpost`), доступный в виде патча для 3.5).

9. Вторая пара осей: используйте верхнуюю и правую оси независимо от нижней и левой, и при построении графиков, и при определении надписей. См. plot.

10. Специальные имена файлов данных `'-'` и `""`. См. special-filenames.

11. Дополнительные системы координат для надписей и стрелок. См. `coordinates`.

12. size может попытаться построить график с заданным увеличением.

13. missing теперь обрабатывает данные корректно.

14. Команда call: load с аргументами.

15. Более гибкие команды `range` с ключевыми словами `reverse` и `writeback`.

16. encoding для многоязыковых кодировок.

17. Новый драйвер `x11` с постоянным окном или множественными окнами.

18. Новые стили графиков: xerrorbars, histeps, financebars и другие. См. style.

19. Новые форматы меток шкалы делений, включая `"%l %L"` который использует мантиссу и возводит в степень по заданному для меток основанию. См. `set format`.

20. Новые драйверы, включая `cgm` для вставки в приложения MS-Office и `gif`, нужный при подготовке графиков для WEB.

21. Опции сглаживания и интерполяции сплайнами для plot. См. smooth.

22. margin и origin позволяют лучше управлять положением графика на странице.

23. border теперь контролирует каждую сторону отдельно.

24. Новые команды if и reread позволяют организовывать циклы команд.

25. Стиль и размер точек, тип и толщина линий могут быть указаны в команде plot. Тип и толщина линий могут быть указаны также для сетки, границ, делений шкалы и стрелок. См. with. Более того, эти типы можно комбинировать и сохранять для дальнейшего использования. См. linestyle.

26. Текст (надписи, метки шкалы, временные марки) может отображаться в вертикальном направлении, если графический терминал это позволяет.

Операции в пакетном/интерактивном режимах

gnuplot может работать и в пакетном и в интерактивном режимах, а также на многих системах может работать в смешанном режиме.

Любые аргументы в командной строке полагаются именами файлов, содержащих команды gnuplot (за исключением стандартных аргументов X11, которые обрабатываются первыми). Каждый файл загружается командой load по порядку. gnuplot завершает работу после обработки последнего файла. Если файлы для обработки не указаны, то gnuplot запускается в интерактивном режиме. Специальное имя файла "-" используется для обозначения стандартного ввода (входного потока).

Обе команды exit и quit завершают обработку текущего командного файла и с помощью load загружается следующий, пока не обработаются все файлы, указанные в качестве аргументов.

Примеры:

Запустить интерактивную сессию:

      gnuplot

Запустить пакетную обработку двух файлов "input1" и "input2":

      gnuplot input1 input2

Запустить интерактивную сессию после обработки файла инициализации "header" и потом продолжить пакетную обработку файла "trailer":

      gnuplot header - trailer

Редактирование в командной строке

Редактирование в командной строке поддерживается в Unix, Atari, VMS, MS-DOS and OS/2 версиях gnuplot. Также механизм история команд позволяет редактировать и снова выполнять предыдущие команды. После редактирования командной строки перевод каретки (новая строка) вводит строку в обработку вне зависимости от того, в каком месте строки находился курсор.

(Функция readline в gnuplot работает иначе, чем readline в GNU Bash и GNU Emacs. Если вы предпочитаете использовать GNU версию поведения командной строки, то можно сделать соответствующий выбор при компиляции.

Команды редактирования:

      `Line-editing`:

      ^B    сдвиг назад на один символ.
      ^F    сдвиг вперед на один символ.
      ^A    перейти на начало строки.
      ^E    перейти к концу строки.
      ^H    и DEL удаляет предыдущий символ.
      ^D    удаляет текущий символ.
      ^K    удаляет с текущей позиции до конца строки.
      ^L,^R перерисовывает строку в случае, если она замусорилась.
      ^U    удаляет строку.
      ^W    удаляет последнее слово.

      `History`:

      ^P    шаг назад по истории команд.
      ^N    шаг вперед по истории команд.

На IBM PC для редактирования строк может использоваться резидентная программа типа DOSEDIT или CED. On the IBM PC, the use of a TSR program such as DOSEDIT or CED may be desired for line editing. По умолчанию в makefile предполагается такая возможность; причем по умолчанию gnuplot скомпилируется без этой возможности редактирования командной строки. Если вы хотите использовать возможности редактирования командной строки gnuplot'а, установите READLINE в makefile и добавьте readline.obj в файл сборки. Следующие клавиши управления курсором могут быть использованы в версиях для IBM PC и Atari, если используется readline:

      Left  Arrow      - как ^B.
      Right Arrow      - как ^F.
      Ctrl Left  Arrow - как ^A.
      Ctrl Right Arrow - как ^E.
      Up    Arrow      - как ^P.
      Down  Arrow      - как ^N.

Atari версия readline определяет некоторые дополнительные клавиатурные команды:

      Undo            - как ^L.
      Home            - как ^A.
      Ctrl Home       - как ^E.
      Esc             - как ^U.
      Help            - help + Ввод.
      Ctrl Help       - `help `.

Комментарии

Комментарии поддерживаются следующим образом: символ `#` может появляться в большинстве мест в строке, и gnuplot будет игнорировать остаток строки. Этого эффекта не будет внутри кавычек, внутри чисел (включая комплексные числа), внутри подстановок команд и т.д. Короче, оно работает везде, где есть смысл работать.

Координаты

Команды arrow, key и label позволяют рисовать нечто в произвольной позиции на графике. Эта позиция определяется таким синтаксисом:

      {} , {}  {,{} }

Каждый может быть `first`, `second`, `graph` или `screen`.

`first` указывает x, y, или z координату в системе, определенной левой и нижней координатными осями; `second` указывает координату в системе, определенной второй парой осей (верхней и правой); `graph` определяет относительные координаты в области графика: 0,0 - нижний левый, 1,1 - верхний правый угол (для splot 0,0,0 - нижний левый угол области построения; используйте отрицательные значения z, чтобы получить координату основания графика - см. ticslevel); `screen` определяет координату в области экрана (целой области, а не той, что выбрана командой size), 0,0 - нижний левый, 1,1 - верхний правый угол.

Если для координаты x система координат не определена, используется `first` по умолчанию. Если для координаты y система не определена, используется та же, что и для координаты x.

Если одна (или более) ось является временной шкалой, соответствующие координаты должны быть заданы как строка даты в кавычках, согласно форматированной строке timefmt. См. xdata и timefmt. gnuplot также воспринимает целочисленное выражение, которое интерпретируется как число секунд, прошедших с 1 января 2000 г.

Переменные среды

gnuplot понимает несколько переменных среды. Они не являются необходимыми, но могут быть полезны.

Если определена переменная GNUTERM, то ее значение используется как имя типа графического терминала, который будет использоваться для вывода. Эта переменная перекрывает все типы терминалов, воспринимаемые gnuplot при старте, но сама может быть перектрыта стартовым файлом настроек .gnuplot (или подобным ему, см. `start-up`) и, конечно, дальнейшими командами.

В Unix, AmigaOS, AtariTOS, MS-DOS и OS/2, может быть определена переменная GNUHELP, указывающая путь к HELP-файлу (gnuplot.gih).

В VMS должно быть определено логическое имя GNUPLOT$HELP в качестве имени библиотеки помощи для gnuplot. Помощь gnuplot может быть помещена внутрь любой системной библиотеки помощи, что позволяет доступ к помощи как из gnuplot так и вне его.

В Unix переменная HOME используется для поиска файла .gnuplot, если он не был найден в текущей директории. В AmigaOS, AtariTOS, MS-DOS и OS/2 используется файл gnuplot. В VMS используется SYS$LOGIN: . См. `help start-up`.

В Unix переменная PAGER используется как выходной фильтр для сообщений справки.

В Unix, AtariTOS и AmigaOS переменная SHELL используется для команды shell. В MS-DOS и OS/2 для команды shell используется переменная COMSPEC.

В MS-DOS, если используется интерфейс BGI или Watcom, переменная PCTRM применяется для указания максимального разрешения, поддерживаемого вашим монитором, путем установки значения S. Т.е. если максмальное разрешение вашего монитора 800x600, используйте:

      set PCTRM=S800

Если PCTRM не установлена, используется стандартный адаптер VGA.

FIT_SCRIPT можно использовать для указания команды, которую выполнит gnuplot, когда интерполяция прерывается - см. fit. FIT_LOG указывает имя log-файла для команды fit.

Выражения

Вообще, допустимы любые математические выражения, воспринимаемые в C, FORTRAN, Pascal или BASIC. Приоритет операций определяется спецификацией языка C. Пробельные символы (пробелы и табуляции) в выраженях игнорируются.

Комплексные константы представляются в виде {,}, где и должны быть числовыми константами. Например, {3,2} представляет 3 + 2i; {0,1} представляет само число 'i'. Фигурные скобки необходимы всегда.

Обратите внимание, что gnuplot использует и "вещественную" и "целую" арифметику, как ФОРТРАН и Си. Целые вводятся как "1", "-10" и т.д., вещественные как "1.0", "-10.0", "1e1", "3.5e-1" и т.д. Наиболее важное отличие между двумя формами состоит в делении: деление целых отбрасывает остаток: 5/2 = 2; деление вещественных - нет: 5.0/2.0 = 2.5. В смешанных выражениях целые "переводятся" в вещественные перед вычислением: 5/2e0 = 2.5. Результат деления отрицательного целого на положительное целое может зависеть от компилятора. Для проверки наберите "print -5/2", чтобы определить, какой ответ выбрала программа, -2 или -3.

Целое выражение "1/0" можно использовать для генерации сигнала "undefined", который приводит к игнорированию значения точки; в описании `тернарного` оператора есть пример.

Действительная и мнимая части комплексных выражений всегда вещественные, независимо от формы записи: в {3,2} и "3" и "2" - вещественные, а не целые.

• Функции
• Операторы
• Функции и переменные пользователя

Функции

Функции в gnuplot аналогичны соответствующим в математической библиотеке Unix, исключая то, что все они принимают целые, вещественные и комплексные аргументы, если не указано иное.

Для тех функций, которые принимают или возвращают углы, которые могут быть заданы в градусах или радианах (sin(x), cos(x), tan(x), asin(x), acos(x), atan(x), atan2(x) и arg(z)), единицы могут быть указаны командой angles, по умолчанию установлены радианы.

abs(x) возвращает абсолютное значение аргумента. Возвращаемое значение имеет тот же тип, что и аргумент. Для комплексных аргументов abs(x) определен как длина вектора x на комплексной плоскости, т.е. sqrt(real(x)**2 + imag(x)**2).

acos(x) возвращает арккосинус (обратный косинус) аргумента в радианах или градусах, как определено командой angles.

acosh(x) возвращает обратный гиперболический косинус аргумента в радианах.

arg(x) возвращает фазу комплексного числа в радианах или градусах, как определено командой angles.

asin(x) возвращает арксинус (обратный синус) аргумента в радианах или градусах, как задано командой angles.

asinh(x) возвращает обратный гиперболический синус аргумента в радианах.

atan(x) возвращает арктангенс (обратный тангенс) аргумента в радианах или градусах, как задано командой angles.

atan2(y,x) возвращает арктангенс (обратный тангенс) отношения действительных частей аргументов в радианах или градусах, как задано командой angles в правильном квадранте.

atanh(x) возвращает обратный гиперболический тангенс аргумента в радианах.

besj0(x) возвращает j0-ую функцию Бесселя от аргумента. besj0 предполагает, что аргумент в радианах.

besj1(x) возвращает j1-ую функцию Бесселя от аргумента. besj1 предполагает, что аргумент в радианах.

besy0(x) возвращает y0-ую функцию Бесселя от аргумента. besy0 предполагает, что аргумент в радианах.

besy1(x) возвращает y1-ую функцию Бесселя от аргумента. besy1 предполагает, что аргумент в радианах.

ceil(x) возвращает наименьшее целое, не превышающее аргумента. Для комплексных чисел возвращает наименьшее целое, не превышающее действительной части аргумента.

cos(x) возвращает косинус аргумента. `cos` принимает аргумент в радианах или градусах, как задано командой angles.

cosh(x) возвращает гиперболический косинус аргумента. cosh полагает, что аргумент в радианах.

erf(x) возвращает error function действительной части аргумента. Если аргумент комплексный, мнимая часть игнорируется.

erfc(x) возвращает 1.0 - error function действительной части аргумента. Если аргумент комплексный, мнимая часть игнорируется.

exp(x) возвращает экспоненциальную функцию аргумента (число `e` возводится в степень равную аргументу). В некоторых реализациях (особенно на SUN), exp(-x) неопределена для очень больших x. В этих случаях может пригодиться пользовательская функция типа safe(x) = x.

floor(x) возвращает наибольшее целое, не превышающее аргумента. Для комплексных чисел floor возвращает целое, не превышающее действительной части аргумента.

gamma(x) возвращает гамма-функцию действительной части аргумента. Для целого n gamma(n+1) = n!. Если аргумент комплексный, то мнимая часть игнорируется.

ibeta(p,q,x) возвращает неполную (incomplete) бета-функцию действительной части ее аргументов. p, q > 0 и x в интервале [0:1]. Если аргументы комплексные, то мнимая часть игнорируется.

inverf(x) - функция, обратная erf, использует только действительную часть аргумента.

igamma(a,x) возвращает неполную гамма-функцию действительной части аргументов. a > 0 и x >= 0. Если аргументы комплексные, то мнимая часть игнорируется.

imag(x) возвращает мнимую часть аргумента как вещественное число.

invnorm(x) возвращает функцию, обратную функции нормального распределения от действительной части аргумента.

int(x) возвращает целую часть аргумента, отсекая дробную часть по направлению к нулю.

lgamma(x) возвращает натуральный логарифм гамма-функции действительной части аргумента. Если аргумент комплексный, мнимая часть игнорируется.

log(x) возвращает натуральный логарифм (по основанию `e`) аргумента.

log10(x) возвращает десятичный логарифм (по основанию 10) аргумента.

norm(x) возвращает функцию нормального распределения (Гауссиан) от действительной части аргумента.

rand(x) возвращает псевдослучайное число в интервале [0:1], используя действительную часть аргумента как источник генерации чисел. Если источник

real(x) возвращает действительную часть аргумента.

sgn(x) возвращает 1, если аргумент положительный, -1 если отрицательный и 0, если аргумент равен 0. Если аргумент комплексный, мнимая часть игнорируется.

sin(x) возвращает синус аргумента. `sin` принимает аргумент в радианах или градусах, как задано командой angles.

sinh(x) возвращает гиперболический синус аргумента. sinh считает, что аргумент в радианах.

sqrt(x) возвращает квадратный корень аргумента.

tan(x) возвращает тангенс аргумента. `tan` принимает аргумент в радианах или градусах, как задано командой angles.

tanh(x) возвращает гиперболический тангенс аргумента. tanh считает, что аргумент в радианах.

Также доступны несколько дополнительных функций:

column(x) может использоваться только в выражениях, манипулирующих командой using для интерполяции или построения графиков по данным из файла. См. using.

tm_hour интерпретирует аргумент как время в секундах, прошедшее с 1 января 2000. Возвращает час (целое в промежутке 0-23) как вещественное число.

tm_mday интерпретирует аргумент как время в секундах, прошедшее с 1 января 2000. Возвращает день месяца (целое в промежутке 1-31) как вещественное число.

tm_min интерпретирует аргумент как время в секундах, прошедшее с 1 января 2000. Возвращает минуту (целое в промежутке 0-59) как вещественное число.

tm_mon интерпретирует аргумент как время в секундах, прошедшее с 1 января 2000. Возвращает месяц (целое в промежутке 1-12) как вещественное число.

tm_sec интерпретирует аргумент как время в секундах, прошедшее с 1 января 2000. Возвращает секунду (целое в промежутке 0-59) как вещественное число.

tm_wday интерпретирует аргумент как время в секундах, прошедшее с 1 января 2000. Возвращает день недели (целое в промежутке 1-7) как вещественное число.

tm_yday интерпретирует аргумент как время в секундах, прошедшее с 1 января 2000. Возвращает день года (целое в промежутке 1-366) как вещественное число.

tm_year интерпретирует аргумент как время в секундах, прошедшее с 1 января 2000. Возвращает год (целое) как вещественное число.

valid(x) может использоваться только в выражениях, манипулирующих командой using для интерполяции или построения графиков по данным из файла. См. using. Use of functions and complex variables for airfoils

Операторы

Операторы в gnuplot аналогичны соответствующим операторам языка Си, исключая то, что все они принимают целые, вещественные и комплексные аргументы, если не указано иное. Оператор ** (возведение в степень) как в ФОРТРАНе.

Можно использовать скобки для изменения порядка вычислений.

• Унарные операторы
• Бинарные операторы
• Тернарный оператор

Унарные операторы

Список унарных операторов и их использования:

    Символ      Пример     Объяснение
      -           -a          унарный минус
      +           +a          унарный плюс (не операция)
      ~           ~a        * дополнение
      !           !a        * логическое отрицание
      !           a!        * факториал
      $           $3        * вызывает аргумент/столбец при манипуляциях с using

(*) Звездочкой отмечены операторы, требующие целочисленный аргумент.

Приоритет операций такой же, как в Си и ФОРТРАНе. Как и в этих языках, скобки используются для смены порядка операций. Поэтому -2**2 = -4, а (-2)**2 = 4.

Факториал возвращает вещественное число, для увеличения диапазона применимости оператора.

Бинарные операторы

Список бинарных операторов и их использования:

    Символ       Пример       Объяснение
      **          a**b          возведение в степень
      *           a*b           умножение
      /           a/b           деление
      %           a%b         * остаток от деления
      +           a+b           сложение
      -           a-b           вычитание
      ==          a==b          равенство
      !=          a!=b          неравенство
                 a>b           больше
      >=          a>=b          больше или равно
      &           a&b         * побитовое И
      ^           a^b         * побитовое исключающее ИЛИ
      |           a|b         * побитовое включающее ИЛИ
      &&          a&&b        * логическое И
      ||          a||b        * логическое ИЛИ

(*) Звездочкой отмечены операторы, требующие целочисленный аргумент.

Логическое И (&&) и ИЛИ (||) выполняется сокращенно, как в Си. Т.е. второй операнд `&&` не вычисляется, если первый ложный; второй операнд `||` не выполняется если первый истинный.

Тернарный оператор

Тернарный оператор только один:

    Символ       Пример       Объяснение
      ?:          a?b:c     тернарный оператор

Тернарный оператор работает также, как в Си. Вычисляется первый аргумент (a), который должен быть целочисленным. Если результат истинный (ненулевой), то вычисляется второй аргумент (b) и возвращается как результат; иначе вычисляется и возвращается третий аргумент (c).

Тернарный оператор очень полезен как при конструировании кусочных функций, так и для отображения точек при выполнении некторого условия.

Примеры:

Построение графика функции, которая равна: sin(x) при 0 1/x при 1

      f(x) = 0
                    
Обратите внимание, что gnuplot тихо игнорирует неопределенные значения, т.е. последняя ветвь функции (1/0) не даст точек для построения. Также обратите внимание, что f(x) будет построена как непрерывная функция на разрыве, если использовался стиль "линия". Для построения разрыва создайте отдельные функции для двух кусков. (Для этих целей также полезны параметрические функции).
                    
Для данных из файла, построить среднее значение столбцов 2 и 3 на данных столбца 1, но только в случае, если значение в столбце 4 неотрицательно:
                    
      plot 'file' using 1:( $4
                    
См. using для объяснения синтаксиса команды using.
                    

                    

                    Раздел: Функции пользователя, Пред.:Операторы, Вверх:Выражения

                    
Функции и переменные пользователя
                    
Можно объявлять пользовательские переменные и функции одной-пяти переменных и использовать их везде, включая саму команду plot.
                    
Синтаксис пользовательской функции:
                    
      (  {,} ... {,} ) = 


                    
где выражение  зависит от переменных от  до .
                    
Синтаксис пользовательской переменной:
                    
       = 


                    
Примеры:
                    
      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 
                    
Обратите внимание, что переменная `pi` уже определена. Но в этом нет ничего особенного - вы можете ее переопределить как вам заблагорассудится.
                    
Допустимыми именами, как и в большинстве языков программирования, считаются те, которые начинаются с буквы, а следующие символы могут быть буквы, цифры, "$" или "_". Однако, помните, что процедура интерполяции fit использует переменные, начинающиеся с "FIT_". Наиболее безопасным будет избегать таких имен. Однако, "FIT_LIMIT" - переменная, которую возможно вы хотели бы переопределить. Подробнее смотрите описание fit.
                    
См. functions, variables и fit.
                    

                    

                    Раздел: Терминология, След.:Построение графиков, Пред.:Выражения, Вверх:gnuplot

                    
Терминология
                    
На протяжении данного документа была предпринята попытка сохранить логичность и постоянство терминологии. Хотя это не может полностью соблюдаться, поскольку gnuplot эволюционировал со временем, были введены некоторые команды и ключевые слова, которые препятствуют такой законченности.
                    
"Странца" ("page") или "экран" ("screen") - это вся область, которой оперирует gnuplot. На мониторе это полный экран, на плоттере это отдельный лист бумаги.
                    
Экран может содержать один или несколько "диаграмм" ("plots"). Диаграмма определяется абсциссой и ординатой, хотя фактически они могут отсутствовать на диаграмме, также как поля и любой текст на ней.
                    
Диаграмма содержит один "график" ("graph"). График определяется абсциссой и ординатой, хотя фактически они могут отсутствовать на нем.
                    
График может содержать одну или несколько "линий" ("lines") или "кривых". Кривая изображает одну функцию или один набор данных. Слово "линия" ("line") также обозначает один из стилей рисования кривой. Это слово также используется в смысле "строка текста" ("a line of text"). Предполагается, что контекст использования слова снимет любую неоднозначность.
                    
Кривые на графике могут иметь индивидуальные имена. Они могут быть перечислены вместе при отображении "ключа" ("key") графика, иногда также называемого "легендой" ("legend").
                    
Слово "название" ("title") встречается во множестве значений в gnuplot. В этом документе всегда поясняется, к чему относится название: к "диаграмме", "кривой" или "легенде", чтобы различать названия этих объектов между собой.
                    
График может иметь до четырех маркированных осей. В различных командах содержится имя оси, например xlabel. В других командах названия одной или нескольких осей указываются в опциях, например `set logscale xy`. Можно использовать следующие названия четырех возможных осей: ось "x" проходит по нижней границе диаграммы, ось "y" - по левой границе, ось "x2" - по верхней границе и ось "y2" - по правой границе. Также при построении трехмерных диаграмм появляется ось "z".
                    
При обсуждении файлов данных, возникает термин "запись" ("record"), используемый для обозначения одной строки текста в файле, т.е символы, стоящие между символами новой строки или конца записи. "Точка" ("point") это данные, извлеченные из одной записи. "Блок данных" ("datablock") это множество точек из последовательных записей, разделенных пустыми записями. В контексте файлов данных, строка (line) есть подмножество блока данных.
                    

                    

                    Раздел: Построение графиков, След.:Запуск программы, Пред.:Терминология, Вверх:gnuplot

                    
Построение графиков
                    
В gnuplot есть три команды, которые фактически создают диаграмму: plot, splot и replot. plot генерирует 2-мерные графики, splot генерирует 3-мерные графики (фактически, естественно, это 2-мерные проекции) и replot добавляет свои аргументы к предыдущей команде plot или splot выполняет эту модифицированную команду.
                    
Много общей информации о построении графиков можно найти в разделе plot; информация о 3-мерных графиках содержится в разделе splot.
                    
plot оперирует и с прямоугольными и с полярными координатами - см. подробнее о последних `set polar`. splot оперирует только с прямоугольными координатами, но команда mapping позволяет использовать несколько других систем координат. Кроме того, опция using позволяет и для plot, и для splot обрабатывать практически любую систему координат, которую вы сумеете определить таким образом.
                    
splot может строить поверхности и контурные линии вдобавок к точкам и/или линиям. В дополнение к splot смотрите isosamples для информации о задании сетки для 3-мерных функций, `splot datafile` - для информации о требуемой структуре файла для 3-мерных данных, и contour и cntrparam - для информации о контурных линиях.
                    

                    

                    Раздел: Запуск программы, След.:Подстановки, Пред.:Построение графиков, Вверх:gnuplot

                    
Запуск программы
                    
Когда gnuplot запускается, он ищет файл инициализации для загрузки. В системах Unix и AmigaOS этот файл называется `.gnuplot`, во всех остальных: `GNUPLOT.INI`. Если этот файл не найден в текущей директории, программа ищет его в домашней директории (под AmigaOS, Atari(single)TOS, MS-DOS и OS/2 переменная среды gnuplot должна содержать имя этой директории). Если определена переменная NOCWDRC при инсталляции, то gnuplot не будет искать в текущей директории.
                    
Если файл инициализации найден, gnuplot исполняет команды, записанные в нем. Это могут быть любые допустимые команды gnuplot, но обычно они ограничены установкой графического терминала и определением часто используемых функций и переменных.
                    

                    

                    Раздел: Подстановки, След.:Синтаксис, Пред.:Запуск программы, Вверх:gnuplot

                    
Подстановки
                    
Подстановки в командной строки устанавливаются системной командой, заключенной в обратные кавычки. Эта команда выполняется, и ее вывод заменяет имя команды (и обратные кавычки) в командной строке. Некоторые реализации также поддерживают каналы (pipes); см. special-filenames.
                    
Символы новой строки в выводе выполняемой команды заменяются пробелами.
                    
Подстановки в командной строке могут быть использованы в любом месте командной строки gnuplot.
                    
Пример:
                    
Следующий пример запускает программу `leastsq` и заменяет `leastsq` (вместе с кавычками) на командную строку с ее выводом:
                    
      f(x) = `leastsq`


                    
или в VMS
                    
      f(x) = `run leastsq`


                    

                    

                    Раздел: Синтаксис, След.:Данные времени/даты, Пред.:Подстановки, Вверх:gnuplot

                    
Синтаксис
                    
Основные правила синтаксиса и пунктуации в gnuplot состоят в том, что ключевые слова и опции имеют строго определенный порядок. Опции и любые сопровождающие параметры отделяются пробелами, тогда как списки и координаты разделяются запятыми. Диапазоны разделяются двоеточием и заключаются в квадратные скобки [], текст и имена файлов заключаются в кавычки, и несколько различных вещей заключаются в круглые скобки (). Фигурные скобки {} используются в нескольких специальных случаях.
                    
Запятые используются для разделения:

                    - координат в командах оператора set - arrow, key и label;

                    - списка переменных для интерполяции (список после ключевого слова `via` в команде fit);

                    - списка отдельных контуров или параметров цикла, определяющих их, в команде cntrparam;

                    - аргументов команд оператора set - dgrid3d, dummy, isosamples, offsets, origin, samples, size, `time` и view;

                    - списков меток шкалы или параметров цикла, определяющих их;

                    - сдвигов заголовка и названий осей; - параметрических функций, используемых для расчета x, y и z координат в командах plot, replot и splot;

                    - и полных наборов ключевых слов, определяющих отдельные кривые (функции или наборы данных) командах plot, replot и splot.
                    
Круглые скобки используются для отделения набора явно определенных меток шкалы (в противоположность параметрам задающего цикла) и для указания вычислений в фильтре using команд fit, plot, replot и splot.
                    
(Круглые скобки и запятые также используются как обычно в записи функций.)
                    
Квадратные скобки используются для разделения диапазонов, даются ли они командой set, plot или splot.
                    
Двоеточия используются для разделения пределов в командах `range` (в командах set, plot или splot) и для разделения частей в фильтре using команд plot, replot, splot и fit.
                    
Точка с запятой используется для разделения команд, записанных в одной строке.
                    
Фигурные скобки используются в тексте, подвергающемся специальной обработке в некоторых графических терминалах типа `postscript`. Также они используются для обозначения комплексных чисел: {3,2} = 3 + 2i.
                    
Текст может быть заключен в одинарные или двойные кавычки. Обработка символов с обратным слэшем, типа n (новая строка) и 345 (восьмеричный код симола) производится только внутри двойных кавычек, но не одинарных.
                    
Выравнивание для всех строк многострочной строки одинаково. Т.е. центрированная строка
                    
      "This is the first line of text.nThis is the second line." 


                    
будет выглядеть как
                    
                       This is the first line of text.
                          This is the second line.

                    
но
                    
      'This is the first line of text.nThis is the second line.'

                    
будет выглядеть как
                    
          This is the first line of text.nThis is the second line.


                    
Имена файлов могут заключаться как в одинарные, так и в двойные кавычки. В этом руководстве в примерах команд в основном имена файлов приводятся в одинарных кавычках, а другие строки в двойных кавычках для ясности.
                    
В настоящее время вы не должны включать n внутрь {}, когда используете расширенную опцию (enhanced) терминала postscript.
                    
Графические драйверы EEPIC, Imagen, Uniplex, LaTeX и TPIC позволяют обозначать новую строку через внутри одинарных или внутри двойных кавычек.
                    
Обратные кавычки используются при выделении системных команд для подстановки.
                    

                    

                    Раздел: Данные времени/даты, Пред.:Синтаксис, Вверх:gnuplot

                    
Данные в формате даты/времени
                    
gnuplot поддерживает использование информации о времени и/или дате в качестве входных данных. Это свойство задействуется командами `set xdata time`, `set ydata time` и т.д.
                    
Внутри программы все времена и даты преобразуются в число секунд, прошедших с 2000 года. Команда timefmt определяет формат для любого ввода: файлы данных, диапазоны, метки шкалы, позиции текстовых меток - короче говоря, все, что принимает значения данных должно получать их в этом формате. Поскольку только один входной формат может быть в силе в данное время, все данные времени/даты, вводимые одновременно, должны быть в одном и том же формате. Поэтому, если данные x и y в файле являются временем/датой, они должны быть в одном формате.
                    
Преобразования туда и обратно предполагают Универсальное Время (которое совпадает с Гринвичским Стандартным Временем). Часовые пояса, или переводы часов (daylight savings) не предусмотрены. Если все ваши данные относятся к одному часовому поясу (и все или летнее время, или стандартное) вам не нужно беспокоиться об этих вещах. Но если абсолютное время критично для вас, вы должны самостоятельно позаботиться о преобразовании в Универсальное Время.
                    
Команды типа xrange будут интерпретировать целые значения в соответствии с timefmt форматом. Если вы изменяете timefmt, а затем выводите (`show`) значение снова, оно будет отображено в новом timefmt формате. В этом случае, если вы указываете команду, деактивирующую формат даты/времени (типа xdata), значение будет отображено в числовом формате.
                    
Команда `set format` определяет формат, который будет использован для меток делений шкалы, независимо от того, является ли ось осью дат/времени.
                    
Если информация о дате/времени должна быть построена из файла, обязательно ДОЛЖНА использоваться опция using в команде plot или splot. Эти команды просто интерпретируют пробельные символы как разделители столбцов, но пробельные символы могут быть частью строки даты/времени. Если вы используете табуляцию в качестве разделителя, может понадобиться методом проб и ошибок определить, как ваша система их интерпретирует в таких случаях.
                    
Следующий пример демонстрирует построение графиков по данным даты/времени.
                    
Предполагается, что файл "data" содержит записи типа
                    
      03/21/95 10:00  6.02e23

                    
Данные из файла могут быть построены следующим образом:
                    
      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


                    
при этом метки делений оси x будут выглядеть как "03/21".
                    
Смотрите подробнее описание каждой команды.
                    

                    

                    Раздел: Команды, След.:Графические интерфейсы, Пред.:gnuplot, Вверх:Top

                    
Команды
                    
Этот раздел содержит список команд gnuplot в алфавитном порядке. Печатные версии этого документа содержат все команды; он-лайн версии могут быть неполными. В некоторых системах списка команд вообще может не быть после этого заголовка.
                    
В большинстве случаев разрешаются недвусмысленные сокращения названий команд и их опций, например "`p f(x) w l`" вместо "`plot f(x) with lines`".
                    
В описании синтаксиса фигурные скобки ({}) необязательные аргументы, а вертикальная черта (|) разделяет взаимоисключающие аргументы.
                    

cd

Команда cd изменяет текущую директорию.

Синтаксис:

      cd ''

Имя директории должно быть заключено в кавычки.

Примеры:

      cd 'subdir'
      cd ".."

Пользователи DOS ДОЛЖНЫ использовать одинарные кавычки, т.к. обратный слэш [] имеет специальное значение внутри двойных кавычек. Например,

      cd "c:newdata"

выдает ошибку, но

      cd 'c:newdata'

работает как ожидалось.

call

Команда call идентична команде load с одним исключением: вы можете указывать до десяти дополнительных параметров в команде (отделяемые стандартными правилами парсеров - пробельными символами), которые могут быть подставлены в строки, читаемые из файла. Поскольку каждая строка, читается из входного файла, вызванного командой call, она сканируется для удовлетворения последовательности из `$` (доллара) и следующей за ним цифры (0-9). Если последовательность найдена, она заменяется соответствующим параметром командной строки команды call. Если параметр был указан как строка в командной строке call, он подставляется без окружающих его кавычек. Последовательность из `$` и любого последующего символа кроме цифры преобразуется в этот символ. Например, ипользование `$$` даст одиночный `$`. Указание более десяти параметров в строке команды call вызовет ошибку. Не указанный параметр не подставляется. Файлы, вызванные командой call, сами могут содержать команды call.

Команда call ДОЛЖНА быть последней в строке, содержащей несколько команд.

Синтаксис:

      call ""   ... 

Имя входного файла должно быть заключено в кавычки, также рекомендуется параметры заключать в кавычки (будущие версии программы могут обрабатывать аргументы в кавычках и без по-разному).

Пример:

В файле 'calltest.gp' содержится строка:

      print "p0=$0 p1=$1 p2=$2 p3=$3 p4=$4 p5=$5 p6=$6 p7=x$7x"

следующая команда:

      call 'calltest.gp' "abcd" 1.2 + "'quoted'"  "$2"

выдаст на экран:

      p0=abcd p1=1.2 p2=+ p3='quoted' p4=- p5=- p6=$2 p7=xx

ЗАМЕЧАНИЕ: есть конфликт в синтаксисе с оператором using для вызова данных из файла. Используйте `$$n` или `column(n)` для доступа к n-ому столбцу в файле данных в аргументах команды call.

clear

Команда clear очищает текущий экран или выходное устройство, указанное командой output. Это обычно вызывает подачу листа (formfeed), если это печатающее устройство. Используйте команду terminal для установки типа выходного устройства.

Для некоторых терминалов clear очищает только часть области для построения, определенную командой size, это можно использовать совместно с командой multiplot для создания вставок.

Пример:

      set multiplot
      plot sin(x)
      set origin 0.5,0.5
      set size 0.4,0.4
      clear
      plot cos(x)
      set nomultiplot

Смотрите подробнее команды multiplot, size и origin.

exit

Команды exit и quit, а также символ конца файла приводят к выходу из текущего командного файла gnuplot и загрузке (load) следующего. См. "Пакетный/интерактивный режим" подробнее.

Каждая из этих команд очищает выходное устройство (как это делает команда clear) перед выходом.

fit

Команда 'fit' может подгонять параметры определенной пользователем функции к двумерным (x, y) или трехмерным (x, y, z) данным, используя нелинейный метод наименьших квадартов (НМНК или NLLS) Маркарта-Левенберга (Marquardt-Levenberg). Любая определенная пользователем переменная, встречающаяся в теле функции, может служить подгоночным параметром, но функция должна возвращать значение действительного типа.

Синтаксис:

      fit {[xrange] {[yrange]}}  ''
          {datafile-modifiers}
          via '' | {,,...}

Временно могут быть определены диапазоны данных, чтобы ограничить промежуток данных, по которому подгоняется функция; любые точки не из диапазона игнорируются. Синтаксис:

      [{dummy_variable=}{}{:}],

аналогично plot; см. ranges.

- любое допустимое для gnuplot выражение, хотя обычно используется ранее определенная пользователем функция в виде f(x) или f(x,y).

интерпретируется также, как и в команде plot. Все модификаторы, допустимые для команды `plot datafile` (using, every,...) кроме smooth, также приментимы к fit. См. `plot datafile`.

Для подгонки функций одной независимой переменной y=f(x) по умолчанию заданы форматы данных {x:}y или x:y:s; эти форматы можно изменить, используя спецификатор using. Третий элемент (номер столбца или выражение), если присутствует, интерпретируется как среднеквадратичное отклонение от соответствующего значения y, и используется для вычисленя веса данной величины: 1/s². В противном случае все точки имеют одинаковый вес равный единице.

Для подгонки к данным функции двух независимых переменных z=f(x,y) необходимый формат using состоит из четырех частей: x:y:z:s. Должен быть задан полный формат - никаких колонок по умолчанию вместо пропущенных частей не подразумевается. Веса для каждой точки данных вычисляются из 's' как и в предыдущем случае. Если оценки среднеквадратичной ошибки неизвестны, можно указать константу (см. using), например `using 1:2:3:(1)`.

Множественные наборы данных могут быть одновременно аппроксимированы функциями одной независимой переменной, если y сделать 'псевдо-переменной', например номер линии данных и подгоночный параметр в качестве двух независимых переменных. См. `fit multibranch`.

Спецификатор `via` указывает варьируемые параметры, непосредственно, или ссылаясь на файл параметров.

Примеры:

      f(x) = a*x**2 + b*x + c
      g(x,y) = a*x**2 + b*y**2 + c*x*y
      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 via a, b, c
      fit g(x,y) 'surface.dat' using 1:2:3:(1) via a, b, c

После каждого итерационного шага на экран выводится детальная информация о текущем состоянии подгонки функции. Та же информация о начальном и конечном состоянии записывается в лог-файл "fit.log". Информация всегда дописывается в конец файла, чтобы не потерять историю предыдущих аппроксимаций; он может быть удален или переименован по вашему усмотрению.

Интерполяция может быть прервана комбинацией клавиш Ctrl-C (для MS-DOS и Atari Multitasking Systems - любая клавиша кроме Ctrl-C). После завершения текущей итерации у вас есть выбор: (1) остановить процедуру интерполяции, на текущих значениях параметров, (2) продолжить интерполяцию, (3) выполнить команду gnuplot, определенную переменной среды FIT_SCRIPT. Переменная FIT_SCRIPT по умолчанию равна replot, т.е. если у вас уже был построен график с данными и интерполирующей функцией, вы можете отобразить текущее состояние интерполяции.

После завершения работы команды fit можно командой update сохранить конечные значения для дальнейшего использования в качестве файла параметров.

• подгоночные параметры
• руководство для начинающего
• оценки ошибок
• управление процедурой подгонки
• подгонка многозначных функций
• начальные значения
• советы

подгоночные параметры

Подгоночные параметры могут быть указаны после слова `via` двумя способами: напрямую в строке команды, или косвенно ссылкой на файл параметров. The two use different means to set initial values.

Подгоночные параметры могут быть указаны через запятую в виде списка после ключевого слова `via`. Если переменная не была определена до этого, то она создается с начальным значением равным 1.0. Однако, больше вероятности, что процедура интерполяции будет сходиться быстрее, если переменные были заранее объявлены с более подходящими значениями.

При использовании файла параметров, в нем указывается каждый варьируемый параметр и соответствующее начальное значение, каждый в отдельной строке, в виде

      varname = value

Допускаются комментарии, начинающиеся с '#' и пустые строки. Специальная запись

      varname = value       # FIXED

обозначает, что переменная трактуется как 'фиксированный параметр', инициализируемый в файле параметров, но не изменяемый процедурой fit. Для ясности может быть полезным определить переменную как фиксированный параметр, чтобы ее значение выводилось в лог-файл командой fit. Ключевое слово `# FIXED` должно появляться исключительно в указанной форме.

Руководство для начинающего

fit используется, чтобы найти набор параметров, с которым заданная вами функция "наилучшим" образом изображает ход ваших данных. О степени соответствия судится на основе суммы квадратов разностей, или "остатков" (СКО, или SSR) между входными данными и соответствующими значениями функции. Эта величина носит название "хи-квадрат" (т.е. греческая буква "хи" в квадрате: ??). Алгоритм пытается минимизировать СКО, точнее, ВСКО (WSSR), т.к. остатки "взвешены" погрешностями входных данных (или 1.0) перед возведением в квадрат; см. подробнее fit error_estimates

Поэтому алгоритм называется "подгонкой по методу наименьших квадратов". Рассмотрим на примере, что означает "нелинейный", но для начала повторим некоторые термины. Здесь удобно использовать в качестве зависимой переменную z, как для пользовательских функций одной независимой переменной, z=f(x), так и двух, z=f(x,y). Параметр - это определенная пользователем переменная, которую fit будет подгонять, т.е. неизвестная величина в определении функции. Линейность/нелинейность относится к соотношению зависимой переменной z и параметров, которые подгоняет fit, а не к соотношению z и независимых переменных x и/или y. (Говоря точнее, вторые [и более высокие] производные подгоняемой функции по подгоночным параметрам равны нулю для линейного метода наименьших квадратов.)

Для линейного метода наименьших квадратов пользовательская функция должна быть суммой простых функций, не включающих подгоночные параметры, каждая из которых умножена на один из параметров НМНК обрабатывает более сложные функции, в которых параметры могут быть использованы многими способами. Рассмотрим пример, иллюстрирующий разницу между линейным и нелинейным МНК - ряд Фурье. Первый член ряда можно записать как

     z=a*sin(c*x) + b*cos(c*x).

Если a и b - неизвестные параметры, а c - константа, то определение значений параметров является линейной задачей наименьших квадратов. Однако, если c - тоже неизвестный параметр, то задача нелинейна.

В линейном случае значения параметров определяются с помощью сравнительно простой линейной алгебры, за один шаг. Однако МНК только один из специальных случаев среди нелинейных МНК задач, решаемых итерационной процедурой gnuplot. Процедура fit подгоняет функцию к данным, пытаясь найти минимум отличий. На каждом шаге (итерации) вычисляется ВСКО с новым набором значений параметров. Значения параметров для следующей итерации выбираются по алгоритму Маркарта-Левенберга. Процесс продолжается до тех пор, пока не достигается один из заданных критериев: (1) подгонка "сошлась" - разность между ВСКО на последнем и предыдущем шаге стала меньше FIT_LIMIT, или (2) достигнуто максимально допустимое число итераций FIT_MAXITER (см. variables). Подгонка также может быть прервана нажатием соответствующих клавиш (см. fit).

Часто в какой-либо теории или модели требуется подогнать теоретическую функцию к поведению экспериментальных данных. Поэтому процедуру fit можно использовать для нахождения значений свободных параметров модели, чтобы определить, насколько хорошо модель соответствует данным, и оценить диапазон ошибок для каждого параметра. См. fit error_estimates.

С другой стороны, на практике бывает, что функции выбираются независимо от модели (на основе опыта, как описывающие данные с необходимым приближением и минимальным числом параметров*функций). В этом случае с помощью процедуры fit получается аналитическое представление данных.

Однако, если все, что вам нужно - это провести гладкую кривую между точками данных, опция smooth команды plot, подойдет вам больше, чем fit.

оценки ошибок

В описании команды fit, термин "ошибка" используется в двух различных контекстах: как величины погрешностей данных и как величины погрешностей подгоночных параметров.

Ошибки данных используются для расчета относительных весов всех точек данных при вычислении взвешенной суммы квадратов остатков, WSSR или хи-квадрат. Они могут влиять на ошибки параметров, т.к. они определяют, насколько сильно влияет отклонение каждой точки данных от пробной функции на окончательные значения. Чем точнее указаны ошибки данных, тем более значима будет выходная информация команды fit, включая ошибки подгоночных параметров.

В Основных сведениях по статистике описаны некоторые данные, выдаваемые командой fit и предпосылки для практического руководства.

• Основные сведения по статистике
• Практическое руководство

Основные сведения по статистике

Теория нелинейного метода наименьших квадратов (НМНК) в целом описана в терминах нормального распределения ошибок, т.е. предполагается, что входные данные являются выборкой из некоторой совокупности, имеющей гауссово (нормальное) распределение и среднее значение, близкое к полученному среднему значению в пределах заданного стандартного отклонения. Для выборки большого размера и известного стандартного отклонения совокупности можно использовать статистику с распределением хи-квадрат для описания "качества подгонки", с помощью переменной, часто так и называемой "хи-квадрат". Здесь необходимо сказать, что приведенный хи-квадрат ( хи-квадрат / число_степеней_свободы, где число степеней свободы - это число точек данных минус число подгоняемых параметров) равный 1.0 означает, что взвешенная сумма квадратов отклонений между подгоняемой функцией и точками данных равна такой же сумме для случайной выборки из совокупности, характеризуемой этой функцией с текущими значениями параметров и заданным стандартным отклонением.

Если стандартное отклонение совокупности не постоянно, как в счетной статистике, где дисперсия равна числу подсчетов, каждая точка должна быть взвешена индивидуально при сравнении наблюдаемой суммы отклонений с ожидаемой суммой.

В заключение fit выдает величину 'stdfit', стандартного отклонения подгонки, которое есть корень из среднего квадрата (RMS) остатков, и величину дисперсии остатков, также называемую "приведенный хи-квадрат" в случае, если точки данных взвешены. В этих оценках используется число степеней свободы (число точек данных минус число подгоняемых параметров), поскольку параметры, используемые для вычисления остатков для точек данных были получены из тех же самых данных.

Чтобы оценить степень доверия полученным параметрам, можно использовать минимальное хи-квадрат, полученное при подгонке и статистику хи-квадрат, чтобы определить значение хи-квадрат, соответствующее желаемой степени доверия, но значительно больше вычислений необходимо для определения комбинаций параметров, из которых получились такие значения.

Скорее, чем определять доверительные интервалы, fit сообщает примерные ошибки параметров, которые без труда находятся из матрицы дисперсий и ковариаций после последней итерации. По обычаю эти величины называются "стандартными ошибками" или "асимптотическими стандартными ошибками", поскольку они вычисляются точно так же, как и стандартные ошибки (стандартное отклонение каждого параметра) линейного метода наименьших квадратов, даже если статистически эти величины в общем случае некорректны для НМНК задачи. Асимптотические стандартные ошибки в общем сверх-оптимистичны и не должны использоваться для определения уровня согласия подгонки, они полезны только для качественных оценок.

На последнем шаге решения также создается корреляционная матрица, которая отображает корреляции между параметрами в области решения: если один параметр изменять, увеличивая тем самым хи-квадрат, изменится ли другой, чтобы это скомпенсировать? Все элементы главной диагонали, автокорреляции, равны 1; если все параметры были независимы, то все другие элементы матрицы будут близки к 0. Две переменные, которые полностью компенсируют изменения друг друга будут иметь недиагональный элемент, модуль которого равен 1, а знак зависит от того, является ли отношение пропорциональным или обратно пропорциональным. Чем меньше модули недиагональных элементов, тем ближе оценка стандартного отклонения каждого параметра будет к асимптотической стандартной ошибке.

Практическое руководство

Если у вас есть основания приписать каждой точке данных свой вес, т.е. некоторые точки более достоверны, чем другие, вы можете использовать эту дополнительную информацию о ваших измерениях, которая может повлиять на итоговые значения подгоночных параметров.

Взвешенные точки данных предоставляют возможность интерпретировать дополнительную информацию в выводе команды fit после заключительной итерации. Даже если вы взвешиваете каждую точку одинаково, использование оценки стандартного отклонения вместо единичного веса делает WSSR безразмерной переменной, как хи-квадрат, по определению. ( ??? 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.)

Каждая итерация подгонки отображает информацию, которая численно выражает ход подгонки. (Символ '*' означает, что меньшая ВСКО не найдена и fit пытается еще раз.) "Сумма квадратов остатков", также называемая "хи-квадрат" - это ВСКО (WSSR) между данными и подгоночной функцией; fit ее минимизирует. На этой стадии предполагается, что хи-квадрат, вместе со взвешенными данными, дает оценку числа степеней свободы (number of degrees of freedom, ndf = число точек данных минус число параметров). WSSR используется для вычисления приведенного хи-квадрат (WSSR/ndf) или stdfit, стандартного отклонения аппроксимации, равного sqrt(WSSR/ndf). Обе эти величины приводятся для окончательного WSSR.

Если данные не взвешены, то stdfit равен корню из среднего квадрата (RMS) отклонений данных от подгоняемой функции, в единицах, в которых измеряются пользовательские данные.

Если указаны адекватные ошибки данных, число точек данных достаточно велико, и модельная функция корректна, то приведенный хи-квадрат должен быть близок к единице. (Подробнее смотрите в вашей любимой книге по статистике "распределение хи-квадрат".) Если это так, то существуют дополнительные тесты на соответствие данных и модели, которые не рассматриваются в этом обзоре.

Приведенный хи-квадрат может быть гораздо больше, чем 1.0 из-за некорректных оценок ошибок данных, распределения ошибок данных, отличного от нормального, систематических ошибок измерения, "выбросов" в данных или некорректной модельной функции. График остатков, т.е. plot 'datafile' using 1:($2-f($1)) может помочь обнаружить систематические отклонения. Построение на одном графике точек данных и модельной функции может помочь выбрать другую модель.

Аналогично, приведенный хи-квадрат меньше 1.0 означает, что взвешенная сумма WSSR меньше, чем сумма для случайной выборки с нормальным распределением ошибок вблизи модельной функции. Оценки ошибок данных могут быть слишком большими, статистические предположения могут не выполняться, или модельная функция может быть слишком обобщенной, по отношению к неустойчивостям при подгонке к данной выборке в дополнение к основым тенденциям. В последнем случае более простая функция может оказаться более подходящей.

Для того чтобы определять соотношение между стандартными ошибками и некоторыми более удобными оценками неопределенностей параметров, или оценивать значимость корреляционной матрицы, вам необходимо освоить и процедуру fit и тот тип задач, в которых вы ее применяете.

Обратите внимание, что процедура fit, и вообще большинство реализаций нелинейного МНК, минимизирует взвешенную сумму квадратов разностей (y-f(x))**2. Она не дает никаких средних значений для оценки "ошибок" значений x, только значений y. Также любые "выбросы" (точки данных, лежащие вне нормального распределения около модельной функции) будут оказывать огромное влияние на результат подгонки.

Управление процедурой подгонки

Есть несколько переменных в gnuplot, значения которых можно задавать, чтобы влиять на процедуру fit. Те, которые могут быть заданы только когда gnuplot запущен, перечислены как "управляющие переменные", а те, которые могут быть заданы перед запуском gnuplot, перечислены в разделе "переменные среды"

• управляющие переменные
• переменные среды

управляющие переменные

Значение эпсилон по умолчанию (1e-5) может быть изменено при помощи переменной

      FIT_LIMIT

Когда разность сумм квадратов остатков в двух последовательных итерациях меньше, чем значение эпсилон, подгонка считается завершенной.

Максимальное число итераций может быть ограничено при помощи переменной

      FIT_MAXITER

Значение 0 (или вообще отсутствие ее определения) означает, что предела нет.

Если вам нужен больший контроль над алгоритмом, и вы хорошо знаете алгоритм Маркарта-Левенберга, то для этого есть еще несколько переменных. Стартовое значение `лямбда` рассчитывается автоматически из МЛ-матрицы, но если вы хотите, можете задать ее значение при помощи

      FIT_START_LAMBDA

Определение FIT_START_LAMBDA меньше, либо равным нулю означает, что `лямбда` опять будет определяться автоматически. Переменная

      FIT_LAMBDA_FACTOR

дает множитель, на который увеличивается или уменьшается `лямбда`, если целевая функция хи-квадрат значительно увеличилась или уменьшилась. Установка FIT_LAMBDA_FACTOR равным нулю возвращает множитель к значению по умолчанию 10.0.

Также другие переменные с префиксом FIT_ могут использоваться процедурой fit, поэтому лучше не использовать этот префикс в названиях пользовательских переменных.

Переменные FIT_SKIP и FIT_INDEX использовались в ранних версиях gnuplot в патче к 'fit', называемом `gnufit`, теперь они недоступны. Функциональность FIT_SKIP обеспечивает модификатор файла данных every. FIT_INDEX использовался для подгонки многозначных функций, имеющих несколько ветвей. Но теперь подгонка многозначной функции одной переменной теперь производится как псевдо-трехмерная подгонка, в которой вторая независимая переменная и модификатор using используются для указания ветви функции. См. multi-branch.

переменные среды

Переменные среды должны быть определены до запуска gnuplot, как это сделать - зависит от вашей операционной системы.

      FIT_LOG

изменяет имя (и/или путь) log-файла команды fit, куда она пишет свой вывод, по умолчанию "fit.log" в текущей директории.

      FIT_SCRIPT

определяет команду, которая может быть выполнена в случае, если пользователь прервал продгонку. По умолчанию это replot, но plot или load также могут быть полезны для вывода графика, отображающего ход подгонки.

Подгонка многозначных функций

Множественные наборы данных могут быть одновременно аппроксимированы функциями одной независимой переменной, имеющими общие параметры, путем минимизации полной WSSR. Функция и параметры (ветвь функции) для каждого набора данных выбираются с помощью "псевдо-переменных", т.е. или с помощью номера строки данных (индекс "столбца" равный -1) или с помощью индекса файла данных (-2) в качестве второй независимой переменной.

Пример: Даны две экспоненциально убывающие зависимости в форме z=f(x), каждая из которых описывает различный набор данных, но обе имеют общее время убывания, для которых надо подобрать значения парамеров. Если данные в файле представлены в виде x:z:s, то

     f(x,y) = (y==0) ? a*exp(-x/tau) : b*exp(-x/tau)
     fit f(x,y) 'datafile' using  1:-1:2:3  via a, b, tau

См. более сложный пример в файле "hexa.fnc", используемом в демонстрационном файле "fit.dem".

Может потребоваться соответствующий выбор весов, поскольку величины весов могут вызывать преобладание одной из ветвей, если есть достаточное различие в масштабе изменения зависимой переменной. Подгонка каждой ветви по отдельности, с использованием решения для нескольких ветвей в качестве начальных значений, может показать относительный эффект каждой ветви в совместном решении для нескольких ветвей.

Начальные значения

Нелинейная аппроксимация не гарантирует сходимости к глобальному минимуми (решению с наименьшей суммой квадратов остатков, SSR), и может сходиться к локальному минимуму. Сама процедура подгонки не может определить так ли это - об этом судить только вам.

Процедура fit может не сойтись, если была начата слишком далеко от конечного решения, где SSR велика и меняется медленно, как и варьируемые параметры, или может попасть в численно нестабильную область (где слишком большое значение может вызвать переполнение операций с плавающей точкой) и завершиться выводом сообщения "undefined value" (значение не определено) или выходом из gnuplot.

Чтобы увеличить шансы найти глобальный минимум, вы должны установить начальные значения параметров, хотя бы грубо, в окрестности решения, т.е. хотя бы по порядку величины, если это возможно. Чем ближе ваши начальные значения к конечному решению, тем меньше шансов попасть в локальный минимум. Один из путей поиска начальных значений параметров заключается в построении на одном графике данных и подгоняемой функции, и затем изменять значения параметров и перерисовывать с помощью replot график, пока не будет достигнуто разумное сходство. Такой график также полезен, чтобы определить, не остановилась ли процедура подгонки в локальном минимуме с плохим соответствием функции и данных.

Конечно, достаточно хорошее приближение само по себе еще не говорит, что нет "лучшего" приближения (которое отличается или лучшим критерием степени приближения в статистическом смысле, или лучшим соответствием модели в физическом смысле). В зависимости от задачи, желательно подгонять функцию с различными наборами начальных значений, покрывающих приемлемый диапазон значений для каждого параметра.

Советы

Здесь приводятся некоторые советы, направленные на то, чтобы получить наилучший результат с помощью команды fit. Они не слишком упорядочены, поэтому лучше прочитать их несколько раз, чтобы запомнить их суть.

Две формы аргумента `via` команды fit служат двум очень различным целям. Форму `via "file"` лучше использовать (по возможности автоматически) для пакетных операций, где вы только указываете стартовые значения в файле и позднее можете использовать update, чтобы скопировать результаты обратно в другой (или в тот же) файл параметров.

Форму `via var1, var2, ...` лучше использовать в интерактивном режиме, когда можно использовать механизм истории команд, чтобы изменить список подгоняемых параметров или указать новые начальные значения для следующей попытки. Это чрезвычайно полезно в сложных задачах, где прямая подгонка всех параметров одновременно не работает без оптимальных стартовых значений. Что бы это сделать вы можете повторить подгонку несколько раз, подбирая только некоторые из параметров, пока значения не будут достаточно близки к тем значениям, при которых удачно пройдет итоговая подгонка с учетом всех параметров.

Убедитесь, что между параметрами подгоночной функции нет взаимных зависимостей. Например, не пытайтесь искать функцию a*exp(x+b), потому что a*exp(x+b)=a*exp(b)*exp(x). Вместо этого используйте для подгонки a*exp(x) или exp(x+b).

Технический момент: параметры не должны сильно отличаться по абсолютной величине. Чем больше отношение модулей наибольшего и наименьшего параметров, тем медленнее будет сходиться подгонка. Если отношение близко или выше величины, обратной машинной точности чисел с плавающей точкой, процедура будет сходиться почти бесконечно, или откажется сходиться вообще. Вы должны адаптировать вашу функцию к этому требованию, т.е. заменить 'parameter' на '1e9*parameter' в определении функции и, соответственно, разделить начальное значение на 1e9.

Если вы можете записать вашу функцию как линейную комбинацию простых функций, умноженных на коэффициенты, которые надо подобрать - во что бы то ни стало сделайте это. Это сильно поможет вам, поскольку задача перестает быть нелинейной и должна сойтись за исключительно малое количество итераций, возможно даже за одну.

Некоторые рекомендации по анализу данных, даваемые в практических экспериментальных курсах, требуют, чтобы вы сначала подогнали некоторую функцию к вашим данным, возможно в несколько шагов, учитывая отдельные аспекты лежащей в основе теории, а затем извлекли из подгоночных параметров функции информацию, которая вам действительно нужна. С помощью команды fit зачастую это можно сделать за один шаг, записав модельную функцию непосредственно в терминах требуемых параметров. Нередко получается, что можно также избежать видоизменения данных, хотя иногда ценой более сложной интерполяционной задачи. Если вы думаете, что это противоречит предыдущему параграфу об упрощении подгоночной функции, то вы правы.

Сообщение "singular matrix" (сингулярная матрица) говорит о том, что данная реализация алгоритма Маркарта-Левенберга не может вычислить значения параметров для следующей итерации. Попробуйте другие начальные значения параметров, запишите функцию в другой форме, или упростите ее.

В заключение приведем удачную цитату из руководства к другому пакету для интерполяции (fudgit), которая подводит итог всем этим вопросам: "Нелинейная интерполяция - это искусство!"

help

Команда help command отображает справку в режиме он-лайн. Для получения информации по отдельной теме, используйте синтаксис:

      help {}

Если тема не указана, печатается краткая информация о программе (Unix) или запускается оглавление справки (Windows). Для ОС семейства Unix:
После вывода помощи по запрошенной теме, выводится меню подразделов темы; помощь по подразделу может быть получена, если набрать его название, тем самым расширяя запрос справки. После отображения подраздела справки, запрос может быть расширен снова, или вы можете вернуться вверх на один уровень к предыдущей теме. В конечном счете вы вернетесь к исходной командной строке gnuplot.

Если в качестве темы указан знак вопроса (?), то на экран выводится список доступных в данный момент тем.

if

Команда if позволяет условное выполнение команд.

Синтаксис:

      if () 

Сначала будет определено условие . Если оно истинное (ненулевое), то будет выполнена командная строка из одной или нескольких команд; если условие ложно (нуль), то команда(ы) игнорируе(ю)тся. Обратите внимание, что использование символа точки с запятой `;` для разделения команд в одной строке НЕ ОБРЫВАЕТ условный оператор.

Примеры:

      pi=3
      if (pi!=acos(-1)) print "?Fixing pi!"; pi=acos(-1); print pi

выдаст на экран:

      ?Fixing pi!
      3.14159265358979

но

      if (1==2) print "Never see this"; print "Or this either"

не выдаст на экран ничего.

См. reread для примера того, как if и reread могут быть использованы вместе для организации цикла.

load

Команда load выполняет каждую строку заданного входного файла так, как если бы она была введена в интерактивном режиме. Файл, созданный командой save может быть загружен позже с помощью load. Можно создать любой текстовый файл, содержащий допустимые команды, и затем выполнить его командой load. Загружаемые при помощи load файлы сами могут содержать команды load или call. См. `Комментарии` для информации о комментариях в командах. Чтобы загрузить файл с аргументами, используйте команду call.

Команда load должна быть ПОСЛЕДНЕЙ в строке из нескольких команд.

Синтаксис:

      load ""

Имя входного файла должно быть заключено в кавычки.

Специальное имя файла "-" может быть использовано для загрузки команд из стандартного входного потока. Это позволяет командному файлу gnuplot принимать какие-либо команды со стандартного ввода. См. подробнее "help batch/interactive".

Примеры:

      load 'work.gnu'
      load "func.dat"

Команда load неявно применяется к любому имени файла, указанному в качестве аргумента к gnuplot. Эти файлы загружаются по порядку и затем gnuplot завершает свою работу.

pause

Команда pause отображает текст, указанный в команде и затем ждет указанное количество времени или пока не будет нажата клавиша перевода каретки. Команда pause особенно полезна в сочетании с командой load загрузки файлов.

Синтаксис:

      pause  {""}

может быть любой целой константой или выражением. При значении -1 программа ждет до тех пор, пока не будет нажат перевод каретки, нуль (0) не создаст паузы вообще, положительное целое означает число секунд ожидания.`pause 0` является синонимом print.

Обратите внимание: Поскольку команда pause взаимодействует с операционной системой теснее, чем устройство графического вывода, она может вести себя различно с различными графическими драйверами устройств (зависит от соотношения графики и текста).

Примеры:

      pause -1    # Ждать нажатия перевода строки
      pause 3     # Ждать три секунды
      pause -1  "Hit return to continue"
      pause 10  "Isn't this pretty?  It's a cubic spline."

plot

Синтаксис:

      plot {}
           { | {"" {datafile-modifiers}}}
           {axes } {} {with 

содержит или функцию , или имя файла данных "" в кавычках. Функция - это математическое выражение или пара математических выражений в параметрическом режиме. Выражение может быть определено (целиком или частично) ранее в потоке команд gnuplotа (см. `user-defined`).

Также можно определять функции и параметры в самой команде plot. Это делается просто отделением их от других пунктов запятыми.

Доступны четыре набора осей; для выбора осей по которым некоторая конкретная кривая должна быть масштабирована используется ключевое слово . `x1y1` соответствует нижней и левой координатным осям; `x2y2` - верхней и правой; `x1y2` - нижней и правой; `x2y1` - верхней и левой. Пределы, указанные в самой команде plot действуют только на первый набор осей (нижнюю и левую).

Примеры:

      plot sin(x)
      plot f(x) = sin(x*a), a = .2, f(x), a = .4, f(x)
      plot [t=1:10] [-pi:pi*2] tan(t), 
           "data.1" using (tan($2)):($3/$4) smooth csplines 
                    axes x1y2 notitle with lines 5

• data-file
• errorbars
• parametric
• ranges
• title
• with

data-file

Дискретные данные, содержащиеся в файле, отображаются путем указания имени файла данных (в одинарных или двойных кавычках) в команде plot.

Синтаксис:

      plot '' {index }
                            {every }
                            {thru }
                            {using }
                            {smooth }

Модификаторы index, every, thru, using, и smooth рассматриваются раздельно. Коротко, index выбирает, какие наборы данных из файла с множественным набором данных должны быть построены, every указывает, какие точки из набора данных должны быть построены, using определяет как интерпретируются столбцы данных в одной записи (thru - специальный вариант команды using), и smooth предоставляет возможность простой интерполяции и аппроксимации ('splot' имеет сходный синтаксис, но не поддерживает опции smooth и thru).

Файлы данных должны содержать хотя бы одну точку данных на строку (using может выбирать одну точку данных из записи(строки)). Записи, начинающиеся с `#` (а также с `!` на VMS) считаются комментариями и игнорируются. Каждая точка данных представляет (x,y) пару. Для графиков с интервалами ошибок (см. errorbars), каждая точка данных должна содержать: (x,y,ydelta), (x,y,ylow,yhigh), (x,y,xdelta), (x,y,xlow,xhigh), или (x,y,xlow,xhigh,ylow,yhigh). В любом случае, числа в каждой записи должны разделяться пробельными символами (один или несколько пробелов или табуляций), если не указан формат в опции using. Эти пробельные символы делят каждую запись на столбцы.

Данные могут быть записаны в формате с плавающей точкой с одним из символов перед показателем степени: e, E, d, D, q или Q.

Обязательно должен присутствовать только один столбец (значения y). Если значения x опущены, вместо них gnuplot подставляет целые числа начиная с 0.

В файлах данных пустые записи (записи не содержащие символов, кроме пробелов и перевода строки) играют существенную роль - пары пустых записей разделяют индексы (см. index). Данные, разделенные двумя пустыми записями, интерперетируются так, если бы они находились в отдельных файлах.

Одиночные пустые записи указывают разрывы в графике; точки, построенные стилем line, не будут соединены, если они разделены пустыми записями.

Если автомасштабирование разрешено (autoscale), пределы осей автоматически расширяются до включения всех точек данных, с полным числом меток шкалы, если метки отображаются. Из этого следует два вывода: 1) Для splot угол поверхности может не совпадать с углом основания. В этом случае вертикальная линия не рисуется. 2) При построении данных в одинаковых диапазонах x-переменных на двухосевых графиках, x-координаты могут не совпадать, если метки второй оси x - x2tics - не рисуются. Это происходит из-за того, что пределы оси x автоматически расширяются до полного числа меток шкалы, а пределы оси x2 - нет. Следующий пример иллюстрирует проблему:

      reset; plot '-', '-'
      1 1
      19 19
      e
      1 1
      19 19
      e

• every
• пример файла данных
• index
• smooth
• специальные имена файлов
• thru
• using

every

Ключевое слово every позволяет строить график по периодической выборке данных.

Далее в описании "точка" означает данные из единственной записи в файле, "блок" означает то же самое, что "блок данных" (см. `Терминология`).

Синтаксис:

      plot 'file' every {}
                          {:{}
                            {:{}
                              {:{}
                                {:{}
                                  {:}}}}}

Точки данных для отображения выбираются начиная от до с шагом , а блоки строятся начиная от до с шагом .

Нумерация записей данных в каждом блоке начинается с '0', как и нумерация блоков в файле.

Обратите внимание, что записи, содержащие неотображаемую информацию, также считаются.

Любое из чисел может быть опущено; по умолчанию оба инкремента и равны единице, стартовые значения и равны первой точке или блоку, конечные значения равны последней точке или блоку. Если ключевое слово every не задано, строятся все точки во всех линиях.

Примеры:

      every :::3::3    # выбирает только четвертый блок ('0' - первый)
      every :::::9     # выбирает первые 10 блоков
      every 2:2        # выбирает каждую вторую точку в каждом втором блоке
      every ::5::15    # выбирает точки с 5 по 15 в каждом блоке.

пример файла данных

В этом примере строятся данные из файла "population.dat" и теоретическая кривая:

      pop(x) = 103*exp((1965-x)/10)
      plot [1960:1990] 'population.dat', pop(x)

Файл "population.dat" может содержать:

      # Gnu population in Antarctica since 1965
         1965   103
         1970   55
         1975   34
         1980   24
         1985   10

index

Ключевое слово index позволяет строить только некоторые из наборов данных в файле, содержащем несколько наборов данных.

Синтаксис:

      plot 'file' index {{:}:
}

Наборы данных разделяются двумя пустыми строками. `index ` выбирает только набор ; `index :` выбирает наборы в диапазоне от до ; `index ::

` выбирает наборы данных , +

, +2

и т.д. и останавливается на . Следуя индексации языка Си, индекс 0 соответствует первому набору данных в файле. Слишком большой индекс приведет к выдаче сообщения об ошибке. Если index не определен, все наборы строятся как один набор данных.

Пример:

      plot 'file' index 4:5

smooth

gnuplot содержит несколько универсальных алгоритмов интерполяции и аппроксимации данных, которые сгруппированы опцией smooth. Более изощренную обработку данных можно проводить во внешней программе, либо с помощью подходящей функции для fit.

Синтаксис:

      smooth {unique | csplines | acsplines | bezier | sbezier}

`unique` строит данные после сортировки точек данных по возрастанию абсциссы x. Все остальные алгоритмы используют данные для определения коэффициентов непрерывной кривой между граничными точками данных. Затем эта кривая строится таким же образом, как и функция, т.е. нахождением ее значений через одинаковые интервалы вдоль абсциссы (см. samples) и соединением этих точек отрезками прямых линий (если выбран стиль "линия").

Если действует autoscale, диапазоны графика будут автоматически выбраны так, чтобы построенная кривая лежала внутри границ графика.

Если точек слишком мало для указанного алгоритма, выдается сообщение об ошибке. Минимальное число точек: одна для `unique`, четыре для `acsplines` и три для остальных.

Опция smooth не действует на графики функций.

ACSPLINES

Опция `acsplines` аппроксимирует данные "натуральным сглаживающим сплайном". После упорядочения данных по x (см. `smooth unique`), строится кривая из сегментов кубических полиномов, коэффициенты которых находятся из взвешенных значений точек данных. По умолчанию веса берутся из третьей колонки файла данных, но это можно менять с помощью третьей позиции списка using, т.е.

      plot 'data-file' using 1:2:(1.0) smooth acsplines

На качественном уровне - абсолютная величина весов определяет число сегментов, используемых для построения кривой. Если веса велики, эффект от каждой точки данных велик и кривая приближается к такой кривой, которая соединяет последовательные точки натуральными кубическими сплайнами. Если веса малы, кривая строится из меньшего числа сегментов и поэтому она более гладкая. Предельный случай есть один сегмент, полученный взвешенным линейным методом наименьших квадратов. Вес сглаживания может быть выражен в терминах ошибок как статистический вес для точки, деленный на "фактор сглаживания" кривой, т.е. (стандартные среднеквадратичные) ошибки в файле данных можно использовать как веса сглаживания.

Пример:

      sw(x,S)=1/(x*x*S)
      plot 'data_file' using 1:2:(sw($3,100)) smooth acsplines

BEZIER

Опция `bezier` аппроксимирует данные кривой Безье степени n (n - число точек данных), которая соединяет граничные точки.

CSPLINES

Опция `csplines` соединяет последовательные точки натуральными кубическими сплайнами после упорядочения данных вдоль оси x (см. `smooth unique`).

SBEZIER

Опция `sbezier` сначала упорядочивает данные вдоль оси x (`unique`) и затем применяет алгоритм `bezier`.

UNIQUE

Опция `unique` упорядочивает точки данных вдоль оси x, точки с одинаковым значением x заменяет одной точкой с усредненным значением y. Затем полученные точки соединяются отрезками прямых линий. See demos.

специальные имена файлов: '?' и ''

Специальное имя файла `'-'` означает, что данные содержатся внутри командного файла, т.е. следуют за командой. За строкой команды могут следовать только данные; такие опции plot, как фильтры, названия и стили линий остаются в строке команды 'plot'. Это похоже на работу операции

Специальное имя файла `'-'` предназначено для ситуаций, когда нужно, чтобы данные и команды находились в одном месте, например, когда gnuplot работает как дочерний процесс некоторого интерфейсного приложения. Представление данных и команд в одном файле используется в некоторых примерах, распространяемых с gnuplot. Использование в данной ситуации таких опций plot, как index и every заставляет вас вводить данные, которые не будут использованы. Пример:

      plot '-' index 0, '-' index 1
      2
      4
      6

      
      10
      12
      14
      e
      2
      4
      6

      
      10
      12
      14
      e

      plot '-', '-'
      2
      4
      6
      e
      10
      12
      14
      e

Если вы используете `'-'` с replot, вам может понадобиться ввести данные более одного раза.

Пустое имя файла ('') означает, что должно быть использовано предыдущее имя файла. Это может быть полезно в случае очень длинного имени файла:

      plot 'a/very/long/filename' using 1:2, '' using 1:3, '' using 1:4

(Если вы используете и `'-'`, и `"` в одной команде plot, вам необходимо иметь два набора данных внутри файла, как в приведенном выше примере.)

Каналы (pipes). В некоторых операционных системах (Unix), где есть функция popen, файл данных может быть сформирован через канал с помощью команд интерпретатора, с указанием первого символа имени файла '

      pop(x) = 103*exp(-x/10)
      plot "
                    
создадут график с той же информацией, что и первый пример про популяцию, но начиная с 1965 года по оси x. Если вы хотите выполнить этот пример, вы должны удалить все комментарии из файла данных этого примера, или заменить часть последней команды (до запятой) на следующее:
                    
      plot "
                    
Поскольку этот подход наиболее гибок, в нем возможно использовать простую фильтрацию данных с помощью ключевых слов using или thru.
                    

                    

                    Раздел: thru, След.:using, Пред.:special-filenames, Вверх:data-file

                    
thru
                    
Функция thru поддерживается для совместимости с предыдущими версиями.
                    
Синтаксис:
                    
      plot 'file' thru f(x)

                    
Эквивалентно:
                    
      plot 'file' using 1:(f($2))


                    
Вторая запись гораздо более гибкая, чем первая. Более естественная запись
                    
      plot 'file' thru f(y)

                    
также работает (вы можете использовать y как независимую переменную). Ключевое слово thru также распознается gnuplot-ом в командах splot и fit но не производит никакого эффекта.
                    

                    

                    Раздел: using, Пред.:thru, Вверх:data-file

                    
using
                    
Ключ using является наиболее общим модификатором для файлов данных.
                    
Синтаксис:
                    
      plot 'file' using { {: {: ...}}} {'format'}


                    
Если указан формат, каждая запись файла данных читается с использованием библиотечной функции Си 'scanf' с указанной строкой формата. В противном случае каждая прочитанная запись разделяется на столбцы, разделители - пробелы или знаки табуляции. Формат не может быть указан, если установлено использование данных в формате времени (при помощи `set data time`).
                    
Итоговый массив данных далее сортируется по столбцам в соответствии с каждым элементом  ключевого слова. Каждый  может быть просто номером столбца, выражением в круглых скобках, или вообще пустым. В выражении нужно использовать $1 для указания данных из первого столбца, $2 - второго столбца, и т.д. Также можно использовать `column(n)` и `valid(n)`, где n - произвольное выражение, результатом которого является целое число. `column(n)` возвращает данные из n-ого столбца, `valid(n)` проверяет, являются ли данные из n-ого столбца числовыми. Номер столбца 0 генерирует число увеличивающееся (от нуля) с каждой точкой данных, и обнуляет счетчик, встретив подряд две пустые строки без данных. Номер столбца -1 выдает номер строки данных (начиная с нуля), который увеличивается после каждой пустой строки, и обнуляется после двух подряд пустых строк. Номер столбца -2 выдает индекс, который увеличивается на единицу только после найденых подряд двух пустых строк. Пустой элемент , расположенный i-тым по счету в списке ключевого слова 'using' соответствует i-му столбцу данных. Например,`using ::4` интерпретируется как `using 1:2:4`.
                    
Обратите внимание, что команда call также использует знак $ как специальный символ. Подробнее о том, как вставить номер столбца в ее список аргументов, можно узнать в описании команды call.
                    
Если в списке ключа using указан только один элемент, то этот элемент  будет использован в качестве значений y, а порядковые номера точек данных будут использованы в качестве значений x; например, "`plot 'file' using 1`" аналогично "`plot 'file' using 0:1`". Если список using содержит два элемента, они будут использованы в качестве значений x и y. Дополнительные элементы списка обычно интерпретируются как погрешности y и/или x. См. style о стилях построения графиков с использованием информации о погрешностях, и fit об использовании погрешностей для интерполяции данных.
                    
В языке Си 'scanf' принимает несколько спецификаций числовых данных, но gnuplot требует, чтобы все входные данные были числами с плавающей точкой, двойной точности, т.е. `lf` - это только разрешенный спецификатор. Функция 'scanf' при обработке данных ожидает между числами пробельные символы: пробелы, табуляцию ("t"), перевод строки ("n") или перевод страницы?? [formfeed] ("f"); все другие разделители должны быть явно опущены во входном потоке.
                    
Обратите внимание, что использование "t", "n" или "f" требует использования двойных кавычек, а не одинарных.
                    
Примеры:
                    
В этом примере по данным 1-го столбца строится график суммы 2-го и 3-го столбцов (строка формата определяет, что столбцы разделены запятыми, а не пробельными символами):
                    
      plot 'file' using 1:($2+$3) '%lf,%lf,%lf'

                    
В этом примере данные читаются из файла "MyData" с использованием более сложного формата:
                    
      plot 'MyData' using "%*lf%lf%*20[^n]%lf"


                    
Обозначения:
                    
      %*lf        пропустить число
      %lf         прочитать вещественное число двойной точности (x по умолчанию)
      %*20[^n]   пропустить 20 символов новой строки
      %lf         прочитать вещественное число двойной точности (y по умолчанию)

                    
Еще один прием состоит в использовании тернарного оператора `?:` для фильтрации данных:
                    
      plot 'file' using 1:($3>10 ? $2 : 1/0)

                    
здесь вдоль значений из первого столбца строятся значения из второго столбца, в случае, если значение в третьем столбце больше десяти. Деление на ноль `1/0` неопределено; gnuplot просто игнорирует неопределенные точки, поэтому неподходящие точки данных просто не будут построены.
                    
Фактически, вы можете использовать константное выражение для числа в колонке, если оно не начинается с открывающей круглой скобки; можно использовать выражения типа `using 0+(сложное выражение)`. Основная особенность состоит в том, что выражение вычисляется один раз, если оно не начинается с открывающей круглой скобки, в обратном случае выражение вычисляется каждый раз при чтении очередной точки данных.
                    
Данные, представляющие дату/время могут занимать несколько столбцов. Должен быть указан первый из этих столбцов. Обратите внимание, что пробелы в записи времени/даты должны учитываться при вычислении номеров следующих столбцов. Например, если первый элемент строки - это время, в котором есть разделитель - пробел, то значения y должны быть указаны в `using` как третья колонка.
                    
Необходимо заметить, между выражениями `plot 'file'`, `plot 'file' using 1:2` и `plot 'file' using ($1):($2)` могут быть тонкие различия: 1) если 'file' содержит строки, в которых либо одна колонка, либо две, то в первом случае значения x выдумываются, если они пропущены, во втором случае строки с одной колонкой будут просто проигнорированы, и в третьтем случае строки с одной колонкой будут считаться неопределенными значениями (если график нарисован линией, то в этих точках будут разрывы); 2) если строка содержит не число, а текст в первой колонке, в первом случае построение графика прервется сообщением об ошибке, во втором и третьем случае строки текстовые строки будут пропущены, как и в случае 1).
                    
Фактически, часто можно построить график из файла, содержащего многострочный текст и данные, просто записав
                    
      plot 'file' using 1:2


                    
Однако, если вы хотите включать текст в ваши файлы данных, безопаснее будет указвать символ комментария (#) в начале каждой текстовой строки. Feeble using demos.
                    

                    

                    Раздел: errorbars, След.:parametric, Пред.:data-file, Вверх:plot

                    
errorbars
                    
Величины погрешностей (error bars) в двухмерных графиках данных считываются из дополнительных столбцов, от одного до четырех (или с помощью using); эти дополнительные значения используются по-разному в различных стилях отображения погрешностей.
                    
По умолчанию gnuplot ожидает три, четыре или шесть чисел в каждой строке файла данных:
                    
      (x, y, ydelta),
      (x, y, ylow, yhigh),
      (x, y, xdelta),
      (x, y, xlow, xhigh),
      (x, y, xdelta, ydelta), or
      (x, y, xlow, xhigh, ylow, yhigh).

                    
Координата x должна быть указана обязательно. Порядок величин должен в точности соответствовать одному из указанных выше, либо указан явно с помощью using. Например:
                    
      plot 'file' with errorbars
      plot 'file' using 1:2:(sqrt($1)) with xerrorbars
      plot 'file' using 1:2:($1-$3):($1+$3):4:5 with xyerrorbars

                    
В последнем примере файл данных содержит комбинацию величин, не поддерживаемую по умолчанию: (x, y, xdelta, ylow, yhigh). Ключ using создает необходимые значения xlow и xhigh.
                    
Величина погрешности y изображается как вертикальный отрезок от (x, ylow) до (x, yhigh). Если вместо ylow и yhigh указано значение ydelta, то эти значения вычисляются как ylow = y - ydelta и yhigh = y + ydelta. Если в строке только два числа (x и y), то оба значения ylow и yhigh приравниваются к y. Величина погрешности x изображается как горизонтальный отрезок аналогичным образом, как и для y. Чтобы соединить линией точки данных на графике, постройте данные из файла дважды, один раз с погрешностями (with errorbars), второй раз сплошной линией (with lines), указав ключ `notitle`, чтобы в легенде не появилась вторая подпись к этим же данным.
                    
На концах отрезков погрешностей рисуются поперечные штрихи, если не указано иное установкой команды bar.
                    
Если включено автомасштабирование, то пределы построения графика по осям подгоняются так, чтобы входили величины погрешностей. Errorbar demos.
                    
See using, with, and style for more information.
                    

                    

                    Раздел: parametric, След.:ranges, Пред.:errorbars, Вверх:plot

                    
parametric
                    
В параметрическом режиме (`set parametric`) математические выражения должны даваться парой для plot и тройкой для splot.
                    
Примеры:
                    
      plot sin(t),t**2
      splot cos(u)*cos(v),cos(u)*sin(v),sin(u)

                    
Данные из файлов строятся также, как и раньше, за ислючением того, что параметрическая функция должна быть полностью определена, перед тем, как будет указано построение данных из файла. Другими словами, обе части параметрической функции, для x (`sin(t)` в примере) и y (`t**2` в примере) должны следовать непосредственно одна за другой, без всяких модификаторов и функций от данных; в противном случае возникнет сообщение о синтаксической ошибке: параметрическая функция определена не полностью.
                    
Другие модификаторы типа with и `title` могут быть указаны только после того, как параметрическая функция полностью определена:
                    
      plot sin(t),t**2 title 'Parametric example' with linespoints


Parametric Mode Demos.
                    

                    

                    Раздел: ranges, След.:title, Пред.:parametric, Вверх:plot

                    
ranges
                    
Диапазоны значений (ranges) являются необязательными и определяют область графика, которая будет отображена.
                    
Синтаксис:
                    
      [{=}{{}:{}}]
      [{{}:{}}]



                    
В первой форме указание диапазона значений применимо к независимой переменной (xrange или trange в параметрическом режиме). Вторая форма записи применяется к зависимой переменной yrange (в параметрическом режиме - и xrange тоже).  задает новое имя независимой переменной (имена по умолчанию могут быть изменены командой dummy). Необязательные элементы  и  могут быть либо константным выражением, либо символом *.
                    
В непараметрическом режиме диапазоны должны указываться в следующем порядке: xrange, а затем yrange.
                    
В параметрическом режиме следующий порядок: trange, xrange, затем yrange. В следующем примере команды plot диапазон trange установлен равным [-pi:pi], диапазон xrange - [-1.3:1.3] и диапазон yrange - [-1:1] на протяжении всего графика:
                    
      plot [-pi:pi] [-1.3:1.3] [-1:1] sin(t),t**2

                    
Обратите внимание, что здесь нельзя устанавливать диапазоны значений для второй пары осей - правой и верхней, для этого нужно использовать команды x2range и y2range.
                    
Диапазоны интерпретируются в указанном выше порядке для соответствующих режимов. Если какой-либо из диапазонов явно задавать не нужно, вместо него ставится пустой диапазон `[]` в качестве "заглушки". Once all those needed are specified, no further ones must be listed, but unneeded ones cannot be skippeduse an empty range `[]` as a placeholder.
                    
Символ `*` можно использовать, чтобы разрешить автомасштабирование минимальной или максимальной границ диапазона. См. также autoscale.
                    
Диапазоны, определенные в команде plot или splot, действуют только на график, отображаемый этой командой. Чтобы изменить диапазоны по умолчанию для серии графиков, используйте xrange, yrange и т.д.
                    
Для данных времени/даты нужно указывать крайние значения диапазонов в кавычках (представление даты/времени должно совпадать с таковым в файле данных). gnuplot использует строку timefmt для чтения значений даты/времени.
                    
Примеры:
                    
Используются текущие диапазоны осей:
                    
      plot cos(x)

                    
Устанавливается только диапазон оси x:
                    
      plot [-10:30] sin(pi*x)/(pi*x)

                    
То же самое, но в независимая переменная переобозначена как t:
                    
      plot [t = -10 :30]  sin(pi*t)/(pi*t)

                    
Устанавливаются диапазоны и для x, и для y:
                    
      plot [-pi:pi] [-3:3]  tan(x), 1/x

                    
Устанавливается только диапазон y и отключается автомасштабирование по обеим осям:
                    
      plot [ ] [-2:sin(5)*-8] sin(x)**besj0(x)

                    
Устанавливаются только значения xmax и ymin:
                    
      plot [:200] [-pi:]  exp(sin(x))

                    
Устанавливается диапазон x для данных в виде даты/времени:
                    
      set timefmt "%d/%m/%y %H:%M"
      plot ["1/6/93 12:00":"5/6/93 12:00"] 'timedata.dat'


See Demo.
                    

                    

                    Раздел: title, След.:with, Пред.:ranges, Вверх:plot

                    
title
                    
Каждый элемент легенды рисунка состоит из названия функции или файла данных и образца ее/его графика (отрезка линии и/или символа). Название элемента может быть изменено с помощью опции `title`.
                    
Синтаксис:
                    
      title "
                    
где  - это новое название графика, которое должно быть заключено в кавычки. Кавычки в легенде не отображаются. Специальные символы могут отображаться с помощью обратного слэша и следующего за ним восьмеричного кода символа "345"). Символ табуляции "t" также доступен. Обратите внимание, что обработка спецсимволов, начинающихся с обратного слэша, производится только в строках, заключенных в двойные кавычки - используйте одинарные кавычки, чтобы отказаться от такой обработки. Символ новой строки "n" в элементах легенды игнорируется.
                    
И название графика, и его образец могут быть опущены в легенде, если указан ключ `notitle` при его построении. Пустое название (`title ""`)является эквивалентом `notitle`. Если требуется отобразить в легенде только образец графика, используйте в качестве названия один или несколько пробелов (`title ' '`).
                    
По умолчанию названием графика является имя функции или имя файла в том виде, в каком оно появляется в команде plot. Если это имя файла, то все использованные модификаторы включаются по умолчанию в название графика этого файла.
                    
Параметры самой легенды (расположение, выравнивание названий и т.д.) можно изменить с помощью команды key.
                    
Примеры:
                    
Построение графика y=x с названием 'x':
                    
      plot x

                    
Построение квадрата от x с названием "x^2" и файла "data.1" с названием "measured data":
                    
      plot x**2 title "x^2", 'data.1' t "measured data"


                    
Построение круговой границы без названия вокруг графика в полярных координатах:
                    
      set polar; plot my_function(t), 1 notitle

                    

                    

                    Раздел: with, Пред.:title, Вверх:plot

                    
with
                    
Для отображения функций и данных в gnuplot существует большое множество стилей. Ключевое слово with предоставляет возможность их выбора.
                    
Синтаксис:
                    
      with 
                    
где  - это `lines`, `points`, linespoints, impulses, dots, steps, fsteps, histeps, errorbars, xerrorbars, yerrorbars, xyerrorbars, boxes, boxerrorbars, boxxyerrorbars, financebars, candlesticks или vector. Некоторые из этих стилей требуют дополнительной информации. См. подробнее `set style `.
                    
Стили, используемые по умолчанию, выбираются с помощью команд style.
                    
По умолчанию для построения каждой функции и каждого файла на одном рисунке используются различные типы линий и маркеров, вплоть до максимального числа доступных типов. Все драйверы терминалов поддерживают не менее шести различных типов маркеров, и используют их повторно, если графиков на рисунке больше. Драйвер LaTeX поддерживает еще шесть дополнительных типов маркеров (все варианты кружков), т.е. стиль маркеров будет повторяться, если на графике больше 12 кривых, изображенных маркерами. Драйвер PostScript (`postscript`) поддерживает всего 64 типа маркеров.
                    
Если вы хотите выбрать тип линии или маркера для отдельной кривой, вы можете указать тип линии  и тип маркера . Тип линии или маркера - это положительная целая константа (или выражение). Для отображения доступных в текущем терминале типов используйте команду test.
                    
Также вы можете масштабировать толщину линии и размер маркера с помощью  и , которые указывают размер отностительно размера по умолчанию для данного терминала. Размер маркеров может быть изменен глобально - подробнее см. pointsize. Но обратите внимание, что размер маркера, установленный по умолчанию, и размер маркера, установленный для данной кривой не умножаются. Т.е. в результате команд `set pointsize 2; plot x w p ps 3` прямая будет изображена маркерами не шести-, а трехкратного размера.
                    
Если вы определили свой стиль линии с помощью linestyle, задав тип/толщину линии и тип/размер маркера, то этот стиль может быть выбран установкой , равным индексу вашего стиля.
                    
Ключевые слова могут быть сокращены, как указано в примерах.
                    
Обратите внимание, что опции `linewidth` и pointsize поддерживаются не всеми терминалами.
                    
Примеры:
                    
Построение графика sin(x) в виде импульсов:
                    
      plot sin(x) with impulses


                    
Построение графика x маркерами, x**2 по умолчанию:
                    
      plot x*y w points, x**2 + y**2


                    
Построение tan(x) стилем по умолчанию, данных из файла "data.1" линией:
                    
      plot [ ] [-2:5] tan(x), 'data.1' with l


                    
Построение данных из "leastsq.dat" импульсами:
                    
      plot 'leastsq.dat' w i


                    
Построение данных из файла "population" прямоугольниками:
                    
      plot 'population' with boxes


                    
Построение "exper.dat" сплошной линией с метками погрешностей (для погрешностей нужны три или четыре колонки):
                    
      plot 'exper.dat' w lines, 'exper.dat' notitle w errorbars


                    
Построение sin(x) и cos(x) линией с маркерами, линии одного типа, а маркеры - разного:
                    
      plot sin(x) with linesp lt 1 pt 3, cos(x) with linesp lt 1 pt 4

                    
Построение данных из файла "data" маркерами 3-го типа и двойного размера:
                    
      plot 'data' with points pointtype 3 pointsize 2

                    
Построение двух наборов данных линиями, которые отличаются только толщиной:
                    
      plot 'd1' t "good" w l lt 2 lw 3, 'd2' t "bad" w l lt 2 lw 1

                    
См. style о том как изменить стили по умолчанию. Styles demos.
                    

                    

                    Раздел: print, След.:pwd, Пред.:plot, Вверх:Команды

                    
print
                    
Команда print выводит значение выражения  на экран. Она является синонимом `pause 0`. Выражение  может быть любым, которое может обработать gnuplot и выдать число, или оно может быть строкой.
                    
Синтаксис:
                    
      print  {, , ...}



                    
См. `Выражения`.
                    

                    

                    Раздел: pwd, След.:quit, Пред.:print, Вверх:Команды

                    
pwd
                    
Команда pwd выводит на экран имя рабочей директории.
                    

                    

                    Раздел: quit, След.:replot, Пред.:pwd, Вверх:Команды

                    
quit
                    
Команды exit и quit и символ конца файла приводят к завершению работы gnuplot. Каждая из этих команд очищает выходное утройство перед завершением работы (как это делает команда clear).
                    

                    

                    Раздел: replot, След.:reread, Пред.:quit, Вверх:Команды

                    
replot
                    
Команда replot без аргументов повторяет последнюю команду plot или splot. Это может быть полезным для построения графика с различными опциями set, или при генерации одного и того же графика для нескольких графических устройств.
                    
Аргументы, указанные после команды replot будут добавлены к последней команде plot или splot (подразумевается разделитель запятая ',') перед тем как она будет повторена. replot принимает те же аргументы, что и plot или splot за исключением диапазонов. Таким образом, вы можете использовать replot чтобы построить функию по второй паре осей, если предыдущая команда была plot, но не splot. Аналогично, вы можете использовать replot, чтобы добавить график данных из бинарного файла только если предыдущая команда построения была splot.
                    
Обратите внимание: использование
                    
      plot '-' ; ... ; replot 
                    
не рекомендуется. gnuplot не сохраняет данные, введенные из командной строки, т.е. поскольку replot добавляет новую информацию к предыдущей команде plot и затем выполняет измененную команду, специальное имя файла `'-'` из начальной командной строки plot снова запросит чтение входных данных со стандартного ввода.
                    
Обратите внимание, что replot не работает в режиме multiplot, поскольку она обновляет только последний график, а не всю рабочую область экрана.
                    
См. также `Редактирование в командной строке` о способах редактирования последней команды plot (splot).
                    

                    

                    Раздел: reread, След.:reset, Пред.:replot, Вверх:Команды

                    
reread
                    
Команда reread возвращает gnuplot в начальную позицию командного файла, загруженного командой load или указанного в командной строке gnuplot при запуске. Это происходит раньше, чем последующие команды будут прочитаны. По существу это приводит к образованию бесконечного цикла команд от начала файла до команды reread. (Но это не беда - reread может быть полезен при использовании в сочетании с командой if. См. подробнее об if). Команда reread не действует, если ввод происходит со стандартного устройства ввода, то бишь с клавиатуры.
                    
Примеры:
                    
Предполагается, что файл "looper" содержит команды:
                    
      a=a+1
      plot sin(x*a)
      pause -1
      if(a
                    
и в gnuplot вы вводите команды:
                    
      a=0
      load 'looper'

                    
В результате последовательно будут выведены четыре графика (разделенные сообщением, которое выдает pause).
                    
Предполагается, что файл "data" содержит шесть колонок чисел с общим диапазоном от 0 до 10; первая колонка - это x, а остальные пять колонок - это пять различных функций от x. Также предполагается, что файл "plotter" содержит команды:
                    
      c_p = c_p+1
      plot "$0" using 1:c_p with lines linetype c_p
      if(c_p 
                    
и в gnuplot вы вводите команды:
                    
      n_p=6
      c_p=1
      set nokey
      set yrange [0:10]
      set multiplot
      call 'plotter' 'data'
      set nomultiplot

                    
В результате получится рисунок, содержащий пять графиков. Диапазон yrange должен быть указан явно для гарантии, что пять отдельных графиков (которые рисуются поверх друг друга в режиме multiplot) будут иметь одинаковые оси. Должен быть указан тип линии, иначе все графики будут нарисованы линией одного и того же типа. Reread Animation Demo
                    

                    

                    Раздел: reset, След.:save, Пред.:reread, Вверх:Команды

                    
reset
                    
Команда reset сбрасывает все опции, которые могут быть установлены командой set, к их значениям по умолчанию. Единственные исключения составляют установка графического терминала `set term` и выходного файла `set output`, которые остаются неизменными. Эта команда полезна, например, для восстановления установок по умолчанию в конце командного файла, или для возвращения к известному состоянию после многочисленных установок, измененных в командном файле. Смотрите описание команды set для информации о значениях по умолчанию для различных опций.
                    

                    

                    Раздел: save, След.:set-show, Пред.:reset, Вверх:Команды

                    
save
                    
Команда save сохраняет пользовательские функции, переменные, опции, установленные при помощи set, или все сразу плюс последнюю команду plot (splot) в заданный файл.
                    
Синтаксис:
                    
      save  {} ''



                    
где  это functions, variables или set. Если опций нет, gnuplot сохраняет функции, переменные set-опции и последнюю команду plot (splot). Сохраняемый файл записывается в текстовом формате и может быть прочитан командой load.
                    
Имя файла должно заключаться в кавычки.
                    
Примеры:
                    
      save 'work.gnu'
      save functions 'func.dat'
      save var 'var.dat'
      save set 'options.dat'


                    

                    

                    Раздел: set-show, След.:shell, Пред.:save, Вверх:Команды

                    
set-show
                    
Команда set используется для установки _множества_ настроек. При установках никакой графической области не отображается, пока не дана команда plot, splot, или replot.
                    
Команда `show` показывает указанные настройки, `show all` показывает все настройки.
                    
Если переменная содержит данные о дате/времени, то `show` отобразит их в соответствии с текущим форматом, определенным командой timefmt, даже если он не был установлен, когда первоначально определялась переменная.
                    

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 3-d mapping as set via the 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 angles. 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}

arrow

Arbitrary arrows can be placed on a plot using the arrow command.

Syntax:

      set arrow {} {from } {to } {{no}head}
                { {linestyle | ls }
                  | {linetype | lt }
                    {linewidth | lw }
      show arrow

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 the arrow command with the appropriate tag and specify the parts of the arrow to be changed.

The s are specified by either x,y or x,y,z, and may be preceded by `first`, `second`, `graph`, or `screen` to select the coordinate system. Unspecified coordinates default to 0. The endpoints can be specified in one of four coordinate systems`first` or `second` axes, `graph` or `screen`. See `coordinates` for details. A coordinate system specifier does not carry over from the "from" position to the "to" position. Arrows outside the screen boundaries are permitted but may cause device errors.

Specifying `nohead` produces an arrow drawn without a heada line segment. This gives you yet another way to draw a line segment on the plot. By default, arrows have heads.

The line style may be selected from a user-defined list of line styles (see linestyle) or may be defined here by providing values for (an index from the default list of styles) and/or (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 arrow command with the appropriate index and `lt` or `lw`.

Examples:

To set an arrow pointing from the origin to (1,2) with user-defined style 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 delete arrow number 2, use:

      set noarrow 2

To delete all arrows, use:

      set noarrow

To show all arrows (in tag order), use:

      show arrow

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.

Syntax:

      set autoscale {{min|max}}
      set noautoscale {{min|max}}
      show autoscale

where is either `x`, `y`, `z`, `x2`, `y2` or `xy`. A keyword with `min` or `max` appended (this cannot be done with `xy`) tells gnuplot to autoscale just the minimum or maximum of that axis. If no keyword is given, all axes are autoscaled.

When autoscaling, the axis range is automatically computed and the dependent axis (y for a plot and z for splot) is scaled to include the range of the function or data being plotted.

If autoscaling of the dependent axis (y or z) is not set, the current y or z range is used.

Autoscaling the independent variables (x for plot and x,y for splot) is a request to set the domain to match any data file being plotted. If there are no data files, autoscaling an independent variable has no effect. In other words, in the absence of a data file, functions alone do not affect the x range (or the y range if plotting z = f(x,y)).

Please see xrange for additional information about ranges.

The behavior of autoscaling remains consistent in parametric mode, (see `set 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 plots and u,v for splots. 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.

Autoscaling works the same way for polar mode as it does for parametric mode for plot, with the extension that in polar mode dummy can be used to change the independent variable from t (see dummy).

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_ xrange and yrange are autoextended to a whole number of tics, which can cause unexpected results.

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 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:

      set noautoscale

This disables autoscaling of the z axis only:

      set noautoscale z

• parametric_mode
• polar_mode

parametric mode

When in parametric mode (`set parametric`), the xrange is as fully scalable as the y range. In other words, in parametric mode the x axis can be automatically scaled to fit the range of the parametric function that is being plotted. Of course, the y axis can also be automatically scaled just as in the non-parametric case. If autoscaling on the x axis is not set, the current x range is used.

Data files are plotted the same in parametric and non-parametric mode. However, there is a difference in mixed function and data plots: in non-parametric mode with autoscaled x, the x range of the datafile controls the x range of the functions; in parametric mode it has no influence.

For completeness a last command `set autoscale t` is accepted. However, the effect of this "scaling" is very minor. When gnuplot determines that the t range would be empty, it makes a small adjustment if autoscaling is true. Otherwise, gnuplot gives an error. Such behavior may, in fact, not be very useful and the command `set autoscale t` is certainly questionable.

splot extends the above ideas as you would expect. If autoscaling is set, then x, y, and z ranges are computed and each axis scaled to fit the resulting data.

polar mode

When in polar mode (`set polar`), the xrange and the yrange are both found from the polar coordinates, and thus they can both be automatically scaled. In other words, in polar mode both the x and y axes can be automatically scaled to fit the ranges of the polar function that is being plotted.

When plotting functions in polar mode, the rrange may be autoscaled. When plotting data files in polar mode, the trange may also be autoscaled. Note that if the trange is contained within one quadrant, autoscaling will produce a polar plot of only that single quadrant.

Explicitly setting one or two ranges but not others may lead to unexpected results. See polar demos

bar

The bar command controls the tics at the ends of errorbars.

Syntax:

      set bar {small | large | }
      show bar

`small` is a synonym for 0.0, and `large` for 1.0. The default is 1.0 if no size is given.

bmargin

The command bmargin sets the size of the bottom margin. Please see margin for details.

border

The border and `set noborder` commands control the display of the graph borders for the plot and splot commands.

Syntax:

      set border { { {linestyle | ls }
                              | {linetype | lt  }
                                {linewidth | lw } } }
      set noborder
      show border

The borders are encoded in a 12-bit integer: the bottom four bits control the border for plot and the sides of the base for splot; The next four bits control the verticals in splot; the top four bits control the edges on top of the splot. In detail, the `` should be the sum of the appropriate entries from the following table:

                        plot border     splot         splot
          Side          splot base    verticals        top
      bottom (south)         1            16           256
      left   (west)          2            32           512
      top    (north)         4            64          1024
      right  (east)          8           128          2048

The default is 31, which is all four sides for plot, and base and z axis for splot.

Using the optional , and specifiers, the way the border lines are drawn can be influenced (limited by what the current terminal driver supports). By default, the border is drawn with twice the usual linewidth. The specifier scales this default value; for example, `set border 15 lw 2` will produce a border with four times the usual linewidth.

Various axes or combinations of axes may be added together in the command.

To have tics on edges other than bottom and left, disable the usual tics and enable the second axes.

Examples:

Draw all borders:

      set border

Draw only the SOUTHWEST borders:

      set border 3

Draw a complete box around a splot:

      set border 4095

Draw a partial box, omitting the front vertical:

      set border 127+256+512

Draw only the NORTHEAST borders:

      set noxtics; set noytics; set x2tics; set y2tics; set border 12

boxwidth

The boxwidth command is used to set the default width of boxes in the boxes and boxerrorbars styles.

Syntax:

      set boxwidth {}
      show boxwidth

If a data file is plotted without the width being specified in the third, fourth, or fifth column (or using entry), or if a function is plotted, the width of each box is set by the boxwidth command. (If a width is given both in the file and by the boxwidth command, the one in the file is used.) If the width is not specified in one of these ways, the width of each box will be calculated automatically so that it touches the adjacent boxes. In a four-column data set, the fourth column will be interpreted as the box width unless the width is set to -2.0, in which case the width will be calculated automatically. See boxerrorbars for more details.

To set the box width to automatic use the command

      set boxwidth

or, for four-column data,

      set boxwidth -2

The same effect can be achieved with the using keyword in plot:

      plot 'file' using 1:2:3:4:(-2)

clabel

gnuplot will vary the linetype used for each contour level when clabel is set. When this option on (the default), a legend labels each linestyle with the z level it represents. It is not possible at present to separate the contour labels from the surface key.

Syntax:

      set clabel {''}
      set noclabel
      show clabel

The default for the format string is %8.3g, which gives three decimal places. This may produce poor label alignment if the key is altered from its default configuration.

The first contour linetype, or only contour linetype when clabel is off, is the surface linetype +1; contour points are the same style as surface points.

See also contour.

clip

gnuplot can clip data points and lines that are near the boundaries of a graph.

Syntax:

      set clip 
      set noclip 

      show clip

Three clip types are supported by gnuplot: `points`, `one`, and `two`. One, two, or all three clip types may be active for a single graph.

The `points` clip type forces gnuplot to clip (actually, not plot at all) data points that fall within but too close to the boundaries. This is done so that large symbols used for points will not extend outside the boundary lines. Without clipping points near the boundaries, the plot may look bad. Adjusting the x and y ranges may give similar results.

Setting the `one` clip type causes gnuplot to draw a line segment which has only one of its two endpoints within the graph. Only the in-range portion of the line is drawn. The alternative is to not draw any portion of the line segment.

Some lines may have both endpoints out of range, but pass through the graph. Setting the `two` clip-type allows the visible portion of these lines to be drawn.

In no case is a line drawn outside the graph.

The defaults are `noclip points`, `clip one`, and `noclip two`.

To check the state of all forms of clipping, use

      show clip

For backward compatibility with older versions, the following forms are also permitted:

      set clip
      set noclip

cntrparam

Syntax:

      set cntrparam {  {linear | cubicspline | bspline}
                      { points } { order  }
                      { levels   auto {} | 
                               | discrete  {,{,...}}
                               | incremental ,  {,}
                       }
                     }
      show contour

This command has two functions. First, it sets the values of z for which contour points are to be determined (by linear interpolation between data points or function isosamples.) Second, it controls the way contours are drawn between the points determined to be of equal z. should be an integral constant expression and , ... any constant expressions. The parameters are:

`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.

`levels` Selection of contour levels, controlled by `auto` (default), `discrete`, `incremental`, and , number of contour levels, limited to

 MAX_DISCRETE_LEVELS as defined in plot.h (30 is standard.)

For `auto`, 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).

For `levels discrete`, contours will be generated at z = , ... as specified; the number of discrete levels sets the number of contour levels. In `discrete` mode, any `set cntrparms levels ` are ignored.

For `incremental`, contours are generated at values of z beginning at and increasing by , until the number of contours is reached. is used to determine the number of contour levels, which will be changed by any subsequent `set cntrparam levels `.

If the command cntrparam is given without any arguments specified, the defaults are used: linear, 5 points, order 4, 5 auto levels.

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

See also contour for control of where the contours are drawn, and clabel for control of the format of the contour labels and linetypes. Contours Demo and contours with User Defined Levels.

contour

Syntax:

      set contour {base | surface | both}
      set nocontour
      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 cntrparam for the parameters that affect the drawing of contours, and clabel for control of labelling of the contours.

The surface can be switched off (see surface), giving a contour-only graph. Though it is possible to use size to enlarge the plot to fill the screen, more control over the output format can be obtained by writing the contour information to a file, and rereading it as a 2-d datafile plot:

      set nosurface
      set contour
      set cntrparam ...
      set term table
      set out 'filename'
      splot ...
      set out
      # contour info now in filename
      set term 
      plot 'filename'

In order to draw contours, the data should be organized as "grid data". In such a file 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 (a line containing no characters other than blank spaces and a carriage return and/or a line feed) separates one y-isoline from the next. See also `splot datafile`.

If contours are desired from non-grid data, dgrid3d can be used to create an appropriate grid. See dgrid3d for more information. Contours Demo and contours with User Defined Levels.

data style

The style command changes the default plotting style for data plots.

Syntax:

      set data style 
      show data style

See style for the choices. If no choice is given, the choices are listed. style shows the current default data plotting style.

dgrid3d

The dgrid3d command enables, and can set parameters for, non-grid to grid data mapping.

Syntax:

      set dgrid3d {} {,{} {,}}
      set nodgrid3d
      show dgrid3d

By default dgrid3d is disabled. When enabled, 3-d data read from a file are always treated as a scattered data set. A grid with dimensions derived from a bounding box of the scattered data and size as specified by the row/col_size parameters is created for plotting and contouring. The grid is equally spaced in x (rows) and in y (columns); the z values are computed as weighted averages of the scattered points' z values.

The third parameter, norm, controls the weighting: Each data point is weighted inversely by its distance from the grid point raised to the norm power. (Actually, the weights are given by the inverse of dx^norm + dy^norm, where dx and dy are the components of the separation of the grid point from each data point. For some norms that are powers of two, specifically 4, 8, and 16, the computation is optimized by using the Euclidean distance in the weight calculation, (dx^2+dx^2)^norm/2. However, any non-negative integer can be used.)

The closer the data point is to a grid point, the more effect it has on that grid point and the larger the value of norm the less effect more distant data points have on that grid point.

The dgrid3d option is a simple low pass filter that converts scattered data to a grid data set. More sophisticated approaches to this problem exist and should be used to preprocess the data outside gnuplot if this simple solution is found inadequate.

(The z values are found by weighting all data points, not by interpolating between nearby data points; also edge effects may produce unexpected and/or undesired results. In some cases, small norm values produce a grid point reflecting the average of distant data points rather than a local average, while large values of norm may produce "steps" with several grid points having the same value as the closest data point, rather than making a smooth transition between adjacent data points. Some areas of a grid may be filled by extrapolation, to an arbitrary boundary condition. The variables are not normalized; consequently the units used for x and y will affect the relative weights of points in the x and y directions.)

Examples:

      set dgrid3d 10,10,1     # defaults
      set dgrid3d ,,4

The first specifies that a grid of size 10 by 10 is to be constructed using a norm value of 1 in the weight computation. The second only modifies the norm, changing it to 4. Dgrid3d Demo.

dummy

The dummy command changes the default dummy variable names.

Syntax:

      set dummy {} {,}
      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)

At least one dummy variable must be set on the command; dummy by itself will generate an error message.

Examples:

      set dummy u,v
      set dummy ,s

The second example sets the second variable to s.

encoding

The encoding command selects a character encoding. Valid values are `default`, which tells a terminal to use its default; `iso_8859_1` (known in the PostScript world as `ISO-Latin1`), which is used on many Unix workstations and with MS-Windows; `cp850`, for OS/2; and `cp437`, for MS-DOS.

Syntax:

      set encoding {}
      show encoding

Note that encoding is not supported by all terminal drivers and that the device must be able to produce the desired non-standard characters.

format

The format of the tic-mark labels can be set with the `set format` command.

Syntax:

      set format {} {""}
      set format {} {''}
      show format

where is either `x`, `y`, `z`, `xy`, `x2`, `y2` or nothing (which is the same as `xy`). The length of the string representing a tic mark (after formatting with 'printf') is restricted to 100 characters. If the format string is omitted, the format will be returned to the default "%g". For LaTeX users, the format "$%g$" is often desirable. If the empty string "" is used, no label will be plotted with each tic, though the tic mark will still be plotted. To eliminate all tic marks, use `set noxtics` or `set noytics`.

Newline (n) is accepted in the format string. Use double-quotes rather than single-quotes to enable such interpretation. See also `syntax`.

The default format for both axes is "%g", but other formats such as "%.2f" or "%3.0em" are often desirable. Anything accepted by 'printf' when given a double precision number, and accepted by the terminal, will work. Some other options have been added. If the format string looks like a floating point format, then gnuplot tries to construct a reasonable format.

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 xtics for more information about tic labels. See demo.

• format_specifiers
• time/date_specifiers

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
      %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
      %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; "#", 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 releases of 'printf' 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 "%.0P%%"; 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 timefmt for a list of the allowed input format codes.

time/date specifiers

In time/date mode, the acceptable formats are:

      Format       Explanation
      %a           abbreviated name of day of the week
      %A           full name of day of the week
      %b or %h     abbreviated name of the month
      %B           full name of the month
      %d           day of the month, 131
      %D           shorthand for "%m/%d/%y"
      %H or %k     hour, 024
      %I or %l     hour, 012
      %j           day of the year, 1366
      %m           month, 112
      %M           minute, 060
      %p           "am" or "pm"
      %r           shorthand for "%I:%M:%S %p"
      %R           shorthand for %H:%M"
      %S           second, 060
      %T           shorthand for "%H:%M:%S"
      %U           week of the year (week starts on Sunday)
      %w           day of the week, 06 (Sunday = 0)
      %W           week of the year (week starts on Monday)
      %y           year, 0-99
      %Y           year, 4-digit

Except for the non-numerical formats, these may be preceded by a "0" ("zero", not "oh") to pad the field length with leading zeroes, and a positive digit, to define the minimum field width (which will be overridden if the specified width is not large enough to contain the number). There is a 24-character limit to the length of the printed text; longer strings will be truncated.

Examples:

Suppose the text is "76/12/25 23:11:11". Then

      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"

Suppose the text is "98/07/06 05:04:03". Then

      set format x "%1y/%2m/%3d %01H:%02M:%03S"  # "98/ 7/  6 5:04:003"

function style

The style command changes the default plotting style for function plots.

Syntax:

      set function style 
      show function style

See style for the choices. If no choice is given, the choices are listed. style shows the current default function plotting style.

functions

The 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`. Splines as User Defined Functions. Use of functions and complex variables for airfoils

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}
               {polar {}}
               { {linestyle }
                 | {linetype | lt }
                   {linewidth | lw }
                 { , {linestyle | ls }
                     | {linetype | lt }
                       {linewidth | lw } } }
      set nogrid
      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.

Additionally, a polar grid can be selected for 2-d plotscircles are drawn to intersect the selected tics, and radial lines are drawn at definable intervals. (The interval is given in degrees or radians ,depending on the angles setting.) Note that a polar grid is no longer automatically generated in polar mode.

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.

By default, grid lines are drawn with half the usual linewidth. The major and minor linewidth specifiers scale this default value; for example, `set grid lw .5` will draw grid lines with one quarter the usual linewidth.

Z grid lines are drawn on the back of the plot. This looks better if a partial box is drawn around the plotsee border.

hidden3d

The 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} |
                   { {{offset } | {nooffset}}
                     {trianglepattern }
                     {{undefined } | {noundefined}}
                     {{no}altdiagonal}
                     {{no}bentover} }
      set nohidden3d
      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 parts behind the surface will be hidden by it. For this to be possible, the surface needs to have 'grid structure' (see `splot datafile` about this), and it has to be drawn `with lines` or linespoints.

When hidden3d is set, both the hidden portion of the surface and possibly its contours drawn on the base (see 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 (surface) don't work. Labels and arrows are always visible and are unaffected. The key is also never hidden by the 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 hidden3d than when plotted with `nohidden3d` because in the latter case functions are evaluated at each sample. Please see samples and 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 linestyle used for lines on the 'back' side. Normally, they are drawn in a linestyle 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 line style offset to add instead of the default 1, by `offset `. Option `nooffset` stands for `offset 0`, making the two sides of the surface use the same linestyle.

Next comes the option `trianglepattern `. 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 ` 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 = 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. = 2 will throw away undefined points, but keep the out-of-range ones. = 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 `undefined` is active (i.e. 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 `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:

                                                              CB
    original quadrangle:  AB      displayed quadrangle:     |   |
      ("set view 0,0")    | /|    ("set view 75,75" perhaps)  |   |
                          |/ |                                |   |
                          CD                                |   |
                                                              A    D

If the diagonal edges of the surface cells aren't generally made visible by bit 2 of the 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. Hidden Line Removal Demo and Complex Hidden Line Demo.

isosamples

The isoline density (grid) for plotting functions as surfaces may be changed by the isosamples command.

Syntax:

      set isosamples  {,}
      show isosamples

Each function surface plot will have iso-u lines and iso-v lines. If you only specify , will be set to the same value as . 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, samples controls the number of points sampled along each isoline; see samples and hidden3d. The contour algorithm assumes that a function sample occurs at each isoline intersection, so change in samples as well as isosamples may be desired when changing the resolution of a function surface/contour.

key

The key enables a key (or legend) describing plots on a plot.

The contents of the key, i.e., the names given to each plotted data set and function and samples of the lines and/or symbols used to represent them, are determined by the `title` and with options of the {`s`}plot command. Please see `plot title` and with for more information.

Syntax:

      set key {  left | right | top | bottom | outside | below
               | }
              {Left | Right} {{no}reverse}
              {samplen } {spacing }
              {width }
              {title ""}
              {{no}box { {linestyle | ls }
                         | {linetype | lt }
                           {linewidth | lw }}}
      set nokey
      show key

By default the key is placed in the upper right corner of the graph. The keywords `left`, `right`, `top`, `bottom`, `outside` and `below` may be used to place the key in the other corners inside the graph or to the right (outside) or below the graph. They may be given alone or combined.

Justification of the labels within the key is controlled by `Left` or `Right` (default is `Right`). The text and sample can be reversed (`reverse`) and a box can be drawn around the key (`box {...}`) in a specified `linetype` and `linewidth`, or a user-defined linestyle. Note that not all terminal drivers support linewidth selection, though.

The length of the sample line can be controlled by `samplen`. The sample length is computed as the sum of the tic length and times the character width. `samplen` also affects the positions of point samples in the key since these are drawn at the midpoint of the sample line, even if it is not drawn. must be an integer.

The vertical spacing between lines is controlled by `spacing`. The spacing is set equal to the product of the pointsize, the vertical tic size, and . The program will guarantee that the vertical spacing is no smaller than the character height.

The 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.

A title can be put on the key (`title ""`)see also `syntax` for the distinction between text in single- or double-quotes. The key title uses the same justification as do the plot titles.

The defaults for key are `right`, `top`, `Right`, `noreverse`, `samplen 4`, `spacing 1.25`, `title ""`, and `nobox`. The default is the same as that used for the plot borders. Entering key with no options returns the key to its default configuration.

The can be a simple x,y,z as in previous versions, but these can be preceded by one of four keywords (`first`, `second`, `graph`, `screen`) which selects the coordinate system in which the position is specified. See `coordinates` for more details.

The key is drawn as a sequence of lines, with one plot described on each line. On the right-hand side (or the left-hand side, if `reverse` is selected) of each line is a representation that attempts to mimic the way the curve is plotted. On the other side of each line is the text description (the line title), obtained from the plot command. The lines are vertically arranged so that an imaginary straight line divides the left- and right-hand sides of the key. It is the coordinates of the top of this line that are specified with the key command. In a plot, only the x and y coordinates are used to specify the line position. For a splot, x, y and z are all used as a 3-d location mapped using the same mapping as the graph itself to form the required 2-d screen position of the imaginary line.

Some or all of the key may be outside of the graph boundary, although this may interfere with other labels and may cause an error on some devices. If you use the keywords `outside` or `below`, gnuplot makes space for the keys and the graph becomes smaller. Putting keys outside to the right, they occupy as few columns as possible, and putting them below, as many columns as possible (depending of the length of the labels), thus stealing as little space from the graph as possible.

When using the TeX or PostScript drivers, or similar drivers where formatting information is embedded in the string, gnuplot is unable to calculate correctly the width of the string for key positioning. If the key is to be positioned at the left, it may be convenient to use the combination `set key left Left reverse`. The box and gap in the grid will be the width of the literal string.

If splot is being used to draw contours, the contour labels will be listed in the key. If the alignment of these labels is poor or a different number of decimal places is desired, the label format can be specified. See clabel for details.

Examples:

This places the key at the default location:

      set key

This disables the key:

      set nokey

This places a key at coordinates 2,3.5,2 in the default (first) coordinate system:

      set key 2,3.5,2

This places the key below the graph:

      set key below

This places the key in the bottom left corner, left-justifies the text, gives it a title, and draws a box around it in linetype 3:

      set key left bottom Left title 'Legend' box 3

label

Arbitrary labels can be placed on the plot using the label command.

Syntax:

      set label {} {""} {at }
                {} {{no}rotate} {font ""}
      set nolabel {}
      show label

The is specified by either x,y or x,y,z, and may be preceded by `first`, `second`, `graph`, or `screen` to select the coordinate system. See `coordinates` for details.

The tag is an integer that is used to identify the label. If no 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 label command with the appropriate tag, and specify the parts of the label to be changed.

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 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.

If `rotate` is given, the label is written vertically (if the terminal can do so, of course).

If one (or more) axis is timeseries, the appropriate coordinate should be given as a quoted time string according to the timefmt format string. See xdata and timefmt.

The EEPIC, Imagen, LaTeX, and TPIC drivers allow in a string to specify a newline.

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:

      set nolabel 2

To delete all labels, use:

      set nolabel

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

linestyle

Each terminal has a default set of line and point types, which can be seen by using the command test. linestyle 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 linestyle  {linetype | lt }
                            {linewidth | lw }
                            {pointtype | pt }
                            {pointsize | ps }
      set nolinestyle
      show linestyle

The line and point types are taken from the default types for the terminal currently in use. The line width and point size are multipliers for the default width and size (but note that here is unaffected by the multiplier given on 'set pointsize').

The defaults for the line and point types is the index. The defaults for the width and size are both unity.

Linestyles created by this mechanism do not replace the default styles; both may be used.

Not all terminals support the `linewidth` and pointsize features; if not supported, the option will be ignored.

Note that this feature is not completely implemented; linestyles defined by this mechanism may be used with 'plot', 'splot', 'replot', and 'set arrow', but not by other commands that allow the default index to be used, such as 'set grid'.

Example: 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 linestyle 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 function style 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 function style linespoints
      plot p(x) lt 1 pt 3, q(x) ls 1

will create a plot of f(x) using the default triangles connected by a red line and q(x) using small triangles connected by a green line.

lmargin

The command lmargin sets the size of the left margin. Please see margin for details.

locale

The locale setting determines the language with which `{x,y,z}{d,m}tics` will write the days and months.

Syntax:

      set locale {""}

may be any language designation acceptable to your installation. See your system documentation for the available options. The default value is determined from the LANG environment variable.

logscale

Log scaling may be set on the x, y, z, x2 and/or y2 axes.

Syntax:

      set logscale  
      set nologscale 
      show logscale

where may be any combinations of `x`, `y`, and `z`, in any order, or `x2` or `y2` and where is the base of the log scaling. If is not given, then 10 is assumed. If is not given, then all axes are assumed. `set nologscale` turns off log scaling for the specified axes.

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 disable z axis log scaling:

      set nologscale z

mapping

If data are provided to splot in spherical or cylindrical coordinates, the 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 polar and azimuthal angles theta and phi (in the units specified by 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.

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 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 mapping can be duplicated with the using filter on the splot command, but mapping may be more convenient if many data files are to be processed. However even if mapping is used, using may still be necessary if the data in the file are not in the required order. mapping has no effect on plot. Mapping Demos.

margin

The computed margins can be overridden by the margin commands. margin shows the current settings.

Syntax:

      set bmargin {}
      set lmargin {}
      set rmargin {}
      set tmargin {}
      show margin

The units of 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.

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.

missing

The missing command allows you to tell gnuplot what character is used in a data file to denote missing data.

Syntax:

      set missing {""}
      show missing

Example:

      set missing "?"

would mean that, when plotting a file containing

         1 1
         2 ?
         3 2

the middle line would be ignored.

There is no default character for missing.

multiplot

The command multiplot places gnuplot in the multiplot mode, in which several plots are placed on the same page, window, or screen.

Syntax:

      set multiplot
      set nomultiplot

For some terminals, no plot is displayed until the command `set nomultiplot` 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 a plot, but the screen may not be cleared between plots.

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`/`set notime` pair around one of the plot, splot or replot commands within the multiplot/`set nomultiplot` block.

The commands origin and size must be used to correctly position each plot; see origin and size for details of their usage.

Example:

      set size 0.7,0.7
      set origin 0.1,0.1
      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)
      set nomultiplot

displays a plot of cos(x) stacked above a plot of sin(x). Note the initial size and origin. While these are not always required, their inclusion is recommended. Some terminal drivers require that bounding box information be available before any plots can be made, and the form given above guarantees that the bounding box will include the entire plot array rather than just the bounding box of the first plot. size and origin refer to the entire plotting area used for each plot. If you want to have the axes themselves line up, you can guarantee that the margins are the same size with the margin commands. See 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. See demo.

mx2tics

Minor tic marks along the x2 (top) axis are controlled by mx2tics. Please see mxtics.

mxtics

Minor tic marks along the x axis are controlled by mxtics. They can be turned off with `set nomxtics`. Similar commands control minor tics along the other axes.

Syntax:

      set mxtics { | default}
      set nomxtics
      show mxtics

The same syntax applies to mytics, mztics, mx2tics and my2tics.

is the number of sub-intervals (NOT the number of minor tics) between major tics (ten is the default for a linear axis, so there are nine minor tics between major tics). Selecting `default` will return the number of minor ticks to its default value.

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 is given. However the usual minor tics (2, 3, ..., 8, 9 between 1 and 10, for example) are obtained by setting to 10, even though there are but nine sub-intervals.

Minor tics can be used only with uniformly spaced major tics. Since major tics can be placed arbitrarily by `set {x|x2|y|y2|z}tics`, minor tics cannot be used if major tics are explicitly set.

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 xtics for information about these.

my2tics

Minor tic marks along the y2 (right-hand) axis are controlled by my2tics. Please see mxtics.

mytics

Minor tic marks along the y axis are controlled by mytics. Please see mxtics.

mztics

Minor tic marks along the z axis are controlled by mztics. Please see mxtics.

offsets

Offsets provide a mechanism to put a boundary around the data inside of an autoscaled graph.

Syntax:

      set offsets , , , 
      set nooffsets
      show offsets

Each offset may be a constant or an expression. Each defaults to 0. Left and right offsets are given in units of the x axis, top and bottom offsets in units of the y axis. A positive offset expands the graph in the specified direction, e.g., a positive bottom offset makes ymin more negative. Negative offsets, while permitted, can have unexpected interactions with autoscaling and clipping.

Offsets are ignored in splots.

Example:

      set offsets 0, 0, 2, 2
      plot sin(x)

This graph of sin(x) will have a y range [-3:3] because the function will be autoscaled to [-1:1] and the vertical offsets are each two.

origin

The 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 ,

output

По умолчанию область графика отображается в стандартный вывод. Команда output перенаправляет вывод в указанный файл или на указанное устройство.

Синтаксис:

      set output {""}
      show output

Имя файла должно заключаться в кавычки. Если имя файла опущено, любой выходной файл, открытый предыдущим вызовом output, будет закрыт и вывод будет направлен в STDOUT. (Если вы задаете команду `set output "STDOUT"`, ваш вывод может быть направлен в файл с именем "STDOUT"! ["Может быть" не значит "будет", т.к. некоторые терминалы типа `x11` игнорируют output]).

Пользователи MSDOS должны учесть, что символ `` имеет особое значение в строках, заключенных в двойные кавычки, поэтому необходимо использовать одиночные кавычки для имен файлов в разных директориях.

Когда terminal и output используются совместно, наиболее надежным является сначала указывать терминал terminal, т.к. некоторые терминалы устанавливают флаг, который необходим в некоторых операционных системах. Это будет в случае, например, когда операционной системе необходимо знать, форматировать ли вывод в виде файла, чтобы он потом корректно открылся.

В операционных системах (Unix), где есть функции работы с каналами (типа popen), вывод может быть направлен на вход системной команды, если первый непробельный символ - это '|'. Например,

      set output "|lpr -Plaser filename"
      set output "|lp -dlaser filename"

В MSDOS команда `set output "PRN"` направит вывод на принтер, установленный в системе по умолчанию. В VMS вывод может быть направлен напрямую в любое буферизуемое устройство. Также возможно посылать вывод в скрытые DECnet задачи, которые представляют собой доволно гибкий механизм.

parametric

The `set parametric` command changes the meaning of plot (splot) from normal functions to parametric functions. The command `set noparametric` restores the plotting style to normal, single-valued expression plotting.

Syntax:

      set parametric
      set noparametric
      show parametric

For 2-d plotting, a parametric function is determined by a pair of parametric functions operating on a parameter. An example of a 2-d parametric function would be `plot sin(t),cos(t)`, which draws a circle (if the aspect ratio is set correctlysee size). gnuplot will display an error message if both functions are not provided for a parametric plot.

For 3-d 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 3-d 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, 3-d 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 `set 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 trange, urange, and 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.

pointsize

The pointsize command scales the size of the points used in plots.

Syntax:

      set pointsize 
      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 with for details.

Please note that the pointsize setting is not supported by all terminal types.

polar

The `set polar` command changes the meaning of the plot from rectangular coordinates to polar coordinates.

Syntax:

      set polar
      set nopolar
      show polar

There have been changes made to polar mode in version 3.7, so that scripts for gnuplot versions 3.5 and earlier will require modification. The main change is that the dummy variable t is used for the angle so that the x and y ranges can be controlled independently. Other changes are: 1) tics are no longer put along the zero axes automatically use `set xtics axis nomirror`; `set ytics axis nomirror`; 2) the grid, if selected, is not automatically polar use `set grid polar`; 3) the grid is not labelled with angles use label as necessary.

In polar coordinates, the dummy variable (t) is an angle. The default range of t is [0:2*pi], or, if degree units have been selected, to [0:360] (see angles).

The command `set nopolar` changes the meaning of the plot back to the default rectangular coordinate system.

The `set polar` command is not supported for splots. See the mapping command for similar functionality for splots.

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, and the x and y ranges control the range of the graph in the x and y directions. Each of these ranges, as well as the rrange, may be autoscaled or set explicitly. See xrange for details of all the `set range` commands.

Example:

      set polar
      plot t*sin(t)
      plot [-2*pi:2*pi] [-3:3] [-3:3] 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 [-3:3] in both directions.

You may want to `set size square` to have gnuplot try to make the aspect ratio equal to unity, so that circles look circular. Polar demos Polar Data Plot.

rmargin

The command rmargin sets the size of the right margin. Please see margin for details.

rrange

The rrange command sets the range of the radial coordinate for a graph in polar mode. Please see xrange for details.

samples

The sampling rate of functions, or for interpolating data, may be changed by the samples command.

Syntax:

      set samples  {,}
      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 smooth re 2-d data and cntrparam and dgrid3d re 3-d data.

When a 2-d graph is being done, only the value of 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 samples and each iso-u line will have samples. If you only specify , will be set to the same value as . See also isosamples.

size

The size command scales the displayed size of the plot.

Syntax:

      set size {{no}square | ratio  | noratio} {,}
      show size

The and values are the scaling factors for the size of the plot, which includes the graph and the margins.

`ratio` causes gnuplot to try to create a graph with an aspect ratio of (the ratio of the y-axis length to the x-axis length) within the portion of the plot specified by and .

The meaning of a negative value for is different. If =-1, gnuplot tries to set the scales so that the unit has the same length on both the x and y axes (suitable for geographical data, for instance). If =-2, the unit on y has twice the length of the unit on x, and so on.

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 that will fit into the specified portion of the output (leaving adequate margins, of course).

`square` is a synonym for `ratio 1`.

Both `noratio` and `nosquare` return the graph to the default aspect ratio of the terminal, but do not return or to their default values (1.0).

`ratio` and `square` have no effect on 3-d plots. size is relative to the default size, which differs from terminal to terminal. Since gnuplot fills as much of the available plotting area as possible by default, it is safer to use size to decrease the size of a plot than to increase it. See terminal for the default sizes.

On some terminals, changing the size of the plot will result in text being misplaced.

Examples:

To set the size to normal size use:

      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

style

Default styles are chosen with the style and style commands. See with for information about how to override the default plotting style for individual functions and data sets.

Syntax:

      set function style 

The types used for all line and point styles (i.e., solid, dash-dot, color, etc. for lines; circles, squares, crosses, etc. for points) will be either those specified on the plot or splot command or will be chosen sequentially from the types available to the terminal in use. Use the command test to see what is available.

None of the styles requiring more than two columns of information (e.g., errorbars) can be used with splots or function plots. Neither boxes nor any of the steps styles can be used with splots. If an inappropriate style is specified, it will be changed to `points`.

For 2-d data with more than two columns, gnuplot is picky about the allowed `errorbar` styles. The using option on the plot command can be used to set up the correct columns for the style you want. (In this discussion, "column" will be used to refer both to a column in the data file and an entry in the using list.)

For three columns, only xerrorbars, yerrorbars (or errorbars), boxes, and boxerrorbars are allowed. If another plot style is used, the style will be changed to yerrorbars. The boxerrorbars style will calculate the boxwidth automatically.

For four columns, only xerrorbars, yerrorbars (or errorbars), xyerrorbars, boxxyerrorbars, and boxerrorbars are allowed. An illegal style will be changed to yerrorbars.

Five-column data allow only the boxerrorbars, financebars, and candlesticks styles. (The last two of these are primarily used for plots of financial prices.) An illegal style will be changed to boxerrorbars before plotting.

Six- and seven-column data only allow the xyerrorbars and boxxyerrorbars styles. Illegal styles will be changed to xyerrorbars before plotting.

For more information about error bars, please see errorbars.

• boxerrorbars
• boxes
• boxxyerrorbars
• candlesticks
• dots
• financebars
• fsteps
• histeps
• impulses
• lines
• linespoints
• points
• steps
• vector
• xerrorbars
• xyerrorbars
• yerrorbars

boxerrorbars

The boxerrorbars style is only relevant to 2-d data plotting. It is a combination of the boxes and yerrorbars styles. The boxwidth will come from the fourth column if the y errors are in the form of "ydelta" and the boxwidth was not previously set equal to -2.0 (`set boxwidth -2.0`) or from the fifth column if the y errors are in the form of "ylow yhigh". The special case `boxwidth = -2.0` is for four-column data with y errors in the form "ylow yhigh". In this case the boxwidth will be calculated so that each box touches the adjacent boxes. The width will also be calculated in cases where three-column data are used.

The box height is determined from the y error in the same way as it is for the yerrorbars styleeither from y-ydelta to y+ydelta or from ylow to yhigh, depending on how many data columns are provided. See Demo.

boxes

The boxes style is only relevant to 2-d plotting. It draws a box centered about the given x coordinate from the x axis (not the graph border) to the given y coordinate. The width of the box is obtained in one of three ways. If it is a data plot and the data file has a third column, this will be used to set the width of the box. If not, if a width has been set using the boxwidth command, this will be used. If neither of these is available, the width of each box will be calculated automatically so that it touches the adjacent boxes.

boxxyerrorbars

The boxxyerrorbars style is only relevant to 2-d data plotting. It is a combination of the boxes and xyerrorbars styles.

The box width and height are determined from the x and y errors in the same way as they are for the xyerrorbars styleeither 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.

candlesticks

The candlesticks style is only relevant for 2-d data plotting of financial data. Five columns of data are required; in order, these should be the x coordinate (most likely a date) and the opening, low, high, and closing prices. The symbol is an open rectangle, 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 width of the rectangle may be changed by bar. The symbol will be unchanged if the low and high prices are interchanged or if the opening and closing prices are interchanged. See bar and financebars. See demos.

dots

The dots style plots a tiny dot at each point; this is useful for scatter plots with many points.

financebars

The financebars style is only relevant for 2-d data plotting of financial data. Five columns of data are required; in order, these should be the x coordinate (most likely a date) and the opening, low, high, and closing prices. 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 bar. The symbol will be unchanged if the high and low prices are interchanged. See bar and candlesticks. See demos.

fsteps

The fsteps style is only relevant to 2-d 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). See demo.

histeps

The histeps style is only relevant to 2-d 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).

If 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 demo. histeps is only a plotting style; gnuplot does not have the ability to create bins and determine their population from some data set.

impulses

The impulses style displays a vertical line from the x axis (not the graph border), or from the grid base for splot, to each point.

lines

The `lines` style connects adjacent points with straight line segments.

linespoints

The linespoints style does both `lines` and `points`, that is, it draws a small symbol at each point and then connects adjacent points with straight line segments. The command pointsize may be used to change the size of the points. See pointsize for its usage. linespoints may be abbreviated `lp`.

points

The `points` style displays a small symbol at each point. The command pointsize may be used to change the size of the points. See pointsize for its usage.

steps

The steps style is only relevant to 2-d 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). See demo.

vector

The vector style draws a vector from (x,y) to (x+xdelta,y+ydelta). Thus it requires four columns of data. It also draws a small arrowhead at the end of the vector.

The vector style is still experimental: it doesn't get clipped properly and other things may also be wrong with it. Use it at your own risk.

xerrorbars

The xerrorbars style is only relevant to 2-d data plots. xerrorbars is like dots, 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. A tic mark is placed at the ends of the error bar (unless bar is usedsee bar for details).

xyerrorbars

The xyerrorbars style is only relevant to 2-d data plots. xyerrorbars is like dots, 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. A tic mark is placed at the ends of the error bar (unless bar is usedsee bar for details).

If data are provided in an unsupported mixed form, the using filter on 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

yerrorbars

The yerrorbars (or errorbars) style is only relevant to 2-d data plots. yerrorbars is like dots, 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. A tic mark is placed at the ends of the error bar (unless bar is usedsee bar for details). See demo.

surface

The command surface controls the display of surfaces by splot.

Syntax:

      set surface
      set nosurface
      show surface

The surface is drawn with the style specifed by with, or else the appropriate style, data or function.

Whenever `set nosurface` is issued, splot will not draw points or lines corresponding to the function or data file points. Contours may be still be drawn on the surface, depending on the contour option. `set nosurface; set contour base` is useful for displaying contours on the grid base. See also contour.

terminal

gnuplot поддерживает много различных графических устройств. Используйте команду terminal, чтобы указать gnuplot, какой тип графического вывода генерировать. Используйте команду output, чтобы перенаправить вывод в файл или устройство.

Синтаксис:

      set terminal {}
      show terminal

Если тип терминала опущен, gnuplot выведет список доступных графических терминалов. может быть записан в сокращенной форме.

Если terminal и output используются вместе, то укажите тип терминала первым, т.к. некоторые терминалы устанавливают флаг, который необходим в некоторых операционных системах.

Несколько терминалов имеют дополнительные опции, Например, `dumb`, `iris4d`, `hpljii` или `postscript`.

Этот документ может описывать графические драйверы, которые вам недоступны, т.к. они не были установлены, либо не описывать все драйверы, доступные вам, в зависимости от их выходного формата. Вся информация о терминалах взята из .trm файлов.

aifm

Several options may be set in `aifm`the Adobe Illustrator 3.0+ driver.

Syntax:

      set terminal aifm {} {""} {}

is either `color` or `monochrome`; "" is the name of a valid PostScript font; is the size of the font in PostScript points, before scaling by the size command. Selecting `default` sets all options to their default values: `monochrome`, "Helvetica", and 14pt.

Since AI does not really support multiple pages, multiple graphs will be drawn directly on top of one another. However, each graph will be grouped individually, making it easy to separate them inside AI (just pick them up and move them).

Examples:

      set term aifm
      set term aifm 22
      set size 0.7,1.4; set term aifm color "Times-Roman" 14"

cgm

The `cgm` terminal generates a Computer Graphics Metafile. 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". Several options may be set in `cgm`.

Syntax:

      set terminal cgm {} {} {} {solid | dashed}
                       {width } {linewidth }
                       {""} {}

where is `landscape`, `portrait`, or `default`; is either `color` or `monochrome`; is either `rotate` or `norotate`; `solid` draws all curves with solid lines, overriding any dashed patterns; is the width of the page in points; is the line width in points; is the name of a font; and `` is the size of the font in points.

By default, `cgm` uses rotated text for the Y axis label.

The first six options can be in any order. Selecting `default` sets all options to their default values.

Examples:

      set terminal cgm landscape color rotate dashed width 432 
                     linewidth 1  'Arial Bold' 12       # defaults
      set terminal cgm 14 linewidth 2  14  # wider lines & larger font
      set terminal cgm portrait 'Times Roman Italic' 12
      set terminal cgm color solid    # no pesky dashes!

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 fonts:

      Arial
      Arial Italic
      Arial Bold
      Arial Bold Italic
      Times Roman
      Times Roman Italic
      Times Roman Bold
      Times Roman Bold Italic
      Helvetica
      Roman

Case is not distinct, but the modifiers must appear in the above order (that is, not 'Arial Italic Bold'). 'Arial Bold' is the default font.

You may also 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 only entry. You must ensure that the spelling, capitalization, and spacing of the name are appropriate for the application that will read the CGM file.

FONTSIZE

Fonts are scaled assuming the page is 6 inches wide. If the size command is used to change the aspect ratio of the page or the CGM file is converted to a different width (e.g. it is imported into a document in which the margins are not 6 inches apart), the resulting font sizes will be different. To change the assumed width, use the `width` option.

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

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.

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 curve.

SIZE

Default size of a CGM page is 32599 units wide and 23457 units high for landscape, or 23457 units wide by 32599 units high for portrait.

WIDTH

All distances in the CGM file are in abstract units. The application that reads the file determines the size of the final page. By default, the width of the final page 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 arithmetic can be used to convert from other units, as follows:

      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

WINWORD6

The default font table was chosen to match, where possible, the default font assignments made by the Computer Graphics Metafile input filter for Microsoft Word 6.0c, although the filter makes available only 'Arial' and 'Times Roman' fonts and their bold and/or italic variants. Other fonts such as 'Helvetica' and 'Roman' are not available. If the CGM file includes a font table, the filter mostly ignores it. However, it changes certain font assignments so that they disagree with the table. As a workaround, the `winword6` option deletes the font table from the CGM file. In this case, the filter makes predictable font assignments. 'Arial Bold' is correctly assigned even with the font table present, which is one reason it was chosen as the default.

`winword6` disables the color tables for a similar reasonwith the color table included, Microsoft Word displays black for color 7.

Linewidths and pointsizes may be changed with linestyle."

corel

The `corel` terminal driver supports CorelDraw.

Syntax:

      set terminal corel {  default
                          | {monochrome | color
                               { {""
                                  {  { }}}}}

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."

dumb

The `dumb` terminal driver has an optional size specification and trailing linefeed control.

Syntax:

      set terminal dumb {[no]feed} { }

where and set the size of the dumb terminals. Default is 79 by 24. The last newline is printed only if `feed` is enabled.

Examples:

      set term dumb nofeed
      set term dumb 79 49 # VGA screen-why would anyone do that?"

dxf

The `dxf` terminal driver creates pictures that can be imported into AutoCad (Release 10.x). It has no options of its own, but some features of its plots may be modified by other means. The default size is 120x80 AutoCad units, which can be changed by size. `dxf` uses seven colors (white, red, yellow, green, cyan, blue and magenta), which 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. See the description of the AutoCad print/plot command."

eepic

The `eepic` terminal driver supports the extended LaTeX picture environment. It is an alternative to the `latex` driver.

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 printer driver that supports the "tpic" specials. If your printer driver doesn't support those specials, "eepicemu.sty" will enable you to use some of them.

Although dotted and dashed lines are possible with `eepic` and are tempting, they do not work well for high-sample-rate curves, fusing the dashes all together into a solid line. For now, the `eepic` driver creates only solid lines. There is another gnuplot driver (`tpic`) that supports dashed lines, but it cannot be used if your DVI driver doesn't support "tpic" specials.

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.

The `eepic` terminal has no options.

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}'"

epson-180dpi

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 generix 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.

Only `nec-cp6` has any options.

Syntax:

      set terminal nec-cp6 {monochrome | colour | draft}

which defaults to monochrome.

With each of these drivers, a binary copy is required on a PC to print. Do not use printuse instead `copy file /b lpt1:`."

fig

The `fig` terminal device generates output in the Fig graphics language.

Syntax:

      set terminal fig {monochrome | color} {small | big}
                       {pointsmax }
                       {landscape | portrait}
                       {metric | inches}
                       {fontsize }
                       {size  }
                       {thickness }
                       {depth }

`monochrome` and `color` determine whether the picture is black-and-white or `color`. `small` and `big` produce a 5x3 or 8x5 inch graph in the default `landscape` mode and 3x5 or 5x8 inches in `portrait` mode. sets the maximum number of points per polyline. Default units for editing with "xfig" may be `metric` or `inches`. `fontsize` sets the size of the text font to points. size sets (overrides) the size of the drawing area to * in units of inches or centimeters depending on the `inches` or `metric` setting in effect. `depth` sets the default depth layer for all lines and text. The default depth is 10 to leave room for adding material with "xfig" on top of the plot.

`thickness` sets the default line thickness, which is 1 if not specified. Overriding the thickness can be achieved by adding a multiple of 100 to the to the `linetype` value for a plot command. In a similar way the `depth` of plot elements (with respect to the default depth) can be controlled by adding a multiple of 1000 to . The depth is then + /1000 and the thickness is (%1000)/100 or, if that is zero, the default line thickness.

Additional point-plot symbols are also available with the `fig` driver. The symbols can be used through `pointtype` values % 100 above 50, with different fill intensities controlled by % 5 and outlines in black (for % 10

        50 - 59:  circles
        60 - 69:  squares
        70 - 79:  diamonds
        80 - 89:  upwards triangles
        90 - 99:  downwards triangles

The size of these symbols is linked to the font size. The depth of symbols is by default one less than the depth for lines to achieve nice error bars. If is above 1000, the depth is + /1000-1. If %1000 is above 100, the fill color is (%1000)/100-1.

Available fill colors are (from 1 to 9): black, blue, green, cyan, red, magenta, yellow, white and dark blue (in monochrome mode: black for 1 to 6 and white for 7 to 9).

See with for details of and .

The `big` option is a substitute for the `bfig` terminal in earlier versions, which is no longer supported.

Examples:

      set terminal fig monochrome small pointsmax 1000  # defaults

      plot 'file.dat' with points linetype 102 pointtype 759

would produce circles with a blue outline of width 1 and yellow fill color.

      plot 'file.dat' using 1:2:3 with err linetype 1 pointtype 554

would produce errorbars with black lines and circles filled red. These circles are one layer above the lines (at depth 9 by default).

To plot the error bars on top of the circles use

      plot 'file.dat' using 1:2:3 with err linetype 1 pointtype 2554"

gif

The `gif` terminal driver generates output in GIF format. It uses Thomas Boutell's gd library, which is available from http://www.boutell.com/gd/

By default, the `gif` terminal driver uses a shared Web-friendy palette."

Syntax:

      set terminal gif {transparent} {interlace}
                       {tiny | small | medium | large | giant}
                       {size ,}
                       {   ...}

`transparent` instructs the driver to generate transparent GIFs. The first color will be the transparent one.

`interlace` instructs the driver to generate interlaced GIFs.

The choice of fonts is `tiny` (5x8 pixels), `small` (6x12 pixels), `medium` (7x13 Bold), `large` (8x16) or `giant` (9x15 pixels)

The size is given in pixelsit defaults to 640x480. The number of pixels can be also modified by scaling with the size command.

Each color must be of the form 'xrrggbb', where x is the literal character 'x' and 'rrggbb' are the red, green and blue components in hex. For example, 'x00ff00' is green. The background color is set first, then the border colors, then the X & Y axis colors, then the plotting colors. The maximum number of colors that can be set is 256.

Examples:

      set terminal gif small size 640,480 
                       xffffff x000000 x404040 
                       xff0000 xffa500 x66cdaa xcdb5cd 
                       xadd8e6 x0000ff xdda0dd x9500d3    # defaults

which uses white for the non-transparent background, black for borders, gray for the axes, and red, orange, medium aquamarine, thistle 3, light blue, blue, plum and dark violet for eight plotting colors.

      set terminal gif transparent xffffff 
                       x000000 x202020 x404040 x606060 
                       x808080 xA0A0A0 xC0C0C0 xE0E0E0 

which uses white for the transparent background, black for borders, dark gray for axes, and a gray-scale for the six plotting colors.

The page size is 640x480 pixels. The `gif` driver can create either color or monochromatic output, but you have no control over which is produced.

The current version of the `gif` driver does not support animated GIFs."

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 { }

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 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 the command

      set terminal gpic x y

for example, using

      .PS 6.0
      copy "trig.pic"
      .PE"

hp2623a

The `hp2623a` terminal driver supports the Hewlett Packard HP2623A. It has no options."

hp2648

The `hp2648` terminal driver supports the Hewlett Packard HP2647 and HP2648. It has no options."

hp500c

The `hp500c` terminal driver supports the Hewlett Packard HP DeskJet 500c. It has options for resolution and compression.

Syntax:

      set terminal hp500c {} {}

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."

hpgl

The `hpgl` driver produces HPGL output for devices like the HP7475A plotter. There are two options which can be setthe number of pens and "eject", which tells the plotter to eject a page when done. The default is to use 6 pens and not to eject the page when done.

The international character sets ISO-8859-1 and CP850 are recognized via `set encoding iso_8859_1` or `set encoding cp850` (see encoding for details).

Syntax:

      set terminal hpgl {} {eject}

The selection

      set terminal hpgl 8 eject

is equivalent to the previous `hp7550` terminal, and the selection

      set terminal hpgl 4

is equivalent to the previous `hp7580b` terminal.

The `pcl5` driver supports the Hewlett-Packard Laserjet III. It actually uses HPGL-2, but there is a name conflict among the terminal devices. It has several options

Syntax:

      set terminal pcl5 {} {} {}

where is `landscape`, or `portrait`, is `stick`, `univers`, or `cg_times`, and is the size in points.

With `pcl5` international characters are handled by the printer; you just put the appropriate 8-bit character codes into the text strings. You don't need to bother with encoding.

HPGL graphics can be imported by many software packages."

hpljii

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 {}

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."

hppj

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."

imagen

The `imagen` terminal driver supports Imagen laser printers. It is capable of placing multiple graphs on a single page.

Syntax:

      set terminal imagen {} {portrait | landscape}
                          {[,]}

where `fontsize` defaults to 12 points and the layout defaults to `landscape`. `` and `` 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."

latex

The `latex` and `emtex` drivers allow two options.

Syntax:

      set terminal latex | emtex {courier | roman | default} {}

`fontsize` may be any size you specify. The default is for the plot to inherit its font setting from the embedding document.

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.

Points are drawn with the LaTex commands Diamond and Box. These commands do no longer belong to the LaTeX2e core, but are included in the latexsym-package in the base distribution, and are hence part of all LaTeX implementations. Please do not forget to use this package.

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}'"

mf

The `mf` terminal driver creates a 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 chose 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.

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:

  fontgnufigs=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{gnufigschar0}
  centerline{gnufigschar1}

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."

mif

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 {colour | monochrome} {polyline | vectors}
                       {help | ?}

`colour` plots lines with line types >= 0 in colour (MIF sep. 2-7) and `monochrome` plots all line types in black (MIF sep. 0). `polyline` plots curves as continuous curves and `vectors` plots curves as collections of vectors. help and `?` print online help on standard error outputboth print a short description of the usage; help also lists the options;

Examples:

      set term mif colour polylines    # defaults
      set term mif                     # defaults
      set term mif vectors
      set term mif help"

pbm

Several options may be set in the `pbm` terminalthe driver for PBMplus.

Syntax:

      set terminal pbm {} {}

where is `small`, `medium`, or `large` and is `monochrome`, `gray` or `color`. The default plot size is 640 pixels wide and 480 pixels high; this may be changed by size.

The output of the `pbm` driver depends upon : `monochrome` produces a portable bitmap (one bit per pixel), `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 Jef Poskanzer's excellent PBMPLUS package, which provides programs to convert the above PBMPLUS formats to GIF, TIFF, MacPaint, Macintosh PICT, PCX, X11 bitmap and many others. PBMPLUS may be obtained from ftp.x.org. The relevant files have names that begin with "netpbm-1mar1994.p1"; they reside in /contrib/utilities. The package can probably also be obtained from one of the many sites that mirrors ftp.x.org.

Examples:

      set terminal pbm small monochrome             # defaults
      set size 2,2; set terminal pbm color medium"

png

The `png` terminal driver supports Portable Network Graphics. To compile it, you will need the third-party libraries "libpng" and "zlib"; both are available at ftp://ftp.uu.net/graphics/png. `png` has two options.

Syntax:

      set terminal png {small | medium | large}
                       {monochrome | gray | color}

The defaults are small (fontsize) and monochrome. Default size of the output is 640*480 pixel."

postscript

Several options may be set in the `postscript` driver.

Syntax:

      set terminal postscript {} {enhanced | noenhanced}
                              {color | monochrome} {solid | dashed}
                              {}
                              {""} {}

where is landscape, portrait, eps or default; solid draws all plots with solid lines, overriding any dashed patterns; is defaultplex, simplex or duplex ("duplexing" in PostScript is the ability of the printer to print on both sides of the same pagedon't set this if your printer can't do it); enhanced activates the "enhanced PostScript" features (subscripts, superscripts and mixed fonts); "" is the name of a valid PostScript font; and is the size of the font in PostScript points.

default mode sets all options to their defaults: landscape, monochrome, dashed, defaultplex, noenhanced, "Helvetica" and 14 pt.

Default size of a PostScript plot is 10 inches wide and 7 inches high.

eps mode generates EPS (Encapsulated PostScript) output, which is just regular PostScript with some additional lines that allow the file to be imported into a variety of other applications. (The added lines are PostScript comment lines, so the file may still be printed by itself.) To get EPS output, use the eps mode and make only one plot per file. In eps mode the whole plot, including the fonts, is reduced to half of the default size.

Examples:

      set terminal postscript default       # old postscript
      set terminal postscript enhanced      # old enhpost
      set terminal postscript landscape 22  # old psbig
      set terminal postscript eps 14        # old epsf1
      set terminal postscript eps 22        # old epsf2
      set size 0.7,1.4; set term post portrait color "Times-Roman" 14

Linewidths and pointsizes may be changed with linestyle.

The `postscript` driver supports about 70 distinct pointtypes, selectable through the `pointtype` option on plot and linestyle.

Several possibly useful files about gnuplot's PostScript are included in the /docs/ps subdirectory of the gnuplot distribution and at the distribution sites. These are "ps_symbols.gpi" (a gnuplot command file that, when executed, creates the file "ps_symbols.ps" which shows all the symbols available through the `postscript` terminal), "ps_guide.ps" (a PostScript file that contains a summary of the enhanced syntax and a page showing what the octal codes produce with text and symbol fonts) and "ps_file.doc" (a text file that contains a discussion of the organization of a PostScript file written by gnuplot).

A PostScript file is editable, so once gnuplot has created one, you are free to modify it to your heart's desire. See the "editing postscript" section for some hints.

ENHANCED POSTSCRIPT

 Control      Examples        Explanation
  ^           a^x             superscript
  _           a_x             subscript
  @           @x or a@^b_c    phantom box (occupies no width)
  &           &{space}        inserts space of specified length

Braces can be used to place multiple-character text where a single character is expected (e.g., 2^{10}). To change the font and/or size, use the full form: {/[fontname][=fontsize | *fontscale] text}. Thus {/Symbol=20 G} is a 20-point GAMMA) and {/*0.75 K} is a K at three-quarters of whatever fontsize is currently in effect. (The '/' character MUST be the first character after the '{'.)

If the encoding vector has been changed by encoding, the default encoding vector can be used instead by following the slash with a dash. This is unnecessary if you use the Symbol font, howeversince /Symbol uses its own encoding vector, gnuplot will not apply any other encoding vector to it.

The phantom box is useful for a@^b_c to align superscripts and subscripts but does not work well for overwriting an accent on a letter. (To do the latter, it is much better to use `set encoding iso_8859_1` to change to the ISO Latin-1 encoding vector, which contains a large variety of letters with accents or other diacritical marks.) 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'.

You can access special symbols numerically by specifying character-code (in octal), e.g., {/Symbol 245} is the symbol for infinity.

You can escape control characters using , e.g., , {, and so on.

But be aware 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.

Examples (these are hard to describe in wordstry them!):

      set xlabel 'Time (10^6 {/Symbol m}s)'
      set title '{/Symbol=18 362@_{/=9.6 0}^{/=12 x}} 
                 {/Helvetica e^{-{/Symbol m}^2/2} d}{/Symbol m}'

The file "ps_guide.ps" in the /docs/ps subdirectory of the gnuplot source distribution contains more examples of the enhanced syntax.

EDITING POSTSCRIPT

The PostScript language is a very complex languagefar too complex to describe in any detail in this document. Nevertheless there are some things in a PostScript file written by gnuplot that can be changed without risk of introducing fatal errors into the file.

For example, the PostScript statement "/Color true def" (written into the file in response to the command `set terminal postscript color`), may be altered in an obvious way to generate a black-and-white version of a plot. Similarly line colors, text colors, line weights and symbol sizes can also be altered in straight-forward ways. Text (titles and labels) can be edited to correct misspellings or to change fonts. Anything can be repositioned, and of course anything can be added or deleted, but modifications such as these may require deeper knowledge of the PostScript language.

The organization of a PostScript file written by gnuplot is discussed in the text file "ps_file.doc" in the /docs/ps subdirectory."

pslatex and pstex

The `pslatex` and `pstex` drivers generate output for further processing by LaTeX and TeX, respectively. Figures generated by `pstex` can be included in any plain-based format (including LaTeX).

Syntax:

      set terminal pslatex | |pstex {} {} {}
                                    {auxfile} {}

is either `color` or `monochrome`. is either `rotate` or `norotate` and determines if the y-axis label is rotated. is used to scale the font from its usual size.

If `auxfile` is specified, it directs the driver to put the PostScript commands into an auxiliary file instead of directly into the LaTeX file. This is useful if your pictures are large enough that dvips cannot handle them. The name of the auxiliary PostScript file is derived from the name of the TeX file given on the output command; it is determined by replacing the trailing `.tex` (actually just the final extent in the file name) with `.ps` in the output file name, or, if the TeX file has no extension, `.ps` is appended. Remember to close the file before leaving gnuplot.

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:

      set term pslatex monochrome dashed rotate       # set to defaults

To write the PostScript commands into the file "foo.ps":

      set term pslatex auxfile
      set output "foo.tex"; plot ...: set output

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}'

Linewidths and pointsizes may be changed with linestyle."

pstricks

The `pstricks` driver is intended for use with the "pstricks.sty" macro package for LaTeX. It is an alternative to the `eepic` and `latex` drivers. You need "pstricks.sty", and, of course, a printer that understands PostScript, or a converter such as Ghostscript.

PSTricks is available via anonymous ftp from the /pub directory at Princeton.EDU. This driver definitely does not come close to using the full capability of the PSTricks package.

Syntax:

      set terminal pstricks {hacktext | nohacktext} {unit | nounit}

The first option invokes an ugly hack that gives nicer numbers; the second has to do with plot scaling. The defaults are `hacktext` and `nounit`."

qms

The `qms` terminal driver supports the QMS/QUIC Laser printer, the Talaris 1200 and others. It has no options."

regis

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}"

sun

The `sun` terminal driver supports the SunView window system. It has no options."

tek410x

The `tek410x` terminal driver supports the 410x and 420x family of Tektronix terminals. It has no options."

table

Instead of producing a graph, the `table` terminal prints out the points on which a graph would be based, i.e., the results of processing the plot or splot command, in a multicolumn ASCII table of X Y {Z} R values. The character R takes on one of three values: "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 labels (see `set format`).

For those times when you want the numbers, you can display them on the screen or save them to a file. This can be useful if you want to generate contours and then save them for further use, perhaps for plotting with plot; see contour for an example. The same method can be used to save interpolated data (see samples and dgrid3d)."

tek40

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; `kc-tek40xx` supports MS-DOS Kermit Tek4010 terminal emulators in color: `km-tek40xx` supports them in monochrome; `selanar` supports Selanar graphics; and `bitgraph` supports BBN Bitgraph terminals. None have any options."

texdraw

The `texdraw` terminal driver supports the LaTeX texdraw environment. It is intended for use with "texdraw.sty" and "texdraw.tex" in the texdraw package.

It has no options."

tgif

Tgif is an X11-based drawing toolit has nothing to do with GIF.

The `tgif` driver supports different pointsizes (with pointsize), different label fonts and font sizes (e.g. `set label "Hallo" at x,y font "Helvetica,34"`) and multiple graphs on the page. The proportions of the axes are not changed.

Syntax:

      set terminal tgif {portrait | landscape} {}
                        {solid | dashed}
                        {""} {}

where specifies the number of graphs in the x and y directions on the page, "" is the name of a valid PostScript font, and specifies the size of the PostScript font. Defaults are `portrait`, `[1,1]`, `dashed`, `"Helvetica"`, and `18`.

The `solid` option is usually prefered 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 ...
      set nomultiplot

See 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 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"

tkcanvas

This terminal driver generates Tk canvas widget commands based on Tcl/Tk (default) or Perl. To use it, rebuild gnuplot (after uncommenting or inserting the appropriate line in "term.h"), then

 gnuplot> set term tkcanvas {perltk} {interactive}
 gnuplot> set output 'plot.file'

After invoking "wish", execute the following sequence of Tcl/Tk commands:

 % source plot.file
 % canvas .c
 % pack .c
 % gnuplot .c

Or, for Perl/Tk use a program like this:

 use Tk;
 my $top = MainWindow->new;
 my $c = $top->Canvas;
 $c->pack();
 do "plot.pl";
 gnuplot->($c);
 MainLoop;

The code generated by gnuplot creates a procedure called "gnuplot" that takes the name of a canvas as its argument. When the procedure is called, it clears the canvas, finds the size of the canvas and draws the plot in it, scaled to fit.

For 2-dimensional plotting (plot) two additional procedures are defined: "gnuplot_plotarea" will return a list containing the borders of the plotting area "xleft, xright, ytop, ybot" in canvas screen coordinates, while the ranges of the two axes "x1min, x1max, y1min, y1max, x2min, x2max, y2min, y2max" in plot coordinates can be obtained calling "gnuplot_axisranges". If the "interactive" option is specified, mouse clicking on a line segment will print the coordinates of its midpoint to stdout. Advanced actions can happen instead if the user supplies a procedure named "user_gnuplot_coordinates", which takes the following arguments: "win id x1s y1s x2s y2s x1e y1e x2e y2e x1m y1m x2m y2m", 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.

The current version of `tkcanvas` supports neither multiplot nor replot."

tpic

The `tpic` terminal driver supports the LaTeX picture environment with tpic specials. It is an alternative to the `latex` and `eepic` terminal drivers. Options are the point size, line width, and dot-dash interval.

Syntax:

      set terminal tpic   

where 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}'"

x11

gnuplot provides the `x11` terminal type for use with X servers. This terminal type is set automatically at 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 x11 {reset} {}

Multiple plot windows are supported: `set terminal x11 ` 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 `. 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 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 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.

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:

 `-clear`   requests that the window be cleared momentarily before a
            new plot is displayed.
 `-gray`    requests grayscale rendering on grayscale or color displays.
            (Grayscale displays receive monochrome rendering by default.)
 `-mono`    forces monochrome rendering on color displays.
 `-persist` plot windows survive after main gnuplot program exits
 `-raise`   raise plot window after each plot
 `-noraise` do not raise plot window after each plot
 `-tvtwm`   requests that geometry specifications for position of the
            window be made relative to the currently displayed portion
            of the virtual root.

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 `) and a resource, `gnuplot*pointsize: `, 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.

MONOCHOME_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.

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 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, for example,

Example:

      gnuplot -background coral

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

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

 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

xlib

The `xlib` terminal driver supports the X11 Windows System. It generates gnulib_x11 commands. `set term x11` behaves similarly to `set terminal xlib; set output "|gnuplot_x11"`. `xlib` has no options, but see `x11`."

tics

The `set tics` command can be used to change the tics to be drawn outwards.

Syntax:

      set tics {}
      show tics

where may be `in` (the default) or `out`.

See also xtics for more control of major (labelled) tic marks and mxtics for control of minor tic marks.

ticslevel

Using splot, one can adjust the relative height of the vertical (Z) axis using ticslevel. The numeric argument provided specifies the location of the bottom of the scale (as a fraction of the z-range) above the xy-plane. The default value is 0.5. Negative values are permitted, but tic labels on the three axes may overlap.

To place the xy-plane at a position 'pos' on the z-axis, ticslevel should be set equal to (pos - zmin) / (zmin - zmax).

Syntax:

      set ticslevel {}
      show tics

See also view.

ticscale

The size of the tic marks can be adjusted with ticscale.

Syntax:

      set ticscale { {}}
      show tics

If is not specified, it is 0.5*. The default size is 1.0 for major tics and 0.5 for minor tics. Note that it is possible to have the tic marks pointing outward by specifying a negative size.

timestamp

The command timestamp places the time and date of the plot in the left margin.

Syntax:

      set timestamp {""} {top|bottom} {{no}rotate}
                    {}{,} {""}
      set notimestamp
      show timestamp

The format string allows you to choose the format 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 at the top or bottom of the left margin (default: bottom). `rotate` lets you write the timestamp vertically, if your terminal supports vertical text. The constants and are offsets from the default position given in character screen coordinates. is used to specify the font with which the time is to be written.

The abbreviation `time` may be used in place of timestamp.

Example:

      set timestamp "%d/%m/%y %H:%M" 80,-2 "Helvetica"

See timefmt for more information about time format strings.

timefmt

This command applies to timeseries where data are composed of dates/times. It has no meaning unless the command `set xdata time` is given also.

Syntax:

      set timefmt ""
      show timefmt

The string argument tells gnuplot how to read timedata from the datafile. The valid formats are:

      Format       Explanation
      %d           day of the month, 131
      %m           month of the year, 112
      %y           year, 099
      %Y           year, 4-digit
      %j           day of the year, 1365
      %H           hour, 024
      %M           minute, 060
      %S           second, 060
      %b           three-character abbreviation of the name of the month
      %B           name of the month

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, %Y reads four digits and %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.

Since gnuplot cannot read non-numerical text, 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: see `set format` for more details about these and other options for printing timedata. (gnuplot will determine the proper month and weekday from the numerical values.)

See also xdata and `Time/date` for more information.

Example:

      set timefmt "%d/%m/%Yt%H:%M"

tells gnuplot to read date and time separated by tab. (But look closely at your datawhat 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.) Time Data Demo

title

The `set title` command produces a plot title that is centered at the top of the plot. `set title` is a special case of label.

Syntax:

      set title {""} {}{,} {",{}"}
      show title

Specifying constants or as optional offsets for the title will move the title or character screen coordinates (not graph coordinates). For example, "`set title ,-1`" will change only the y offset of the title, moving the title down by roughly the height of one character.

is used to specify the font with which the title is to be written; the units of the font depend upon which terminal is used.

`set 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.

tmargin

The command tmargin sets the size of the top margin. Please see margin for details.

trange

The trange command sets the parametric range used to compute x and y values when in parametric or polar modes. Please see xrange for details.

urange

The urange and vrange commands set the parametric ranges used to compute x, y, and z values when in splot parametric mode. Please see xrange for details.

variables

The variables command lists all user-defined variables and their values.

Syntax:

      show variables

version

The version command lists the version of gnuplot being run, its last modification date, the copyright holders, and email addresses for the FAQ, the info-gnuplot mailing list, and reporting bugs-in short, the information listed on the screen when the program is invoked interactively.

Syntax:

      show version {long}

When the `long` option is given, it also lists the operating system, the compilation options used when gnuplot was installed, the location of the help file, and (again) the useful email addresses.

view

The view command sets the viewing angle for splots. It controls how the 3-d coordinates of the plot are mapped into the 2-d screen space. It provides controls for both rotation and scaling of the plotted data, but supports orthographic projections only.

Syntax:

      set view  {,{}{,{}{,}}}
      show view

where and control the rotation angles (in degrees) in a virtual 3-d 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 around the x axis. The second rotation applied is around the new z axis.

is bounded to the [0:180] range with a default of 60 degrees, while is bounded to the [0:360] range with a default of 30 degrees. controls the scaling of the entire splot, while 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.

See also ticslevel.

vrange

The urange and vrange commands set the parametric ranges used to compute x, y, and z values when in splot parametric mode. Please see xrange for details.

x2data

The x2data command sets data on the x2 (top) axis to timeseries (dates/times). Please see xdata.

x2dtics

The x2dtics command changes tics on the x2 (top) axis to days of the week. Please see xdtics for details.

x2label

The x2label command sets the label for the x2 (top) axis. Please see xlabel.

x2mtics

The x2mtics command changes tics on the x2 (top) axis to months of the year. Please see xmtics for details.

x2range

The x2range command sets the horizontal range that will be displayed on the x2 (top) axis. Please see xrange for details.

x2tics

The x2tics command controls major (labelled) tics on the x2 (top) axis. Please see xtics for details.

x2zeroaxis

The x2zeroaxis command draws a line at the origin of the x2 (top) axis (y2 = 0). For details, please see zeroaxis.

xdata

This command sets the datatype on the x axis to time/date. A similar command does the same thing for each of the other axes.

Syntax:

      set xdata {time}
      show xdata

The same syntax applies to ydata, zdata, x2data and y2data.

The `time` option signals that the datatype is indeed time/date. If the option is not specified, the datatype reverts to normal.

See timefmt to tell gnuplot how to read date or time data. The time/date is converted to seconds from start of the century. There is currently only one timefmt, which implies that all the time/date columns must confirm to this format. Specification of ranges should be supplied as quoted strings according to this format to avoid interpretation of the time/date as an expression.

The function 'strftime' (type "man strftime" on unix to look it up) is used to print tic-mark labels. gnuplot tries to figure out a reasonable format for this unless the `set format x "string"` has supplied something that does not look like a decimal format (more than one '%' or neither %f nor %g).

See also `Time/date` for more information.

xdtics

The 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
      set noxdtics
      show xdtics

The same syntax applies to ydtics, zdtics, x2dtics and y2dtics.

See also the `set format` command.

xlabel

The xlabel command sets the x axis label. Similar commands set labels on the other axes.

Syntax:

      set xlabel {""} {}{,} {"{,}"}
      show xlabel

The same syntax applies to x2label, ylabel, y2label and zlabel.

Specifying the constants or as optional offsets for a label will move it or character widths or heights. For example, "` set xlabel -1`" will change only the x offset of the xlabel, moving the label roughly one character width to the left. The size of a character depends on both the font and the terminal.

is used to specify the font in which the label is written; the units of the font depend upon which terminal is used.

To clear a label, put no options on the command line, e.g., "y2label".

The default positions of the axis labels are as follows:

xlabel: The x-axis label is centered below the bottom axis.

ylabel: The position of the y-axis label depends on the terminal, and can be one of the following three positions:

1. Horizontal text flushed left at the top left of the plot. Terminals that cannot rotate text will probably use this method. If x2tics is also in use, the ylabel may overwrite the left-most x2tic label. This may be remedied by adjusting the ylabel position or the left margin.

2. Vertical text centered vertically at the left of the plot. Terminals that can rotate text will probably use this method.

3. Horizontal text centered vertically at the left of the plot. The EEPIC, LaTeX and TPIC drivers use this method. The user must insert line breaks using to prevent the ylabel from overwriting the plot. To produce a vertical row of characters, add between every printing character (but this is ugly).

zlabel: The z-axis label is centered along the z axis and placed in the space above the grid level.

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 top axis but below the plot 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 titlennThis is the x2label"

Note that double quotes must be used. The same font will be used for both lines, of course.

If you are not satisfied with the default position of an axis label, use label instead-that command gives you much more control over where text is placed.

Please see `set syntax` for further information about backslash processing and the difference between single- and double-quoted strings.

xmtics

The xmtics commands 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 `set noxmtics`. Similar commands perform the same duties for the other axes.

Syntax:

      set xmtics
      set noxmtics
      show xmtics

The same syntax applies to x2mtics, ymtics, y2mtics, and zmtics.

See also the `set format` command.

xrange

The 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 [{{}:{}}] {{no}reverse} {{no}writeback}
      show xrange

where and 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 timefmt format. Any value omitted will not be changed.

The same syntax applies to yrange, zrange, x2range, y2range, rrange, trange, urange and vrange.

The `reverse` option reverses the direction of the axis, e.g., `set xrange [0:1] reverse` will produce an axis with 1 on the left and 0 on the right. This is identical to the axis produced by `set xrange [1:0]`, of course. `reverse` is intended primarily for use with autoscale.

The `writeback` option essentially saves the range found by autoscale in the buffers that would be filled by 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. For example,

      set xrange [-10:10]
      set yrange [] writeback
      plot sin(x)
      set noautoscale y
      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 yrange after each command in the above example should help you understand what is going on.

In 2-d, xrange and yrange determine the extent of the axes, trange determines the range of the parametric variable in parametric mode or the range of the angle in polar mode. Similarly in parametric 3-d, xrange, yrange, and zrange govern the axes and urange and vrange govern the parametric variables.

In polar mode, rrange determines the radial range plotted. acts as an additive constant to the radius, whereas acts as a clip to the radiusno point with radius greater than will be plotted. xrange and yrange are affectedthe 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.

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 [*:]

xtics

Fine control of the major (labelled) tics on the x axis is possible with the xtics command. The tics may be turned off with the `set noxtics` command, and may be turned on (the default state) with xtics. Similar commands control the major tics on the y, z, x2 and y2 axes.

Syntax:

      set xtics {axis | border} {{no}mirror} {{no}rotate}
                {  autofreq
                 | 
                 | ,  {,}
                 | ({""}  {,{""} }...) }
      set noxtics
      show xtics

The same syntax applies to ytics, ztics, x2tics and y2tics.

`axis` or 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 can result in tic labels overwriting other text written in the margin.

`mirror` tells gnuplot to put unlabelled tics at the same positions on the opposite border. `nomirror` does what you think it does.

`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.

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 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 border. 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.

Positions of the tics are calculated automatically by default or if the `autofreq` option is given; otherwise they may be specified in either of two forms:

The implicit , , form specifies that a series of tics will be plotted on the axis between the values and with an increment of . If is not given, it is assumed to be infinity. The increment may be negative. If neither nor is given, is assumed to be negative infinity, is assumed to be positive infinity, and the tics will be drawn at integral multiples of . If the axis is logarithmic, the increment will be used as a multiplicative factor.

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,10e8

The explicit ("" , ...) form allows arbitrary tic positions or non-numeric tic labels. A set of tics is a set of positions, each with its own optional label. Note that the label is a string enclosed by quotes. It may be a constant string, such as "hello", may contain formatting information for converting the position into its label, such as "%3f clients", or may be empty, "". See `set format` for more information. If no string is given, the default label (numerical) is used. In this form, the tics do not need to be listed in numerical order.

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)

In the second example, all tics are labelled. In the third, only the end tics are labelled.

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 labels is included in the `set xtic (``)` form.

Minor (unlabelled) tics can be added by the mxtics command.

In case of timeseries data, position values must be given as quoted dates or times according to the format timefmt. If the , , form is used, and must be given according to timefmt, but must be in seconds. Times will be written out according to the format given on `set format`, however.

Examples:

      set xdata time
      set timefmt "%d/%m"
      set format x "%b %d"
      set xrange ["01/12":"06/12"]
      set xtics "01/12", 172800, "05/12"

      set xdata time
      set timefmt "%d/%m"
      set format x "%b %d"
      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 unlabelled.

xzeroaxis

The xzeroaxis command draws a line at y = 0. For details, please see zeroaxis.

y2data

The y2data command sets y2 (right-hand) axis data to timeseries (dates/times). Please see xdata.

y2dtics

The y2dtics command changes tics on the y2 (right-hand) axis to days of the week. Please see xdtics for details.

y2label

The y2dtics command sets the label for the y2 (right-hand) axis. Please see xlabel.

y2mtics

The y2mtics command changes tics on the y2 (right-hand) axis to months of the year. Please see xmtics for details.

y2range

The y2range command sets the vertical range that will be displayed on the y2 (right-hand) axis. Please see xrange for details.

y2tics

The y2tics command controls major (labelled) tics on the y2 (right-hand) axis. Please see xtics for details.

y2zeroaxis

The y2zeroaxis command draws a line at the origin of the y2 (right-hand) axis (x2 = 0). For details, please see zeroaxis.

ydata

Sets y-axis data to timeseries (dates/times). Please see xdata.

ydtics

The ydtics command changes tics on the y axis to days of the week. Please see xdtics for details.

ylabel

This command sets the label for the y axis. Please see xlabel.

ymtics

The ymtics command changes tics on the y axis to months of the year. Please see xmtics for details.

yrange

The yrange command sets the vertical range that will be displayed on the y axis. Please see xrange for details.

ytics

The ytics command controls major (labelled) tics on the y axis. Please see xtics for details.

yzeroaxis

The yzeroaxis command draws a line at x = 0. For details, please see zeroaxis.

zdata

Set zaxis date to timeseries (dates/times). Please see xdata.

zdtics

The zdtics command changes tics on the z axis to days of the week. Please see xdtics for details.

zero

The `zero` value is the default threshold for values approaching 0.0.

Syntax:

      set zero 
      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.

zeroaxis

The x axis may be drawn by xzeroaxis and removed by `set noxzeroaxis`. Similar commands behave similarly for the y, x2, and y2 axes.

Syntax:

      set {x|x2|y|y2|}zeroaxis { {linestyle | ls }
                                 | { linetype | lt }
                                   { linewidth | lw }}
      set no{x|x2|y|y2|}zeroaxis
      show {x|y|}zeroaxis

By default, these options are off. The selected zero axis is drawn with a line of type and width (if supported by the terminal driver currently in use), or a user-defined style .

If no linetype is specified, any zero axes selected will be drawn using the axis linetype (linetype 0).

`set zeroaxis l` is equivalent to `set xzeroaxis l; set yzeroaxis l`. `set nozeroaxis` is equivalent to `set noxzeroaxis; set noyzeroaxis`.

zlabel

This command sets the label for the z axis. Please see xlabel.

zmtics

The zmtics command changes tics on the z axis to months of the year. Please see xmtics for details.

zrange

The 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 xrange for details.

ztics

The ztics command controls major (labelled) tics on the z axis. Please see xtics for details.

shell

Команда shell запускает интерактивный командный процессор (shell) операционной системы. Чтобы вернуться обратно в `gnuplot`, введите `logout` в VMS, exit или символ конца файла в Unix, `endcli` в AmigaOS или exit в MS-DOS или OS/2.

Отдельная команда интерпретатора может быть запущена, если перед ней поставить символ ! ($ в VMS) в начале командной строки. После выполнения команды управление сразу же передается gnuplot. Например, в Unix, AmigaOS, MS-DOS или OS/2,

      ! dir

напечатает содержимое директории и затем вернется в gnuplot.

На Atari, команда `!` сначала проверяет, загружен ли уже интерпретатор и использует его, если возможно. Это полезно, например, если gnuplot запущен из `gulam`.

splot

splot - команда для построения трехмерных графиков (точнее, их двумерных проекций на плоскость экрана). Эта команда может строить графики по функциям или файлам данных, аналогичным образом, что и команда plot.

See plot for features common to the plot command; only differences are discussed in detail here. Note specifically that the binary and matrix options (discussed under "datafile-modifiers") are not available for plot.

Syntax:

      splot {}
             | "" {datafile-modifiers}}
            {} {with 

where either a or the name of a data file enclosed in quotes is supplied. The function can be a mathematical expression, or a triple of mathematical expressions in parametric mode.

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 ticslevel. The orientation of a splot projection is controlled by view. See view and ticslevel for more information.

The syntax for setting ranges on the splot command is the same as for plot. In non-parametric mode, the order in which ranges must be given is xrange, yrange, and zrange. In parametric mode, the order is urange, vrange, xrange, yrange, and zrange.

The `title` option is the same as in plot. The operation of with is also the same as in plot, except that the plotting styles available to splot are limited to `lines`, `points`, linespoints, dots, and impulses; the error-bar capabilities of plot are not available for splot.

The datafile options have more differences.

• data-file_
• grid_data
• splot_overview

data-file

As for plot, discrete data contained in a file can be displayed by specifying the name of the data file, enclosed in quotes, on the splot command line.

Syntax:

      splot '' {binary | matrix}
                          {index }
                          {every }
                          {using }

The special filenames `""` and `"-"` are permitted, as in plot.

In brief, binary and matrix indicate that the the data are in a special form, index selects which data sets in a multi-data-set file are to be plotted, every specifies which datalines (subsets) within a single data set are to be plotted, and using determines how the columns within a single record are to be interpreted.

The options index and 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 options thru and smooth are not available for splot, but `cntrparams` and dgrid3d provide limited smoothing cabilities.

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 datablock number will be used for y, and the index of the data point in the datablock will be used for x. If two values are provided, gnuplot gives you an error message. Three values are interpreted as an (x,y,z) triple. Additional values are generally used as errors, which can be used by fit.

Single blank records separate datablocks in a splot datafile; splot treats datablocks as the equivalent of function y-isolines. No line will join points separated by a blank record. If all datablocks contain the same number of points, gnuplot will draw cross-isolines between datablocks, connecting corresponding points. This is termed "grid data", and is required for drawing a surface, for contouring (contour) and hidden-line removal (hidden3d). See also `splot grid data`

It is no longer necessary to specify `parametric` mode for three-column splots.

• binary
• example_datafile_
• matrix

binary

splot can read binary files written with a specific format (and on a system with a compatible binary file representation.)

In previous versions, gnuplot dynamically detected binary data files. It is now necessary to specify the keyword binary directly after the filename.

Single precision floats are stored in a binary file as follows:

                ...  

           ... 
           ... 

        :      :      :      :   ...    :

which are converted into triplets:

        
        

        
       :    :     :
        

        
        
       :    :     :

These triplets are then converted into gnuplot iso-curves and then gnuplot proceeds in the usual manner to do the rest of the plotting.

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`.

The index keyword is not supported, since the file format allows only one surface per file. The every and using filters are supported. using operates as if the data were read in the above triplet form. Binary File Splot Demo.

example datafile

A simple example of plotting a 3-d 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 (datablocks) 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 datablock, 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 datablock. 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.

matrix

The matrix flag indicates that the ASCII data are stored in matrix format. 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. The row and column indices are used for the x- and y-values.

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 isosamples, or reading a datafile, see `splot 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 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 datablock, then "isolines" will connect the points in a datablock, and "cross-isolines" will connect the corresponding points in each datablock 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 converted to a {different} grid format with 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 function style 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

splot_overview

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 isosamples. The surface may be approximated by connecting the points with straight line segments, see 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 view.

Additionally, for points in a grid format, splot can interpolate points having a common amplitude (see contour) and can then connect those new points to display contour lines, either directly with straight-line segments or smoothed lines (see `set cntrparams`). Functions are already evaluated in a grid format, determined by isosamples and samples, while file data must either be in a grid format, as described in `data-file`, or be used to generate a grid (see 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.

test

Команда test создает изображение стилей линий и маркеров и других полезных вещей, присущих текущему графическому терминалу.

Синтаксис:

      test

update

Эта команда записывает текущие значения параметров аппроксимации (fit) в заданный файл, форматированный как файл начальных значений (как описано в секции `fit`). Это нужно для сохранения текущих значений для дальнейшего использования или для перезапуска аппроксимации, которая сошлась или была остановлена.

Синтаксис:

      update  {}

Если указано второе имя файла, обновленные значения записываются в этот файл, а исходный файл параметров остается неизменным.

Иначе, если файл уже существует, gnuplot сначала переименовывает его, добавляя расширение `.old` и затем открывает новый файл. Поэтому "`update 'fred'`" ведет себя так же, как "`!rename fred fred.old; update 'fred.old' 'fred'`". [В DOS и других системах, которые используют 12-ти символьные имена файлов "filename.ext", "ext" будет "`old`" и "filename" будет соответствовать (надеемся) исходному имени. Переименование не выполняется вообще в системах VMS, т.к. они используют версификацию файлов (file-versioning).]

См. fit подробнее об аппроксимации.

Графические интерфейсы пользователя

Several graphical user interfaces have been written for gnuplot and one for win32 is included in this distribution. In addition, there is a Macintosh interface at ftp://ftp.ee.gatech.edu/pub/mac/gnuplot and several X11 interfaces include three Tcl/Tk located at the usual Tcl/Tk repositories.

Bugs

Floating point exceptions (floating point number too large/small, divide by zero, etc.) may occasionally be generated by user defined functions. Some of the demos in particular may cause numbers to exceed the floating point range. Whether the system ignores such exceptions (in which case gnuplot labels the corresponding point as undefined) or aborts gnuplot depends on the compiler/runtime environment.

The bessel functions do not work for complex arguments.

The gamma function does not work for complex arguments.

As of gnuplot version 3.7, all development has been done using ANSI C. With current operating system, compiler, and library releases, the OS specific bugs documented in release 3.5, now relegated to `old_bugs`, may no longer be relevant.

Bugs reported since the current release may be located via the official distribution site:

       ftp://ftp.dartmouth.edu/pub/gnuplot
      http://www.cs.dartmouth.edu/gnuplot_info.html

Please e-mail any bugs to [email protected].

• Old_bugs

Old_bugs

There is a bug in the stdio library for old Sun operating systems (SunOS Sys4-3.2). The "%g" format for 'printf' sometimes incorrectly prints numbers (e.g., 200000.0 as "2"). Thus, tic mark labels may be incorrect on a Sun4 version of gnuplot. A work-around is to rescale the data or use the `set format` command to change the tic mark format to "%7.0f" or some other appropriate format. This appears to have been fixed in SunOS 4.0.

Another bug: On a Sun3 under SunOS 4.0, and on Sun4's under Sys4-3.2 and SunOS 4.0, the 'sscanf' routine incorrectly parses "00 12" with the format "%f %f" and reads 0 and 0 instead of 0 and 12. This affects data input. If the data file contains x coordinates that are zero but are specified like '00', '000', etc, then you will read the wrong y values. Check any data files or upgrade the SunOS. It appears to have been fixed in SunOS 4.1.1.

Suns appear to overflow when calculating exp(-x) for large x, so gnuplot gets an undefined result. One work-around is to make a user-defined function like e(x) = x

Microsoft C 5.1 has a nasty bug associated with the %g format for 'printf'. When any of the formats "%.2g", "%.1g", "%.0g", "%.g" are used, 'printf' will incorrectly print numbers in the range 1e-4 to 1e-1. Numbers that should be printed in the %e format are incorrectly printed in the %f format, with the wrong number of zeros after the decimal point. To work around this problem, use the %e or %f formats explicitly.

gnuplot, when compiled with Microsoft C, did not work correctly on two VGA displays that were tested. The CGA, EGA and VGA drivers should probably be rewritten to use the Microsoft C graphics library. gnuplot compiled with Borland C++ uses the Turbo C graphics drivers and does work correctly with VGA displays.

VAX/VMS 4.7 C compiler release 2.4 also has a poorly implemented %g format for 'printf'. The numbers are printed numerically correct, but may not be in the requested format. The K&R second edition says that for the %g format, %e is used if the exponent is less than -4 or greater than or equal to the precision. The VAX uses %e format if the exponent is less than -1. The VAX appears to take no notice of the precision when deciding whether to use %e or %f for numbers less than 1. To work around this problem, use the %e or %f formats explicitly. From the VAX C 2.4 release notes: e,E,f,F,g,G Result will always contain a decimal point. For g and G, trailing zeros will not be removed from the result.

VAX/VMS 5.2 C compiler release 3.0 has a slightly better implemented %g format than release 2.4, but not much. Trailing decimal points are now removed, but trailing zeros are still not removed from %g numbers in exponential format.

The two preceding problems are actually in the libraries rather than in the compilers. Thus the problems will occur whether gnuplot is built using either the DEC compiler or some other one (e.g. the latest gcc).

ULTRIX X11R3 has a bug that causes the X11 driver to display "every other" graph. The bug seems to be fixed in DEC's release of X11R4 so newer releases of ULTRIX don't seem to have the problem. Solutions for older sites include upgrading the X11 libraries (from DEC or direct from MIT) or defining ULTRIX_KLUDGE when compiling the x11.trm file. Note that the kludge is not an ideal fix, however.

The constant HUGE was incorrectly defined in the NeXT OS 2.0 operating system. HUGE should be set to 1e38 in plot.h. This error has been corrected in the 2.1 version of NeXT OS.

Some older models of HP plotters do not have a page eject command 'PG'. The current HPGL driver uses this command in HPGL_reset. This may need to be removed for these plotters. The current PCL5 driver uses HPGL/2 for text as well as graphics. This should be modified to use scalable PCL fonts.

On the Atari version, it is not possible to send output directly to the printer (using `/dev/lp` as output file), since CRs are added to LFs in binary output. As a work-around, write the output to a file and copy it to the printer afterwards using a shell command.

On AIX 4, the literal 'NaNq' in a datafile causes the special internal value 'not-a-number' to be stored, rather than setting an internal 'undefined' flag. A workaround is to use `set missing 'NaNq'`.

There may be an up-to-date list of bugs since the release on the WWW page:

      http://www.cs.dartmouth.edu/gnuplot_info.html

Please report any bugs to [email protected].

Concept Index

Command Index

Options Index

Function Index

Terminal Index

Table of Contents

• Master Menu
• gnuplot
  • Copyright
  • Introduction
  • Seeking-assistance
  • What's New in version 3.7
  • Batch/Interactive Operation
  • Command-line-editing
  • Comments
  • Coordinates
  • Environment
  • Expressions
    • Functions
      • abs
      • acos
      • acosh
      • arg
      • asin
      • asinh
      • atan
      • atan2
      • atanh
      • besj0
      • besj1
      • besy0
      • besy1
      • ceil
      • cos
      • cosh
      • erf
      • erfc
      • exp
      • floor
      • gamma
      • ibeta
      • inverf
      • igamma
      • imag
      • invnorm
      • int
      • lgamma
      • log
      • log10
      • norm
      • rand
      • real
      • sgn
      • sin
      • sinh
      • sqrt
      • tan
      • tanh
      • column
      • tm_hour
      • tm_mday
      • tm_min
      • tm_mon
      • tm_sec
      • tm_wday
      • tm_yday
      • tm_year
      • valid
    • Operators
      • Unary
      • Binary
      • Ternary
    • User-defined
  • Glossary
  • Plotting
  • Start-up
  • Substitution
  • Syntax
  • Time/Date data
• Commands
  • cd
  • call
  • clear
  • exit
  • fit
    • adjustable parameters
    • beginner's guide
    • error estimates
      • statistical overview
      • practical guidelines
    • fit controlling
      • control variables
      • environment variables
    • multi-branch
    • starting values
    • tips
  • help
  • if
  • load
  • pause
  • plot
    • data-file
      • every
      • example datafile
      • index
      • smooth
      • special-filenames
      • thru
      • using
    • errorbars
    • parametric
    • ranges
    • title
    • with
  • print
  • pwd
  • quit
  • replot
  • reread
  • reset
  • save
  • set-show
    • angles
    • arrow
    • autoscale
      • parametric mode
      • polar mode
    • bar
    • bmargin
    • border
    • boxwidth
    • clabel
    • clip
    • cntrparam
    • contour
    • data style
    • dgrid3d
    • dummy
    • encoding
    • format
      • format specifiers
      • time/date specifiers
    • function style
    • functions
    • grid
    • hidden3d
    • isosamples
    • key
    • label
    • linestyle
    • lmargin
    • locale
    • logscale
    • mapping
    • margin
    • missing
    • multiplot
    • mx2tics
    • mxtics
    • my2tics
    • mytics
    • mztics
    • offsets
    • origin
    • output
    • parametric
    • pointsize
    • polar
    • rmargin
    • rrange
    • samples
    • size
    • style
      • boxerrorbars
      • boxes
      • boxxyerrorbars
      • candlesticks
      • dots
      • financebars
      • fsteps
      • histeps
      • impulses
      • lines
      • linespoints
      • points
      • steps
      • vector
      • xerrorbars
      • xyerrorbars
      • yerrorbars
    • surface
    • terminal
      • aifm
      • cgm
      • corel
      • dumb
      • dxf
      • eepic
      • epson-180dpi
      • fig
      • gif
      • gpic
      • hp2623a
      • hp2648
      • hp500c
      • hpgl
      • hpljii
      • hppj
      • imagen
      • latex
      • mf
      • mif
      • pbm
      • png
      • postscript
      • pslatex and pstex
      • pstricks
      • qms
      • regis
      • sun
      • tek410x
      • table
      • tek40
      • texdraw
      • tgif
      • tkcanvas
      • tpic
      • x11
      • xlib
    • tics
    • ticslevel
    • ticscale
    • timestamp
    • timefmt
    • title
    • tmargin
    • trange
    • urange
    • variables
    • version
    • view
    • vrange
    • x2data
    • x2dtics
    • x2label
    • x2mtics
    • x2range
    • x2tics
    • x2zeroaxis
    • xdata
    • xdtics
    • xlabel
    • xmtics
    • xrange
    • xtics
    • xzeroaxis
    • y2data
    • y2dtics
    • y2label
    • y2mtics
    • y2range
    • y2tics
    • y2zeroaxis
    • ydata
    • ydtics
    • ylabel
    • ymtics
    • yrange
    • ytics
    • yzeroaxis
    • zdata
    • zdtics
    • zero
    • zeroaxis
    • zlabel
    • zmtics
    • zrange
    • ztics
  • shell
  • splot
    • data-file
      • binary
      • example datafile
      • matrix
    • grid_data
    • splot_overview
  • test
  • update
• Graphical User Interfaces
• Bugs
  • Old_bugs
• Concept Index
• Command Index
• Options Index
• Function Index
• Terminal Index