跳转至

欢迎使用 PaddleScience

1. 开始安装

1.1 从 docker 镜像启动[可选]

# pull image
docker pull hydrogensulfate/paddlescience

# create a container named 'paddlescience_container' based on pulled image
## docker version < 19.03
nvidia-docker run --name paddlescience_container --network=host -it --shm-size 64g hydrogensulfate/paddlescience:latest /bin/bash

## docker version >= 19.03
# docker run --name paddlescience_container --gpus all --network=host -it shm-size 64g hydrogensulfate/paddlescience:latest /bin/bash

Note

Dockerhub 拉取的镜像仅预装了运行 PaddleScience 所需的依赖包，如 pymesh、open3d，并不包含 PaddleScience。 因此请在镜像拉取和容器构建完成后，参考 1.4 安装 PaddleScience 中的步骤，在容器中安装 PaddleScience。

git clone https://github.com/PaddlePaddle/PaddleScience.git
cd PaddleScience/docker/
wget -nc https://paddle-org.bj.bcebos.com/paddlescience/docker/pymesh.tar.xz
bash run.sh

如果出现因网络问题导致的 docker 构建时 apt 下载报错，则重复执行 bash run.sh 直至构建完成。

更多关于 Paddle Docker 的安装和使用，请参考 Docker 安装。

1.2 python 环境安装[可选]

如果你还没有 python 环境或者 python 版本小于 3.9，则推荐使用 Anaconda 安装并配置 python 环境，否则可以忽略本步骤。

  1. 根据系统环境，从 https://repo.anaconda.com/archive/ 中下载对应的 Anaconda3 安装包，并手动安装。

  2. 创建 python 3.9 环境，并进入该环境。

    # 使用 conda 创建 python 环境，并命名为 "ppsci_py39"
conda create -n ppsci_py39 python=3.9

# 进入创建好的 "ppsci_py39" 环境
conda activate ppsci_py39

1.3 安装 PaddlePaddle

请在 PaddlePaddle 官网按照您的运行环境，安装 develop 版的 PaddlePaddle。

安装完毕之后，运行以下命令，验证 Paddle 是否安装成功。

python -c "import paddle; paddle.utils.run_check()"

如果出现 PaddlePaddle is installed successfully! Let's start deep learning with PaddlePaddle now. 信息，说明您已成功安装，可以继续安装 PaddleScience。

1.4 安装 PaddleScience

1.4.1 安装基础功能

从以下三种安装方式中任选一种。

执行以下命令，从 github 上 clone PaddleScience 源代码，并以 editable 的方式安装 PaddleScience。

git clone -b develop https://github.com/PaddlePaddle/PaddleScience.git
# 若 github clone 速度比较慢，可以使用 gitee clone
# git clone -b develop https://gitee.com/paddlepaddle/PaddleScience.git

cd PaddleScience

# install paddlesci with editable mode
pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple

执行以下命令以 pip 的方式安装最新版本的 PaddleScience。

# nightly build
pip install https://paddle-qa.bj.bcebos.com/PaddleScience/whl/latest/dist/paddlesci-0.0.0-py3-none-any.whl
# release
# pip install -U paddlesci

如果在您的环境中，上述两种方式都无法正常安装，则可以选择本方式，在终端内将环境变量 PYTHONPATH 临时设置为 PaddleScience 的绝对路径，如下所示。

cd PaddleScience/
export PYTHONPATH=$PYTHONPATH:$PWD
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple # manually install requirements

cd PaddleScience/
set PYTHONPATH=%cd%
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple # manually install requirements

上述方式的优点是步骤简单无需安装，缺点是当环境变量生效的终端被关闭后，需要重新执行上述命令设置 PYTHONPATH 才能再次使用 PaddleScience，较为繁琐。

1.4.2 安装额外功能[可选]

如需使用 .obj, .ply, .off, .stl, .mesh, .node, .poly and .msh 等复杂几何文件构建几何（计算域），以及使用加密采样等功能，则需按照下方给出的命令，安装 open3d、 pybind11、pysdf、PyMesh 四个依赖库（上述1.1 从 docker 镜像启动中已安装上述依赖库)。

