FDS Manuals: Switch from bibtex to biblatex

mcgratta · mcgratta · commit f8fee564d7a4 · 2025-12-18T16:30:03.000-05:00
diff --git a/Manuals/Bibliography/FDS_general.bib b/Manuals/Bibliography/FDS_general.bib
diff --git a/Manuals/Bibliography/commoncommands.tex b/Manuals/Bibliography/commoncommands.tex
@@ -63,6 +63,7 @@
 \usepackage[section]{placeins}
 \usepackage{scrextend}
 \usepackage{needspace}
+\usepackage[backend=biber, style=numeric, sorting=none, backref=true]{biblatex}
 
 \newcommand{\nopart}{\expandafter\def\csname Parent-1\endcsname{}} % To fix table of contents in pdf.
 \newcommand{\ct}[1]{\lstinline{#1}}
@@ -103,7 +104,6 @@
         citecolor=linkred,     % citation number colors
         linkcolor=linknavy,    % \ref{...} and \pageref{...}
         pdfproducer={pdflatex},
-        pagebackref,
         pdfpagemode=UseNone,
         bookmarksopen=true,
         plainpages=false,
diff --git a/Manuals/FDS_Config_Management_Plan/FDS_Config_Management_Plan.tex b/Manuals/FDS_Config_Management_Plan/FDS_Config_Management_Plan.tex
@@ -18,9 +18,13 @@
 {\input{../Bibliography/gitrevision}}
 {\newcommand{\gitrevision}{unknown} }
 
+\addbibresource{../Bibliography/FDS_refs.bib}
+\addbibresource{../Bibliography/FDS_general.bib}
+\addbibresource{../Bibliography/FDS_mathcomp.bib}
+
+
 \begin{document}
 
-\bibliographystyle{unsrt}
 \pagestyle{empty}
 
 \begin{minipage}[t][9in][s]{6.5in}
@@ -547,7 +551,7 @@ \section{Training}
 \backmatter
 \nopart
 
-\bibliography{../Bibliography/FDS_refs,../Bibliography/FDS_general,../Bibliography/FDS_mathcomp}
+\printbibliography[heading=bibintoc,title={References}]
 
 \printindex
 
diff --git a/Manuals/FDS_Config_Management_Plan/make_guide.sh b/Manuals/FDS_Config_Management_Plan/make_guide.sh
@@ -11,7 +11,7 @@ gitrevision=`git describe --abbrev=7 --long --dirty`
 echo "\\newcommand{\\gitrevision}{$gitrevision}" > ../Bibliography/gitrevision.tex
 
 pdflatex -interaction nonstopmode FDS_Config_Management_Plan &> FDS_Config_Management_Plan.err
-bibtex FDS_Config_Management_Plan &> FDS_Config_Management_Plan.err
+biber FDS_Config_Management_Plan &> FDS_Config_Management_Plan.err
 pdflatex -interaction nonstopmode FDS_Config_Management_Plan &> FDS_Config_Management_Plan.err
 pdflatex -interaction nonstopmode FDS_Config_Management_Plan &> FDS_Config_Management_Plan.err
 pdflatex -interaction nonstopmode FDS_Config_Management_Plan &> FDS_Config_Management_Plan.err
diff --git a/Manuals/FDS_Technical_Reference_Guide/FDS_Technical_Reference_Guide.tex b/Manuals/FDS_Technical_Reference_Guide/FDS_Technical_Reference_Guide.tex
@@ -24,10 +24,13 @@
     \includeonly{Introduction_Chapter, Equation_Chapter, Mass_Chapter, Momentum_Chapter, Combustion_Chapter, Radiation_Chapter, Solid_Chapter, Aerosol_Chapter, Particle_Chapter, Device_Chapter, HVAC_Chapter, Wildland_Chapter, Appendices}
 \fi
 
+\addbibresource{../Bibliography/FDS_refs.bib}
+\addbibresource{../Bibliography/FDS_general.bib}
+\addbibresource{../Bibliography/FDS_mathcomp.bib}
+
 \begin{document}
 
 
-\bibliographystyle{unsrt}
 \pagestyle{empty}
 
 
@@ -189,7 +192,7 @@ \chapter{Acknowledgments}
 \fi
 \include{Wildland_Chapter}
 
-\bibliography{../Bibliography/FDS_refs,../Bibliography/FDS_general,../Bibliography/FDS_mathcomp}
+\printbibliography[heading=bibintoc,title={References}]
 
 \appendix
 
diff --git a/Manuals/FDS_Technical_Reference_Guide/make_guide.sh b/Manuals/FDS_Technical_Reference_Guide/make_guide.sh
@@ -11,7 +11,7 @@ gitrevision=`git describe --abbrev=7 --long --dirty`
 echo "\\newcommand{\\gitrevision}{$gitrevision}" > ../Bibliography/gitrevision.tex
 
 pdflatex -interaction nonstopmode FDS_Technical_Reference_Guide &> FDS_Technical_Reference_Guide.err
-bibtex FDS_Technical_Reference_Guide &> FDS_Technical_Reference_Guide.err
+biber FDS_Technical_Reference_Guide &> FDS_Technical_Reference_Guide.err
 pdflatex -interaction nonstopmode FDS_Technical_Reference_Guide &> FDS_Technical_Reference_Guide.err
 pdflatex -interaction nonstopmode FDS_Technical_Reference_Guide &> FDS_Technical_Reference_Guide.err
 pdflatex -interaction nonstopmode FDS_Technical_Reference_Guide &> FDS_Technical_Reference_Guide.err
diff --git a/Manuals/FDS_User_Guide/FDS_User_Guide.tex b/Manuals/FDS_User_Guide/FDS_User_Guide.tex
@@ -18,9 +18,12 @@
 {\input{../Bibliography/gitrevision}}
 {\newcommand{\gitrevision}{unknown}}
 
+\addbibresource{../Bibliography/FDS_refs.bib}
+\addbibresource{../Bibliography/FDS_general.bib}
+\addbibresource{../Bibliography/FDS_mathcomp.bib}
+
 \begin{document}
 
-\bibliographystyle{unsrt}
 \pagestyle{empty}
 
 
@@ -15318,7 +15321,7 @@ \section{File Extension Glossary}
 %\backmatter
 \nopart %To Fix TOC in PDF output.
 
-\bibliography{../Bibliography/FDS_refs,../Bibliography/FDS_general,../Bibliography/FDS_mathcomp}
+\printbibliography[heading=bibintoc,title={References}]
 
 
 \appendix
diff --git a/Manuals/FDS_User_Guide/make_guide.sh b/Manuals/FDS_User_Guide/make_guide.sh
@@ -11,7 +11,7 @@ gitrevision=`git describe --abbrev=7 --long --dirty`
 echo "\\newcommand{\\gitrevision}{$gitrevision}" > ../Bibliography/gitrevision.tex
 
 pdflatex -interaction nonstopmode FDS_User_Guide &> FDS_User_Guide.err
-bibtex FDS_User_Guide &> FDS_User_Guide.err
+biber FDS_User_Guide &> FDS_User_Guide.err
 pdflatex -interaction nonstopmode FDS_User_Guide &> FDS_User_Guide.err
 pdflatex -interaction nonstopmode FDS_User_Guide &> FDS_User_Guide.err
 pdflatex -interaction nonstopmode FDS_User_Guide &> FDS_User_Guide.err
diff --git a/Manuals/FDS_Validation_Guide/Burning_Rate_Chapter.tex b/Manuals/FDS_Validation_Guide/Burning_Rate_Chapter.tex
@@ -1331,7 +1331,7 @@ \subsection{Pool Fire Measurements}
 
 \subsection{NIST Pool Fires}
 
-Figure~\ref{NIST_1_m_methanol_MLRPUA} displays the measured and predicted burning rate of a 100~cm diameter methanol pool fire experiment conducted by Sung~et~al. at NIST~\cite{Sung:TN2019}.
+Figure~\ref{NIST_1_m_methanol_MLRPUA} displays the measured and predicted burning rate of a 100~cm diameter methanol pool fire experiment conducted by Sung~et~al. at NIST~\cite{Sung:TN2083}.
 
 \begin{figure}[!ht]
 \centering
diff --git a/Manuals/FDS_Validation_Guide/Experiment_Chapter.tex b/Manuals/FDS_Validation_Guide/Experiment_Chapter.tex
@@ -2148,15 +2148,15 @@ \section{NIST Polymers}
 \section{NIST Pool Fire Experiments}
 \label{NIST_Pool_Fires_Description}
 
-The NIST Pool Fire Experiments include temperature, species concentration, velocity, and heat flux measurements of 30~cm and 100~cm diameter circular liquid fuel fires, and 37~cm gaseous burner fires. The 30~cm and 37~cm fires are documented in Ref.~\cite{Sung:TN2162r1}.
+The NIST Pool Fire Experiments include temperature, species concentration, velocity, and heat flux measurements of 30~cm and 100~cm diameter circular liquid fuel fires, and 37~cm gaseous burner fires. The 30~cm and 37~cm fires are documented in Ref.~\cite{Sung:TN2162r1}. The 100~cm methanol fire is documented in Ref.~\cite{Sung:TN2083}.
 
 The 30~cm burner is 15~cm deep and has a wall thickness of 1.6~mm. The burner is fitted with legs such that the burner rim is positioned 30~cm above the floor. The bottom of the burner is maintained at a constant temperature by flowing tap water (nominally 20~$^\circ$C) through a 3~cm section on the bottom of the fuel pan. The dimensions of the circular burner are similar to Weckman's methanol experiment described in Sec.~\ref{Waterloo_Methanol_Description}.
 
 The 37~cm burner is actually 38~cm in diameter with an effective diameter of 37~cm. It is water cooled, and the surface temperature is maintained at approximately 40~$^\circ$C.  The measured fuel flow rate for the methane fire was 0.69~g/s and its estimated HRR was 34.5~kW. The heat release rates of the three propane fires were 20~kW, 34~kW, and 50~kW.
 
 The 100~cm burner is also 15~cm deep, has a wall thickness of 1.6~mm, and is water-cooled.
 
-Details and references with regard to the plume temperature measurements are given in Sec.~\ref{NIST_Pool_Fires_Plume_Temps}. Details on the heat flux measurements are given in Sec.~\ref{NIST_Pool_Fires_Heat_Flux_Results}. Details on the gas species measurements is given in Sec.~\ref{sec:NIST_Pool_Fires}. Details on the velocity measurements is given in Sec.~\ref{NIST_Pool_Fires_Velocity}.
+Details and references with regard to the plume temperature measurements are given in Sec.~\ref{NIST_Pool_Fires_Plume_Temps}. Details on the heat flux measurements are given in Sec.~\ref{NIST_Pool_Fires_Heat_Flux_Results}. Details on the gas species measurements are given in Sec.~\ref{sec:NIST_Pool_Fires}. Details on the velocity measurements are given in Sec.~\ref{NIST_Pool_Fires_Velocity}.
 
 
 \subsubsection{Modeling Notes}
diff --git a/Manuals/FDS_Validation_Guide/FDS_Validation_Guide.tex b/Manuals/FDS_Validation_Guide/FDS_Validation_Guide.tex
@@ -22,9 +22,13 @@
 
 %\includeonly{Experiment_Chapter,HGL_Chapter,Velocity_Chapter}
 
+\addbibresource{../Bibliography/FDS_refs.bib}
+\addbibresource{../Bibliography/FDS_general.bib}
+\addbibresource{../Bibliography/FDS_mathcomp.bib}
+
+
 \begin{document}
 
-\bibliographystyle{unsrt}
 \pagestyle{empty}
 
 \begin{minipage}[t][9in][s]{6.5in}
@@ -293,6 +297,6 @@ \section{Summary of FDS Validation Git Statistics}
 \IfFileExists{SCRIPT_FIGURES/Scatterplots/validation_git_stats.tex}{\input{SCRIPT_FIGURES/Scatterplots/validation_git_stats.tex}}{\typeout{Error: Missing file SCRIPT_FIGURES/Scatterplots/validation_git_stats.tex}}
 
 
-\bibliography{../Bibliography/FDS_refs,../Bibliography/FDS_general,../Bibliography/FDS_mathcomp}
+\printbibliography[heading=bibintoc,title={References}]
 
 \end{document}
diff --git a/Manuals/FDS_Validation_Guide/Heat_Flux_Chapter.tex b/Manuals/FDS_Validation_Guide/Heat_Flux_Chapter.tex
@@ -2072,10 +2072,10 @@ \subsection{NIST Pool Fires}
 
 A description of the NIST Pool Fire experiments and modeling is given in Sec.~\ref{NIST_Pool_Fires_Description}. On the following pages are comparisons of heat flux measurements and predictions at various locations and orientations.
 \begin{itemize}
-\item Figure~\ref{NIST_Pool_Fire_Heat_Flux} displays downward radiative and total heat flux near the liquid pool surface of a 30~cm methanol fire. The {\rm radiative} heat flux measurements were made by Hamins~et~al.~\cite{Hamins:CST1994} and the {\em total} heat flux measurements were made by Kim et al.~\cite{Kim:FSJ2019}.
-\item Figure~\ref{NIST_Pool_Fire_Heat_Flux2} displays radial and vertical profiles of {\em total} heat flux for a 30~cm methanol fire extending beyond the outer rim of the pan~\cite{Kim:FSJ2019}. The vertical profile was made at $r=60$~cm. Additional radial measurements were made by Klassen~et~al.~\cite{Klassen:GCR1994}.
-\item Figure~\ref{NIST_Pool_Fire_Heat_Flux3} displays a radial profile of the total heat flux in the downward direction for a 100~cm pan methanol fire. The radial distance ranges from the burner edge ($r=50$~cm) to $r=200$~cm. The positions of the heat flux gauges were located $z=1$~cm above the fuel surface and oriented in the upward direction~\cite{Sung:TN2019}.
-\item Figure~\ref{NIST_Pool_Fire_Heat_Flux4} displays radial profiles of the total heat flux emitted radially away from the fire at heights of $z=41$~cm, $z=61$~cm, and $z=81$~cm above the fuel surface. The heat flux gauges were oriented in the horizontal direction toward the fire centerline~\cite{Sung:TN2019}.
+\item Figure~\ref{NIST_Pool_Fire_Heat_Flux} displays downward radiative and total heat flux near the liquid pool surface of a 30~cm methanol fire. The {\rm radiative} heat flux measurements are reported by Hamins~et~al.~\cite{Hamins:CST1994} and the {\em total} heat flux measurements are reported by Kim et al.~\cite{Kim:FSJ2019}.
+\item Figure~\ref{NIST_Pool_Fire_Heat_Flux3} displays a radial profile of the total heat flux in the downward direction for a 100~cm pan methanol fire. The radial distance ranges from the burner edge ($r=50$~cm) to $r=200$~cm. The positions of the heat flux gauges are located $z=1$~cm above the fuel surface and oriented in the upward direction~\cite{Sung:TN2083}.
+\item Figure~\ref{NIST_Pool_Fire_Heat_Flux4} displays radial profiles of the total heat flux emitted radially away from the 100~cm methanol fire at heights of $z=41$~cm, $z=61$~cm, and $z=81$~cm above the fuel surface. The heat flux gauges are oriented in the horizontal direction toward the fire centerline~\cite{Sung:TN2083}.
+\item Figures~\ref{NIST_Pool_Fire_Heat_Flux2} and \ref{NIST_Pool_Fire_Heat_Flux2b} display radial and vertical profiles of {\em total} heat flux for 30~cm acetone, ethanol, and methanol fires and 37~cm methane and propane fires. The radial profiles extend beyond the outer rim of the pan~\cite{Kim:FSJ2019}. The vertical profile for the methanol pool fire is located at $r=60$~cm, whereas for the other fuels it is at approximately 180~cm. Additional radial measurements are reported by Klassen~et~al.~\cite{Klassen:GCR1994}.
 \end{itemize}
 
 \begin{figure}[!ht]
@@ -2088,16 +2088,6 @@ \subsection{NIST Pool Fires}
 \label{NIST_Pool_Fire_Heat_Flux}
 \end{figure}
 
-\begin{figure}[!ht]
-\begin{tabular*}{\textwidth}{l@{\extracolsep{\fill}}r}
-\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Methanol_30_cm_HF_radial2} &
-\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Methanol_30_cm_HF_vertical}
-\end{tabular*}
-\caption[NIST Pool Fires, 30 cm methanol, radial and vertical profiles of total heat flux]
-{NIST Pool Fires, 30 cm methanol fire, radial and vertical profiles of total heat flux from a 30~cm methanol fire.}
-\label{NIST_Pool_Fire_Heat_Flux2}
-\end{figure}
-
 \begin{figure}[!ht]
 \begin{tabular*}{\textwidth}{l@{\extracolsep{\fill}}r}
 \includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/NIST_Methanol_1m_pan_HF_radial_0_cm} &
