summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/asmejour
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-05-27 20:55:16 +0000
committerKarl Berry <karl@freefriends.org>2019-05-27 20:55:16 +0000
commitb0167c50d0281faddeb893289371d006f65693cc (patch)
tree4692164ee3f553f9e19a33d136abe8c3a9d152e8 /Master/texmf-dist/doc/latex/asmejour
parentd2e278139abfbc492dcd7dc8bed5266b9ac25413 (diff)
asmejour (27may19)
git-svn-id: svn://tug.org/texlive/trunk@51233 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/asmejour')
-rw-r--r--Master/texmf-dist/doc/latex/asmejour/README.md4
-rw-r--r--Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdfbin352617 -> 354323 bytes
-rw-r--r--Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex214
3 files changed, 119 insertions, 99 deletions
diff --git a/Master/texmf-dist/doc/latex/asmejour/README.md b/Master/texmf-dist/doc/latex/asmejour/README.md
index 963ec282a75..5064c9bf473 100644
--- a/Master/texmf-dist/doc/latex/asmejour/README.md
+++ b/Master/texmf-dist/doc/latex/asmejour/README.md
@@ -1,7 +1,7 @@
#asmejour: A template for ASME journal papers#
- Version 1.02 dated 2019/05/22.
+ Version 1.03 dated 2019/05/26.
####Overview####
This class provides a template to format preprints submitted to ASME journals in the style that
@@ -57,6 +57,8 @@
####Change log####
+v1.03: expand documentation; fix conflict between lineno and balance packages; more footer options; edit \\entry
+
v1.02: adjust formats of 2nd and 3rd level headings; add option for line numbers; eqn tags in blue
v1.01: edit documentation, remove development code
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
index e42d18d3063..72d8871234b 100644
--- a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
+++ b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
index cb6c8457faf..9ca000dbea2 100644
--- a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
+++ b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
@@ -2,7 +2,7 @@
%% This file is asmejour-template.tex, a template to format papers in the style of ASME journal papers
%% as they are being published in early 2019.
%%
-%% This file is version 1.02 dated 2019/05/22
+%% This file is version 1.03 dated 2019/05/26
%%
%% Author: John H. Lienhard V
%% Department of Mechanical Engineering
@@ -12,12 +12,11 @@
%% Class options are set up in the asmejour.cls file. These include:
%%
%% * Option to color the vertical bar in the title block [barcolor = colorname]
-%% where colorname is any name def'd by xcolor package; omit barcolor option to get black
+%% * where colorname is any name def'd by xcolor package; omit barcolor option to get black
%%
%% * Option to include line numbers [lineno]. The lineno package does not number equation
%% * lines, captions, etc. You must run twice for proper placement.
-%% * If you have been using lineno and then disable it, you may see errors about \@LN@col
-%% * undefined. To resolve this, delete your aux file.
+%% * This option will disable balancing column height on final page.
%%
%% * Math options from M. Sharpe's newtxmath package: upright integrals [upint]; and
%% * varvw for a v and w that are better distinguished from greek nu; and also
@@ -69,18 +68,8 @@
%% Class options are described above.
\documentclass[largesc,upint,varvw,barcolor=Red4,nocopyright]{asmejour}
-\usepackage{balance} % issue balance command near the end to nearly balance heights of final page short columns
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%% The following two packages can be deleted if not being used
-
-\usepackage{lipsum} % Generates paragraphs of gibberish latin for checking layout ... e.g. \lipsum[2-4] produces
- % paragraphs 2 through 4 of the text.
-\usepackage{metalogo,hologo} % Access various LaTeX logos
-
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%%%%% Fields to be completed %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%% FIELDS TO BE COMPLETED FOLLOW %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%% pdf metadata, the user should edit %%%%%%%%%%%%%%%%%%
@@ -90,21 +79,22 @@
pdfauthor={John H. Lienhard}, % <=== change to YOUR name[s]!!!
}
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+%%%% Journal name and optional copyright year %%%%%%%%%%%%%%
%% Omit "Journal of"
-%% If Journal Name is quite long, use \\ to insert linebreak
+%% If Journal Name is quite long, use \\ to insert a line break
\JourName{Heat Transfer} %<=== change to name of your journal
-\PaperYear % defaults to current year if no argument; \PaperYear{} omits year; \PaperYear{2018} sets 2018.
+\PaperYear % defaults to current year if no argument or omitted;
+ % \PaperYear{} omits year; \PaperYear{2018} sets 2018.
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%% End of Preamable %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}
-% Change to your name[s] and addresses, in the desired order of authors.
+% Change to your author name[s] and addresses, in the desired order of authors.
% First name, middle initial, last name
% Use title case (upper and lower case letters)
% Note usage below for corresponding author.
@@ -129,7 +119,7 @@ Cambridge, MA 02139 USA \\
email: lienhard@mit.edu
}
-%%% Change to your title. Can insert line breaks if you wish, otherwise selected automatically.
+%%% Change to your paper title. Can insert line breaks if you wish (otherwise selected automatically).
\SetTitle{Preprint Template for ASME\\ Journal Papers: asmejour.cls}
@@ -142,12 +132,14 @@ email: lienhard@mit.edu
%% Abstract should be no more than 250 words
\SetAbstract{%
-This paper is an example and template for the {\upshape\texttt{asmejour}} class. Papers typeset in this class will follow ASME journal style for margins, fonts, headings, captions, and reference formats. Standard \LaTeX\ commands are used. The class will lay out the author, title, and abstract in ASME style. The class will produce a pdf file that that includes hyperlinks, bookmarks, and pdf metadata. The class is intended to be used with the {\upshape\texttt{asmejour.bst}} \hologo{BibTeX} style for typesetting references, which is part of this distribution. This style supports hyperlinks and modern reference formats, following current ASME practice. The class may be invoked with several options, most of which address math fonts. The class calls a number of packages, all of which are in \TeX\textsc{live}\ and on CTAN (\href{http://ctan.org}{ctan.org}). The class is compatible with \hologo{pdfLaTeX} or \LuaLaTeX.
+This paper is an example and template for the {\upshape\texttt{asmejour}} class. Papers typeset in this class will follow ASME journal style for margins, fonts, headings, captions, and reference formats. Standard \LaTeX\ commands are used. The class will lay out the author, title, and abstract in ASME style. The class will produce a pdf file that that includes hyperlinks, bookmarks, and pdf metadata. The class is intended to be used with the {\upshape\texttt{asmejour.bst}} \hologo{BibTeX} style for typesetting references, which is part of this distribution. This style supports hyperlinks and modern reference formats, following current ASME practice. The class may be invoked with several options, most of which address math fonts. The class calls a number of packages, all of which are in \TeX~Live and in CTAN (\href{http://ctan.org}{ctan.org}). The class is compatible with \hologo{pdfLaTeX} or \LuaLaTeX.
}
-\MakeTitlePage
-%%%%%%%%%%%%%%%%%%%%% End of fields to be completed. Now write! %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\MakeTitlePage %% This command creates the author/title/abstract block. Essential!
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%% End of fields to be completed. Now write! %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section*{Introduction}
@@ -173,13 +165,13 @@ The vertical bar in the title block is black in all ASME journals. Since the \te
\section*{References to Figures, Equations, and Citations}
For ASME papers, the labels Figure and Equation should be abbreviated when they do not start a sentence, as in Fig.~\ref{fig:1} and Eq.~\eqref{eqn:1}. Figure~\ref{fig:1} is spelled out when it starts a sentence. Equation~\eqref{eqn:1} is spelled out when it starts a sentence.
-Citations will be numbered automatically \cite{DKE1969}. They should be inserted at the appropriate point using a \verb|\cite{ref}| command~\cite{toohey2007,gibson2008}. The citations will be automatically sorted and compressed, as well, if they are given in a set \cite{stevens1999, DKE1969, wions2005, oligaria2011,mollen2014,smith2014,apple2019}. See the \texttt{asmeconf-sample.bib} file for examples of how to enter your references.
+Citations will be numbered automatically \cite{DKE1969}. They should be inserted at the appropriate point using a \verb|\cite{ref}| command~\cite{toohey2007,gibson2008}. The citations will be automatically sorted and compressed, as well, if they are given in a set \cite{stevens1999, DKE1969, wions2005, oligaria2011,mollen2014,smith2014,apple2019}. Just refer to the number when naming a reference, as in \cite{smith2014}. Reference~\cite{smith2014} is appropriate at the beginning of a sentence.
+See the \texttt{asmeconf-sample.bib} file for examples of how to enter your references.
Equations are typeset in the usual way. The class file loads the \texttt{amsmath} and \texttt{mathtools} packages. Further, the \texttt{newtxmath} package used for the math fonts includes many additional features.
\begin{equation}\label{eqn:1}
\mathbf{q} = -k\nabla T
\end{equation}
-Be sure to put your symbols into the nomenclature list, including SI units.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section*{Section Headings and Captions}
@@ -191,10 +183,22 @@ Math can be used in either captions or section headings, and an appropriate math
If you wish to override the default math format in a heading or caption, put \verb|\mathversion{normal}| in the heading or caption. (The \texttt{newtxmath} package \cite{sharpe1} includes a complete set of bold math fonts, however, so the need to override should be rare.)
+Single-sentence captions should not end with a period. Multi-sentence captions do include periods.
+
\subsection*{Subsection Headings}
-Section and subsection headings should be in title case (first letter of primary words capitalized). ASME does not use \verb|\subsubsection| or \verb|\paragraph|, so the class file treats these commands like \verb|\subsection|.
+Section, subsection, and subsubsection headings should be in title case (first letter of primary words capitalized). ASME does not use \verb|\paragraph|, so the class file treats this commands like \verb|\subsubsection|.
+%%%%%%%%%%%%% begin figure %%%%%%%%%%%%%%%%%
+
+%% captions go below figures
+\begin{figure}
+\centering\includegraphics[width=0.7\linewidth]{sample-figure-1.pdf}
+\caption{A figure caption with math, $z = (r,\phi)$ \cite{Lienhard2019b}\label{fig:1}}
+\end{figure}
+
+%%%%%%%%%%%%% end figure %%%%%%%%%%%%%%%%%%%
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section*{More on Math}
To get bold math outside of the captions, you can use the \verb|\bm{..}| macro from the \texttt{bm} package, which is loaded by the class.
@@ -203,17 +207,30 @@ To get bold math outside of the captions, you can use the \verb|\bm{..}| macro f
\bm{ S = k \ln w}
\end{equation}
-Math italics are used for roman and greek letters by default. If you want an upright letter in math, you can use the relevant math alphabet, e.g., \verb|\mathrm, \mathbf, \mathsf|:
+Math italics are used for roman and lower-case greek letters by default. If you want an upright letter in math, you can use the relevant math alphabet, e.g., \verb|\mathrm, \mathbf, \mathsf|:
\begin{equation}\label{eqn:newton2}
\vec{F} = m \vec{a} \quad\textrm{or}\quad \vec{\mathrm{F}} = m \vec{\mathrm{a}} \quad\textrm{or}\quad \mathbf{F} = m \mathbf{a} \quad\textrm{or}\quad \vec{\mathsf{F}} = m \vec{\mathsf{a}}
\end{equation}
-ASME typesets vectors in upright bold, like the third instance in Eq.\ \eqref{eqn:newton2}, and sets matrices in bold italic.
-The \texttt{newtxmath} package includes a large number of options for mathematics, most of which can be called using options to the documentclass. For example, the \texttt{upint} option of \texttt{newtxmath} selects upright integral signs (rather than slanted integral signs):
+ASME typesets vectors in upright bold, like the third instance in Eq.\ \eqref{eqn:newton2}, and sets matrices in bold italic. In the next equation $\mathbf{w}$ is a vector and $\bm{J}_1$ is a matrix:
+\begin{equation}\label{eqn:dw}
+d\mathbf{w} =
+ \begin{pmatrix}
+ du \\ dv
+ \end{pmatrix} =
+ \underbrace{\begin{pmatrix}
+ \partial u/\partial x & \partial u/\partial y \\
+ \partial v/\partial x & \partial v/\partial y
+ \end{pmatrix}}_{=\,\bm{J}_1} \begin{pmatrix}
+ dx \\ dy
+ \end{pmatrix}
+\end{equation}
+
+The \texttt{newtxmath} package includes a large number of options for mathematics, most of which can be called as options to \verb|\documentclass|. For example, the \texttt{upint} option of \texttt{newtxmath} selects upright integral signs (rather than slanted integral signs):
\begin{quote}
\verb|\documentclass[upint]{asmejour}|.
\end{quote}
-Options are discussed further in the \texttt{asmejour-template.tex} file.
+These math options are discussed further in the \texttt{asmejour-template.tex} file.
In addition, many options for calligraphic, script, and fraktur fonts are available as options to the \texttt{mathalfa} package, which is also loaded. These may be invoked, for example, as
\begin{quote}
@@ -223,33 +240,28 @@ which selects the Euler font for \verb|\mathcal| (this is our default). To find
The typewriter font loaded is \texttt{inconsolata} (which is sans serif), as suggested by the \texttt{newtx} package documentation. The class is not set up for use with the \texttt{fontspec} or \texttt{unicode-math} packages.
-%%%%%%%%%%%%% begin figure %%%%%%%%%%%%%%%%%
-%% captions go below figures
-\begin{figure}
-\centering\includegraphics[width=0.7\linewidth]{sample-figure-1.pdf}
-\caption{A figure caption with math, $z = (r,\phi)$ \cite{Lienhard2019b}\label{fig:1}}
-\end{figure}
-
-%%%%%%%%%%%%% end figure %%%%%%%%%%%%%%%%%%%
+\subsubsection*{Units and Nomenclature} ASME requires SI units. U.S.\ style units may be follow in parentheses. Be sure to put your symbols into the nomenclature list, including the SI units.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\section*{Tables}
+\section*{Tables and Figures}
Table \ref{tab:1} is an example of a simple table. Table captions should be placed above tables.
The class loads the \texttt{array} and \texttt{dcolumn} packages which provide extended capabilities for columns in the \texttt{tabular} environment (used in Tables \ref{tab:2} and \ref{tab:3}). Table~\ref{tab:3} is designed to have exactly the width of a text column. Table~\ref{tab:4} shows a table that spans both text columns.
+Text in the figures should be checked for legibility at either single-column width (about 83~mm) or full-column width (about 170~mm). Figure captions should be placed below figures.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section*{Reference Formatting with \texttt{asmejour.bst}}
The {\upshape\texttt{asmejour.bst}} \hologo{BibTeX} style follows the reference styles observed in ASME journals in 2019. The vast majority of published references are to journal papers and books. Examples for these and many other cases are given in the \texttt{asmejour-sample.bib} file, which is part of this distribution. Nevertheless, a few comments are necessary.
-\subsection*{Hyperlinked Titles} If an \verb|@article{..| or \verb|@book{..| includes \verb|doi={..}|, the journal title will be hyperlinked to that doi number. If no doi is included, but a url is included, then the title will be hyperlinked to that url. To display the doi (or the url when no doi is given), put it into the \verb|note={..}| field:
+\subsection*{Hyperlinked Titles} If an \verb|@article{..| or \verb|@book{..| includes \verb|doi={..}|, the journal title will be hyperlinked to that doi number, and the doi number will not be printed. If no doi is included, but a url is included, then the title will be hyperlinked to that url. To display the doi (or the url when no doi is given), put it into the \verb|note={..}| field:
\begin{quote}
\verb|note = {\doi{10.1115/1.4042912}}|
\end{quote}
+Include doi numbers in references whenever possible.
-Elementary support for \texttt{eprint} numbers is also included, generating a url at the end of the citation. The \texttt{archive} type may be specified using the macros \texttt{arxiv, googlebooks, hndl, jstore}, or \texttt{pubmed} (e.g., \texttt{archive=hndl}, \textit{without} braces). Both fields \textit{must} be given. Other root urls may be invoked using \verb|archive = {http://another.url.org/}|.
+Elementary support for \texttt{eprint} numbers is also included, generating a url at the end of the citation. The \texttt{archive} type may be specified using the macros \texttt{arxiv, googlebooks, hndl, jstore}, or \texttt{pubmed} (e.g., \texttt{archive=hndl}, \textit{without} braces). Both \texttt{eprint} and \texttt{archive} fields \textit{must} be given. Other root urls may be invoked using \verb|archive = {http://another.url.org/}|.
\subsection*{Online Sources} A bibliography field \verb|@online{..| is included for citation of online sources, such as web pages. See the examples of use in the \texttt{asmejour-sample.bib} file.
@@ -259,16 +271,6 @@ Elementary support for \texttt{eprint} numbers is also included, generating a ur
\subsection*{Version Number\footnote{Another longer footnote to show the leading and line breaking, and how it will sit at the bottom of a column. Another longer footnote to show the leading and line breaking, and how it will sit at the bottom of a column.}} The \verb|version={..}| field may be used with \verb|@book|, \verb|@online|, and \verb|@manual|. By default, the text will read \texttt{Version `number'} as in \cite{sharpe1,sharpe2}, but different wording may be selected using the \verb|versiontype={..}| field, to have ``Revision'' or something similar, as in \cite{GSL}. ASME often puts the version in the title, as in \cite{dlmf, texshop}, so I've left the final decision for discussion between the authors and the copy editor.
-%% Dealing with complicated math in a section heading: optional argument of \section provides the pdfbookmark
-%% without losing characters or producing warnings/errors. Note that bookmark can include simple math.
-%%
-%% Newtxmath provides the option for upright Greek letters as \upomega (vs. \omega), etc.
-%%
-\section*[Math in a Section Heading: \omega\cdot U=0]{Math in a Section Heading: $\hat{\upomega}\cdot\hat{\mathrm{U}}=0$}
-
-The rest of this is fake Latin text to demonstrate formats.
-\lipsum[6] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
-
%%%%%%%%%%%%%%% begin simple table %%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -310,6 +312,37 @@ Our competitor's data & 72.321 & 141.384 \\[1pt]
%%%%%%%%%%%%%%%% end table %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%% begin wide figure %%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{figure*}[t]
+\begin{minipage}[c]{0.5\textwidth}
+\centering{
+ \includegraphics{sample-figure-2a.pdf}
+\subcaption{Interior region\label{fig:interior-region}}
+}\end{minipage}
+%%%%%%%% don't leave a break here
+\begin{minipage}[c]{0.5\textwidth}
+\centering{
+\includegraphics{sample-figure-2b.pdf}
+\subcaption{Exterior region\label{fig:exterior-region}}
+}\end{minipage}
+\caption{A figure with two subfigures \cite{Lienhard2019b}}
+\end{figure*}
+
+%%%%%%%%%%%%%%%%%%% end wide figure %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section*{Additional Options for \texttt{asmejour.cls}}
+The class accepts a number of options in addition to those already described.
+
+\subsubsection*{Line Numbers} The option \texttt{[lineno]} invokes the the \texttt{lineno} package. This will produce line numbers in the margins. You must run \LaTeX\ twice for proper placement. The \texttt{lineno} package is not compatible with the \texttt{balance} package that makes final short columns the same height. Balancing will be disabled when this option is called. See the documentation of the \texttt{lineno} package for further commands to control line numbering.
+
+\subsubsection*{Changing the Footer Text} The option \texttt{[nofoot]} will omit everything other than a page number from the page footer. The option \texttt{nocopyright} will omit the ASME copyright from the first page footer. The command \verb|\PreprintString{..}| replaces the words \textsf{PREPRINT FOR REVIEW}. The final paper number may be added to the page number using \verb|\PaperNumber{..}|.
+
+\subsubsection*{Superiors Font} The \texttt{newtxtext} package includes a superiors font (both numbers and letters) for use in footnote markers and superscripts. To enable this font, use the option \texttt{[nodefaultsups]}. The corresponding author mark in the author block will not change.
+
+
%%%%%%%%%%%%%%%%%%% begin linewidth table %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{table}[b]
@@ -331,45 +364,24 @@ q_\textrm{gray} & q_\textrm{int, $T_1$} & q_\textrm{int, $T_m$} & q_\textrm{exa
%%%%%%%%%%%%%%%%%%%% end linewidth table %%%%%%%%%%%%%%%%%%%%%%%
-%%%%%%%%%%%%%%%%% begin wide figure %%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\begin{figure*}[t]
-\begin{minipage}[c]{0.5\textwidth}
-\centering{
- \includegraphics{sample-figure-2a.pdf}
-\subcaption{Interior region\label{fig:interior-region}}
-}\end{minipage}
-%%%%%%%% don't leave a break here
-\begin{minipage}[c]{0.5\textwidth}
-\centering{
-\includegraphics{sample-figure-2b.pdf}
-\subcaption{Exterior region\label{fig:exterior-region}}
-}\end{minipage}
-\caption{A figure with two subfigures \cite{Lienhard2019b}}
-\end{figure*}
-
-%%%%%%%%%%%%%%%%%%% end wide figure %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Dealing with complicated math in a section heading: optional argument of \section provides the pdfbookmark
+%% without losing characters or producing warnings/errors. Note that bookmark can include simple math.
+%%
+%% Newtxmath provides the option for upright Greek letters as \upomega (vs. \omega), etc.
+%%
+\section*[Math in a Section Heading: \omega\cdot U=0]{Math in a Section Heading: $\hat{\upomega}\cdot\hat{\mathrm{U}}=0$}
-\subsection*{Subsection Heading}
+To include complicated math in a section heading without producing bookmark-related errors, use the optional argument of \verb|\section| to create the pdfbookmark. The heading above was set with the following command:
+\begin{quote}\raggedright
+\verb|\section*[Math in a Section Heading:|
+\hspace*{1em}\verb|\omega\cdot U=0]{Math in a Section Heading:|
+\hspace*{1em}\verb|$\hat{\upomega}\cdot\hat{\mathrm{U}}=0$}|
+\end{quote}
+Note that bookmark can include simple math. Also note that \texttt{newtxmath} provides the option to obtain upright Greek letters as \verb|\upomega| (vs.\ \verb|\omega|), etc.
-\lipsum[12-13] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
-\begin{equation}\label{eqn:dw}
-d\mathbf{w} =
- \begin{pmatrix}
- du \\ dv
- \end{pmatrix} =
- \underbrace{\begin{pmatrix}
- \partial u/\partial x & \partial u/\partial y \\
- \partial v/\partial x & \partial v/\partial y
- \end{pmatrix}}_{=\,\bm{J}_1} \begin{pmatrix}
- dx \\ dy
- \end{pmatrix}
-\end{equation}
-Note ASME style for vectors, $\mathbf{w}$, and matrices, $\bm{J}_1$.
-\subsubsection*{Third Level Heading}
-\lipsum[13]
%%%%%%%%%%%%%%% begin table %%%%%%%%%%%%%%%%%%
\begin{table*}[t]
@@ -403,8 +415,10 @@ Note ASME style for vectors, $\mathbf{w}$, and matrices, $\bm{J}_1$.
%%%%%%%%%%%%%%%% end table %%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section*{Summary}
-\lipsum[17] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
+The class \texttt{asmejour} and associated files are for typesetting preprints in the style of ASME journals.
+Documentation is provided in this file and by comments in the \texttt{.tex} source code. Examples of entering references are shown in the \texttt{asmejour-sample.bib} file. The \texttt{asemjour.bst} file produces references following ASME's current formats. This package is not a publication of ASME and is offered without charge under the terms of the \href{https://ctan.org/license/mit}{MIT license}.
\begin{enumerate}
\item First conclusion
@@ -416,13 +430,14 @@ Note ASME style for vectors, $\mathbf{w}$, and matrices, $\bm{J}_1$.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\section*{Acknowledgement}
-\lipsum[17] % <=== This command generates paragraphs of fake Latin. Delete it here and elsewhere!
+\section*{Acknowledgment} %% ASME requests this exact spelling, singular.
+Acknowledge individuals, institutions, or companies that supported the authors in preparing the work. Those mentioned might have provided technical support, insightful comments or conversations, materials used in the work, or access to facilities.
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section*{Funding Data}
\begin{itemize}
-\item U.S.\ Department of Heat Transfer, Office of Important Ideas (DOHT Award No.\ 3.14159265)
+\item U.S.\ Department of Heat Transfer, Office of Important Ideas (DOHT-OII Award No.\ 3.14159265)
\end{itemize}
@@ -450,7 +465,7 @@ Note ASME style for vectors, $\mathbf{w}$, and matrices, $\bm{J}_1$.
\end{nomenclature}
-%%%%%%%%%%%%%%% Appendices %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%% APPENDICES %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Note that appendices will be "numbered" A, B, C, ... etc. Use \section, not \section*
%% Subsections need not be numbered, use \subsection*
@@ -462,7 +477,7 @@ Note ASME style for vectors, $\mathbf{w}$, and matrices, $\bm{J}_1$.
\section{Incomplete Zeta Function~\cite{Lienhard2019c}\label{app:zetafunction}}
-The radiation fractional function may be written in terms of the incomplete zeta function for convenience:
+This text is just an illustration of an appendix. The radiation fractional function may be written in terms of the incomplete zeta function for convenience:
\begin{align}
f(\lambda T) = {}& \frac{1}{\sigma T^4} \int_0^\lambda\frac{2\pi h c_o^2}{\lambda^5 \left[ \exp (h c_o/k_B T \lambda) - 1\right] } \, d\lambda \\
= {}& \frac{1}{\sigma T^4}\frac{2\pi k_B^4 T^4}{h^3c_o^2}\int^\infty_{c_2/\lambda T}\frac{t^3}{e^t -1}\, dt\label{eqn:zeta}
@@ -473,20 +488,23 @@ When $\lambda T \rightarrow \infty$, $f = 1$ and the last equation yields the we
\end{equation}
where the Gamma function $\Gamma(4) = 3!$ and the Riemann zeta function, $\zetaup(4)$, has the indicated integral representation \cite[\S13.12]{ww1927}. A classical result due to Euler \cite{euler1740} gives $\zetaup(4) = \pi^4/90$ (see also \cite[\S167]{euler1748}), from which we recover the usual definition of the Stefan-Boltzmann constant, $\sigma$.
-%%%%%%%%%%%%% Bibliography %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%% BIBLIOGRAPHY %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\balance %<=== this command, from the balance package, attempts to balance column heights on last page.
% performance is a bit variable, however...
+ % The [lineno] option will disable this command
+
+\nocite{*} %% <=== delete this line - unless you want to typeset the entire contents of your .bib file.
+
+\bibliographystyle{asmejour} %% .bst file that follows ASME journal format. Do not change.
-\nocite{*} %% <=== delete this line unless you want to typeset the entire contents of your .bib file.
-\bibliographystyle{asmejour} %% .bst file following ASME journal format. Do not change.
\bibliography{asmejour-sample} %% <=== change this to name of your bib file
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\clearpage
-%% ASME requires these lists for production
+%% ASME requires these lists for production.
\twocolumn[
\begin{@twocolumnfalse}
\listoffigures