Skip to content

Latest commit

 

History

History
145 lines (130 loc) · 12.2 KB

ReleaseNotes.md

File metadata and controls

145 lines (130 loc) · 12.2 KB
Raw

IDEAS v2.1

IDEAS 2.1 has been released on February 28th, 2019. The most important changes are:

  • IBPSA has been updated up to commit 2d6a5a6ff80.
  • The twin house example model has been re-added to the library.
  • The PPD12 examples now includes a model that compares a rule based controller with a model predictive controller.

Detailed release notes:

  1. Deprecated IDEAS.Fluid.Actuators.Valves.Simplified.ThreeWayValve.
  2. Extended IDEAS.Buildings.Components.Shading.BuildingShade with a parameter for configuring partial shading.
  3. Added a two-way and three-way valve with a mixed linear-equal percentage opening characteristic.
  4. Added a bypass for the PPD12 air handling unit.
  5. Modified the way how initial equations are defined for wall models. This avoids duplicate initial equations.
  6. Fixed a bug in the zone model when allowFlowReversal was set to false.
  7. Added the option for setting a fixed boudnary condition temperature in BoundaryWall.
  8. Added a utility that automatically checks the git version of library dependencies when running a model, for enhanced version checking of models.
  9. Revised the implementation of the thermostatic radiator valve model such that it is smooth.
  10. Revised documentation in ExteriorSolarAbsorption.
  11. Fixed a compatibility bug with OpenModelica.
  12. Removed reference to non-existent parameter in RectangularZoneTemplate.

IDEAS v2.0

IDEAS 2.0 has been released on September 28th, 2018. Highlights of this release compared to v1.0 are:

  • Unit tests have been automated. When a developer makes a pull request against the master, unit tests are run automatically using Travis CI. This greatly simplifies the development process when no unit test results change.
  • IDEAS has been updated to IBPSA version 3.0. This includes a new heat pump model and a thoroughly updated borefield model.
  • Some old models have been removed and the library has been cleaned up in general.
  • New example models and unit tests have been added that better demonstrate how IDEAS can be used. In general, the documentation of the library has improved.
  • The OuterWall model now natively supports shading from external buildings using the BuildingShade model.
  • The InternalWall model now has the option to simulate natural convection through open doors or cavities.
  • The license has been modified from MSL2 to BSD3.
  • LIDEAS has been merged into IDEAS. LIDEAS contains code for linearizing an IDEAS building envelope model and for exporting it as a state space model. For more details see http://www.ep.liu.se/ecp/118/005/ecp1511851.pdf

Detailed release notes:

  1. The RectangularZoneTemplate has been extended considerably. Some changes are not reverse compatible.
    • Internal walls can no longer be combined with a window.
    • A building shade option has been added for outer walls.
    • An option has been added to completely drop one of the surfaces of the model.
    • An option has been added to override the default wall lengths.
    • An option to add a wall that is entirely enclosed by the zone.
    • The Window model has been made replaceable such that a fully configured window can easily be used.
    • An option for adding a cavity to internal walls has been added.
    • An option has been added for including an internal wall that is completely surrounded by the zone.
    • External proBus connectors are now vectors.
  2. The EmbeddedPipe model has been modified:
    • The parameter useSimplifiedRt has been removed.
    • The implementation now has final alpha=0 in the PrescribedHeatFlowRate blocks, which can significantly reduce the size of algebraic loops that are formed.
  3. A bug has been solved in the BuildingShade model that caused it to only work correctly for south oriented surfaces.
  4. A bug has been solved in the computation of the absolute humidity. The shading models now compute the impact on the diffuse solar irradiation more accurately. Although the used models are relatively simple, they are more accurate than the previous implementation, which disregarded the influence completely.
  5. Several bugs have been solved in the implementation of the Adsolair internal controller, which caused the unit not to work as intended.
  6. A bug has been fixed where the Zone model did not work when the air medium does not contain water vapor.
  7. The zone model now has several options for defining the occupancy internally. A fixed occupancy, a table, or an external input can be used. The relevant block is replaceable such that users can write their own occupancy models.
  8. Fixed the propagation of T_start in MonoLayerDynamic.
  9. A bug has been fixed where the shading control input of the window model was not displayed correctly.
  10. Two new shading models have been added: a horizontal fin shading model and the combination of a horizontal fin shading model with an overhang.
  11. ThreeWayValveMotor now also has a valve leakage since the old implementation can lead to singularities when the flow rate is exactly zero.
  12. The azimuth angle computation has been modified such that the argument of an arcsin cannot become larger than 1 due to roundoff/numerical errors. This caused models to crash in very rare occasions.
  13. Atmospheric pressure and relative humidity have been added to the weather bus since these variables are sometimes used to set the boundary conditions of a zone using a Boundary_pT.
  14. Fixed a bug in RunningMeanTemperatureEN15251 where the model output is incorrect for non-zero start times.
  15. Parameters energyDynamicsAir and mSenFac were not propagated correctly into the zone air model. This is now fixed.
  16. The StrobeInfoManager has been modified such that it also works for negative simulation times.
  17. A dry air medium for MPC applications has been added.
  18. The unit test tolerances have been decrease from the default of 1e-4 to 1e-6 to achieve more consistent results in the automated unit tests. LSodar is now used instead of DASSL.
  19. The zone air states now have a nominal attribute such that the state variables are better scaled when using implicit integrators. Similarly, the nominal values of the FluidPorts have been set.
  20. We now allow an OuterWall to be used as a floor.
  21. A bug has been corrected in the BESTEST weather file.
  22. Many old models have been removed and examples that depend on them have been updated to better illustrate how IDEAS can/should be used.
  23. The OuterWall model now also supports the computation of shading cast by external objects buildings. Future work should extend the set of supported shading models.
  24. The SimInfoManager has been modified such that it now exposes the same WeatherBus as the one that is used in the LBL Buildings library. The Buildings library solar thermal collectors are thus natively supported.
  25. IDEAS is now licensed under BSD3.
  26. Added multiple asserts that avoid the improper use of IDEAS models.
  27. Added an output for the CO2 concentration in the Zone model, which outputs zero when the Zone Medium does not contain CO2.
  28. The window model has been extended such that it can be configured to consist of nWin identical windows. This makes it easier to correctly configure the shading of multiple identical windows. The heat flow rates are simply scaled by nWin.
  29. IDEAS 2.0 is based on IBPSA 3.0, which includes general performance and documentation improvements. Notable additions from the IBPSA library are:
  • A heat pump model that implements a detailed thermodynamic cycle has been added.
  • A thermal storage tank model has been added.
  • A geothermal bore field model has been added.
  • A model has been added for directly writing .csv result files. These result files can also be used as an input for a CombiTimeTable.
  1. IDEAS now supports multiple trace substances for the zone model. I.e. other trace substances than CO2 are also supported.
  2. The Zone models now have the option for computing thermal heat gains due to lighting. Various zone types are supported, which determine the illuminance requirements. The lighting type determines the electrical power required for this illuminance. A lighting controller determines whether the lighting is enabled.

IDEAS v1.0

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

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
  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. 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.
  11. A zone template has been added that allows to add a rectangular zone, including 4 walls, 4 optional windows, a floor and a ceiling.
  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

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.