@@ -2119,6 +2109,37 @@ \subsection{NIST Pool Fires}
 \label{NIST_Pool_Fire_Heat_Flux4}
 \end{figure}
 
+\begin{figure}[!ht]
+\begin{tabular*}{\textwidth}{l@{\extracolsep{\fill}}r}
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Acetone_HF_radial} &
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Acetone_HF_vertical} \\
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Ethanol_HF_radial} &
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Ethanol_HF_vertical} \\
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Methanol_30_cm_HF_radial2} &
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Methanol_30_cm_HF_vertical} 
+\end{tabular*}
+\caption[NIST Pool Fires, 30 cm acetone, ethanol, methanol, radial and vertical profiles of total heat flux]
+{NIST Pool Fires, 30 cm acetone, ethanol, methanol fires, radial and vertical profiles of total heat flux.}
+\label{NIST_Pool_Fire_Heat_Flux2}
+\end{figure}
+
+\begin{figure}[!ht]
+\begin{tabular*}{\textwidth}{l@{\extracolsep{\fill}}r}
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Methane_HF_radial} &
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Methane_HF_vertical} \\
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Propane_20kW_HF_radial} &
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Propane_20kW_HF_vertical} \\
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Propane_34kW_HF_radial} &
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Propane_34kW_HF_vertical} \\
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Propane_50kW_HF_radial} &
+\includegraphics[height=2.15in]{SCRIPT_FIGURES/NIST_Pool_Fires/Propane_50kW_HF_vertical}
+\end{tabular*}
+\caption[NIST Pool Fires, 37 cm methane and propane, radial and vertical profiles of total heat flux]
+{NIST Pool Fires, 37 cm methane and propane fires, radial and vertical profiles of total heat flux.}
+\label{NIST_Pool_Fire_Heat_Flux2b}
+\end{figure}
+
+
 \clearpage
 
 \subsection{NIST Structure Separation Verification}
