跳转至

欢迎使用 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 下的模块来编写自己的案例。