Note

This documents the development version of PyGraphviz. Documentation for the current release can be found here.

安装¶

PyGraphviz要求：

Python(版本3.9、3.10或3.11)
Graphviz (版本2.46或更高版本)
C/C++编译器

备注

这些说明假定您的计算机上安装了Python和C/C++编译器。

警告

不要使用默认通道来安装 conda 。应改用Conda-Forge通道：：

conda install --channel conda-forge pygraphviz

推荐¶

我们建议使用以下方式安装Python包 pip and virtual environments 。

Linux操作系统¶

我们建议使用您的Linux系统的包管理器安装Graphviz。下面是一些流行的发行版的示例。

Ubuntu和Debian¶

$ sudo apt-get install graphviz graphviz-dev
$ pip install pygraphviz

软呢帽和红帽子¶

您可能需要更换 dnf 使用 yum 在下面的示例中。

$ sudo dnf install graphviz graphviz-devel
$ pip install pygraphviz

MacOS¶

我们建议使用Homebrew包管理器或MacPorts for MacOS安装Graphviz。

自制酒¶

$ brew install graphviz
$ pip install pygraphviz

备注

Graphviz可能安装在不在默认搜索路径上的位置。在这种情况下，可能需要手动指定GRAPVIZ INCLUDE和/或库目录的路径，例如：

pip install --use-pep517 \
            --config-setting="--global-option=build_ext" \
            --config-setting="--build-option=-I$(brew --prefix graphviz)/include/" \
            --config-setting="--build-option=-L$(brew --prefix graphviz)/lib/" \
            pygraphviz

有关详细信息，请参阅高级部分。

MacPorts¶

$ port install graphviz
$ pip install pygraphviz
$ pip install --use-pep517 \
              --config-setting="--global-option=build_ext" \
              --config-setting="--global-option="-I/opt/local/include/" \
              --config-setting="--global-option="-L/opt/local/lib/" \
              pygraphviz

高级¶

主要的两个困难是

安装Graphviz和
通知pip安装Graphviz的位置。

提供通向Graphviz的路径¶

如果您已安装Graphviz和 pip 无法找到Graphviz，则需要提供 pip 带着小路(S)，在那里它可以找到格拉夫维兹。为此，您首先需要找出Graphviz的二进制文件、包括文件和库文件在您的文件系统中的位置。

一旦您知道了Graphviz的安装位置，您将需要执行如下操作。页面下方还有一个在Windows上使用巧克力的额外例子。

窗口¶

从历史上看，在Windows上安装Graphviz和PyGraphviz一直是一件具有挑战性的事情。幸运的是，Graphviz开发人员正在努力解决这个问题，他们最近发布的版本极大地改善了这种情况。

因此，在Windows上，PyGraphviz 1.7仅支持Graphviz 2.46.0或更高版本。我们建议您手动安装Graphviz的官方二进制版本，或者使用 Chocolatey ，已更新到Graphviz 2.46.0。

您可能还需要安装Visual C/C++，例如从此处：https://visualstudio.microsoft.com/visual-cpp-build-tools/

假设您已经安装了Python和Visual C/C++，我们相信下面的代码应该可以在使用PowerShell的Windows 10(64位)上运行。

手动下载¶

下载并安装2.46.0 for Windows 10(64位)： stable_windows_10_cmake_Release_x64_graphviz-install-2.46.0-win64.exe 。
通过以下方式安装PyGraphviz

PS C:\> python -m pip install --use-pep517 `
              --config-setting="--global-option=build_ext" `
              --config-setting="--global-option="-IC:\Program Files\Graphviz\include" `
              --config-setting="--global-option="-LC:\Program Files\Graphviz\lib" `
              pygraphviz

巧克力味¶

PS C:\> choco install graphviz
PS C:\> python -m pip install --use-pep517 `
              --config-setting="--global-option=build_ext" `
              --config-setting="--global-option="-IC:\Program Files\Graphviz\include" `
              --config-setting="--global-option="-LC:\Program Files\Graphviz\lib" `
              pygraphviz

FAQ¶

Q:
我按照安装说明操作，但是当我这样做时：
>>> import pygraphviz
我收到如下错误：

ImportError: libagraph.so.1: cannot open shared object file: No such file or directory

怎么啦？
A:
有些Unix系统在运行时链接器的默认搜索路径中不包括Graphviz库。路径通常类似于 /usr/lib/graphviz 或 /sw/lib/graphviz 等，并且需要将其添加到您的搜索路径中。在*nIX系统上，执行此操作的首选方法是在构建/安装时设置适当的标志 pygraphviz 。例如，如果Graphviz库安装在 /opt/lib/mygviz/ 在您的系统上：
pip install --global-option=build_ext \
            --global-option="-L/opt/lib/mygviz/" \
            --global-option="-R/opt/lib/mygviz/" \
            pygraphviz
在此示例中， -L 和 -R 标志分别告诉链接器在构建时和运行时查找所需的Graphviz库的位置。
Q:

如何在Windows下编译pyraphviz？

A:

看见窗口获取有关如何在Windows上安装Graphviz和pyraphviz的最新信息。

Q:

为什么不分发一个pyraphviz Windows安装程序呢？

A:

我们非常愿意为您提供两个轮子 pygraphviz ，但有几个复杂的问题。 pygraphviz 是Graphviz的包装器，这意味着必须安装Graphviz，以及Graphviz头文件、库 and 包装器必须可以访问所有命令行可执行文件。的推荐用法 Graphviz CLI 给车轮包装带来了挑战。

参见

这 GitHub issue 关于轮子和包装的进一步讨论。