NatLabRockies / NatLabRockies/OpenStudio

Add "Field Set: Surface Name, Fraction of Radiant Energy to Surface" parameter for ZoneHVACCoolingPanelRadiantConvectiveWater and ZoneHVACBaseboardRadiantConvectiveWater

Open
#5,592 2 comments 0 reactions 1 assignee View on GitHub

@joseph-robertson is already working on this.

Since Jan 26, 2026.

component - Model Enhancement Request IDDChange
Dominant language
C++
Stars
646
Forks
237
Avg merge
3d 11h
Merged PRs (30d)
10

Description

General Summary

Currently OpenstudioSDK do not have methods to set the "Field Set: Surface Name, Fraction of Radiant Energy to Surface" for both ZoneHVACCoolingPanelRadiantConvectiveWater and ZoneHVACBaseboardRadiantConvectiveWater.

Detailed Description

Currently the field is defaulted to the following for radiant cooling panel and baseboard:

// Assume that 5% of what is not on people is on the floor
double fractionOnFloor = (1.0 - fractionofRadiantEnergyIncidentonPeople) * 0.05;
// Assume that 55% of what is not on people is on the walls
double fractionOnWall = (1.0 - fractionofRadiantEnergyIncidentonPeople) * 0.55;
// Assume that 40% of what is not on people is on the ceiling
double fractionOnCeiling = (1.0 - fractionofRadiantEnergyIncidentonPeople) * 0.40;

Although this will make sense for baseboard. This is problematic for Radiant ceiling panel. RCP will not have 40% of its radiant energy transmitted to the ceiling

The best would be to have functions to let users set their own view factor to each surface. This will help them account for rooms of different shapes etc.

Possible Implementation

No response

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.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.