Merge pull request firemodels#14038 from mcgratta/master

FDS Verification: Add explanation of tga_analysis

Manuals/FDS_User_Guide/FDS_User_Guide.tex

@@ -3365,10 +3365,26 @@ \subsection{Simulating Bench-scale Measurements like the TGA, DSC, and MCC}
 Note: If applying \ct{TGA_ANALYSIS} to a case where the \ct{SURF} is associated with a \ct{PART} class yet to be inserted into the calculation, FDS may not find the \ct{SURF} and hence throw an error. In this case, create a simple case with a single particle that is inserted at the start.
 \end{warning}
 
-The result of the \ct{TGA_ANALYSIS} is a single comma-delimited file called \ct{CHID_tga.csv}. The first and second columns of the file consist of the time and sample temperature. The third column is the normalized sample mass; that is, the sample mass divided by its initial mass. The following columns list the mass fractions of the individual material components. The next column is the total mass loss rate, in units of s$^{-1}$, followed by the mass loss rates of the individual material components. The next column is the heat release rate per unit mass of the sample in units of W/g, typical of an MCC measurement. The final column is the heat absorbed by the sample normalized by its mass, also in units of W/g, typical of a DSC measurement. Results for a typical analysis of wood are shown in Fig.~\ref{tga_results}. In this case, a sample of wood containing about 10~\% water by mass heats up and undergoes three reactions, including the evaporation of water. Note that the TGA plots include both fuel and water vapor, while the MCC results only show fuel.
+The result of the \ct{TGA_ANALYSIS} is a single comma-delimited file called \ct{CHID_tga.csv}. The first and second columns of the file consist of the time and sample temperature. The third column is the normalized sample mass; that is, the sample mass divided by its initial mass. The following columns list the mass fractions of the individual material components. The next column is the total mass loss rate, in units of s$^{-1}$, followed by the mass loss rates of the individual material components. The next column is the heat release rate per unit mass of the sample in units of W/g, typical of an MCC measurement. The final column is the rate of heat absorbed by the sample normalized by its {\it original} mass, also in units of W/g, typical of a DSC measurement. 
 
 Details of the output quantities are discussed in Sec.~\ref{info:material_components}. Further details on these measurement techniques and how to interpret them are found in the FDS Verification Guide~\cite{FDS_Verification_Guide}.
 
+\subsubsection{Example}
+
+Results for an analysis (\ct{Pyrolysis/tga_analysis.fds}) of a simplified version of wood are shown in Fig.~\ref{tga_results}. The sample, referred to as ``wet wood'', contains 10~\% ``water'' by mass. It is heated at a rate of $\beta=5/60$~K/s and undergoes three reactions: the evaporation of ``water'', the conversion of ``dry wood'' to ``char'', and the conversion of ``char'' to ``ash''.
+
+The upper two plots in Fig.~\ref{tga_results} show the results of the TGA analysis; that is, the decrease in mass as a function of sample temperature. The left plot shows the total sample mass and the right shows the individual components. Below these are two plots that show the mass loss rates of the total sample and its components. These plots are simply the (negative) values of the first derivative of the upper plots.
+
+The lower left plot in Fig.~\ref{tga_analysis} shows the results of the MCC analysis; that is, the gas phase combustion heat release rate per unit mass of the original sample. Note that this MCC plot does not include evidence of the evaporation of water because water vapor does not combust. The integral (with respect to time) under the MCC curve yields $Q=12\,680$~J/g. The heat of combustion of the ``cellulose,'' which is the assumed gas phase fuel resulting from the pyrolysis of dry wood and char, is $h_{\rm c}=14\,988$~J/g. The dry wood and char constitute $Y=0.846$ of the original sample, thus $h_{\rm c} \, Y \approx Q$. 
+
+The lower right plot Fig.~\ref{tga_analysis} shows the results of the DSC analysis. The curve represents the rate of heat absorbed by the sample. The three peaks represent the endothermic reactions where heat from the hot gas is used to evaporate water or pyrolyze the wood and char. The plateaus between the reaction peaks represent the heating of the solid only. For example, at a temperature of 200~$^\circ$C, the value is $\dot{q}(200)=0.075$~W/g which corresponds to the specific heat of the dry wood which has not yet undergone its conversion to char:
+\be
+   c_p = \frac{\dot{q}(200)}{Y(200) \, \beta} = 1 \; \hbox{kJ/(kg K)}
+\ee
+The term $Y(200)=0.9$ in the denominator is the ratio of mass of the sample at 200~$^\circ$C to the original mass.
+
+
+
 \begin{figure}[ht]
 \begin{tabular*}{\textwidth}{lr}
 \includegraphics[width=3.2in]{SCRIPT_FIGURES/tga_analysis_mass} &

