Unmet hours for dehumidification

[shorowit]

Pull Request Description

Closes #2203. Adds a dehumidification unmet hours output (tolerance = 1% RH) as well as a warning if the number of hours exceeds 300. If there are no dehumidifiers, zero will be reported.

Note: E+ with hourly timesteps does not perfectly maintain RH setpoint, rather we see oscillations that can result in reported unmet hours. Is this something we can address?

• Note that the dehumidifier is the last piece of equipment that runs
• Double-check our EMS program
• Double-check sub-hourly timesteps
• Do we see similar behavior if we add a dehumidifier to a standard E+ sample file?
• Are there any E+ knobs/settings that would affect this?

Checklist

Not all may apply:

• Schematron validator (EPvalidator.sch) has been updated
• Sample files have been added/updated (openstudio tasks.rb update_hpxmls)
• Tests have been added/updated (e.g., HPXMLtoOpenStudio/tests/test*.rb and/or workflow/tests/test*.rb)
• Documentation has been updated
• Changelog has been updated
• openstudio tasks.rb update_measures has been run
• No unexpected changes to simulation results of sample files

[Copilot]

Pull request overview

Adds annual/timeseries reporting support for dehumidification unmet hours, addressing #2203 by calculating hours where RH exceeds the dehumidifier setpoint tolerance and surfacing warnings for large values.

Changes:

• Adds dehumidification unmet-hours EMS generation and reporting plumbing.
• Adds dehumidifier availability EMS sensor support.
• Updates constants, tests, measure metadata, README, docs, and changelog for the new output.

Reviewed changes

Copilot reviewed 10 out of 11 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
ReportSimulationOutput/tests/test_report_sim_output.rb	Adds dehumidification unmet-hours columns to expected report outputs.
ReportSimulationOutput/README.md	Documents the new measure output name.
ReportSimulationOutput/measure.xml	Registers the new output and updates checksums/version metadata.
ReportSimulationOutput/measure.rb	Wires dehumidification unmet hours into EMS output requests, annual reporting, and warnings.
HPXMLtoOpenStudio/resources/output.rb	Adds EMS program for dehumidification unmet hours and renames/refactors unmet-hours program constants/variables.
HPXMLtoOpenStudio/resources/hvac.rb	Adds an EMS sensor for dehumidifier availability schedules.
HPXMLtoOpenStudio/resources/constants.rb	Adds dehumidification unmet-hours and availability constants.
HPXMLtoOpenStudio/measure.xml	Updates resource checksums/version metadata.
docs/source/workflow_outputs.rst	Documents dehumidification unmet-hours behavior and warning threshold.
Changelog.md	Notes the new dehumidification unmet-hours feature.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[shorowit]

Filed an EnergyPlus issue: NatLabRockies/EnergyPlus#11657