diff --git a/Buildings/BoundaryConditions/UsersGuide.mo b/Buildings/BoundaryConditions/UsersGuide.mo
index 676a0770498..c1ec283778d 100644
--- a/Buildings/BoundaryConditions/UsersGuide.mo
+++ b/Buildings/BoundaryConditions/UsersGuide.mo
@@ -18,6 +18,16 @@ and
Buildings.HeatTransfer.Types.Tilt
can be used.
+
+Note that a ceiling has a tilt of 0, and also the solar collector models
+in
+Buildings.Fluid.SolarCollectors
+require a tilt of 0 if they are facing straight upwards.
+This is correct because
+the solar irradiation on a ceiling construction is on the other-side surface,
+which faces upwards toward the sky. Hence, a construction is considered
+a ceiling from the view point of a person standing inside a room.
+
References
diff --git a/Buildings/Fluid/SolarCollectors/BaseClasses/PartialSolarCollector.mo b/Buildings/Fluid/SolarCollectors/BaseClasses/PartialSolarCollector.mo
index 5f730df6b7b..6c85a9115b1 100644
--- a/Buildings/Fluid/SolarCollectors/BaseClasses/PartialSolarCollector.mo
+++ b/Buildings/Fluid/SolarCollectors/BaseClasses/PartialSolarCollector.mo
@@ -8,9 +8,11 @@ model PartialSolarCollector "Partial model for solar collectors"
parameter Integer nSeg(min=3) = 3
"Number of segments used to discretize the collector model";
- parameter Modelica.SIunits.Angle lat "Latitude";
- parameter Modelica.SIunits.Angle azi "Surface azimuth";
- parameter Modelica.SIunits.Angle til "Surface tilt";
+ parameter Modelica.SIunits.Angle lat(displayUnit="degree") "Latitude";
+ parameter Modelica.SIunits.Angle azi(displayUnit="degree")
+ "Surface azimuth (0 for south-facing; -90 degree for east-facing; +90 degree for west facing";
+ parameter Modelica.SIunits.Angle til(displayUnit="degree")
+ "Surface tilt (0 for horizontally mounted collector)";
parameter Real rho "Ground reflectance";
parameter Modelica.SIunits.HeatCapacity C=385*perPar.mDry
"Heat capacity of solar collector without fluid (default: cp_copper*mDry*nPanels)";
@@ -219,7 +221,13 @@ equation