Utilities/Matlab/FDS_verification_dataplot_inputs.csv

@@ -624,9 +624,9 @@ d,target_test,Radiation/target_test_git.txt,Radiation/target_test_devc.csv,2,3,T
 d,TC_heating,Radiation/TC_heating_git.txt,Radiation/TC_heating.csv,2,3,Time,Temp,Analytical (Temp),ko,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Radiation/TC_heating_devc.csv,2,3,Time,TC,FDS (TC),k-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Temperature (TC\_heating),Time (s),Temperature (°C),0,90,1,0,700,1,no,0.05 0.90,SouthEast,,1,linear,FDS_Verification_Guide/SCRIPT_FIGURES/TC_heating,Relative Error,end,0.01,Radiation,ro,r,TeX
 d,TC_view_factor,Radiation/TC_view_factor_git.txt,Radiation/TC_view_factor.csv,1,2,Time,TC,Ideal (TC),ko,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Radiation/TC_view_factor_devc.csv,2,3,Time,TC_1,FDS (TC\_1),k-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Temperature (TC\_view\_factor),Time (s),Temperature (°C),0,180,1,0,500,1,no,0.05 0.90,SouthEast,,1,linear,FDS_Verification_Guide/SCRIPT_FIGURES/TC_view_factor,Relative Error,end,0.03,Radiation,ro,r,TeX
 d,tga_analysis,Pyrolysis/tga_analysis_git.txt,Pyrolysis/tga_analysis_exact.csv,2,3,Temp,Total Mass,Expected,k-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Pyrolysis/tga_analysis_tga.csv,2,3,Temp,Total Mass,FDS,k--,0,100000,,0,100000,-1.00E+09,1.00E+09,0,TGA Results (tga\_analysis),Temperature (°C),Total Mass Fraction,0,600,1,0,1.2,1,no,0.05 0.90,,,1,linear,FDS_User_Guide/SCRIPT_FIGURES/tga_analysis_mass,N/A,end,0,Pyrolysis,kd,k,TeX
-d,tga_analysis,Pyrolysis/tga_analysis_git.txt,Pyrolysis/tga_analysis_exact.csv,2,3,Temp,component 1 Mass|component 2 Mass,Component 1|Component 2,k-|r-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Pyrolysis/tga_analysis_tga.csv,2,3,Temp,residue Mass|water Mass,Residue|Water,g--|b--,0,100000,,0,100000,-1.00E+09,1.00E+09,0,TGA Results (tga\_analysis),Temperature (°C),Component Mass Fraction,0,600,1,0,1.2,1,no,0.05 0.90,West,,1,linear,FDS_User_Guide/SCRIPT_FIGURES/tga_analysis_mass_components,N/A,end,0,Pyrolysis,kd,k,TeX
+d,tga_analysis,Pyrolysis/tga_analysis_git.txt,Pyrolysis/tga_analysis_exact.csv,2,3,Temp,dry wood Mass|char Mass,dry wood|char,k-|r-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Pyrolysis/tga_analysis_tga.csv,2,3,Temp,ash Mass|water Mass,ash|water,g--|b--,0,100000,,0,100000,-1.00E+09,1.00E+09,0,TGA Results (tga\_analysis),Temperature (°C),Component Mass Fraction,0,600,1,0,1.2,1,no,0.05 0.90,West,,1,linear,FDS_User_Guide/SCRIPT_FIGURES/tga_analysis_mass_components,N/A,end,0,Pyrolysis,kd,k,TeX
 d,tga_analysis,Pyrolysis/tga_analysis_git.txt,Pyrolysis/tga_analysis_exact.csv,2,3,Temp,Total MLR,Expected,k-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Pyrolysis/tga_analysis_tga.csv,2,3,Temp,Total MLR,FDS,k--,0,100000,,0,100000,-1.00E+09,1.00E+09,0,TGA Results (tga\_analysis),Temperature (°C),Total Mass Loss Rate (1/s),0,600,1,-0.0015,0.0035,1,no,0.05 0.90,,,1,linear,FDS_User_Guide/SCRIPT_FIGURES/tga_analysis_mlr,N/A,max,0,Pyrolysis,kd,k,TeX
