Skip to content

Commit d9d9e65

Browse files
committed
Update to version 2.0.0
1 parent 195d69d commit d9d9e65

File tree

416 files changed

+4331
-2988
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

416 files changed

+4331
-2988
lines changed

BuildSysPro/BaseClasses/HeatTransfer/Components/ASHRAE_vert.mo

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
within BuildSysPro.BaseClasses.HeatTransfer.Components;
1+
within BuildSysPro.BaseClasses.HeatTransfer.Components;
22
model ASHRAE_vert
3-
"Coefficient d'échange convectif non linéaire de l'ASHRAE pour une surface verticale"
3+
"Generic non linear convective heat exchange coefficient from ASHRAE for a vertical wall"
44
extends BaseClasses.HeatTransfer.Interfaces.Element1D;
55

66
parameter Modelica.SIunits.Area S;
@@ -26,10 +26,20 @@ Q_flow = S*(1.24*dT^(1/3));
2626
fillPattern=FillPattern.HorizontalCylinder,
2727
fillColor={170,170,255},
2828
textString="ASHRAE")}), Documentation(info="<html>
29+
<p><u><b>Hypothesis and equations</b></u></p>
30+
<p>none</p>
31+
<p><u><b>Bibliography</b></u></p>
32+
<p>none</p>
33+
<p><u><b>Instructions for use</b></u></p>
34+
<p>none</p>
35+
<p><u><b>Known limits / Use precautions</b></u></p>
36+
<p>none</p>
37+
<p><u><b>Validations</b></u></p>
38+
<p>Validated model</p>
2939
<p><b>--------------------------------------------------------------<br>
3040
Licensed by EDF under the Modelica License 2<br>
3141
Copyright &copy; EDF 2009 - 2016<br>
32-
BuildSysPro version 2015.12<br>
42+
BuildSysPro version 2.0.0<br>
3343
Author : EDF<br>
3444
--------------------------------------------------------------</b></p>
3545
</html>"));

BuildSysPro/BaseClasses/HeatTransfer/Components/BodyRadiation.mo

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,7 @@ equation
4949
fillColor={191,0,0},
5050
fillPattern=FillPattern.Solid)}),
5151
Documentation(info="<html>
52+
<p><u><b>Hypothesis and equations</b></u></p>
5253
<p>This is a model describing the thermal radiation, i.e., electromagnetic radiation emitted between two bodies as a result of their temperatures. The following constitutive equation is used: </p>
5354
<pre> Q_flow = Gr*sigma*(port_a.T^4 - port_b.T^4);</pre>
5455
<p>where Gr is the radiation conductance and sigma is the Stefan-Boltzmann constant (= Modelica.Constants.sigma). Gr may be determined by measurements and is assumed to be constant over the range of operations. </p>
@@ -61,7 +62,7 @@ equation
6162
rubber 0.95
6263
silver, polished 0.02
6364
wood 0.85..0.9</pre>
64-
<h4>Analytical Equations for Gr</h4>
65+
<p><b>Analytical Equations for Gr</b></p>
6566
<p><b>Small convex object in large enclosure</b> (e.g., a hot machine in a room): </p>
6667
<pre> Gr = e*A
6768
where
@@ -83,10 +84,16 @@ equation
8384
L : Length of the two cylinders
8485
e1: Emission value of inner cylinder (0..1)
8586
e2: Emission value of outer cylinder (0..1)</pre>
87+
<p><u><b>Bibliography</b></u></p>
88+
<p>none</p>
89+
<p><u><b>Instructions for use</b></u></p>
90+
<p>none</p>
91+
<p><u><b>Known limits / Use precautions</b></u></p>
92+
<p>none</p>
8693
<p><b>--------------------------------------------------------------<br>
8794
Licensed by EDF under the Modelica License 2<br>
8895
Copyright &copy; EDF 2009 - 2016<br>
89-
BuildSysPro version 2015.12<br>
96+
BuildSysPro version 2.0.0<br>
9097
Initial model : <a href=\"Modelica.Thermal.HeatTransfer.Components.BodyRadiation\">BodyRadiation</a>, Anton Haumer, Copyright © Modelica Association, Michael Tiller and DLR.<br>
9198
--------------------------------------------------------------</b></p>
9299
</html>"),

BuildSysPro/BaseClasses/HeatTransfer/Components/ControlledThermalConductor.mo

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
within BuildSysPro.BaseClasses.HeatTransfer.Components;
22
model ControlledThermalConductor
3-
"Résistance thermique dont la valeur est commandée - Lumped thermal element transporting heat without storing it"
3+
"Lumped thermal element transporting heat without storing it - with controlled conductance"
44
extends BaseClasses.HeatTransfer.Interfaces.Element1D;
55

66
Modelica.Blocks.Interfaces.RealInput G annotation (Placement(
@@ -29,6 +29,7 @@ equation
2929
Diagram(coordinateSystem(preserveAspectRatio=false,extent={{-100,-100},{100,
3030
100}}), graphics),
3131
Documentation(info="<html>
32+
<p><u><b>Hypothesis and equations</b></u></p>
3233
<p>This is a model for transport of heat without storing it. It may be used for complicated geometries where the thermal conductance G (= inverse of thermal resistance) is determined by measurements and is assumed to be constant over the range of operations. If the component consists mainly of one type of material and a regular geometry, it may be calculated, e.g., with one of the following equations: </p>
3334
<ul>
3435
<li>Conductance for a <b>box</b> geometry under the assumption that heat flows along the box length: </li>
@@ -52,10 +53,16 @@ equation
5253
silver 407
5354
steel 45 .. 15 (V2A)
5455
wood 0.1 ... 0.2</pre></p>
56+
<p><u><b>Bibliography</b></u></p>
57+
<p>none</p>
58+
<p><u><b>Instructions for use</b></u></p>
59+
<p>none</p>
60+
<p><u><b>Known limits / Use precautions</b></u></p>
61+
<p>none</p>
5562
<p><b>--------------------------------------------------------------<br>
5663
Licensed by EDF under the Modelica License 2<br>
5764
Copyright &copy; EDF 2009 - 2016<br>
58-
BuildSysPro version 2015.12<br>
65+
BuildSysPro version 2.0.0<br>
5966
Author : EDF<br>
6067
Initial model : <a href=\"Modelica.Thermal.HeatTransfer.Components.ThermalConductor\">ThermalConductor</a>, Anton Haumer, Copyright © Modelica Association, Michael Tiller and DLR.<br>
6168
--------------------------------------------------------------</b></p>

BuildSysPro/BaseClasses/HeatTransfer/Components/ConvectiveBoundaryLayer.mo

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,33 @@
1-
within BuildSysPro.BaseClasses.HeatTransfer.Components;
1+
within BuildSysPro.BaseClasses.HeatTransfer.Components;
22
model ConvectiveBoundaryLayer
3-
"Couche limite convective à exposant variable (TF75 C2K)"
3+
"Convective boundary layer with variable exponent (TF75 C2K)"
44
extends BaseClasses.HeatTransfer.Interfaces.Element1D;
55

66
parameter Modelica.SIunits.CoefficientOfHeatTransfer h=5
7-
"coefficient d'échange";
8-
parameter Modelica.SIunits.Area S=1 "surface d'échange";
9-
parameter Real alpha=0.5 "exposant de la loi d'échange";
7+
"Heat exchange coefficient";
8+
parameter Modelica.SIunits.Area S=1 "Exchange surface";
9+
parameter Real alpha=0.5 "Exponent of the exchange law";
1010

1111
equation
1212
Q_flow = sign(dT)*h*S*abs(dT)^alpha;
1313

1414
annotation (
1515
Documentation(info="<html>
16-
<p>Ce modèle reprend le TF 75 de CLIM2000. Il permet de définir un coefficient d'échange convectif entre un fluide et une paroi sous la forme : </p>
17-
<p>Flux_convectif = hS (deltaT)^alpha </p>
18-
<p>EAB avril 2010 </p>
16+
<p><u><b>Hypothesis and equations</b></u></p>
17+
<p>This model allows to define a convective heat exchange coefficient between a fluid and a wall, in the form of :</p>
18+
<p>Q_flow = h.S.(deltaT)<sup>alpha</sup></p>
19+
<p><u><b>Bibliography</b></u></p>
20+
<p>See notice TF75 of CLIM2000.</p>
21+
<p><u><b>Instructions for use</b></u></p>
22+
<p>none</p>
23+
<p><u><b>Known limits / Use precautions</b></u></p>
24+
<p>none</p>
25+
<p><u><b>Validations</b></u></p>
26+
<p>Validated model - EAB 04/2010</p>
1927
<p><b>--------------------------------------------------------------<br>
2028
Licensed by EDF under the Modelica License 2<br>
2129
Copyright &copy; EDF 2009 - 2016<br>
22-
BuildSysPro version 2015.12<br>
30+
BuildSysPro version 2.0.0<br>
2331
Author : EDF<br>
2432
--------------------------------------------------------------</b></p>
2533
</html>"),

BuildSysPro/BaseClasses/HeatTransfer/Components/ExtConvection.mo

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
1-
within BuildSysPro.BaseClasses.HeatTransfer.Components;
1+
within BuildSysPro.BaseClasses.HeatTransfer.Components;
22
model ExtConvection
3-
"Coefficient d'échange convectif tenant compte de la vitesse du vent"
3+
"Convective heat exchange coefficient taking into account the wind"
44
extends BaseClasses.HeatTransfer.Interfaces.Element1D;
55
parameter Real a;
66
parameter Real n;
77
parameter Real b;
88
parameter Modelica.SIunits.Area S;
99

10-
Modelica.Blocks.Interfaces.RealInput v "vitesse du vent [m/s]"
10+
Modelica.Blocks.Interfaces.RealInput v "Wind speed [m/s]"
1111
annotation (Placement(transformation(
1212
extent={{-110,26},{-70,66}}), iconTransformation(extent={{-120,20},{
1313
-80,60}})));
@@ -23,14 +23,21 @@ equation
2323
Diagram(coordinateSystem(preserveAspectRatio=true, extent={{-100,
2424
-100},{100,100}}), graphics),
2525
Documentation(info="<html>
26-
<p>Corrélation générique du coefficient d'échange convectif en fonction de la vitesse du vent sous la forme : </p>
27-
<p>hcv = a * v^n + b </p>
28-
<p>voir par exemple notice TF112 de CLIM2000 pour des exemples biblio. </p>
29-
<p>EAB avril 2010 </p>
26+
<p><u><b>Hypothesis and equations</b></u></p>
27+
<p>Generic correlation of the convective heat exchange coefficient depending on the wind speed :</p>
28+
<p><code>hcv = a * v<sup>n</sup> + b</code></p>
29+
<p><u><b>Bibliography</b></u></p>
30+
<p>See notice TF112 of CLIM2000 for examples from the bibliography.</p>
31+
<p><u><b>Instructions for use</b></u></p>
32+
<p>none</p>
33+
<p><u><b>Known limits / Use precautions</b></u></p>
34+
<p>none</p>
35+
<p><u><b>Validations</b></u></p>
36+
<p>Validated model - EAB 04/2010</p>
3037
<p><b>--------------------------------------------------------------<br>
3138
Licensed by EDF under the Modelica License 2<br>
3239
Copyright &copy; EDF 2009 - 2016<br>
33-
BuildSysPro version 2015.12<br>
40+
BuildSysPro version 2.0.0<br>
3441
Author : EDF<br>
3542
--------------------------------------------------------------</b></p>
3643
</html>"));

BuildSysPro/BaseClasses/HeatTransfer/Components/ExtLWR.mo

Lines changed: 29 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,38 @@
11
within BuildSysPro.BaseClasses.HeatTransfer.Components;
2-
model ExtLWR "Echanges GLO avec l'environnement et le ciel"
2+
model ExtLWR
3+
"Long wavelength radiation exchanges with the sky and the environment"
34

45
parameter Modelica.SIunits.Area S=1 "Surface";
5-
parameter Real eps=0.5 "Emissivité";
6+
parameter Real eps=0.5 "Emissivity";
67
parameter Modelica.SIunits.Conversions.NonSIunits.Angle_deg incl
7-
"Inclinaison de la surface par rapport à l'horizontale - vers le sol=180°, vers le ciel=0°, verticale=90°";
8+
"Tilt of the surface relative to the horizontal - toward the ground=180°, toward the sky=0°, vertical=90°";
89
parameter Boolean GLO_env=true
9-
"Prise en compte de rayonnement GLO vers l'environnement";
10+
"Integration of long wavelength radiation (infrared) toward the environment";
1011
parameter Boolean GLO_ciel=true
11-
"Prise en compte de rayonnement GLO vers le ciel";
12+
"Integration of long wavelength radiation (infrared) toward the sky";
1213

1314
BuildSysPro.BaseClasses.HeatTransfer.Interfaces.HeatPort_a T_ciel
14-
"Température du ciel" annotation (Placement(transformation(extent={{-100,-60},
15+
"Sky temperature" annotation (Placement(transformation(extent={{-100,-60},
1516
{-80,-40}}, rotation=0)));
1617
BuildSysPro.BaseClasses.HeatTransfer.Components.BodyRadiation GLOenv(Gr=GrEnv)
17-
"Echange GLO avec l'environnement"
18+
"Long wavelength exchanges with the environment"
1819
annotation (Placement(transformation(extent={{-28,28},{4,60}})));
1920
BuildSysPro.BaseClasses.HeatTransfer.Components.BodyRadiation GLOciel(Gr=GrCiel)
20-
"Echange GLO avec le ciel"
21+
"Long wavelength exchanges with the sky"
2122
annotation (Placement(transformation(extent={{-32,-66},{2,-32}})));
2223
BuildSysPro.BaseClasses.HeatTransfer.Interfaces.HeatPort_a T_ext
23-
"Température extérieure (de l'environnement)" annotation (Placement(
24+
"Outside temperature (of the environment)" annotation (Placement(
2425
transformation(extent={{-100,20},{-80,40}}, rotation=0)));
2526
BuildSysPro.BaseClasses.HeatTransfer.Interfaces.HeatPort_b Ts_p
26-
"Température de surface de la paroi" annotation (Placement(transformation(
27+
"Outside temperature at the wall surface" annotation (Placement(transformation(
2728
extent={{80,-10},{100,10}}, rotation=0), iconTransformation(extent={{
2829
80,-10},{100,10}})));
2930

3031
protected
3132
parameter Real GrEnv= if GLO_env then eps*S*(0.5*(1-cos(incl*Modelica.Constants.pi/180))) else 0
32-
"Net radiation conductance between two surfaces (Env-paroi)";
33+
"Net radiation conductance between two surfaces (Env-Wall)";
3334
parameter Real GrCiel= if GLO_ciel then eps*S*(0.5*(1+cos(incl*Modelica.Constants.pi/180))) else 0
34-
"Net radiation conductance between two surfaces (Ciel-paroi)";
35+
"Net radiation conductance between two surfaces (Sky-Wall)";
3536

3637
equation
3738
connect(T_ext, GLOenv.port_a) annotation (Line(
@@ -98,38 +99,36 @@ annotation (
9899
fillColor={191,0,0},
99100
fillPattern=FillPattern.Solid)}),
100101
Documentation(info="<html>
101-
<h4>Modèle permettant de calculer les échanges par rayonnement GLO avec le ciel et l'environnement</h4>
102-
<p><u><b>Hypothèses et équations</b></u></p>
103-
<p>Le flux de rayonnement GLO a deux origines : l'environnement et le ciel. On fait plusieurs hypothèses :</p>
102+
<p>Calculation of long wavelength radiation exchanges with the sky and the environment</p>
103+
<p><u><b>Hypothesis and equations</b></u></p>
104+
<p>The solar flux with long wavelength radiation has two sources : the environment and the sky. Different hypothesis have been made :</p>
104105
<ul>
105-
<li>Le flux dû au ciel est supposé isotrope </li>
106-
<li>La paroi échange avec le ciel et l'environnement uniquement en fonction de son inclinaison et de son émissivité GLO.</li>
107-
<li>Le ciel et l'environnement sont des corps noirs isothermes.</li>
106+
<li>The flux from the sky is supposed isotropic.</li>
107+
<li>The exchanges between the wall, the sky and the environment are supposed to depend only on the tilt and the long wavelength emissivity.</li>
108+
<li>The sky and the environment are supposed to be isothermal black bodies.</li>
108109
</ul>
109-
<p>Le flux radiatif net échangé entre une paroi et l'extérieur est calculé avec la fonction ci-après : </p>
110+
<p>The radiative net fux exchanged between a wall and the outside is calculated with the function below :</p>
110111
<p><img src=\"modelica://BuildSysPro/Resources/Images/Equations/FluxGLOEnv.png\"/></p>
111-
<p> <img src=\"modelica://BuildSysPro/Resources/Images/Equations/equation-DUkSL5mr.png\" alt=\"sigma\"/> est la constante de Stefan-Boltzmann.</p>
112-
<p><u><b>Bibliographie</b></u></p>
112+
<p>Where <img src=\"modelica://BuildSysPro/Resources/Images/Equations/equation-DUkSL5mr.png\" alt=\"sigma\"/> is the Stefan-Boltzmann constant.</p>
113+
<p><u><b>Bibliography</b></u></p>
113114
<p>TF1 CLIM2000</p>
114-
<p><u><b>Mode d'emploi</b></u></p>
115-
<p><b>Typical values for epsilon</b><i> (d'après le modèle Modelica.Thermal.HeatTransfer.Components.BodyRadiation)</i></p>
115+
<p><u><b>Instructions for use</b></u></p>
116+
<p>Typical values for epsilon <i>(from <a href=\"BuildSysPro.BaseClasses.HeatTransfer.Components.BodyRadiation\">BodyRadiation</a> model)</i> :</p>
116117
<pre> aluminium, polished 0.04
117118
copper, polished 0.04
118119
gold, polished 0.02
119120
paper 0.09
120121
rubber 0.95
121122
silver, polished 0.02
122123
wood 0.85..0.9</pre>
123-
<p><u><b>Limites connues du modèle / Précautions d'utilisation</b></u></p>
124-
<ul>
125-
<li>Ce modèle étant utilisé dans un modèle de paroi avec échanges convectifs et radiatifs à sa surface, il faut prendre garde à ce que le coefficient d'échange superficiel extérieur soit un vrai coefficient d'échange convectif au lieu d'intégrer le rayonnement GLO.</li>
126-
</ul>
127-
<p><u><b>Validations effectuées</b></u></p>
128-
<p>Modèle validé (Vérification analytique + vérification de la cohérence de l'allure des flux échangés) - Aurélie Kaemmerlen 09/2011</p>
124+
<p><u><b>Known limits / Use precautions</b></u></p>
125+
<p>As this model is used in a wall model with convective and radiatives exchanges on its surface, care must be taken to ensure that the outside superficial heat exchange coefficient is a real convective heat exchange coefficient instead of integrating the long wavelength radiation.</p>
126+
<p><u><b>Validations</b></u></p>
127+
<p>Validated model (analytical verification + verification of the coherence of the exchanged fluxes profile) - Aurélie Kaemmerlen 09/2011</p>
129128
<p><b>--------------------------------------------------------------<br>
130129
Licensed by EDF under the Modelica License 2<br>
131130
Copyright &copy; EDF 2009 - 2016<br>
132-
BuildSysPro version 2015.12<br>
131+
BuildSysPro version 2.0.0<br>
133132
Author : Aurélie KAEMMERLEN, EDF (2011)<br>
134133
Initial model : <a href=\"Modelica.Thermal.HeatTransfer.Components.BodyRadiation\">BodyRadiation</a>, Anton Haumer, Copyright © Modelica Association, Michael Tiller and DLR.<br>
135134
--------------------------------------------------------------</b></p>

BuildSysPro/BaseClasses/HeatTransfer/Components/HeatCapacitor.mo

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
within BuildSysPro.BaseClasses.HeatTransfer.Components;
2-
model HeatCapacitor "Element stockant de la chaleur"
2+
model HeatCapacitor "Heat capacitor"
33
parameter Modelica.SIunits.HeatCapacity C
4-
"Capacité thermique de l'élément (= cp*m)";
4+
"Heat capacity of the element (= cp*m)";
55

66
Modelica.SIunits.Temperature T( displayUnit="degC")
7-
"Température de l'élement";
7+
"Temperature of the element";
88
Modelica.SIunits.TemperatureSlope der_T(start=0)
9-
"Dérivée de la température par rapport au temps (= der(T))";
9+
"Time derivative of the temperature (= der(T))";
1010

1111
BaseClasses.HeatTransfer.Interfaces.HeatPort_a port annotation (Placement(
1212
transformation(extent={{0,-100},{20,-80}}, rotation=0)));
@@ -50,6 +50,7 @@ equation
5050
-100},{100,100}}),
5151
graphics),
5252
Documentation(info="<html>
53+
<p><u><b>Hypothesis and equations</b></u></p>
5354
<p>This is a generic model for the heat capacity of a material. No specific geometry is assumed beyond a total volume with uniform temperature for the entire volume. Furthermore, it is assumed that the heat capacity is constant (indepedent of temperature). </p>
5455
<p>The temperature T [Kelvin] of this component is a <b>state</b>. A default of T = 25 degree Celsius (= SIunits.Conversions.from_degC(25)) is used as start value for initialization. This usually means that at start of integration the temperature of this component is 25 degrees Celsius. You may, of course, define a different temperature as start value for initialization. Alternatively, it is possible to set parameter <b>steadyStateStart</b> to <b>true</b>. In this case the additional equation '<b>der</b>(T) = 0' is used during initialization, i.e., the temperature T is computed in such a way that the component starts in <b>steady state</b>. This is useful in cases, where one would like to start simulation in a suitable operating point without being forced to integrate for a long time to arrive at this point. </p>
5556
<p>Note, that parameter <b>steadyStateStart</b> is not available in the parameter menue of the simulation window, because its value is utilized during translation to generate quite different equations depending on its setting. Therefore, the value of this parameter can only be changed before translating the model. </p>
@@ -63,10 +64,18 @@ equation
6364
silver 235
6465
steel 420 ... 500 (V2A)
6566
wood 2500</pre>
67+
<p><u><b>Bibliography</b></u></p>
68+
<p>none</p>
69+
<p><u><b>Instructions for use</b></u></p>
70+
<p>none</p>
71+
<p><u><b>Known limits / Use precautions</b></u></p>
72+
<p>none</p>
73+
<p><u><b>Validations</b></u></p>
74+
<p>Validated model</p>
6675
<p><b>--------------------------------------------------------------<br>
6776
Licensed by EDF under the Modelica License 2<br>
6877
Copyright &copy; EDF 2009 - 2016<br>
69-
BuildSysPro version 2015.12<br>
78+
BuildSysPro version 2.0.0<br>
7079
Initial model : <a href=\"Modelica.Thermal.HeatTransfer.Components.HeatCapacitor\">HeatCapacitor</a>, Anton Haumer, Copyright © Modelica Association, Michael Tiller and DLR.<br>
7180
--------------------------------------------------------------</b></p>
7281
</html>"));

0 commit comments

Comments
 (0)