1561 airflowwindowventilationempiricalexpressionsdin16798 add deactivation option for window opening

[Jun-Jiang-92]

Add parameter "winOpnBeh" to the model of DIN EN 16798-7.

This parameter should be set to false, if the window opening behavior of occupant is not considered for the calculation of airflow rate. In this case, the correction factor cofExt will be set as 1. If this parameter is activated, the airflow rate will be reduced by the correction factor cofExt by high wind speed or low ambient temperature, caused by the window closing from occupant due to draught and thermal comfort.

Both examples are also updated for comparisons.

[Jun-Jiang-92]

@FWuellhorst Hi, Fabian. I updated one paramter for the model of DIN EN 16798-7 for the package window ventilation. Since you reviewed the entire package last time and you are familiar with this package, could you please take a review of this PR?

[ebc-aixlib-bot]

Reference results have been displayed graphically and are created under the following page https://rwth-ebc.github.io/AixLib/1561-airflowwindowventilationempiricalexpressionsdin16798-add-deactivation-option-for-window-opening/charts

[ebc-aixlib-bot]

Thank you for making a Pull Request to AixLib!

Our CI pipeline will help you finalize your contribution.
Here's what is typically checked:

• HTML syntax of your models, primarily in your documentation.
• Adherence to the naming convention in all changed files.
• Ability to check all models.
• Ability to simulate all models, if they are examples.
• If your contribution changes existing reference results.

If HTML errors occur, I will fix the issues using a separate pull request.
For the other checks, I will post the results here: https://rwth-ebc.github.io/AixLib/1561-airflowwindowventilationempiricalexpressionsdin16798-add-deactivation-option-for-window-opening/index.html

Tips to fix possible naming violations:

• Stick to the naming guidelines, e.g. Namespace Requirements
• Do all paramaters, variables, models, etc. have a description?
• Use absolute paths to classes! -> AixLib.Fluid.HeatExchangers.Radiator - Avoid: HeatExchangers.Radiator

If all CI stages pass and you have addressed possible naming violations, please consider the following:

• Use "group" and "tab" annotations to achieve a good visualization window.
• Use units consistently.
• Instantiate the replaceable medium package as:
  replaceable package Medium = Modelica.Media.Interfaces.PartialMedium "Medium model";
  instead of using a full media model like AixLib.Media.Water directly.
• Never using absolute paths to files (e.g., C: or D:). Replace them with modelica://AixLib/....
• Ensure your documentation is helpful and concise.
• Make sure icons are clear. Please avoid using images!
• Stick to 80 characters per line, as long as it makes sense.
• Add or modify examples for new or revised models.
• Include a simulate-and-plot script as a regression test for new models.
  How? Follow the documentation here: https://github.com/ibpsa/modelica-ibpsa/wiki/Unit-Tests#how-to-include-models-as-part-of-the-unit-tests
  Tip: To create the initial script, you can use Dymolas script generator, explained here: https://www.claytex.com/tech-blog/how-to-use-a-plot-script/)

Once you have addressed these points, you can assign a reviewer.
Although this process may seem tedious, ensuring CI passes allows the reviewer to focus
their time on the actual modeling rather than syntax and unintended breakages caused by your changes.

If you have any questions or issues, please tag a library developer.
Once again, thank you for your valuable contribution!

[FWuellhorst]

I only have minor comments, please address/comment merge afterwards.

[FWuellhorst]

Can you add a revision why this changed?

[FWuellhorst]

I would advise setting winOpnBeh final in both models with and without opening behavior to avoid users overriding it. If you know use cases where a non-final setting is useful, keep it this way.

[FWuellhorst]

same here. Also, explicitly set winOpnBeh in any case to avoid changes if someone changes the default at some point.