AixLib v1.3.2

OpenModelica Release

This release aims to increase the compatibility of the AixLib with OpenModelica.
We checked and simulated all models locally. Aside from issues already raised to OM, only the heat pump models do not work yet. This is due to the integration into the IBPSA library, which will be finished shortly. In the IBPSA, the heat pump models are fully OM compatible.

What's Changed

• Issue1297 fluid ports hom by @larissakuehn in #1334
• Fix uses conitions #1336 by @FWuellhorst in #1337
• Fix partialMedium by using si units by @FWuellhorst in #1339
• Fix missing each #1342 by @FWuellhorst in #1353
• 1361 dpcontrolledmovers fail in open modelica by @larissakuehn in #1362
• issue1340_OpenModelica compatibility for ExergyMeter by @tosch4 in #1366
• Issue1351 membrane based enthalpy exchnager om by @KremerMartin in #1357
• 1343 model for humans fails in openmodelica by @HannahRomberg in #1365
• #1372 heatingRod OpenModelica by @tosch4 in #1373
• Moved example of obsolete model also in obsolete package by @larissakuehn in #1364
• Issue1368 pump polynomial based om by @KremerMartin in #1374
• Issue1350 hom om compatible by @LauraMaier in #1356
• Add interval length to make simulation run in OM #1341 by @LauraMaier in #1355
• Issue1352 dhc by @FWuellhorst in #1376
• Issue1349 reducedorder fails in openmodelica by @hannah-kruetzfeldt in #1377
• #1358 cooler Controller/CtrAHUBasic.mo reverseActing set to false by @alexanderAKU in #1360
• issue1346 Hydraulic Modules fail in Open Modelica by @KremerMartin in #1359
• Issue1320 add example for ahu control by @KremerMartin in #1380
• Create .gitattributes by @DaJansenGit in #1384
• Add simulate and plot script for thermal zone example by @larissakuehn in #1386
• Add simulate and plot scripts by @larissakuehn in #1389
• Corrected HTML Code in branch correct_HTML_Issue1313_revision_of_gitlab_templates by @ebc-aixlib-bot in #1400
• 1348 multiple fails in controls package in openmodelica by @DaJansenGit in #1370
• Issue1345 modular ahu open modelica by @KremerMartin in #1379
• Issue1381 new logo by @LauraMaier in #1382
• Corrected HTML Code in branch correct_HTML_Issue1313_revision_of_gitlab_templates by @ebc-aixlib-bot in #1409
• Issue1313 revision of gitlab templates by @SvenHinrichs in #1393
• fix name by @FWuellhorst in #1418
• fix comparison #1411 by @FWuellhorst in #1419
• add replaceable to declaration of thermalZone record #1424 by @larissakuehn in #1425
• Open Modelica PR by @FWuellhorst in #1378

New Contributors

• @HannahRomberg made their first contribution in #1365
• @hannah-kruetzfeldt made their first contribution in #1377

Full Changelog: v1.3.1...v1.3.2

AixLib v1.3.1

Bugfixes

Bugfix to make OpenModelica load and hopefully check the library correctly. See #1323

AixLib v1.3.0

Release Notes

The following highlights show some of our achievements with reaching v1.3.0:

Modelica Standard library

• Update to MSL4.0

IBPSA

• Merge of current IBPSA modelica base repository
• IBPSA models are now marked by an icon

Improvements in CI

• New reference results for some models (e.g. pump examples)
• Integration of google charts for the comparision of reference results

Changes in ThermalZone

• ROM:
  • Integration of post processing blocks with some interesting outpus (e.g. sum of energy for heating) into AixLib.ThermalZones.ReducedOrder.Multizone.BaseClasses
• HOM:
  • New partial model to increase usability / modelling speed for users of the model: AixLib.ThermalZones.HighOrder.Rooms.BaseClasses.PartialRoomFourWalls
  • Replacing air load model with air volume to provide possibility to consider CO2 and humidity
  • Move AixLib.ThermalZones.HighOrder.Rooms.MFD.OneAppartment to obsolete

Changes for Thermal energy storage

• Substituting the model AixLib.Fluid.Storage.Storage by AixLib.Fluid.Storage.BufferStorage in most of the examples as it is more detailed and hence realistic

New pump model

• AixLib.Fluid.Movers.DpControlledMovers
  • This model represents a pump or fan which includes already a controller.
  • This enables the user to quickly select between the two common control modes constant pressure (dpConst) and variable pressure (dpVar).

New control models

• AixLib.Systems.HydraulicModules.Controller.CalcHydraulicPower:
  • Calculates the power of hydraulic modules and returns the power as real.
• AixLib.Systems.HydraulicModules.Controller.CtrThrottleQFlow:
  • Simple controller for Throttle and ThrottlePump circuit that is based on a PID controller.

New TABS model

• AixLib.Systems.TABS:
  • This module is a thermally activated building system (TABS) with a closed hydraunic system that is connected to the concrete and supplied by two throttle circuits via heat exchangers.

New AHU model

