Skip to content

Update SZVAV controls#11545

Open
rraustad wants to merge 1 commit intodevelopfrom
9090-SZVAV-control-issues
Open

Update SZVAV controls#11545
rraustad wants to merge 1 commit intodevelopfrom
9090-SZVAV-control-issues

Conversation

@rraustad
Copy link
Copy Markdown
Collaborator

Pull request overview

Description of the purpose of this PR

SZVAV controls were updated to allow a more defined air flow and supply air temperature region as described in the Engineering Reference.

image

Pull Request Author

  • Title of PR should be user-synopsis style (clearly understandable in a standalone changelog context)
  • Label the PR with at least one of: Defect, Refactoring, NewFeature, Performance, and/or DoNoPublish
  • Pull requests that impact EnergyPlus code must also include unit tests to cover enhancement or defect repair
  • Author should provide a "walkthrough" of relevant code changes using a GitHub code review comment process
  • If any diffs are expected, author must demonstrate they are justified using plots and descriptions
  • If changes fix a defect, the fix should be demonstrated in plots and descriptions
  • If any defect files are updated to a more recent version, upload new versions here or on DevSupport
  • If IDD requires transition, transition source, rules, ExpandObjects, and IDFs must be updated, and add IDDChange label
  • If structural output changes, add to output rules file and add OutputChange label
  • If adding/removing any LaTeX docs or figures, update that document's CMakeLists file dependencies
  • If adding/removing any output files (e.g., eplustbl.*)
    • Update ..\scripts\Epl-run.bat
    • Update ..\scripts\RunEPlus.bat
    • Update ..\src\EPLaunch\ MainModule.bas, epl-ui.frm, and epl.vbp (VersionComments)
    • Update ...github\workflows\energyplus.py

Reviewer

  • Perform a Code Review on GitHub
  • If branch is behind develop, merge develop and build locally to check for side effects of the merge
  • If defect, verify by running develop branch and reproducing defect, then running PR and reproducing fix
  • If feature, test running new feature, try creative ways to break it
  • CI status: all green or justified
  • Check that performance is not impacted (CI Linux results include performance check)
  • Run Unit Test(s) locally
  • Check any new function arguments for performance impacts
  • Verify IDF naming conventions and styles, memos and notes and defaults
  • If new idf included, locally check the err file and other outputs

@rraustad rraustad added the Defect Includes code to repair a defect in EnergyPlus label Apr 24, 2026
@github-actions
Copy link
Copy Markdown

⚠️ Regressions detected on ubuntu-24.04 for commit 9594e0b

Regression Summary
  • ESO Small Diffs: 706
  • Table Small Diffs: 393
  • MTR Small Diffs: 525
  • Table String Diffs: 177
  • EIO: 397
  • JSON Small Diffs: 2
  • ZSZ Small Diffs: 72
  • Table Big Diffs: 37
  • ERR: 15
  • MTR Big Diffs: 2
  • ESO Big Diffs: 10
  • SSZ Small Diffs: 13
  • EDD: 4
  • JSON Big Diffs: 2

@github-actions
Copy link
Copy Markdown

⚠️ Regressions detected on macos-14 for commit 9594e0b

Regression Summary
  • ERR: 1
  • MTR Small Diffs: 1
  • Table Big Diffs: 1

@rraustad
Copy link
Copy Markdown
Collaborator Author

Since I made a claim in the description that I "updated" and made a "more defined" control, based solely on the issue unit test, I figured I would run the SZVAV example file to see what changed. This test file does not seem to change, which is disturbing.

The figures in the left column are all data. This system cycles during unoccupied times (SZVAV is not active) and the fan runs continuously during occupancy (SZVAV is active). The right column subsets on occupancy/constant fan (valid data).

Why is the supply air temperature below the Maximum Supply Air Temperature at higher loads in Region 3, while the shape of the SZVAV curve looks correct in Region 2?

image

@rraustad
Copy link
Copy Markdown
Collaborator Author

rraustad commented Apr 25, 2026

I noticed that the schedule report Schedule Value only reports at the TimeStep frequency. When other Zone frequency reports output at the detailed frequency. All reports are detailed frequency but the schedule is missing in action.

image

thisSys.simulate(*state, thisSys.Name, FirstHVACIteration, 0, PTUnitNum, HeatActive, CoolActive, 0, 0, true, QUnitOut, latOut);
EXPECT_NEAR(QUnitOut, 2010.0, 0.01);
ASSERT_NEAR(thisSys.DesignMaxOutletTemp, state->dataHeatingCoils->HeatingCoil(1).OutletAirTemp, 0.1);
ASSERT_NEAR(thisSys.DesignMaxOutletTemp, state->dataHeatingCoils->HeatingCoil(1).OutletAirTemp, 1.0);
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This change was a hard pill for me to swallow. DesignMaxOutletTemp is a target AND is set at design conditions (i.e., meaning that at off design conditions the system may not have the same capacity and cannot provide that same outlet temperature). There is no guarantee that the system will hit that target. The system will certainly attempt to hit the target, and will drive towards the target, but could be several degrees short of the target. Now that the fan is operating correctly (i.e., at a higher air flow rate), the outlet air temp is lower than it was before. So this is why I changed several of these tolerances. The system is not missing the target, it can't actually hit the target but needs to approach the target. Feel free to run several hours of debug and correct me if I'm wrong (I would welcome that).

HeatCoilLoad,
SupHeaterLoad,
CompressorONFlag);
SZVAVModel.calcUnitarySystemToLoad(state,
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure why this change was required but the debugger showed me these were different (i.e., using thisSys vs SZVAVModel, which are both references to the same unitarySytsem. At line 711 above, where SZVAVModel.FanPartLoadRatio = 0.0, that code DID change FanPartLoadRatio in the SZVAVModel reference but DID NOT change FanPartLoadRatio in the thisSys reference. I know, it's a conundrum. This is the reason for this change, this needs to reference the right system.

maxAirMassFlow,
CoolingLoad,
1.0);
iterWaterAirOrNot);
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This was another subtle but necessary change. This residual function has 2 choices for adjusting air and water flow rates. If the load is in Region 1 or 3 (iterWaterAirOrNot = 0) then the air flow is constant and the compressor speed or water flow rate changes to meet the load. When in region 2 (iterWaterAirOrNot = 1), both change. See the figure in the PR description for clarity or just ask me. Feel free to suggest a different variable name.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Defect Includes code to repair a defect in EnergyPlus

Projects

None yet

Development

Successfully merging this pull request may close these issues.

SingleZoneVAV model at times fails to meet the load and outlet temperature min/max

2 participants