From d38038b53916de16ecfaf71e24ab6501b904898c Mon Sep 17 00:00:00 2001
From: hcasperfu <hcasperfu@lbl.gov>
Date: Wed, 28 Feb 2024 13:45:45 -0800
Subject: [PATCH 01/13] moved models

---
 .../Multizone/BaseClasses/Examples/package.order       |  1 -
 IBPSA/Airflow/Multizone/BaseClasses/package.order      |  1 -
 IBPSA/Airflow/Multizone/Table_m_flow.mo                |  2 +-
 ..._Utilities_Math_Functions_Examples_Interpolate.txt} |  0
 .../Math/Functions}/Examples/Interpolate.mos           |  2 +-
 .../Math/Functions}/Examples/Interpolate.mo            | 10 +++++-----
 IBPSA/Utilities/Math/Functions/Examples/package.order  |  1 +
 .../Math/Functions}/interpolate.mo                     |  2 +-
 IBPSA/Utilities/Math/Functions/package.order           |  1 +
 9 files changed, 10 insertions(+), 10 deletions(-)
 rename IBPSA/Resources/ReferenceResults/Dymola/{IBPSA_Airflow_Multizone_BaseClasses_Examples_Interpolate.txt => IBPSA_Utilities_Math_Functions_Examples_Interpolate.txt} (100%)
 rename IBPSA/Resources/Scripts/Dymola/{Airflow/Multizone/BaseClasses => Utilities/Math/Functions}/Examples/Interpolate.mos (62%)
 rename IBPSA/{Airflow/Multizone/BaseClasses => Utilities/Math/Functions}/Examples/Interpolate.mo (83%)
 rename IBPSA/{Airflow/Multizone/BaseClasses => Utilities/Math/Functions}/interpolate.mo (98%)

diff --git a/IBPSA/Airflow/Multizone/BaseClasses/Examples/package.order b/IBPSA/Airflow/Multizone/BaseClasses/Examples/package.order
index e841c46bf2..d11030019d 100644
--- a/IBPSA/Airflow/Multizone/BaseClasses/Examples/package.order
+++ b/IBPSA/Airflow/Multizone/BaseClasses/Examples/package.order
@@ -1,4 +1,3 @@
-Interpolate
 PowerLaw
 PowerLawFixedM
 WindPressureLowRise
diff --git a/IBPSA/Airflow/Multizone/BaseClasses/package.order b/IBPSA/Airflow/Multizone/BaseClasses/package.order
index 698bba52a4..ab4a1d1fef 100644
--- a/IBPSA/Airflow/Multizone/BaseClasses/package.order
+++ b/IBPSA/Airflow/Multizone/BaseClasses/package.order
@@ -6,7 +6,6 @@ PowerLawResistanceParameters
 TwoWayFlowElement
 TwoWayFlowElementBuoyancy
 ZonalFlow
-interpolate
 powerLaw
 powerLawFixedM
 windPressureLowRise
