Modelica library allowing simultaneous transient simulation of thermal and electrical systems at both building and feeder level.
Modelica HTML Python Java Jupyter Notebook C
Clone or download
Latest commit 5982423 Jul 19, 2018

README.md

IDEAS v1.0.0

Build Status

Modelica model environment for Integrated District Energy Assessment Simulations (IDEAS), allowing simultaneous transient simulation of thermal and electrical systems at both building and feeder level.

IDEAS v1.0.0

May 5th 2017: IDEAS v1.0.0 has been released.
February 16th 2018: A paper describing IDEAS v1.0.0 has been published on line.

Backward compatibility

Quite some backward incompatible changes have been performed. However, a conversion script is provided that fixes most of these. The conversion script prompt should occur automatically if your model or package 'uses' IDEAS version 0.3 before updating. Make sure you have a backup (e.g. using git) before running the conversion script.

The insulationType and insulationThickness parameters were removed from the wall/surface models. The insulation types and thicknesses will therefore need to be integrated manually into the construction types that you use. If the insulationthickness is zero or you did not use 'insulationType' in your construction records, then both parameters can just be removed.

Release notes

Changes compared to v0.3 include but are not limited to:

  1. IDEAS 1.0.0 is based on Annex 60 version 1.0.0
  2. The IDEAS packages have been restructured to be more in line with the Annex 60 package structure. ..* IDEAS.Constants has been replaced by IDEAS.Types ..* The SimInfoManager has been moved to IDEAS.BoundaryConditions ..* Interfaces such as HeatingSystem and BaseCircuits have been moved to IDEAS.Templates
  3. Setting up new Construction records has been simplified. Parameter values of nLay and nGain are now inferred from the other parameters and may therefore no longer be assigned.
  4. Optional parameter incLastLay has been added to Construction records. Users may use this to double-check if InternalWalls are connected as intended.
  5. The way how internal gains may be connected to surfaces has been changed.
  6. Convection and thermal radiation equations have been tuned to be more accurate and faster.
  7. Added an option to the zone model for evaluating thermal comfort.
  8. Added an option to the zone model for computing the sensible and latent heat gains from occupants.
  9. The zone air model is now replaceable such that custom models may be created.
  10. A zone template has been added that allows to add a rectangular zone, including 4 walls, 4 optional windows, a floor and a ceiling.
  11. Some variables have been renamed. A conversion script is provided for converting the user's models to accomodate these changes. ..* TStar has been renamed into TRad in the zone model. ..* flowPort_Out and flowPort_In have been renamed in the zone model, heating system, ventilaiton system and structure models. ..* Some Annex 60 models were renamed.
  12. Added example model of a terraced house in IDEAS.Examples.PPD12
  13. Added twin house validation models in IDEAS.Examples.TwinHouse
  14. Added solar irradiation model for window frames.
  15. Added optional thermal bridge model for windows.
  16. Extended implementation of building shade model.
  17. Fixed bug in view factor implementation.
  18. Updated documentation for many models in IDEAS.Buildings
  19. Added thermostatic valve model: IDEAS.Fluid.Actuators.Valves.TwoWayTRV
  20. Removed insulationType and insulationThickness parameters. These should now be defined in the Construction records.
  21. Harmonised implementation of Perez solar irradiation model with Annex 60 implementation.
  22. Cleaned up implementation of BESTEST models.
  23. Added new, specialised window types.
  24. Added options for model linearisation.
  25. Improved accuracy of model that computes internal longwave radiation.
  26. Improved accuracy of model that computes exterior sky temperature.
  27. Moved Electrical package into Experimental package since this package contains broken models.
  28. Added unit tests for templates.
  29. Added Menerga Adsolair model.

Tool compatibility

The library is developed using Dymola. Furthermore, changes have been made such that the library can be read using OpenModelica. The building models can be simulated using JModelica too, although not everything is supported yet.

IDEAS v0.3.0

