Note

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

安装

PyGraphviz要求:

  • Python(版本3.7、3.8或3.9)

  • GraphViz (版本2.42或更高版本)

注解

我们假设您的计算机上安装了Python。

高级

两个主要困难是(1)通知pip安装Graphviz的位置和(2)安装Graphviz。

提供通向Graphviz的路径

您需要知道Graphviz的二进制文件、包含文件和库文件在您的文件系统中的什么位置。以下是一些如何告诉pip这些文件在哪里的示例。

MacPorts

$ port install graphviz-devel
$ pip install -- pre --global-option=build_ext \
              --global-option="-I/opt/local/include/" \
              --global-option="-L/opt/local/lib/" \
              pygraphviz

在Windows上安装Graphviz

在Windows上安装Graphviz和PyGraphviz并非易事。幸运的是,Graphviz开发人员正在努力解决这个问题,最近发布的版本极大地改善了这种情况。

以下是我们目前支持在Windows上安装的唯一方式:

  1. 下载并安装2.46.0 for Windows 10(64位): stable_windows_10_cmake_Release_x64_graphviz-install-2.46.0-win64.exe

  2. 通过以下方式安装PyGraphviz pip install --pre 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 获取有关如何在Windows上安装Graphviz和pyraphviz的最新信息。

Q

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

A

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

参见

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