thewalrus 0.7.0

功能

• 一般和某些结构矩阵的hafinian、loop-hafinian和torontonian的最快计算。
• 一个易于使用的界面，使用环路哈夫尼亚进行量子态计算
• 从图的hafinian和torontonian采样的最新算法。
• 非负矩阵的HFFAN逼近的有效经典方法。

安装

预装的二进制车轮可用于以下平台：

要安装，只需运行

pip install thewalrus

从源代码编译

海象依赖于以下python包：

• Python>；=3.5
• NumPy>；=1.13.3

< C++ 11编译器，如：千字节}；；；=；；3.3；
• {a10} -线性代数的C++头库。

在基于debian的系统上，可以通过apt和curl：

$ sudo apt install g++ libeigen3-dev

或者在MacOS上使用自制程序：

$ brew install gcc eigen

或者，您可以手动下载特征头：

$ mkdir ~/.local/eigen3 &&cd ~/.local/eigen3
$ wget http://bitbucket.org/eigen/eigen/get/3.3.7.tar.gz -O eigen3.tar.gz
$ tar xzf eigen3.tar.gz eigen-eigen-323c052e1731/Eigen --strip-components 1$exportEIGEN_INCLUDE_DIR=$HOME/.local/eigen3

请注意，我们导出环境变量EIGEN_INCLUDE_DIR，这样海象就可以找到eigen3头文件（如果没有提供，海象将默认在/use/include/eigen3和/usr/local/include/eigen3中查找）。

安装完所有依赖项后，您可以编译最新稳定版本的walrus库，如下所示：

$ python -m pip install thewalrus --no-binary :all:

或者，可以通过克隆git存储库并在开发模式下使用pip安装来编译最新的开发版本。

$ git clone https://github.com/XanaduAI/thewalrus.git
$cd thewalrus && python -m pip install -e .

$USE_LAPACK=1 python -m pip install thewalrus --no-binary :all:

软件测试

为了确保walrus库在安装后正常工作，可以导航到源代码文件夹并运行来运行测试套件

$ make test

运行低级C++测试套件，Googletest 将需要安装。在基于ubuntu的发行版中，可以按如下方式执行：

sudo apt-get install cmake libgtest-dev
cd /usr/src/googletest/googletest
sudo cmake
sudo make
sudo cp libgtest* /usr/lib/
sudo mkdir /usr/local/lib/googletest
sudo ln -s /usr/lib/libgtest.a /usr/local/lib/googletest/libgtest.a
sudo ln -s /usr/lib/libgtest_main.a /usr/local/lib/googletest/libgtest_main.a

或者，最新的googletest版本可以从源代码安装：

sudo apt install cmake
wget -qO - https://github.com/google/googletest/archive/release-1.8.1.tar.gz | tar -xz
cmake -D CMAKE_INSTALL_PREFIX:PATH=$HOME/googletest -D CMAKE_BUILD_TYPE=Release googletest-release-1.8.1
make install

如果从源安装googletest，请确保包含的头和 库在包含/库路径中可用。

文档

海象文档可以在Read the Docs上在线获得。

要在本地构建它，您需要安装以下软件包：

• Sphinx>；=1.5
• sphinxcontrib-bibtex>；=0.3.6
• nbsphinx
• Pandoc
• breathe>；=4.12.0
• exhale
• Doxygen

如果在基于debian的系统上，可以通过pip和apt的组合安装它们：

$ sudo apt install pandoc doxygen
$ pip3 install sphinx sphinxcontrib-bibtex nbsphinx breathe exhale

要构建html文档，请转到顶层目录并运行命令

$ make doc

然后可以在docs/_build/html/目录中找到文档。

作者

尼古拉斯·奎萨达、布拉杰什·古普特和乔希·伊扎克。

所有贡献都在acknowledgments page中确认。

如果你用海象做研究，请引用our paper：

Andreas Björklund, Brajesh Gupt, and Nicolás Quesada. A faster hafnian formula for complex matrices and its benchmarking on a supercomputer, Journal of Experimental Algorithmics (JEA) 24 (1), 11 (2019)

支架

• 源代码：https://github.com/XanaduAI/thewalrus
• 问题跟踪程序：https://github.com/XanaduAI/thewalrus/issues

如果您有问题，请通过在我们的github问题跟踪器上发布该问题来通知我们。

许可证

walrus是free和open source，根据apache许可证2.0版发布。