diff --git a/IBPSA/Airflow/Multizone/Table_m_flow.mo b/IBPSA/Airflow/Multizone/Table_m_flow.mo
index f736baf4b8..f17dd0c252 100644
--- a/IBPSA/Airflow/Multizone/Table_m_flow.mo
+++ b/IBPSA/Airflow/Multizone/Table_m_flow.mo
@@ -2,7 +2,7 @@ within IBPSA.Airflow.Multizone;
 model Table_m_flow
   "Mass flow(y-axis) vs Pressure(x-axis) cubic spline fit model based from table data, with last two points linearly interpolated"
   extends IBPSA.Airflow.Multizone.BaseClasses.PartialOneWayFlowElement(
-    m_flow = IBPSA.Airflow.Multizone.BaseClasses.interpolate(
+    m_flow = IBPSA.Utilities.Math.Functions.interpolate(
       u=dp,
       xd=dpMea_nominal,
       yd=mMea_flow_nominal,
diff --git a/IBPSA/Resources/ReferenceResults/Dymola/IBPSA_Airflow_Multizone_BaseClasses_Examples_Interpolate.txt b/IBPSA/Resources/ReferenceResults/Dymola/IBPSA_Utilities_Math_Functions_Examples_Interpolate.txt
similarity index 100%
rename from IBPSA/Resources/ReferenceResults/Dymola/IBPSA_Airflow_Multizone_BaseClasses_Examples_Interpolate.txt
rename to IBPSA/Resources/ReferenceResults/Dymola/IBPSA_Utilities_Math_Functions_Examples_Interpolate.txt
diff --git a/IBPSA/Resources/Scripts/Dymola/Airflow/Multizone/BaseClasses/Examples/Interpolate.mos b/IBPSA/Resources/Scripts/Dymola/Utilities/Math/Functions/Examples/Interpolate.mos
similarity index 62%
rename from IBPSA/Resources/Scripts/Dymola/Airflow/Multizone/BaseClasses/Examples/Interpolate.mos
rename to IBPSA/Resources/Scripts/Dymola/Utilities/Math/Functions/Examples/Interpolate.mos
index 8d1f874fd5..a684903a75 100644
--- a/IBPSA/Resources/Scripts/Dymola/Airflow/Multizone/BaseClasses/Examples/Interpolate.mos
+++ b/IBPSA/Resources/Scripts/Dymola/Utilities/Math/Functions/Examples/Interpolate.mos
@@ -1,2 +1,2 @@
-simulateModel("IBPSA.Airflow.Multizone.BaseClasses.Examples.Interpolate", stopTime=500, tolerance=1e-06, resultFile="Interpolate");
+simulateModel("IBPSA.Utilities.Math.Functions.Examples.Interpolate", stopTime=500, tolerance=1e-06, resultFile="Interpolate");
 createPlot(id=1, position={15, 15, 584, 361}, x="dp", y={"m_flow"}, range={-50.0, 50.0, -0.1, 0.04000000000000001}, grid=true, filename="Interpolate.mat", colors={{28,108,200}}, timeUnit="Pa", displayUnits={"kg/s"});
diff --git a/IBPSA/Airflow/Multizone/BaseClasses/Examples/Interpolate.mo b/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
similarity index 83%
rename from IBPSA/Airflow/Multizone/BaseClasses/Examples/Interpolate.mo
rename to IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
index d8bc5892ce..62f3e9559c 100644
--- a/IBPSA/Airflow/Multizone/BaseClasses/Examples/Interpolate.mo
+++ b/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
@@ -1,4 +1,4 @@
-within IBPSA.Airflow.Multizone.BaseClasses.Examples;
+within IBPSA.Utilities.Math.Functions.Examples;
 model Interpolate "Test model for the interpolation function"
   extends Modelica.Icons.Example;
 
@@ -28,18 +28,18 @@ initial equation
     ensureMonotonicity=true);
 equation
    dp=ramp.y;
-   m_flow =IBPSA.Airflow.Multizone.BaseClasses.interpolate(u=dp,xd=xd,yd=yd,d=d);
+   m_flow =IBPSA.Utilities.Math.Functions.interpolate(u=dp,xd=xd,yd=yd,d=d);
 
   annotation (
 experiment(
       StopTime=500,
       Tolerance=1e-06),
-  __Dymola_Commands(file="modelica://IBPSA/Resources/Scripts/Dymola/Airflow/Multizone/BaseClasses/Examples/Interpolate.mos"
+  __Dymola_Commands(file="modelica://IBPSA/Resources/Scripts/Dymola/Utilities/Math/Functions/Examples/Interpolate.mos"
         "Simulate and plot"), Documentation(info="<html>
 <p>
 This example demonstrates the function
-<a href=\"modelica://IBPSA.Airflow.Multizone.BaseClasses.interpolate\">
-IBPSA.Airflow.Multizone.BaseClasses.interpolate</a>.
+<a href=\"modelica://IBPSA.Utilities.Math.Functions.interpolate\">
+IBPSA.Utilities.Math.Functions.interpolate</a>.
 </p>
 </html>", revisions="<html>
 <ul>
diff --git a/IBPSA/Utilities/Math/Functions/Examples/package.order b/IBPSA/Utilities/Math/Functions/Examples/package.order
index 1f7f461fae..a073d84717 100644
--- a/IBPSA/Utilities/Math/Functions/Examples/package.order
+++ b/IBPSA/Utilities/Math/Functions/Examples/package.order
@@ -7,6 +7,7 @@ CubicHermite
 ExponentialIntegralE1
 Factorial
 FallingFactorial
+Interpolate
 InverseXDerivativeCheck
 InverseXDerivative_2_Check
 InverseXRegularized
diff --git a/IBPSA/Airflow/Multizone/BaseClasses/interpolate.mo b/IBPSA/Utilities/Math/Functions/interpolate.mo
similarity index 98%
rename from IBPSA/Airflow/Multizone/BaseClasses/interpolate.mo
rename to IBPSA/Utilities/Math/Functions/interpolate.mo
index 2b768fe7ab..0fec91b1ab 100644
--- a/IBPSA/Airflow/Multizone/BaseClasses/interpolate.mo
+++ b/IBPSA/Utilities/Math/Functions/interpolate.mo
@@ -1,4 +1,4 @@
-within IBPSA.Airflow.Multizone.BaseClasses;
+within IBPSA.Utilities.Math.Functions;
 function interpolate
   "Function for the interpolation of table data for airflow models"
   extends Modelica.Icons.Function;
diff --git a/IBPSA/Utilities/Math/Functions/package.order b/IBPSA/Utilities/Math/Functions/package.order
index ff8b7e92e6..b809973459 100644
--- a/IBPSA/Utilities/Math/Functions/package.order
+++ b/IBPSA/Utilities/Math/Functions/package.order
@@ -12,6 +12,7 @@ exponentialIntegralE1
 factorial
 fallingFactorial
 integerReplicator
+interpolate
 inverseXRegularized
 isMonotonic
 polynomial

From e0adeb6f3d733642edd53311cfad1b745e1d287c Mon Sep 17 00:00:00 2001
From: hcasperfu <hcasperfu@lbl.gov>
Date: Wed, 28 Feb 2024 13:49:44 -0800
Subject: [PATCH 02/13] updated change log

---
 .../Utilities/Math/Functions/Examples/Interpolate.mo  | 11 +++++++++++
 IBPSA/Utilities/Math/Functions/interpolate.mo         | 11 +++++++++++
 2 files changed, 22 insertions(+)

diff --git a/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo b/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
index 62f3e9559c..fdcdb66177 100644
--- a/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
+++ b/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
@@ -44,6 +44,17 @@ IBPSA.Utilities.Math.Functions.interpolate</a>.
 </html>", revisions="<html>
 <ul>
 <li>
+February 29, 2024, by Hongxiang Fu:<br/>
+Moved to
+<a href=\"modelica://IBPSA.Utilities.Math.Functions.Examples\">
+IBPSA.Utilities.Math.Functions</a>
+from
+<a href=\"modelica://IBPSA.Airflow.Multizone.BaseClasses.Examples\">
+IBPSA.Airflow.Multizone.BaseClasses</a>.<br/>
+This is for
+<a href=\"https://github.com/ibpsa/modelica-ibpsa/issues/1844\">IBPSA, #1844</a>.
+</li>
+<li>
 February 2, 2022, by Michael Wetter:<br/>
 Revised implementation.<br/>
 This is for
diff --git a/IBPSA/Utilities/Math/Functions/interpolate.mo b/IBPSA/Utilities/Math/Functions/interpolate.mo
index 0fec91b1ab..c6043dcc74 100644
--- a/IBPSA/Utilities/Math/Functions/interpolate.mo
+++ b/IBPSA/Utilities/Math/Functions/interpolate.mo
@@ -60,6 +60,17 @@ National Institute of Standards and Technology, NIST TN 1887, Sep. 2015. doi:
 </html>", revisions="<html>
 <ul>
 <li>
+February 29, 2024, by Hongxiang Fu:<br/>
+Moved to
+<a href=\"modelica://IBPSA.Utilities.Math.Functions\">
+IBPSA.Utilities.Math.Functions</a>
+from
+<a href=\"modelica://IBPSA.Airflow.Multizone.BaseClasses\">
+IBPSA.Airflow.Multizone.BaseClasses</a>.<br/>
+This is for
+<a href=\"https://github.com/ibpsa/modelica-ibpsa/issues/1844\">IBPSA, #1844</a>.
+</li>
+<li>
 February 26, 2024, by Hongxiang Fu:<br/>
 Correct implementation to make it smooth.<br/>
 This is for

From 91486b905cebd5f7d5067e4605df9085bbe8078b Mon Sep 17 00:00:00 2001
From: hcasperfu <hcasperfu@lbl.gov>
Date: Wed, 28 Feb 2024 14:15:05 -0800
Subject: [PATCH 03/13] created block

---
 IBPSA/Utilities/Math/Interpolate.mo | 31 +++++++++++++++++++++++++++++
 IBPSA/Utilities/Math/package.order  |  1 +
 2 files changed, 32 insertions(+)
 create mode 100644 IBPSA/Utilities/Math/Interpolate.mo

diff --git a/IBPSA/Utilities/Math/Interpolate.mo b/IBPSA/Utilities/Math/Interpolate.mo
new file mode 100644
index 0000000000..9869d16f69
--- /dev/null
+++ b/IBPSA/Utilities/Math/Interpolate.mo
@@ -0,0 +1,31 @@
+within IBPSA.Utilities.Math;
+block Interpolate
+  "Output the smooth interpolation of the input signal on the given curve"
+  extends Modelica.Blocks.Interfaces.SISO;
+
+  parameter Real[:] xd "X-axis support points";
+  parameter Real[size(xd, 1)] yd "Y-axis support points";
+  parameter Real[size(xd, 1)] d(each fixed=false) "Derivatives at the support points";
+equation
+  y = IBPSA.Utilities.Math.Functions.interpolate(u=u,xd=xd,yd=yd,d=d);
+
+annotation (
+defaultComponentName="int",
+    Documentation(info="<html>
+<p>
+This block outputs the value on a cubic hermite spline through the given
+support points and their spline derivatives at these points, using the function
+<a href=\"modelica://IBPSA.Utilities.Math.Functions.interpolate\">
+IBPSA.Utilities.Math.Functions.interpolate</a>.
+</p>
+</html>", revisions="<html>
+<ul>
+<li>
+February 29, 2024, by Hongxiang Fu:<br/>
+First implementation.<br/>
+This is for
+<a href=\"https://github.com/ibpsa/modelica-ibpsa/issues/1844\">IBPSA, #1844</a>.
+</li>
+</ul>
+</html>"));
+end Interpolate;
diff --git a/IBPSA/Utilities/Math/package.order b/IBPSA/Utilities/Math/package.order
index 7fa4d9a94b..72bc222a56 100644
--- a/IBPSA/Utilities/Math/package.order
+++ b/IBPSA/Utilities/Math/package.order
@@ -12,6 +12,7 @@ Factorial
 FallingFactorial
 IntegerReplicator
 IntegratorWithReset
+Interpolate
 InverseXRegularized
 Max
 Min

From cbb122e761b49a45c8eecc8d76232fa33ba3bcdd Mon Sep 17 00:00:00 2001
From: hcasperfu <hcasperfu@lbl.gov>
Date: Wed, 28 Feb 2024 14:58:27 -0800
Subject: [PATCH 04/13] created example model for the block

---
 .../Utilities/Math/Examples/Interpolate.mos   |  2 +
 IBPSA/Utilities/Math/Examples/Interpolate.mo  | 54 +++++++++++++++++++
 IBPSA/Utilities/Math/Examples/package.order   |  1 +
 IBPSA/Utilities/Math/Interpolate.mo           |  2 +-
 4 files changed, 58 insertions(+), 1 deletion(-)
 create mode 100644 IBPSA/Resources/Scripts/Dymola/Utilities/Math/Examples/Interpolate.mos
 create mode 100644 IBPSA/Utilities/Math/Examples/Interpolate.mo

diff --git a/IBPSA/Resources/Scripts/Dymola/Utilities/Math/Examples/Interpolate.mos b/IBPSA/Resources/Scripts/Dymola/Utilities/Math/Examples/Interpolate.mos
new file mode 100644
index 0000000000..43a18535fa
--- /dev/null
+++ b/IBPSA/Resources/Scripts/Dymola/Utilities/Math/Examples/Interpolate.mos
@@ -0,0 +1,2 @@
+simulateModel("IBPSA.Utilities.Math.Examples.Interpolate", stopTime=500, tolerance=1e-06, resultFile="InterpolateBlock");
+createPlot(id=1, position={15, 15, 584, 361}, x="int.u", y={"int.y"}, range={-50.0, 50.0, -0.1, 0.04000000000000001}, grid=true, filename="InterpolateBlock.mat", colors={{28,108,200}}, timeUnit="Pa", displayUnits={"kg/s"});
diff --git a/IBPSA/Utilities/Math/Examples/Interpolate.mo b/IBPSA/Utilities/Math/Examples/Interpolate.mo
new file mode 100644
index 0000000000..15805509b9
--- /dev/null
+++ b/IBPSA/Utilities/Math/Examples/Interpolate.mo
@@ -0,0 +1,54 @@
+within IBPSA.Utilities.Math.Examples;
+model Interpolate "Example model of the Interpolate block"
+  extends Modelica.Icons.Example;
+
+  parameter Real table[:,:]=[-50,-0.08709; -25,-0.06158; -10,-0.03895; -5,-0.02754;
+    -3,-0.02133; -2,-0.01742; -1,-0.01232; 0,0; 1,0.01232; 2,0.01742; 3,0.02133;
+    4.5,0.02613; 50,0.02614]
+    "Table of mass flow rate in kg/s (second column) as a function of pressure difference in Pa (first column)";
+  parameter Real[:] xd=table[:,1] "X-axis support points";
+  parameter Real[size(xd, 1)] yd=table[:,2] "Y-axis support points";
+  parameter Real[size(xd, 1)] d =
+    IBPSA.Utilities.Math.Functions.splineDerivatives(
+      x=xd,
+      y=yd,
+      ensureMonotonicity=true) "Derivatives at the support points";
+
+  IBPSA.Utilities.Math.Interpolate int(
+    xd=xd,
+    yd=yd,
+    d=d) "Interpolate block"
+    annotation (Placement(transformation(extent={{-10,-10},{10,10}})));
+  Modelica.Blocks.Sources.Ramp ramp(
+    duration=500,
+    height=100,
+    offset=-50) "Ramp from -50Pa to +50Pa"
+    annotation (Placement(transformation(extent={{-60,-10},{-40,10}})));
+
+equation
+  connect(ramp.y, int.u)
+    annotation (Line(points={{-39,0},{-12,0}}, color={0,0,127}));
+annotation (
+experiment(
+      StopTime=500,
+      Tolerance=1e-06),
+  __Dymola_Commands(file="modelica://IBPSA/Resources/Scripts/Dymola/Utilities/Math/Examples/Interpolate.mos"
+        "Simulate and plot"), Documentation(info="<html>
+<p>
+This example is the same as
+<a href=\"modelica://IBPSA.Utilities.Math.Functions.Examples.Interpolate\">
+IBPSA.Utilities.Math.Functions.Examples.Interpolate</a>
+except that the block is used in place of the function.
+</p>
+</html>", revisions="<html>
+<ul>
+<li>
+February 29, 2024, by Hongxiang Fu:<br/>
+First implementation.<br/>
+This is for
+<a href=\"https://github.com/ibpsa/modelica-ibpsa/issues/1844\">IBPSA, #1844</a>.
+</li>
+</ul>
+</html>
+"));
+end Interpolate;
diff --git a/IBPSA/Utilities/Math/Examples/package.order b/IBPSA/Utilities/Math/Examples/package.order
index 4504982d1f..8dd737c07e 100644
--- a/IBPSA/Utilities/Math/Examples/package.order
+++ b/IBPSA/Utilities/Math/Examples/package.order
@@ -12,6 +12,7 @@ Factorial
 FallingFactorial
 IntegerReplicator
 IntegratorWithReset
+Interpolate
 InverseXRegularized
 Polynomial
 PowerLinearized
diff --git a/IBPSA/Utilities/Math/Interpolate.mo b/IBPSA/Utilities/Math/Interpolate.mo
index 9869d16f69..0078326b23 100644
--- a/IBPSA/Utilities/Math/Interpolate.mo
+++ b/IBPSA/Utilities/Math/Interpolate.mo
@@ -5,7 +5,7 @@ block Interpolate
 
   parameter Real[:] xd "X-axis support points";
   parameter Real[size(xd, 1)] yd "Y-axis support points";
-  parameter Real[size(xd, 1)] d(each fixed=false) "Derivatives at the support points";
+  parameter Real[size(xd, 1)] d "Derivatives at the support points";
 equation
   y = IBPSA.Utilities.Math.Functions.interpolate(u=u,xd=xd,yd=yd,d=d);
 

From 7e799c25c57c6ca99ac6e0048b09da4a24eb2349 Mon Sep 17 00:00:00 2001
From: hcasperfu <hcasperfu@lbl.gov>
Date: Wed, 28 Feb 2024 15:21:22 -0800
Subject: [PATCH 05/13] created icon

---
 IBPSA/Utilities/Math/Interpolate.mo | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/IBPSA/Utilities/Math/Interpolate.mo b/IBPSA/Utilities/Math/Interpolate.mo
index 0078326b23..eec816aea0 100644
--- a/IBPSA/Utilities/Math/Interpolate.mo
+++ b/IBPSA/Utilities/Math/Interpolate.mo
@@ -27,5 +27,25 @@ This is for
 <a href=\"https://github.com/ibpsa/modelica-ibpsa/issues/1844\">IBPSA, #1844</a>.
 </li>
 </ul>
-</html>"));
+</html>"),
+    Icon(graphics={
+        Ellipse(
+          extent={{-58,-56},{-68,-46}},
+          lineColor={28,108,200},
+          fillColor={28,108,200},
+          fillPattern=FillPattern.Solid),
+        Line(
+          points={{-64,-52},{-36,6},{8,40},{78,26}},
+          color={28,108,200},
+          smooth=Smooth.Bezier),
+        Ellipse(
+          extent={{82,20},{72,30}},
+          lineColor={28,108,200},
+          fillColor={28,108,200},
+          fillPattern=FillPattern.Solid),
+        Ellipse(
+          extent={{-10,18},{-20,28}},
+          lineColor={28,108,200},
+          fillColor={28,108,200},
+          fillPattern=FillPattern.Solid)}));
 end Interpolate;

From 459009abf72dd3502ce34903ab72437dec59a6a6 Mon Sep 17 00:00:00 2001
From: hcasperfu <hcasperfu@lbl.gov>
Date: Thu, 29 Feb 2024 08:21:05 -0800
Subject: [PATCH 06/13] created result files

---
 .../Dymola/IBPSA_Utilities_Math_Examples_Interpolate.txt | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 IBPSA/Resources/ReferenceResults/Dymola/IBPSA_Utilities_Math_Examples_Interpolate.txt

diff --git a/IBPSA/Resources/ReferenceResults/Dymola/IBPSA_Utilities_Math_Examples_Interpolate.txt b/IBPSA/Resources/ReferenceResults/Dymola/IBPSA_Utilities_Math_Examples_Interpolate.txt
new file mode 100644
index 0000000000..b7c14e9f57
--- /dev/null
+++ b/IBPSA/Resources/ReferenceResults/Dymola/IBPSA_Utilities_Math_Examples_Interpolate.txt
@@ -0,0 +1,9 @@
+last-generated=2024-02-29
+statistics-simulation=
+{
+  "linear": " ",
+  "nonlinear": " ",
+  "numerical Jacobians": "0"
+}
+time=[0e+00, 5e+02]
+int.y=[-8.709000051021576e-02, -8.607897162437439e-02, -8.508513867855072e-02, -8.410613983869553e-02, -8.313964307308197e-02, -8.218330889940262e-02, -8.123478293418884e-02, -8.029171824455261e-02, -7.935179024934769e-02, -7.841263711452484e-02, -7.747191935777664e-02, -7.652729749679565e-02, -7.557642459869385e-02, -7.461696118116379e-02, -7.364656031131744e-02, -7.266288250684738e-02, -7.166357338428497e-02, -7.064630091190338e-02, -6.960871070623398e-02, -6.854847073554993e-02, -6.74632266163826e-02, -6.635063886642456e-02, -6.520836800336838e-02, -6.403406709432602e-02, -6.282539665699005e-02, -6.157999858260155e-02, -6.03080615401268e-02, -5.901877209544182e-02, -5.770833417773247e-02, -5.637295171618462e-02, -5.500881373882294e-02, -5.36121279001236e-02, -5.217909067869186e-02, -5.070589855313301e-02, -4.918875172734261e-02, -4.762385040521622e-02, -4.600739479064941e-02, -4.433558508753777e-02, -4.260461404919624e-02, -4.081068560481071e-02, -3.894999995827675e-02, -3.698130697011948e-02, -3.486191853880882e-02, -3.258588165044785e-02, -3.014722652733326e-02, -2.754000015556812e-02, -2.463850006461143e-02, -2.133000083267689e-02, -1.741999946534634e-02, -1.231999974697828e-02, 0e+00, 1.231999974697828e-02, 1.741999946534634e-02, 2.133000083267689e-02, 2.528040856122971e-02, 2.613032609224319e-02, 2.613095752894878e-02, 2.613155916333199e-02, 2.61321347206831e-02, 2.613268233835697e-02, 2.613320574164391e-02, 2.613370306789875e-02, 2.613417431712151e-02, 2.613462321460247e-02, 2.613504603505135e-02, 2.613544836640358e-02, 2.613582648336887e-02, 2.613618411123753e-02, 2.613652125000954e-02, 2.613683789968491e-02, 2.613713406026363e-02, 2.613740973174572e-02, 2.613766863942146e-02, 2.613791078329086e-02, 2.613813430070877e-02, 2.613834105432034e-02, 2.613853104412556e-02, 2.613870799541473e-02, 2.613886818289757e-02, 2.613901719450951e-02, 2.61391494423151e-02, 2.61392705142498e-02, 2.613938041031361e-02, 2.613947726786137e-02, 2.613956481218338e-02, 2.61396411806345e-02, 2.613970823585987e-02, 2.61397659778595e-02, 2.613981626927853e-02, 2.613985724747181e-02, 2.613989263772964e-02, 2.613992244005203e-02, 2.613994479179382e-02, 2.613996341824532e-02, 2.613997645676136e-02, 2.613998576998711e-02, 2.61399932205677e-02, 2.6139996945858e-02, 2.613999880850315e-02, 2.61400006711483e-02, 2.61400006711483e-02]

From 0749682ff727fc2562248718645fbef309ac6028 Mon Sep 17 00:00:00 2001
From: hcasperfu <hcasperfu@lbl.gov>
Date: Thu, 29 Feb 2024 08:57:13 -0800
Subject: [PATCH 07/13] updated documentation of smoothInterpolation() to
 direct to new function

---
 .../Math/Functions/smoothInterpolation.mo      | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/IBPSA/Utilities/Math/Functions/smoothInterpolation.mo b/IBPSA/Utilities/Math/Functions/smoothInterpolation.mo
index 05f50bfcd3..2ced8f620c 100644
--- a/IBPSA/Utilities/Math/Functions/smoothInterpolation.mo
+++ b/IBPSA/Utilities/Math/Functions/smoothInterpolation.mo
@@ -61,10 +61,20 @@ function value <i>y<sup>1</sup></i> is returned.
 </p>
 <p>
 Note that if <code>xSup</code> and <code>ySup</code> only depend on parameters
-or constants, then
-<a href=\"modelica://IBPSA.Utilities.Math.Functions.cubicHermiteLinearExtrapolation\">
-IBPSA.Utilities.Math.Functions.cubicHermiteLinearExtrapolation</a>
-will be more efficient.
+or constants and will not change during the simulation,
+it is more efficient to first call
+<a href=\"modelica://IBPSA.Utilities.Math.Functions.splineDerivatives\">
+IBPSA.Utilities.Math.Functions.splineDerivatives</a>
+to find the derivatives, and then call
+<a href=\"modelica://IBPSA.Utilities.Math.Functions.interpolate\">
+IBPSA.Utilities.Math.Functions.interpolate</a> to perform the interpolation.
+This way the derivatives only need to be computed once upon initialisation,
+not at each step during the simulation.
+See the example implemented in
+<a href=\"modelica://IBPSA.Utilities.Math.Functions.Examples.Interpolate\">
+IBPSA.Utilities.Math.Functions.Examples.Interpolate</a>.
+</p>
+<p>
 In contrast to the function
 <a href=\"modelica://Modelica.Math.Vectors.interpolate\">
 Modelica.Math.Vectors.interpolate</a>

From 0cbe50aa04949df9a186385559968b614aab81a7 Mon Sep 17 00:00:00 2001
From: Michael Wetter <mwetter@lbl.gov>
Date: Tue, 5 Mar 2024 10:39:47 -0800
Subject: [PATCH 08/13] Revised documentation

---
 IBPSA/Utilities/Math/Functions/smoothInterpolation.mo | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/IBPSA/Utilities/Math/Functions/smoothInterpolation.mo b/IBPSA/Utilities/Math/Functions/smoothInterpolation.mo
index 2ced8f620c..9a996d06a1 100644
--- a/IBPSA/Utilities/Math/Functions/smoothInterpolation.mo
+++ b/IBPSA/Utilities/Math/Functions/smoothInterpolation.mo
@@ -61,7 +61,7 @@ function value <i>y<sup>1</sup></i> is returned.
 </p>
 <p>
 Note that if <code>xSup</code> and <code>ySup</code> only depend on parameters
-or constants and will not change during the simulation,
+or constants, and therefore will not change during the simulation,
 it is more efficient to first call
 <a href=\"modelica://IBPSA.Utilities.Math.Functions.splineDerivatives\">
 IBPSA.Utilities.Math.Functions.splineDerivatives</a>

From 6d89bf37605698e7fced2bd8ebc697955474f787 Mon Sep 17 00:00:00 2001
From: Michael Wetter <mwetter@lbl.gov>
Date: Tue, 5 Mar 2024 10:42:28 -0800
Subject: [PATCH 09/13] Revised documentation

---
 IBPSA/Utilities/Math/Examples/Interpolate.mo           | 4 ++--
 IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo | 4 ++--
 IBPSA/Utilities/Math/Functions/interpolate.mo          | 4 ++--
 IBPSA/Utilities/Math/Interpolate.mo                    | 4 ++--
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/IBPSA/Utilities/Math/Examples/Interpolate.mo b/IBPSA/Utilities/Math/Examples/Interpolate.mo
index 15805509b9..0c63bd0737 100644
--- a/IBPSA/Utilities/Math/Examples/Interpolate.mo
+++ b/IBPSA/Utilities/Math/Examples/Interpolate.mo
@@ -6,8 +6,8 @@ model Interpolate "Example model of the Interpolate block"
     -3,-0.02133; -2,-0.01742; -1,-0.01232; 0,0; 1,0.01232; 2,0.01742; 3,0.02133;
     4.5,0.02613; 50,0.02614]
     "Table of mass flow rate in kg/s (second column) as a function of pressure difference in Pa (first column)";
-  parameter Real[:] xd=table[:,1] "X-axis support points";
-  parameter Real[size(xd, 1)] yd=table[:,2] "Y-axis support points";
+  parameter Real[:] xd=table[:,1] "x-axis support points";
+  parameter Real[size(xd, 1)] yd=table[:,2] "y-axis support points";
   parameter Real[size(xd, 1)] d =
     IBPSA.Utilities.Math.Functions.splineDerivatives(
       x=xd,
diff --git a/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo b/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
index fdcdb66177..99ddc892d3 100644
--- a/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
+++ b/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
@@ -13,8 +13,8 @@ model Interpolate "Test model for the interpolation function"
     "Mass flow rate";
 
 protected
-  parameter Real[:] xd=table[:,1] "X-axis support points";
-  parameter Real[size(xd, 1)] yd=table[:,2] "Y-axis support points";
+  parameter Real[:] xd=table[:,1] "x-axis support points";
+  parameter Real[size(xd, 1)] yd=table[:,2] "y-axis support points";
   parameter Real[size(xd, 1)] d(each fixed=false) "Derivatives at the support points";
 
   Modelica.Blocks.Sources.Ramp ramp(
diff --git a/IBPSA/Utilities/Math/Functions/interpolate.mo b/IBPSA/Utilities/Math/Functions/interpolate.mo
index c6043dcc74..c9c10f7b39 100644
--- a/IBPSA/Utilities/Math/Functions/interpolate.mo
+++ b/IBPSA/Utilities/Math/Functions/interpolate.mo
@@ -4,8 +4,8 @@ function interpolate
   extends Modelica.Icons.Function;
 
   input Real u "Independent variable";
-  input Real[:] xd "X-axis support points";
-  input Real[size(xd, 1)] yd "Y-axis support points";
+  input Real[:] xd "x-axis support points";
+  input Real[size(xd, 1)] yd "y-axis support points";
   input Real[size(xd, 1)] d(each fixed=false) "Derivatives at the support points";
 
   output Real z "Dependent variable with monotone interpolation";
diff --git a/IBPSA/Utilities/Math/Interpolate.mo b/IBPSA/Utilities/Math/Interpolate.mo
index eec816aea0..b1cac9f1f8 100644
--- a/IBPSA/Utilities/Math/Interpolate.mo
+++ b/IBPSA/Utilities/Math/Interpolate.mo
@@ -3,8 +3,8 @@ block Interpolate
   "Output the smooth interpolation of the input signal on the given curve"
   extends Modelica.Blocks.Interfaces.SISO;
 
-  parameter Real[:] xd "X-axis support points";
-  parameter Real[size(xd, 1)] yd "Y-axis support points";
+  parameter Real[:] xd "x-axis support points";
+  parameter Real[size(xd, 1)] yd "y-axis support points";
   parameter Real[size(xd, 1)] d "Derivatives at the support points";
 equation
   y = IBPSA.Utilities.Math.Functions.interpolate(u=u,xd=xd,yd=yd,d=d);

From c59df5482f8b6435b2fa266f2e15a5cab91f4e21 Mon Sep 17 00:00:00 2001
From: Michael Wetter <mwetter@lbl.gov>
Date: Tue, 5 Mar 2024 10:46:38 -0800
Subject: [PATCH 10/13] Updated documentation

---
 IBPSA/Utilities/Math/Functions/interpolate.mo | 2 +-
 IBPSA/Utilities/Math/Interpolate.mo           | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/IBPSA/Utilities/Math/Functions/interpolate.mo b/IBPSA/Utilities/Math/Functions/interpolate.mo
index c9c10f7b39..38b997c8b0 100644
--- a/IBPSA/Utilities/Math/Functions/interpolate.mo
+++ b/IBPSA/Utilities/Math/Functions/interpolate.mo
@@ -1,6 +1,6 @@
 within IBPSA.Utilities.Math.Functions;
 function interpolate
-  "Function for the interpolation of table data for airflow models"
+  "Function for cubic hermite spline interpolation of table data"
   extends Modelica.Icons.Function;
 
   input Real u "Independent variable";
diff --git a/IBPSA/Utilities/Math/Interpolate.mo b/IBPSA/Utilities/Math/Interpolate.mo
index b1cac9f1f8..604338a82e 100644
--- a/IBPSA/Utilities/Math/Interpolate.mo
+++ b/IBPSA/Utilities/Math/Interpolate.mo
@@ -1,13 +1,13 @@
 within IBPSA.Utilities.Math;
 block Interpolate
-  "Output the smooth interpolation of the input signal on the given curve"
+  "Output the cubic hermite spline interpolation of the input signal on the given curve"
   extends Modelica.Blocks.Interfaces.SISO;
 
   parameter Real[:] xd "x-axis support points";
   parameter Real[size(xd, 1)] yd "y-axis support points";
   parameter Real[size(xd, 1)] d "Derivatives at the support points";
 equation
-  y = IBPSA.Utilities.Math.Functions.interpolate(u=u,xd=xd,yd=yd,d=d);
+  y = IBPSA.Utilities.Math.Functions.interpolate(u=u, xd=xd, yd=yd, d=d);
 
 annotation (
 defaultComponentName="int",

From 211baf71e50f039a8cb6c019e5df91f09b96a7de Mon Sep 17 00:00:00 2001
From: Michael Wetter <mwetter@lbl.gov>
Date: Tue, 5 Mar 2024 10:46:59 -0800
Subject: [PATCH 11/13] Removed fixed attribute in function argument

---
 IBPSA/Utilities/Math/Functions/interpolate.mo | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/IBPSA/Utilities/Math/Functions/interpolate.mo b/IBPSA/Utilities/Math/Functions/interpolate.mo
index 38b997c8b0..56fb832770 100644
--- a/IBPSA/Utilities/Math/Functions/interpolate.mo
+++ b/IBPSA/Utilities/Math/Functions/interpolate.mo
@@ -6,7 +6,7 @@ function interpolate
   input Real u "Independent variable";
   input Real[:] xd "x-axis support points";
   input Real[size(xd, 1)] yd "y-axis support points";
-  input Real[size(xd, 1)] d(each fixed=false) "Derivatives at the support points";
+  input Real[size(xd, 1)] d "Derivatives at the support points";
 
   output Real z "Dependent variable with monotone interpolation";
 

From 4fde82520e2771ca090d2a8a23e350fffc17c5bc Mon Sep 17 00:00:00 2001
From: Michael Wetter <mwetter@lbl.gov>
Date: Tue, 5 Mar 2024 10:54:12 -0800
Subject: [PATCH 12/13] Updated link and documentation

---
 IBPSA/Utilities/Math/Functions/splineDerivatives.mo | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/IBPSA/Utilities/Math/Functions/splineDerivatives.mo b/IBPSA/Utilities/Math/Functions/splineDerivatives.mo
index 05216017aa..c5b194d4e7 100644
--- a/IBPSA/Utilities/Math/Functions/splineDerivatives.mo
+++ b/IBPSA/Utilities/Math/Functions/splineDerivatives.mo
@@ -83,13 +83,13 @@ The algorithm to ensure monotonicity is based on the method described in Fritsch
 </p>
 <p>
 This function is typically used with
-<a href=\"modelica://Buildings.Utilities.Math.Functions.cubicHermiteLinearExtrapolation\">
-Buildings.Utilities.Math.Functions.cubicHermiteLinearExtrapolation</a>
+<a href=\"modelica://IBPSA.Utilities.Math.Functions.cubicHermiteLinearExtrapolation\">
+IBPSA.Utilities.Math.Functions.cubicHermiteLinearExtrapolation</a>
 which is used to evaluate the cubic spline.
 Because in many applications, the shape of the spline depends on parameters
 which will no longer change once the initialisation is complete,
-this function computes and stores the derivatives only once instead of doing so
-at each time step to save system resources.
+this function computes and returns the derivatives so that they can be stored by the calling
+model to avoid repetitive computations.
 </p>
 <h4>References</h4>
 <p>

From 09bec6db04c89cada38858723482110d184bae88 Mon Sep 17 00:00:00 2001
From: Michael Wetter <mwetter@lbl.gov>
Date: Tue, 5 Mar 2024 11:06:47 -0800
Subject: [PATCH 13/13] Updated documentation

---
 IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo | 4 ++--
 IBPSA/Utilities/Math/Functions/interpolate.mo          | 6 +++++-
 IBPSA/Utilities/Math/Functions/splineDerivatives.mo    | 4 ++--
 3 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo b/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
index 99ddc892d3..3bb1d55d33 100644
--- a/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
+++ b/IBPSA/Utilities/Math/Functions/Examples/Interpolate.mo
@@ -22,13 +22,13 @@ protected
     height=100,
     offset=-50) "Ramp from -50Pa to +50Pa";
 initial equation
-  d =IBPSA.Utilities.Math.Functions.splineDerivatives(
+  d = IBPSA.Utilities.Math.Functions.splineDerivatives(
     x=xd,
     y=yd,
     ensureMonotonicity=true);
 equation
    dp=ramp.y;
-   m_flow =IBPSA.Utilities.Math.Functions.interpolate(u=dp,xd=xd,yd=yd,d=d);
+   m_flow = IBPSA.Utilities.Math.Functions.interpolate(u=dp, xd=xd, yd=yd, d=d);
 
   annotation (
 experiment(
diff --git a/IBPSA/Utilities/Math/Functions/interpolate.mo b/IBPSA/Utilities/Math/Functions/interpolate.mo
index 56fb832770..1f2e359e8d 100644
--- a/IBPSA/Utilities/Math/Functions/interpolate.mo
+++ b/IBPSA/Utilities/Math/Functions/interpolate.mo
@@ -34,7 +34,11 @@ algorithm
     Documentation(info="<html>
 <p>
 This function returns the value on a cubic hermite spline through the given support points
-and provided spline derivatives at these points with monotonically increasing values.
+and provided spline derivatives at these points.
+The spline derivatives at the support points can be computed using
+<a href=\"modelica://IBPSA.Utilities.Math.Functions.splineDerivatives\">
+IBPSA.Utilities.Math.Functions.splineDerivatives</a>.
+The support points must be monotonically increasing.
 Outside the provided support points, the function returns a linear extrapolation with
 the same slope as the cubic spline has at the respective support point.
 </p>
diff --git a/IBPSA/Utilities/Math/Functions/splineDerivatives.mo b/IBPSA/Utilities/Math/Functions/splineDerivatives.mo
index c5b194d4e7..ac460a8d9d 100644
--- a/IBPSA/Utilities/Math/Functions/splineDerivatives.mo
+++ b/IBPSA/Utilities/Math/Functions/splineDerivatives.mo
@@ -83,8 +83,8 @@ The algorithm to ensure monotonicity is based on the method described in Fritsch
 </p>
 <p>
 This function is typically used with
-<a href=\"modelica://IBPSA.Utilities.Math.Functions.cubicHermiteLinearExtrapolation\">
-IBPSA.Utilities.Math.Functions.cubicHermiteLinearExtrapolation</a>
+<a href=\"modelica://IBPSA.Utilities.Math.Functions.interpolate\">
+IBPSA.Utilities.Math.Functions.interpolate</a>
 which is used to evaluate the cubic spline.
 Because in many applications, the shape of the spline depends on parameters
 which will no longer change once the initialisation is complete,