example update

Buildings/Fluid/AirFilters/BaseClasses/Characteristics/filtrationEfficiencyParameters.mo

@@ -11,7 +11,7 @@ record filtrationEfficiencyParameters
 <p>
 Data record that describes the relative mass of the contaminant captured by the filter <code>rat</code> versus
 the filteration efficiency <code>eps</code>.
-The <code>rat</code> must be increasing, 
+The elements of the vector <code>rat</code> should be in ascending order, 
 i.e.,<code>rat[i] &lt; rat[i+1]</code>.
 Both vectors, <code>rat</code> and <code>eps</code>
 must have the same size.

Buildings/Fluid/AirFilters/Empirical.mo

@@ -261,7 +261,7 @@ The dynamic characteristics of the filters are defined by
 <ul>
 <li>
 The <code>mCon_nominal</code> determines the maximum mass of the contaminants that the
-filter can capture.
+filter can held.
 </li>
 <li>
 A performance dataset <code>per</code> that determines 
@@ -281,10 +281,10 @@ with the contaminant accumulation for each contaminant.
 </ul>
 <p>
 See more detailed descriptions in
-<a href=\"modelica://Buildings.Fluid.AirFilters.BaseClasses.FiltrationEfficiency\">
-Buildings.Fluid.AirFilters.BaseClasses.FiltrationEfficiency</a> and
 <a href=\"modelica://Buildings.Fluid.AirFilters.BaseClasses.FlowCoefficientCorrection\">
-Buildings.Fluid.AirFilters.BaseClasses.FlowCoefficientCorrection</a>.
+Buildings.Fluid.AirFilters.BaseClasses.FlowCoefficientCorrection</a>
+and <a href=\"modelica://Buildings.Fluid.AirFilters.BaseClasses.FiltrationEfficiency\">
+Buildings.Fluid.AirFilters.BaseClasses.FiltrationEfficiency</a>, respectively.
 </p>
 <p>
 The input boolean flag, <code>uRep</code>, triggers the filter replacement.
@@ -299,7 +299,7 @@ when the captured contaminant mass becomes greater than the
 maximum contaminant mass (<code>mCon_nominal</code>).
 </li>
 <li>
-when the <code>extraPropertiesNames</code> in the medium model don't contain all the contaminants
+or when the <code>extraPropertiesNames</code> in the medium model don't contain all the contaminants
 defined in the <code>per</code>.
 </li>
 </ul>

Buildings/Fluid/AirFilters/Examples/SpaceCooling.mo

@@ -3,7 +3,8 @@ model SpaceCooling
   "Space cooling system"
   extends Modelica.Icons.Example;
 
-  replaceable package MediumA = Buildings.Media.Air(extraPropertiesNames={"CO2"}) "Medium for air";
+  replaceable package MediumA = Buildings.Media.Air(extraPropertiesNames={"PM10"})
+  "Medium for air";
   replaceable package MediumW = Buildings.Media.Water "Medium for water";
 
   Buildings.Fluid.MixingVolumes.MixingVolume vol(
@@ -162,19 +163,22 @@ model SpaceCooling
     annotation (Placement(transformation(extent={{-128,-10},{-108,10}})));
   Buildings.Fluid.AirFilters.BaseClasses.Data.Generic per(
     mCon_nominal=5,
-    filterationEfficiencyParameters(rat={{0,0.5,1}}, eps={{0.5,0.4,0.2}}),   b=1.2)
+    substanceName={"PM10"},
+    filterationEfficiencyParameters(rat={{0,0.5,1}}, eps={{0.5,0.4,0.2}}),
+    b=1.3)
     "Performance dataset of the air filter"
     annotation (Placement(transformation(extent={{-80,64},{-60,84}})));
   Modelica.Blocks.Sources.Ramp C_inflow(
     duration=87600/2,
-    height=50/1000000*1.53,
-    offset=100/1000000*1.53,
+    height=5/1000000000/1.293,
+    offset=10/1000000000/1.293,
     startTime=15552000 + 87600/2)
     "Contaminant mass flow rate fraction"
     annotation (Placement(transformation(extent={{-170,-70},{-150,-50}})));
   Buildings.Fluid.Sensors.TraceSubstancesTwoPort C_out(redeclare package
     Medium =MediumA,
-    m_flow_nominal=mA_flow_nominal)
+    m_flow_nominal=mA_flow_nominal,
+    substanceName="PM10")
     "Trace substance sensor of outlet air"
     annotation (Placement(transformation(extent={{-102,-10},{-82,10}})));
   Buildings.Controls.OBC.CDL.Logical.Sources.Constant repSig(k=false)