否则无法使用 ppsci.geometry.Mesh 等基于复杂几何文件的 API，因此也无法运行如 Aneurysm 等依赖 ppsci.geometry.Mesh API 的复杂案例。

pip install open3d -i https://pypi.tuna.tsinghua.edu.cn/simple

pip install pybind11 -i https://pypi.tuna.tsinghua.edu.cn/simple

pip install pysdf

在安装 PyMesh 之前，首先需通过 cmake --version 确认环境中是否已安装 cmake。 如未安装，可按照下列命令下载、解压 cmake 包，并添加到 PATH 变量中即可完成安装。

wget -nc https://paddle-org.bj.bcebos.com/paddlescience/cmake-3.23.0-linux-x86_64.tar.gz
tar -zxvf cmake-3.23.0-linux-x86_64.tar.gz
rm -f cmake-3.23.0-linux-x86_64.tar.gz
PATH=$PWD/cmake-3.23.0-linux-x86_64/bin:$PATH

# cmake --version
# cmake version 3.23.0

# CMake suite maintained and supported by Kitware (kitware.com/cmake).

PyMesh 库需要以 setup 的方式进行安装，命令如下：

wget -nc https://paddle-org.bj.bcebos.com/paddlescience/PyMesh.tar.gz
tar -zxvf PyMesh.tar.gz

# 也可以使用 git 命令下载，速度可能会比较慢
# git clone https://github.com/PyMesh/PyMesh.git
# git submodule update --init --recursive --progress

cd PyMesh
export PYMESH_PATH=`pwd`

apt-get install \
    libeigen3-dev \
    libgmp-dev \
    libgmpxx4ldbl \
    libmpfr-dev \
    libboost-dev \
    libboost-thread-dev \
    libtbb-dev \
    python3-dev

python -m pip install --user -r $PYMESH_PATH/python/requirements.txt
python setup.py build
python setup.py install --user

# test whether installed successfully
python -c "import pymesh; pymesh.test()"

# Ran 175 tests in 3.150s

# OK (SKIP=2)

安装注意事项

如果使用 git 命令下载 PyMesh 项目文件，则安装过程中可能会出现两个问题，可以按照以下方式解决：

  1. 由于网络问题，git submodule update 过程中可能某些 submodule 会 clone 失败，此时只需 反复执行 git submodule update --init --recursive --progress 直到所有库都 clone 成功即可。

  2. 所有 submodule 都 clone 成功后，请检查 PyMesh/third_party/ 下是否有空文件夹，若有则需 手动找到并删除这些空文件夹，再执行 git submodule update --init --recursive --progress 命 令即可恢复这些空文件夹至正常含有文件的状态，此时再继续执行剩余安装命令即可。

2. 验证安装

  • 执行以下代码，验证安装的 PaddleScience 基础功能是否正常。

    python -c "import ppsci; ppsci.run_check()"

    如果出现 PaddleScience is installed successfully.✨ 🍰 ✨，则说明安装验证成功。

  • [可选]如果已按照 1.4.2 安装额外依赖 正确安装了 4 个额外依赖库，则可以执行以下代码， 验证 PaddleScience 的 ppsci.geometry.Mesh 模块是否能正常运行。

    python -c "import ppsci; ppsci.run_check_mesh()"

    如果出现 ppsci.geometry.Mesh module running successfully.✨ 🍰 ✨，则说明该模块运行正常。

3. 开始使用

  • 运行内置的案例（以 ldc2d_unsteady_Re10.py 为例）

    cd examples/ldc/
python ./ldc2d_unsteady_Re10.py

  • 编写自己的案例（假设案例名为 demo）

    推荐在 examples/ 下新建 demo 文件夹，然后在 demo 文件夹下新建 demo.py，最后在 demo.py 文件中使用 PaddleScience 提供的 API 编写代码。

    examples/demo/demo.py
    1
2
3
    import ppsci

# write your code here...

    编写完毕后运行你的代码

    cd examples/demo
python ./demo.py

    如不了解接下来该如何基于 PaddleScience 编写代码，则推荐参考 快速开始 和其他案例的文档、代码，进一步了解如何使用 ppsci 下的模块来编写自己的案例。