-d,tga_analysis,Pyrolysis/tga_analysis_git.txt,Pyrolysis/tga_analysis_exact.csv,2,3,Temp,component 1 MLR|component 2 MLR,Component 1|Component 2,k-|r-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Pyrolysis/tga_analysis_tga.csv,2,3,Temp,residue MLR|water MLR,Residue|Water,g--|b--,0,100000,,0,100000,-1.00E+09,1.00E+09,0,TGA Results (tga\_analysis),Temperature (°C),Component Mass Loss Rate (1/s),0,600,1,-0.0015,0.0035,1,no,0.05 0.90,West,,1,linear,FDS_User_Guide/SCRIPT_FIGURES/tga_analysis_mlr_components,N/A,end,0,Pyrolysis,kd,k,TeX
+d,tga_analysis,Pyrolysis/tga_analysis_git.txt,Pyrolysis/tga_analysis_exact.csv,2,3,Temp,dry wood MLR|char MLR,dry wood|char,k-|r-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Pyrolysis/tga_analysis_tga.csv,2,3,Temp,ash MLR|water MLR,ash|water,g--|b--,0,100000,,0,100000,-1.00E+09,1.00E+09,0,TGA Results (tga\_analysis),Temperature (°C),Component Mass Loss Rate (1/s),0,600,1,-0.0015,0.0035,1,no,0.05 0.90,West,,1,linear,FDS_User_Guide/SCRIPT_FIGURES/tga_analysis_mlr_components,N/A,end,0,Pyrolysis,kd,k,TeX
 d,tga_analysis,Pyrolysis/tga_analysis_git.txt,Pyrolysis/tga_analysis_exact.csv,2,3,Temp,MCC,Expected,k-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Pyrolysis/tga_analysis_tga.csv,2,3,Temp,MCC,FDS,k--,0,100000,,0,100000,-1.00E+09,1.00E+09,0,MCC Results (tga\_analysis),Temperature (°C),Heat Release Rate (W/g),0,600,1,0,30,1,no,0.05 0.90,,,1,linear,FDS_User_Guide/SCRIPT_FIGURES/tga_analysis_mcc,N/A,max,0,Pyrolysis,kd,k,TeX
 d,tga_analysis,Pyrolysis/tga_analysis_git.txt,Pyrolysis/tga_analysis_exact.csv,2,3,Temp,DSC,Expected,k-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Pyrolysis/tga_analysis_tga.csv,2,3,Temp,DSC,FDS,k--,0,100000,,0,100000,-1.00E+09,1.00E+09,0,DSC Results (tga\_analysis),Temperature (°C),Heating Rate (W/g),0,600,1,0,4,1,no,0.05 0.90,,,1,linear,FDS_User_Guide/SCRIPT_FIGURES/tga_analysis_dsc,N/A,max,0,Pyrolysis,kd,k,TeX
 d,tga_sample,Pyrolysis/tga_sample_git.txt,Pyrolysis/tga_sample_data.csv,1,2,Temp,Mass,Measured,k-,0,100000,,0,100000,-1.00E+09,1.00E+09,0,Pyrolysis/tga_sample_devc.csv,2,3,TGA temp,mpua,FDS (mpua),k--,0,100000,,0,100000,-1.00E+09,1.00E+09,0,TGA Mass (tga\_sample),Temperature (°C),Mass Fraction,0,900,1,0,1.2,1,no,0.05 0.90,South,,1,linear,FDS_Verification_Guide/SCRIPT_FIGURES/tga_sample_mass,Relative Error,end,0.01,Pyrolysis,ro,r,TeX

