Командная строка

Все программы Graphviz вызываются похожим образом:

cmd [ flags ] [ input files ]

Например:

$ dot -Tsvg input.dot

Если входные файлы не указаны, программа читает данные из stdin. Например:

$ echo 'digraph { a -> b }' | dot -Tsvg > output.svg

Создаёт:

Флаги

-Gname[=value]

Задать атрибут графа; значение value по умолчанию = true

Например,

$ echo 'digraph { a -> b }' | dot -Tsvg -Gfontcolor=red -Glabel="My favorite letters"

Переопределяет атрибуты графа fontcolor и label по умолчанию, создавая красную легенду:

-Nname[=value]

Задать атрибут узла по умолчанию; значение value по умолчанию = true.

Например,

$ echo 'digraph { a -> b }' | dot -Tsvg -Nfontcolor=red -Nshape=rect

Переопределяет атрибуты узла fontcolor и shape по умолчанию, создавая прямоугольные узлы с красным текстом:

-Ename[=value]

Задать атрибут ребра по умолчанию; значение value по умолчанию = true.

Например,

$ echo 'digraph { a -> b }' | dot -Tsvg -Ecolor=red -Earrowhead=diamond

Переопределяет атрибуты ребра color и arrowhead по умолчанию, создавая красные рёбра с ромбовидным наконечником стрелки:

-Klayout

Указывает, какой механизм компоновки использовать по умолчанию, переопределяя значение, заданное именем команды. Например, запуск dot -Kneato эквивалентен запуску neato.

-Tformat[:renderer[:formatter]]

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

В зависимости от способа сборки Graphviz для создания определённого формата вывода может быть доступно несколько средств визуализации, а для подготовки окончательного результата — несколько средств форматирования. Например, типичная установка может создавать вывод в формате PNG с помощью библиотеки Cairo или GD. Требуемый механизм визуализации можно указать после двоеточия. Если доступно несколько механизмов форматирования, нужный можно указать аналогичным образом после механизма визуализации. Таким образом, -Tpng:cairo задаёт вывод PNG, созданный средствами Cairo (с использованием форматировщика Cairo по умолчанию), а -Tpng:cairo:gd задаёт вывод PNG, созданный средствами Cairo и отформатированный с помощью библиотеки GD.

Если средство визуализации не указано или указано средство визуализации без средства форматирования, используется значение по умолчанию. Флаг -Tformat: выводит список всех средств визуализации, доступных для указанного format; первое в списке средство с префиксом, совпадающим с format, используется по умолчанию. Флаг -v, описанный ниже, выводит сведения о фактически используемых формате, средстве визуализации и средстве форматирования.

-V

Вывести сведения о версии и завершить работу. Например:

$ dot -V
dot - graphviz version 2.47.1 (20210417.1919)

-llibrary

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

Для вывода PostScript они рассматриваются как имена файлов; их содержимое включается в преамбулу после стандартной преамбулы. Если library — пустая строка "", стандартная преамбула не выводится.

-n[num]

Устанавливает флаг no-op в neato. Если флаг установлен, neato предполагает, что узлы уже размещены и у всех узлов есть атрибут pos, задающий их координаты. Затем программа при необходимости корректирует компоновку, чтобы устранить перекрытия узлов, в зависимости от значения атрибута overlap, вычисляет компоновку рёбер в зависимости от значения атрибута splines и выводит граф в соответствующем формате. Если задано значение num, выполняются следующие действия:

num = 1

Эквивалентно -n.

num > 1

Использовать заданные положения узлов без корректировки для устранения перекрытий узлов, а также использовать все уже заданные варианты компоновки рёбер из атрибута pos. neato вычисляет компоновку для рёбер без атрибута pos. Как обычно, компоновка рёбер определяется атрибутом splines.

-ooutfile

Записать вывод в файл outfile. Например,

$ echo 'digraph { a -> b }' | dot -Tsvg -o output.svg

Создаёт файл output.svg:

По умолчанию вывод направляется в stdout.

-O

Автоматически создавать имена выходных файлов на основе имени входного файла и форматов вывода, заданных флагами -T.

Например,

$ dot -Tsvg -O ~/family.dot ~/debug.dot

Создаёт файлы ~/family.dot.svg и ~/debug.dot.svg.

-P

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

$ dot -P -Tsvg -o plugins.svg

-q

Подавлять предупреждения.

-s[scale]

Задать масштаб входных данных scale. Если значение не указано, используется 72.0. Это число используется для преобразования единиц координат в пунктах, применяемых в атрибуте pos, в дюймы — именно в них задаются координаты для neato и fdp. Поэтому для передачи вывода программы компоновки графов в neato или fdp почти всегда требуется этот флаг. Игнорируется, если используется флаг -n.

-v

Подробный режим

-x

В neato, при чтении входных данных, удалять изолированные узлы и тупиковые ветви. Это удаляет не представляющие интереса элементы структуры графа и делает изображение менее загромождённым.

-y

По умолчанию в универсальных форматах вывода, таких как dot с атрибутами, расширенный dot, plain и plain-ext, используется стандартная декартова система координат с началом координат в левом нижнем углу; координата y увеличивается при движении точек снизу вверх. При использовании флага -y система координат инвертируется: увеличение значения y соответствует движению сверху вниз.

-?

Вывести справочную информацию и завершить работу.

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

Обратите внимание, что флаги -G, -N и -E переопределяют все начальные объявления атрибутов во входном графе, то есть объявления атрибутов, расположенные до любых определений узлов, рёбер или подграфов. Кроме того, эти флаги приводят к постоянному добавлению соответствующих атрибутов в граф. Поэтому при выводе в формате dot с атрибутами граф будет содержать эти атрибуты.

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

GDFONTPATH

Список путей к каталогам, в которых программа должна искать шрифты. Переопределяется переменной DOTFONTPATH. Используется только в сборках Graphviz без библиотеки fontconfig

DOTFONTPATH

Список путей к каталогам, в которых программа должна искать шрифты. Переопределяется атрибутом fontpath. Используется только в сборках Graphviz без библиотеки fontconfig

SERVER_NAME

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

GVBINDIR

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