NatLabRockies / NatLabRockies/EnergyPlus

HX Bypass and General OA Controller Cleanup

Open
#6,973 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C++
Stars
1.6k
Forks
490
Avg merge
6d 21h
Merged PRs (30d)
22

Description

Issue overview

The original user test file for #6886 is somewhat problematic in that it asks the OA controller to do things that just don't add up. The fix implemented in #6861 gets the right answer for better formed models, but it goes to max iterations with this particular file. The OA controller should be able to come up with a stable answer for this case. It could as simple as forcing LockoutWithHeating in for some combinations of inputs, or adding more logic to make an HX bypass decision and stick with it rather than flipping back and forth.

More generally, the OA Controller logic has become hard to follow again, and could use some refactoring, and possibly reordering as well as eliminating similar variables that are sometimes a fraction of design flow vs current system flow.

Details

Some additional details for this issue (if relevant):

  • Platform (Operating system, version)
  • Version of EnergyPlus (if using an intermediate build, include SHA)
  • Unmethours link or helpdesk ticket number
Checklist

Add to this list or remove from it as applicable. This is a simple templated set of guidelines.

  • Defect file added (list location of defect file here)
  • Ticket added to Pivotal for defect (development team task)
  • Pull request created (the pull request will have additional tasks related to reviewing changes that fix this defect)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Begin with the original user test file from #6886 and the OA Controller logic, reproducing the case where the controller reaches maximum iterations. A complete change should produce a stable answer for that case and make the controller logic easier to follow, including the requested cleanup of similar flow variables and decision logic.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
backend
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.