From 3818141b664058549cf16fff89b82ddcbd70b72a Mon Sep 17 00:00:00 2001 From: mcgratta Date: Tue, 22 Sep 2026 17:32:01 -0400 Subject: [PATCH] CFAST User Guide: Edits to Diagnostics --- .../Appendix_CFAST_Keywords.tex | 45 +++++++------------ .../CFAST_Users_Guide/Input_File_Chapter.tex | 8 ++-- 2 files changed, 20 insertions(+), 33 deletions(-) diff --git a/Manuals/CFAST_Users_Guide/Appendix_CFAST_Keywords.tex b/Manuals/CFAST_Users_Guide/Appendix_CFAST_Keywords.tex index 2eddb4947..3093c50cd 100644 --- a/Manuals/CFAST_Users_Guide/Appendix_CFAST_Keywords.tex +++ b/Manuals/CFAST_Users_Guide/Appendix_CFAST_Keywords.tex @@ -255,36 +255,21 @@ \section{\texorpdfstring{{\tt DIAG}}{DIAG} (Diagnostic Parameters)} \hline \hline \endhead {\bf Parameter} & {\bf Type} & {\bf Ref.} & {\bf Units} & {\bf Default} \\ \hline -\ct{ADIABATIC_TARGET_VERIFICATION} & Character & Sec.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline -\ct{CEILING_JET_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{CONDUCTION_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{CONVECTION_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{DASSL_DEBUG_PRINT} & Character & Sec.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline -\ct{DEBUG_PRINT} & Character & Sec.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline -\ct{DOOR_JET_FIRE_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{ENTRAINMENT_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{F} & Real Array & Sec.~\ref{info:DIAG} & \degc & \\ \hline -\ct{FIRE_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{GAS_ABSORBTION_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'CALCULATED'} \\ \hline -\ct{GAS_TEMPERATURE} & Real & Sec.~\ref{info:DIAG} & \degc & \\ \hline -\ct{HORIZONTAL_FLOW_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{KEYBOARD_INPUT} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{LAYER_MIXING_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{MECHANICAL_FLOW_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{MODE} & Character & Sec.~\ref{info:DIAG} & & \\ \hline -\ct{OXYGEN_TRACKING} & Character & Sec.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline -\ct{PARTIAL_PRESSURE_CO2} & Real & Sec.~\ref{info:DIAG} & Pa & \\ \hline -\ct{PARTIAL_PRESSURE_H2O} & Real & Sec.~\ref{info:DIAG} & Pa & \\ \hline -\ct{RADIATION_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline -\ct{RADIATIVE_INCIDENT_FLUX} & Real & Sec.~\ref{info:DIAG} & kW/m$^2$ & 0 \\ \hline -\ct{RAD_SOLVER} & Character & Sec.~\ref{info:DIAG} & & \\ \hline -\ct{RESIDUAL_DEBUG_PRINT} & Character & Sec.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline -\ct{STEADY_STATE_INITIAL_CONDITIONS} & Character & Sec.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline -\ct{T} & Real Array & Sec.~\ref{info:DIAG} & s & \\ \hline -\ct{UPPER_LAYER_THICKNESS} & Real & Sec.~\ref{info:DIAG} & m & \\ \hline -\ct{VERIFICATION_FIRE_HEAT_FLUX} & Real & Sec.~\ref{info:DIAG} & kW/m$^2$ & \\ \hline -\ct{VERIFICATION_TIME_STEP} & Real & Sec.~\ref{info:DIAG} & s & 0 \\ \hline -\ct{VERTICAL_FLOW_SUB_MODEL} & Character & Sec.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline +\ct{ADIABATIC_TARGET_VERIFICATION} & Character & Chap.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline +\ct{DASSL_DEBUG_PRINT} & Character & Chap.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline +\ct{DEBUG_PRINT} & Character & Chap.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline +\ct{F} & Real Array & Chap.~\ref{info:DIAG} & \degc & \\ \hline +\ct{GAS_TEMPERATURE} & Real & Chap.~\ref{info:DIAG} & \degc & \\ \hline +\ct{PARTIAL_PRESSURE_CO2} & Real & Chap.~\ref{info:DIAG} & Pa & \\ \hline +\ct{PARTIAL_PRESSURE_H2O} & Real & Chap.~\ref{info:DIAG} & Pa & \\ \hline +\ct{RADIATION_SUB_MODEL} & Character & Chap.~\ref{info:DIAG} & & \ct{'ON'} \\ \hline +\ct{RADIATIVE_INCIDENT_FLUX} & Real & Chap.~\ref{info:DIAG} & kW/m$^2$ & 0 \\ \hline +\ct{RESIDUAL_DEBUG_PRINT} & Character & Chap.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline +\ct{STEADY_STATE_INITIAL_CONDITIONS} & Character & Chap.~\ref{info:DIAG} & & \ct{'OFF'} \\ \hline +\ct{T} & Real Array & Chap.~\ref{info:DIAG} & s & \\ \hline +\ct{UPPER_LAYER_THICKNESS} & Real & Chap.~\ref{info:DIAG} & m & \\ \hline +\ct{VERIFICATION_FIRE_HEAT_FLUX} & Real & Chap.~\ref{info:DIAG} & kW/m$^2$ & \\ \hline +\ct{VERIFICATION_TIME_STEP} & Real & Chap.~\ref{info:DIAG} & s & \\ \hline \end{xltabular} diff --git a/Manuals/CFAST_Users_Guide/Input_File_Chapter.tex b/Manuals/CFAST_Users_Guide/Input_File_Chapter.tex index dbf10ed8b..0e52d52c7 100644 --- a/Manuals/CFAST_Users_Guide/Input_File_Chapter.tex +++ b/Manuals/CFAST_Users_Guide/Input_File_Chapter.tex @@ -650,10 +650,12 @@ \section{Output Options} \item[Show CFAST Window] If checked, this item allows the user to see the Windows command prompt that is used to execute the CFAST model when the Model Simulation, CFAST menu item is used. By default, this is not checked. Normally, this can be left unchecked. For troubleshooting, this can be selected to see additional details of the calculation as it progresses. \end{description} -\section{Diagnostic Parameters} + + +\chapter{Advanced Diagnostics} \label{info:DIAG} -The \ct{DIAG} namelist is intended for model verification and developer diagnostics, not normal scenarios. These parameters can only be entered manually in the input file using a single \ct{DIAG} namelist record. +The following miscellaneous parameters are used for diagnostics and testing, not typical fire scenarios. They can only be entered manually in the input file using a single \ct{DIAG} namelist record. \begin{description} \item[\texttt{ADIABATIC\_TARGET\_VERIFICATION}] Enables the adiabatic-surface-temperature verification calculation; default \ct{OFF}. When enabled, \ct{RADIATIVE_INCIDENT_FLUX} supplies the imposed flux. \item[\texttt{DASSL\_DEBUG\_PRINT}] Enables DASSL diagnostic output; default \ct{OFF}. @@ -669,5 +671,5 @@ \section{Diagnostic Parameters} \item[\texttt{T}] Times in s corresponding to the verification temperatures in \ct{F}. \item[\texttt{UPPER\_LAYER\_THICKNESS}] Imposed upper-layer thickness in m for radiation verification. \item[\texttt{VERIFICATION\_FIRE\_HEAT\_FLUX}] Imposed fire heat flux in \unit{kW/m^2} for verification. -\item[\texttt{VERIFICATION\_TIME\_STEP}] Time step in s used by verification calculations; default 0~s. +\item[\texttt{VERIFICATION\_TIME\_STEP}] Time step used by verification calculations. \end{description}