• AixLib.GenericAU
  • The GenericAHU is an air-handling unit model with detailed hydraulic system of the preheater, heater and cooler. The ahu includes a heat exchanger for heat recovery and a humidifier for the supply air. The humidifier can be insert steam or water that evaporates completely (adiabatic). Further, the ahu includes an adiabatic humidifier in the return air channel in order to cool the return air and use the heat recovery heat exchanger to cool the supply air. The preheater, steam humdifier and adiabatic humidifier are conditional and can be deactivated.
  • Further related models:
    • AixLib.Fluid.Movers.Data.Fans.GenericFan
    • AixLib.Systems.ModularAHU.BaseClass.GenericAHUBus
    • AixLib.Systems.ModularAHU.Controller.CtrAHUBasic
    • AixLib.Systems.ModularAHU.Examples.EONERC_AHU2
    • AixLib.Systems.ModularAHU.Examples.GenericAHU

Additional Resources:

• Added weather data for Aachen

What's Changed

• Merge for release 1.3.0 by @larissakuehn in #1318

Full Changelog: v1.0.0...v1.3.0

AixLib v1.0.0

We worked hard to achieve AixLib version 1.0.0!

For this, we carried out a thorough spring cleaning with extensive model enhancements on the one hand and farewell to some models on the other :-)

Non-backwards compatibility

We made a lot of changes in the following packages that are not backward-compatible:

• Electrical
• Fluid.Storage
• ThermalZone.HOM
• Utilities.Sources.InternalGains

The following highlights show some of our achievements with reaching v1.0.0:

Byebye FastHVAC

• Despite its great potential of fast simulations, we decided against supporting our modeling package FastHVAC and moved it to the Obsolete Package. Here, it is still accessible but not enhanced or maintained for now.

Enhancement of High Order Building Model

The existing HOM was extensively enhanced regarding usability, contents and error-proneness.
The main changes are:

• We included a Partial room model
• The propagation was facilitated from wall to building level for OFD rooms and building
• We comparatively validated it according to ASHRAE standards and carried out empirical validation based on two measurement references. All validation models are part of automated unit testing via CI.

New refrigerant library for vapour compression cycles

• We replaced the simplified Black-Box approach to consider refrigerants' performance data by including the Python library VCLib.
• The VCLib enables studies on different fluids and flowsheets in e.g. heat pumps.

New validated PV system model

• We replaced our old simplified PV model by a new modular one which is validated using measurement data from the National Institute of Standard Technology (NIST).
• The new model bases on manufacturer data only and distinguishes two typical mountings to make DC power output calculation more realistic.

Improvements in CI

• More granular testing of the AixLib library with different stages for:
  • automatic reference result creation
  • various library checks
  • regressions tests
  • simulation tests
• Implementation of a CI based automatic merge of IBPSA library

AixLib v0.9.1

Bugfixes

• Bugfix to make OpenModelica load the library correctly. See #856

AixLib v0.9.0

Non-backwards compatibility

We made a lot of changes for the Thermazone and Multizone models which broke the backward compatibility.

Release Notes

• Moisture calculation for the Thermal Zone models
• The ideal heater and cooler model was moved from Multi Zone to Thermal Zone model and was improved by the integration of outside temperature threshold values to prevent simultaneously heating and cooling
• Automatic calculation of water volumes and massflows for the Heatpump model
• The new Heatpump model from v0.7 is now also integrated for FastHVAC: AixLib.FastHVAC.Components.HeatGenerators.HeatPump
• New modular CHP model for calibration: AixLib.Fluid.BoilerCHP.ModularCHP
• New boiler model AixLib.Fluid.BoilerCHP.BoilerNoControl where the input is the part load rate
• New pump model in package AixLib.Fluid.Movers.PumpsPolynomialBased that is based on polynomial functions
• New heat exchanger model AixLib.Fluid.HeatExchangers.DynamicHX with dynamic behavior
• New humidifier model AixLib.Fluid.Humidifiers.GenericHumidifier_u for steam and adiabatic humidification and part load rate as input
• New air medium AixLib.Media.AirIncompressible with constant density for duct work simulations
• Continuous Integration with regression tests to check simulation results
• Inclues latest IBPSA (15.01.2020)

v0.7.3

Bugfixes

This contains correction of two little bugixes:

• Fixing packages and case-sensitive file naming in #646
• Correct a gain value in HeatPumpSimple in #655

v0.7.2

Bugfixes and Cleaning

This release fixes some errors in the FastHVAC package and cleans up missing deletes of duplicated folders in the Media.Refrigerant Package.

v0.7.1

This is an additional release with bug fixes that are missing in v0.7.0.
The relevant commits can be found in #630.
All changes are related to the new heat pump model.
The most important bug was a wrong sign for the heat flow in the evaporator.

v0.7.0

Release notes:

• Includes a bugfix in AixLib.ThermalZones.RC.FourElements, see ibpsa/modelica-ibpsa#997
• Includes IBPSA Modelica Library v3.0.0, see https://github.com/ibpsa/modelica-ibpsa/releases/tag/v3.0.0 that comes with a borehole heat exchanger model
• Includes further refrigerants
• Changes license from Modelica2 to BSD-3 to comply to IBPSA Library, see https://github.com/ibpsa/modelica-ibpsa
• Moves Buildings package to AixLib.ThermalZones
• Adds Systems package with preconfigured hydraulic circuits to simplify modelling typical hydraulic systems
• Adds new, state-of-the-art heat pump model with various features for annual simulations
• Adds further models to model heat pumps including refrigerant cycle and in-detail modelling of compressor, condenser, evaporator and expansion valve