安装

本生成器依赖 fenics 作为有限元求解器，可参照 fenics 安装文档，推荐以下两种方式安装，如果没有没有 docker 使用经验推荐 Anaconda 方式

Anaconda

• Anaconda (Linux， Mac)

  1. 使用 conda 创建并激活环境

  conda create -n fenicsproject -c conda-forge fenics mshr
  source activate fenicsproject
  

  1. 使用 pip 安装本 package

  pip install -U git+https://git.idrl.site/idrl/layout-generator.git
  

Docker

• Docker (Linux, Win, Mac)

  • 使用 Dockerfile 构建 image

    1. clone repo

    git clone https://git.idrl.site/idrl/layout-generator.git
    docker build -t layout-generator:latest layout-generator
    

    1. 切换到需要生成数据集的目录，准备好配置文件 config.yml
    2. 使用 config.yml 在当前目录下生成数据集

    docker run --rm layout-generator:latest -v $(pwd):/home/layout layout_generater --config config.yml
    

  • 在 Container 中自行安装

    1. 安装 docker-ce (若已安装 docker 可跳过)
    2. pull fenics image (docker hub 中国 Azure 源): docker pull quay.azk8s.cn/fenicsproject/stable
    3. 创建并启动容器: docker run -it -v $(pwd):/home/fenics/shared quay.azk8s.cn/fenicsproject/stable bash
    4. 使用 pip 安装本 package

    pip install git+https://git.idrl.site/idrl/layout-generator.git
    

FAQ

• Windows 下可以使用 Docker 方式安装，或在应用商店安装 Ubuntu WSL

• pip 安装前可使用国内源如清华、阿里

  pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
  

• 如果出现 HDF5 error，请使用如下命令重新安装 h5py

  pip uninstall h5py
  pip install --no-binary=h5py h5py
  

• 目前仅支持 Python3.6 以上版本

• 如果按照以上 Anaconda 安装方式，别忘了切换到 fenicsproject 环境