diff --git a/Manuals/FDS_Validation_Guide/Plume_Chapter.tex b/Manuals/FDS_Validation_Guide/Plume_Chapter.tex
@@ -216,7 +216,7 @@ \subsection{NIST Pool Fires}
 \begin{itemize}
 \item Figures~\ref{NIST_Pool_Fires_Temperature_1} and \ref{NIST_Pool_Fires_Temperature_2} display centerline profiles of mean and rms temperature for 30~cm diameter acetone, ethanol, heptane, and methanol liquid pool fires; and 37~cm methane and propane gaseous fires~\cite{Sung:TN2162r1}.
 \item Figure~\ref{NIST_Pool_Fires_Temperature_3} displays radial profiles of mean and rms temperature for a 30~cm methanol fire at heights of $z=3$~cm (mean only), $z=30$~cm (mean only), $z=41$~cm, $z=51$~cm, and $z=61$~cm. The profiles at 3~cm and 30~cm are from Ref.~\cite{Hamins:TN1928} and the others are from Ref.~\cite{Sung:TN2162r1}.
-\item Figures~\ref{NIST_Pool_Fires_Plume_Temps_1} and \ref{NIST_Pool_Fires_Plume_Temps_2} display centerline and radial profiles of mean and rms temperature for a 100~cm methanol fire. The radial profiles are located at heights of $z=20$~cm, $z=60$~cm, $z=100$~cm, $z=140$~cm, and $z=180$~cm~\cite{Sung:TN2019}.
+\item Figures~\ref{NIST_Pool_Fires_Plume_Temps_1} and \ref{NIST_Pool_Fires_Plume_Temps_2} display centerline and radial profiles of mean and rms temperature for a 100~cm methanol fire. The radial profiles are located at heights of $z=20$~cm, $z=60$~cm, $z=100$~cm, $z=140$~cm, and $z=180$~cm~\cite{Sung:TN2083}.
 \end{itemize}
 
 \newpage
diff --git a/Manuals/FDS_Validation_Guide/make_guide.sh b/Manuals/FDS_Validation_Guide/make_guide.sh
@@ -20,7 +20,7 @@ gitrevision=`git describe --abbrev=7 --long --dirty`
 echo "\\newcommand{\\gitrevision}{$gitrevision}" > ../Bibliography/gitrevision.tex
 
 pdflatex -interaction nonstopmode FDS_Validation_Guide &> FDS_Validation_Guide.err
-bibtex FDS_Validation_Guide &> FDS_Validation_Guide.err
+biber FDS_Validation_Guide &> FDS_Validation_Guide.err
 pdflatex -interaction nonstopmode FDS_Validation_Guide &> FDS_Validation_Guide.err
 pdflatex -interaction nonstopmode FDS_Validation_Guide &> FDS_Validation_Guide.err
 pdflatex -interaction nonstopmode FDS_Validation_Guide &> FDS_Validation_Guide.err
diff --git a/Manuals/FDS_Verification_Guide/FDS_Verification_Guide.tex b/Manuals/FDS_Verification_Guide/FDS_Verification_Guide.tex
diff --git a/Manuals/FDS_Verification_Guide/make_guide.sh b/Manuals/FDS_Verification_Guide/make_guide.sh
