hongyuanjia/eplusr

eplusr-docker

用于结合EnergyPlus和R工作的Dockerfile

概述

本仓库提供基于https://hub.docker.com/r/rocker/rstudio和https://hub.docker.com/r/rocker/verse容器的Dockerfile，用于通过https://cran.r-project.org/package=eplusr包在R中使用EnergyPlus。

支持的EnergyPlus版本

支持从v8.3.0开始的所有发行版。用户可指定EnergyPlus版本标签，例如hongyuanjia/eplusr:9.1.0，或使用默认latest标签（如hongyuanjia/eplusr）获取最新版本的EnergyPlus。

默认基础容器为https://hub.docker.com/r/rocker/rstudio。可添加`-verse`后缀使用https://hub.docker.com/r/rocker/verse基础容器，例如`hongyuanjia/eplusr:9.1.0-verse`、`hongyuanjia/eplusr:latest-verse`。

快速开始

bash
docker run --rm -p 8787:8787 -e PASSWORD=yourpasswordhere docker.xuanyuan.run/hongyuanjia/eplusr

在浏览器中访问http://localhost:8787，使用用户名rstudio和设置的密码登录。注意：现在必须设置密码，否则容器将报错。

常用配置选项

安装不同版本的EnergyPlus

有时可能需要在当前指定的EnergyPlus版本之外安装其他版本，有两种方法：

• 若要使用https://hongyuanjia.github.io/eplusr/reference/install_eplus.html将EnergyPlus安装到默认位置，运行容器时需通过`ROOT=TRUE`授予root权限：

  bash
  docker run -d -p 8787:8787 -e ROOT=TRUE -e PASSWORD=yourpasswordhere docker.xuanyuan.run/hongyuanjia/eplusr
  

• 若不想授予root权限，可通过https://hongyuanjia.github.io/eplusr/reference/install_eplus.html下载所需版本的EnergyPlus，然后按照说明手动安装。

绕过认证步骤

警告：仅在安全环境中使用。不要在AWS或其他具有公共可访问IP地址的云服务器上使用此方法。

只需设置环境变量DISABLE_AUTH=true，例如：

bash
docker run --rm -p 8787:8787 -e DISABLE_AUTH=true docker.xuanyuan.run/hongyuanjia/eplusr

访问http://localhost:8787，无需密码即可以rstudio用户登录RStudio。

更多帮助

• https://github.com/rocker-org/rocker-versioned/blob/master/rstudio/容器
• https://github.com/rocker-org/rocker项目的https://github.com/rocker-org/rocker/wiki提供更多文档

许可证

本仓库中的Dockerfile采用GPL 2或更高版本许可。

商标

RStudio是RStudio, Inc.的注册商标。通过https://registry.hub.docker.com/托管的镜像分发RStudio二进制文件及使用商标术语RStudio已获得RStudio的明确许可。请查看http://www.rstudio.com/about/trademark/，有关进一步分发或其他问题的咨询请联系***。