Verification/Pyrolysis/tga_analysis.fds

@@ -8,18 +8,18 @@
 &REAC FUEL='CELLULOSE', C=6, H=10, O=5, SOOT_YIELD=0.015 /
 &SPEC ID='WATER VAPOR' /
 
-&VENT XB=-1,1,-0.5,0.5,0.0,0.0, SURF_ID='SAMPLE' /
+&VENT XB=-1,1,-0.5,0.5,0.0,0.0, SURF_ID='wet wood' /
 
-&SURF ID             = 'SAMPLE'
+&SURF ID             = 'wet wood'
       TGA_ANALYSIS   = .TRUE.
       COLOR          = 'RED'
       THICKNESS      = 0.01
-      MATL_ID(1,1) = 'component 1'
+      MATL_ID(1,1) = 'dry wood'
       MATL_ID(1,2) = 'water'
       MATL_MASS_FRACTION(1,1) = 0.90
       MATL_MASS_FRACTION(1,2) = 0.10 /
 
-&MATL ID                    = 'component 1'
+&MATL ID                    = 'dry wood'
       EMISSIVITY            = 1.0
       DENSITY 	            = 500.
       CONDUCTIVITY          = 0.20
@@ -30,10 +30,10 @@
       NU_SPEC 	            = 0.60
       SPEC_ID               = 'CELLULOSE'
       NU_MATL               = 0.40
-      MATL_ID               = 'component 2'
+      MATL_ID               = 'char'
       HEAT_OF_REACTION      = 1000. /  
 
-&MATL ID                    = 'component 2'
+&MATL ID                    = 'char'
       EMISSIVITY            = 1.0
       DENSITY 	            = 500.
       CONDUCTIVITY          = 0.20
@@ -44,7 +44,7 @@
       NU_SPEC 	            = 0.85
       SPEC_ID               = 'CELLULOSE'
       NU_MATL               = 0.15
-      MATL_ID               = 'residue'
+      MATL_ID               = 'ash'
       HEAT_OF_REACTION      = 1000. /
 
 &MATL ID = 'water'
@@ -58,7 +58,7 @@
       SPEC_ID = 'WATER VAPOR'
       HEAT_OF_REACTION= 2500. /
 
-&MATL ID                    = 'residue'
+&MATL ID                    = 'ash'
       DENSITY               = 200.
       CONDUCTIVITY          = 0.20
       SPECIFIC_HEAT         = 1.0 /

Verification/Pyrolysis/tga_analysis_exact.csv

@@ -1,5 +1,5 @@
 s,C,g/g,g/g,g/g,g/g,g/g,1/s,1/s,1/s,1/s,1/s,W/g,W/g
-Time,Temp,Total Mass,component 1 Mass,water Mass,component 2 Mass,residue Mass,Total MLR,component 1 MLR,water MLR,component 2 MLR,residue MLR,MCC,DSC
+Time,Temp,Total Mass,dry wood Mass,water Mass,char Mass,ash Mass,Total MLR,dry wood MLR,water MLR,char MLR,ash MLR,MCC,DSC
  9.9999998E-003, 2.0000656E+001, 9.9999970E-001, 8.9999998E-001, 9.9999696E-002, 1.8281761E-028, 0.0000000E+000, 3.0502872E-005, 4.5704404E-026, 3.0502872E-005,-1.8281761E-026, 0.0000000E+000, 4.1102064E-022, 3.3669153E-001
  1.2000000E+001, 2.0999897E+001, 9.9962682E-001, 8.9999998E-001, 9.9626839E-002, 2.6496921E-025, 0.0000000E+000, 3.1695799E-005, 6.5907301E-026, 3.1695799E-005,-2.6362921E-026, 0.0000000E+000, 5.9270571E-022, 1.9476888E-001
  2.4000000E+001, 2.1999895E+001, 9.9923915E-001, 8.9999998E-001, 9.9239163E-002, 6.4669091E-025, 0.0000000E+000, 3.2921896E-005, 9.4837468E-026, 3.2921896E-005,-3.7934987E-026, 0.0000000E+000, 8.5287531E-022, 1.9784707E-001