欢迎使用 PaddleScience¶

1. 开始安装¶

1.1 从 docker 镜像启动[可选]¶

从 DockerHub 拉取镜像通过 Dockerfile 构建镜像

# pull image
docker pull hydrogensulfate/paddlescience

# create a container named 'paddlescience' 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 环境，否则可以忽略本步骤。

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

创建 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 安装基础功能¶

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

git 源码安装[推荐]pip 安装设置 PYTHONPATH

执行以下命令，从 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。

pip install -U paddlesci

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

LinuxWindows

cd PaddleScience/
export PYTHONPATH=$PYTHONPATH:$PWD

cd PaddleScience/
set PYTHONPATH=%cd%

上述方式的优点是步骤简单无需安装，缺点是当环境变量生效的终端被关闭后，需要重新执行上述命令设置 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 的复杂案例。

open3d 安装命令pybind11 安装命令pysdf 安装命令PyMesh 安装命令

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 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 项目文件，则安装过程中可能会出现两个问题，可以按照以下方式解决：

由于网络问题，git submodule update 过程中可能某些 submodule 会 clone 失败，此时只需反复执行 git submodule update --init --recursive --progress 直到所有库都 clone 成功即可。
所有 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 下的模块来编写自己的案例。