pyzeo

Python对Zeo++库的封装。基于最新发布的0.3版本。

安装

我们为几个平台（包括Apple Silicon）提供预构建的wheel。因此，在大多数情况下，您将想要使用pip安装该软件包。

pip install pyzeo

从源安装

如果您希望直接从源代码安装该软件包，可以使用以下方法

git clone https://github.com/nomad-coe/pyzeo
cd pyzeo
pip install .

请注意，此类型的安装将需要一个独立的、平台依赖的编译步骤。以下是在编译步骤中可能会遇到的一些常见问题

• 致命错误: Python.h: 没有此文件或目录: 该软件包依赖于在设置期间编译的C/C++扩展。为了编译工作，您需要安装pythonX.X-dev-包，其中X.X是您使用的Python版本。例如，对于Ubuntu上的python 3.9，此包可以通过以下方式安装

  .. code-block:: sh

   sudo apt install python3.9-dev
  

• MacOS上的安装错误：此软件包依赖于在设置过程中编译的C++扩展。如果在MacOS上设置过程中遇到问题，您可能需要安装Xcode命令行工具包。可以通过以下方式完成：

  .. code-block:: sh

  xcode-select --install
  

Cython

默认情况下，软件包包含预构建的Cython绑定代码。Cython包装器定义位于src/pyzeo中。可以通过首先在setup.py中设置USE_CYTHON=True来重新创建这些绑定，然后使用以下方式重新创建绑定：

python setup.py build_ext --inplace --force

记得之后通过在setup.py中设置USE_CYTHON=False来禁用cython。

许可协议

Python包装器代码遵循Apache 2.0许可协议。《Zeo++库》和《Voro++库》，这些库包含在源代码中，具有以下许可协议：

Zeo++

Zeo++ 版权所有 (c) 2011，加州大学董事会，通过劳伦斯伯克利国家实验室（前提是收到美国能源部所需的所有批准）。保留所有权利。

以下条件满足时，允许重新分配和使用源代码和二进制形式，无论是否修改：

(1) 源代码重新分配必须保留上述版权声明、本条件列表和以下免责声明。

(2) 二进制形式重新分配必须在文档和/或其他提供的材料中复制上述版权声明、本条件列表和以下免责声明。

(3) 美国加州大学、劳伦斯伯克利国家实验室、美国能源部及其贡献者的名称不得用于认可或推广源自本软件的产品，除非事先获得书面许可。

本软件由版权所有者和贡献者提供“现状”且不承担任何明示或暗示的保证，包括但不限于适销性和适用于特定目的的暗示保证。在任何情况下，版权所有者或贡献者均不对任何直接、间接、偶然、特殊、示范性或后果性的损害（包括但不限于替代商品或服务的采购；使用、数据或利润的丧失；或业务中断）承担责任，无论何种原因以及基于何种责任理论（合同、严格责任或侵权，包括疏忽或不作为）均产生，即使被告知本软件使用可能产生此类损害。

您没有义务为源代码的任何错误修复、补丁或升级功能、功能或性能（“改进”）向任何人提供；但是，如果您选择公开或直接向劳伦斯伯克利国家实验室提供您的改进，而不为此类改进单独签订书面许可协议，则您特此授予以下许可：非独占的、免版税的永久许可，以安装、使用、修改、制作衍生作品、将其纳入其他计算机软件、分发和再许可此类改进或衍生作品，无论以二进制形式还是源代码形式。

Voro++

Voro++ 版权所有 (c) 2008，加州大学董事会，通过劳伦斯伯克利国家实验室（前提是收到美国能源部所需的所有批准）。保留所有权利。

以下条件满足时，允许重新分配和使用源代码和二进制形式，无论是否修改：

(1) 源代码重新分配必须保留上述版权声明、本条件列表和以下免责声明。

(2) 二进制形式重新分配必须在文档和/或其他提供的材料中复制上述版权声明、本条件列表和以下免责声明。

(3) 美国加州大学、劳伦斯伯克利国家实验室、美国能源部及其贡献者的名称不得用于认可或推广源自本软件的产品，除非事先获得书面许可。

本软件由版权所有者和贡献者提供“现状”且不承担任何明示或暗示的保证，包括但不限于适销性和适用于特定目的的暗示保证。在任何情况下，版权所有者或贡献者均不对任何直接、间接、偶然、特殊、示范性或后果性的损害（包括但不限于替代商品或服务的采购；使用、数据或利润的丧失；或业务中断）承担责任，无论何种原因以及基于何种责任理论（合同、严格责任或侵权，包括疏忽或不作为）均产生，即使被告知本软件使用可能产生此类损害。

您没有义务为源代码的任何错误修复、补丁或升级功能、功能或性能（“改进”）向任何人提供；但是，如果您选择公开或直接向劳伦斯伯克利国家实验室提供您的改进，而不为此类改进单独签订书面许可协议，则您特此授予以下许可：非独占的、免版税的永久许可，以安装、使用、修改、制作衍生作品、将其纳入其他计算机软件、分发和再许可此类改进或衍生作品，无论以二进制形式还是源代码形式。