IDEAS release v0.3 has been pushed on 2 september 2015. Major changes compared to v0.2 are:

  1. Added code for checking conservation of energy
  2. Added options for linear / non-linear radiative heat exchange and convection for exterior and interior faces of walls and floors/ceilings. Respective correlations have been changed.
  3. Overall improvements resulting in more efficient code and less warnings.
  4. The emissivity of window coatings must now be specified as a property of the solid (glass sheet) and not as a property of the gas between the glass sheets. This is only relevant if you create your own glazing.
  5. Merged Annex 60 library up to commit d7749e3
  6. Expanded unit tests
  7. More correct implementation of Koschenz's model for TABS. Also added the option for discretising TABS sections.
  8. Added new building shade components.
  9. Removed inefficient code that would lead to numerical Jacobians in grid.
  10. Added new AC and DC electrical models.

License

The IDEAS package is licensed by KU Leuven and 3E under the Modelica License Version 2.

References

Development of IDEAS

  1. F. Jorissen, G. Reynders, R. Baetens, D. Picard, D. Saelens, and L. Helsen. (2018) Implementation and Verification of the IDEAS Building Energy Simulation Library. Journal of Building Performance Simulation, doi: 10.1080/19401493.2018.1428361. Published on line
  2. R. Baetens, R. De Coninck, F. Jorissen, D. Picard, L. Helsen, D. Saelens (2015). OpenIDEAS - An Open Framework for Integrated District Energy Simulations. In Proceedings of Building Simulation 2015, Hyderabad, 347--354.
  3. R. Baetens. (2015) On externalities of heat pump-based low-energy dwellings at the low-voltage distribution grid. PhD thesis, Arenberg Doctoral School, KU Leuven.
  4. F. Jorissen, W. Boydens, and L. Helsen. (2017) Validated air handling unit model using indirect evaporative cooling. Journal of Building Performance Simulation, 11 (1), 48–64, doi: 10.1080/19401493.2016.1273391
  5. R. Baetens, D. Saelens. (2016) Modelling uncertainty in district energy simulations by stochastic residential occupant behaviour. Journal of Building Performance Simulation 9 (4), 431–447, doi:10.1080/19401493.2015.1070203.
  6. M. Wetter, M. Fuchs, P. Grozman, L. Helsen, F. Jorissen, M. Lauster, M. Dirk, C. Nytsch-geusen, D. Picard, P. Sahlin, and M. Thorade. (2015) IEA EBC Annex 60 Modelica Library - An International Collaboration to Develop a Free Open-Source Model Library for Buildings and Community Energy Systems. In Proceedings of Building Simulation 2015, Hyderabad, 395–402.
  7. B. van der Heijde, M. Fuchs, C. Ribas Tugores, G. Schweiger, K. Sartor, D. Basciotti, D. Müller,C. Nytsch-Geusen, M. Wetter, L. Helsen (2017). Dynamic equation-based thermo-hydraulic pipe model for district heating and cooling systems. Energy Conversion and Management, 151, 158-169.
  8. D. Picard, L. Helsen (2014). Advanced Hybrid Model for Borefield Heat Exchanger Performance Evaluation, an Implementation in Modelica. In Proceedings of the 10th International Modelica Conference. Lund, 857-866.
  9. D. Picard, L. Helsen (2014). A New Hybrid Model For Borefield Heat Exchangers Performance Evaluation. 2014 ASHRAE ANNUAL CONFERENCE: Vol. 120 (2). ASHRAE: Ground Source Heat Pumps: State of the Art Design, Performance and Research. Seattle, 1-8.
  10. Picard D., Jorissen F., Helsen L. (2015). Methodology for Obtaining Linear State Space Building Energy Simulation Models. 11th International Modelica Conference. International Modelica Conference. Paris, 21-23 September 2015 (pp. 51-58).

