EnergyPlus Co-simulation Toolbox

버전 1.2.3.1 (70.8 MB) 작성자: Jiri Dostal

Co-simulation of EnergyPlus models in Matlab/Simulink.

https://github.com/dostaji4/EnergyPlus-co-simulation-toolbox

팔로우

4.7

(15)

다운로드 수: 1.7K

업데이트 날짜: 2021/4/18

GitHub에서 라이선스 보기

Description
---------------
The toolbox facilitates simultaneous simulation of EnergyPlus and Matlab (co-simulation). The main component is the mlep class containing all the necessary tools to configure and run EnergyPlus co-simulation within the Matlab environment.

System Requirements
-----------------------------
* Windows. The toolbox has only been tested for Windows, but considerable preparations for other OS has already been done.
* EnergyPlus installed. You can obtain the software here https://energyplus.net/. If you install the EnergyPlus to the default location ('C:\EnergyPlusVx-x-x') then it might be detected automatically by the toolbox.

Installation
--------
Obtain a copy of the toolbox from
* Matlab Add-on Manager
* or Mathworks File Exchange https://uk.mathworks.com/matlabcentral/fileexchange/69074-energyplus-co-simulation-toolbox
* or a GitHub repository https://github.com/dostaji4/EnergyPlus-co-simulation-toolbox/releases
and install.

Features
-----------
The toolbox contains:

* Parsing of the IDF file to determine co-simulation inputs/outputs.
* Automatic socket communication configuration (on localhost).
* Background start of the EnergyPlus process with an output to the Matlab command line.
* System Object implementation usable in Matlab & Simulink.
* Bus input/output integration for easy Simulink model setup.

Examples
-------------
See the GettingStarted.mlx guide delivered with the Matlab toolbox or the documentation residing under Help -> Supplemental Software -> EnergyPlus co-simulation toolbox

Troubleshooting
---------------------
* Always be sure that EnergyPlus itself is working. To check run "EP-Launch.exe" from the EnergyPlus installation folder and try running one of its examples (located at <EP folder>/ExampleFiles/).
* If you have issues with "EnergyPlus not found." run "setupMlep.m".
* If you have an issue with a "Vector to Bus" block not having its bus types correctly specified, run the model again. Bus objects should now be in the workspace and it should work.

This software builds on the free software by Truong Nghiem(truong@seas.upenn.edu), Willy Bernal (Willy.BernalHeredia@nrel.gov) and several other third-party open-source tools.

인용 양식

Dostal, Jiri, and Tomas Baumelt. “Model Predictive Control for Buildings with Active One-Pipe Hydronic Heating.” E3S Web of Conferences, edited by S.I Tanabe et al., vol. 111, EDP Sciences, 2019, p. 04050, doi:10.1051/e3sconf/201911104050.

양식 더 보기

MATLAB 릴리스 호환 정보

개발 환경: R2019b

R2017a 이상 릴리스와 호환

플랫폼 호환성

Windows macOS Linux

카테고리

Help Center 및 MATLAB Answers에서 Simulink Cosimulation에 대해 자세히 알아보기

태그 태그 추가

도움

받음: dirPlus, xml2struct , with bug fix and added features, Process manager, Line-wrap a string, findPropByAttr

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

setupMlep

@mlep

examples/legacy_example

library

third_party/processManager

third_party/xml2struct

xml2struct

examples/legacy_example

mlepSimulink_example.slx

library

mlepLibrary.slx

doc

GettingStarted.mlx

GitHub 디폴트 브랜치를 사용하는 버전은 다운로드할 수 없음

버전	게시됨	릴리스 정보
1.2.3.1	2021/4/18	added short Troubleshooting section in this description.
1.2.3	2019/12/9	Updated IDF files to EnergyPlus 9.2 version. Followed Upgrade advisor to remove "not recommended" Matlab commands. Fixed some documentation bugs. Fixed a bug for ExternalInterface:Actuator.
1.2.2.2	2019/8/27	CITE THE SOURCE WHEN USING THE TOOLBOX, please.
1.2.2.1	2019/4/30	* minor bug in ExternalInterface:Actuator & ExternalInterface:Variable. Working now as intended.
1.2.2	2019/4/18	* updated examples to EnergyPlus version 9.1.0 * disabled IDF simulation with mismatching EnergyPlus version. * updated simulink models to Matlab r18b. It can still be simulated by older Matlab (enable this in Simulink preferences). * minor fixes
1.2.1.1	2018/12/7	* corrected a bug in the setup routine. Made first time use through Simulink end in a neverending loop. * extended communication timeouts to accommodate for larger EP simulations
1.2.1	2018/12/4	Added better documentation
1.2	2018/11/22	### Added * Load and Save routines. ### Changed * Bus objects are now loading in the Init function callback. It should solve the '_Missing Bus objects_' issues. * Optimized IDF file parsing speed. * Initialization no longer triggered fro
1.1.1.2	2018/10/23	* compatibility issues in r18b
1.1.1.1	2018/10/23	forgot to add the update binary
1.1.1	2018/10/23	* using Matlab's internal JRE instead of searching for external one.
1.1	2018/10/23	Added * Bus objects now support signal names longer than 63 characters. * Simulation and initialization are now considerably faster. * A Vector to Bus block added. * Browse buttons in the Simulink block mask.
1.0.3	2018/10/11	Adding the binary to the repository code. Hopefully, the Matlab Add-on Explorer will detect it now.
1.0.2	2018/10/11	Adding further info. Mainly for manual toolbox installation (The binary is obtainable at GitHub)
1.0.1	2018/10/10

이 GitHub 애드온의 문제를 보거나 보고하려면 GitHub 리포지토리로 가십시오.

MLA	Dostal, Jiri, and Tomas Baumelt. “Model Predictive Control for Buildings with Active One-Pipe Hydronic Heating.” E3S Web of Conferences, edited by S.I Tanabe et al., vol. 111, EDP Sciences, 2019, p. 04050, doi:10.1051/e3sconf/201911104050.
APA	Dostal, J., & Baumelt, T. (2019). Model predictive control for buildings with active one-pipe hydronic heating. (S. I. Tanabe, H. Zhang, J. Kurnitski, M. C. G. da Silva, I. Nastase, P. Wargocki, G. Cao, et al., Eds.)E3S Web of Conferences, 111, 04050. EDP Sciences. Retrieved from https://doi.org/10.1051%2Fe3sconf%2F201911104050
BibTeX	@article{Dostal_2019, doi = {10.1051/e3sconf/201911104050}, url = {https://doi.org/10.1051%2Fe3sconf%2F201911104050}, year = 2019, publisher = {{EDP} Sciences}, volume = {111}, pages = {04050}, author = {Jiri Dostal and Tomas Baumelt}, editor = {S.I Tanabe and H. Zhang and J. Kurnitski and M.C. Gameiro da Silva and I. Nastase and P. Wargocki and G. Cao and L. Mazzarela and C. Inard}, title = {Model predictive control for buildings with active one-pipe hydronic heating}, journal = {E3S Web of Conferences} }