@@ -279,31 +283,29 @@ equation
 This block is identical to
 <a href=\"modelica://Buildings.Examples.Tutorial.SpaceCooling.System3\">
 Buildings.Examples.Tutorial.SpaceCooling.System3</a>,
-except that an air filter is added.
+except that an air filter is added to the cooling system.
 </p>
 <p>
 The major input signals for the air filter are configured as follows:
 </p>
 <ul>
 <li>
-The operating signal <i>uRot</i> changes from <code>false</code> to <code>true</code> at 6:00 (15552000+6*3600 seconds)
-and from <code>true</code> to <code>false</code> at 18:00 (15552000+18*3600 seconds).
-</li>
-<li>
-The supply air flow rate <i>mAir_flow</i> changes from <i>0</i> to <i>0.646</i> at around 5:00
-and from <i>0.646</i> to <i>0</i> at around 17:00.
+The input trace substance <i>C_inflow.y</i> changes from 10 &#181;g/m&sup3; (7.73e-9 kg/kg) to 15 &#181;g/m&sup3;
+(1.15e-8 kg/kg) at 12:00 (15552000+12*3600 seconds).
 </li>
 <li>
-The bypass damper positions are controlled to maintain the temperature of the air leaving the thermal wheel, 
-<code>senTemHXOut.T</code>, at 298.15 K.
+the filter replacement signal <code>repSig</code> is false.
 </li>
 </ul>
 <p>
-The expected output is:
+The expected output are:
 </p>
 <ul>
 <li>
-<code>senTemHXOut.T</code> is less or equal to 298.15 K.
+The ratio of the outlet trace substance <i>C_out.C</i> to the <i>C_inflow.y</i> slightly decreases. 
+</li>
+<li>
+The fan power  <i>fan.P</i> slightly increases. 
 </li>
 </ul>
 </html>", revisions="<html>
@@ -318,7 +320,7 @@ Buildings.Examples.Tutorial.SpaceCooling.System3</a>.
     Diagram(coordinateSystem(preserveAspectRatio=true, extent={{-180,-160},{120,
             100}})),
     __Dymola_Commands(file=
-     "modelica://Buildings/Resources/Scripts/Dymola/Examples/Tutorial/SpaceCooling/System3.mos"
+     "modelica://Buildings/Resources/Scripts/Dymola/Fluid/AirFilters/Examples/SpaceCooling.mos"
         "Simulate and plot"),
     experiment(StartTime=15552000, Tolerance=1e-6, StopTime=15638400));
 end SpaceCooling;

Buildings/Fluid/AirFilters/Validation/Empirical.mo

@@ -31,14 +31,14 @@ model Empirical "Example for using the empirical air filter model"
     annotation (Placement(transformation(extent={{-50,40},{-30,60}})));
   Modelica.Blocks.Sources.Ramp C_CO2_inflow(
     duration=30,
-    height=-0.3,
-    offset=1,
+    height=-0.03,
+    offset=0.1,
     startTime=20) "Contaminant mass flow rate fraction for CO2"
     annotation (Placement(transformation(extent={{-160,20},{-140,40}})));
   Modelica.Blocks.Sources.Ramp C_VOC_inflow(
     duration=40,
-    height=-0.4,
-    offset=1,
+    height=-0.04,
+    offset=0.1,
     startTime=20)
     "Contaminant mass flow rate fraction for VOC"
     annotation (Placement(transformation(extent={{-160,-40},{-140,-20}})));
@@ -100,17 +100,17 @@ First implementation.
 </html>", info="<html>
 <p>
 From 0 to 12 seconds, the testing case is warming-up and the inlet trace substances of 
-are fixed at <i>1kg/kg</i>.
+are fixed at <i>0.1kg/kg</i>.
 </p>
 <p>
-From 20 to 50 seconds, the inlet trace substances changes from <i>1</i> to <i>0.7kg/kg</i>.
+From 20 to 50 seconds, the inlet trace substances changes from <i>0.1</i> to <i>0.07kg/kg</i>.
 </p>
 <p>
-At the 30 seconds and , the filter replacement signal <code>repSig</code> changes from <i>false</i> to <i>true</i>.
+At the 30 seconds, the filter replacement signal <code>repSig</code> changes from <i>false</i> to <i>true</i>.
 </p>
 <p>
 From 12 to 30 seconds, the trace substance of the outlet port <code>C_out</code> doesn't change much;
-From 30 to 45 seconds, the outlet trace substances first decrease and then increase.
+From 30 to 45 seconds, the outlet trace substances first decrease and then becomes relatively smooth.
 </p>
 </html>"),
     Diagram(coordinateSystem(extent={{-180,-100},{140,100}})),