Applications of IDEAS

  1. D. Picard. (2017) Modeling, optimal control and HVAC design of large buildings using ground source heat pump systems. PhD thesis, Arenberg Doctoral School, KU Leuven.
  2. G. Reynders. (2015) Quantifying the impact of building design on the potential of structural storage for active demand response in residential buildings. PhD thesis, Arenberg Doctoral School, KU Leuven.
  3. R. De Coninck. (2015) Grey-box based optimal control for thermal systems in buildings - Unlocking energy efficiency and flexibility. PhD thesis, Arenberg Doctoral School, KU Leuven.
  4. G. Reynders, T. Nuytten, D. Saelens. (2013) Potential of structural thermal mass for demand-side management in dwellings. Building and Environment 64, 187–199, doi:10.1016/j.buildenv.2013.03.010.
  5. R. De Coninck, R. Baetens, D. Saelens, A. Woyte, L. Helsen (2014). Rule-based demand side management of domestic hot water production with heat pumps in zero energy neighbourhoods. Journal of Building Performance Simulation, 7 (4), 271-288.
  6. R. Baetens, R. De Coninck, J. Van Roy, B. Verbruggen, J. Driesen, L. Helsen, D. Saelens (2012). Assessing electrical bottlenecks at feeder level for residential net zero-energy buildings by integrated system simulation. Applied Energy, 96, 74-83.
  7. G. Reynders, J. Diriken, D. Saelens. (2014) Quality of grey-box models and identified parameters as function of the accuracy of input and observation signals. Energy & Buildings 82, 263–274, doi:10.1016/j.enbuild.2014.07.025.
  8. F. Jorissen, L. Helsen, M. Wetter (2015). Simulation Speed Analysis and Improvements of Modelica Models for Building Energy Simulation. In Proceedings of the 11th International Modelica Conference. Paris, 59-69.
  9. C. Protopapadaki, G. Reynders, D. Saelens (2014). Bottom-up modeling of the Belgian residential building stock: impact of building stock descriptions. In Proceedings of the 9th International Conference on System Simulation in Buildings. Liège.
  10. G. Reynders, J. Diriken, D. Saelens (2014). Bottom-up modeling of the Belgian residential building stock: impact of model complexity. In Proceedings of the 9th International Conference on System Simulation in Buildings. Liège.
  11. G. Reynders, J. Diriken, D. Saelens (2015). Impact of the heat emission system on the indentification of grey-box models for residential buildings. Energy Procedia 78, 3300-3305, doi: 10.1016/j.egypro.2015.11.740.
  12. I. De Jaeger, G. Reynders, D. Saelens (2017). Impact of spacial accuracy on district energy simulations. Energy Procedia 132, 561-566, doi: 10.1016/j.egypro.2017.09.741
  13. G. Reynders, R. Andriamamonjy, R. Klein, D. Saelens (2017). Towards an IFC-Modelica Tool Facilitating Model Complexity Selection for Building Energy Simulation. In Proceedings of the 15th Conference of the International Building Performance Simulation Association. California.
  14. G. Reynders, J. Diriken, D. Saelens (2017). Generic characterization method for energy flexibility: Applied to structural thermal storage in residential buildings. Applied Energy 198, 192-202, doi: 10.1016/j.apenergy.2017.04.061
  15. F. Jorissen. (2018) Toolchain for optimal control and design of energy systems in buildings. PhD thesis, Arenberg Doctoral School, KU Leuven.
  16. Picard D., Sourbron M., Jorissen F., Vana Z., Cigler J., Ferkl L., Helsen L. (2016). Comparison of Model Predictive Control Performance Using Grey-Box and White-Box Controller Models of a Multi-zone Office Building. International High Performance Buildings Conference. International High Performance Buildings Conference. West Lafayette, 11-14 July 2016 (art.nr. 203).

Bibtex entry for citing IDEAS

@article{Jorissen2018ideas,
author = {Jorissen, Filip and Reynders, Glenn and Baetens, Ruben and Picard, Damien and Saelens, Dirk and Helsen, Lieve},
journal = {Journal of Building Performance Simulation},
note = {Published on line},
title = {{Implementation and Verification of the IDEAS Building Energy Simulation Library}},
volume = {},
doi={10.1080/19401493.2018.1428361},
year = {2018}
}