diff --git a/papers/variational_smoother/changelog.txt b/papers/variational_smoother/changelog.txt new file mode 100644 index 0000000..b21a586 --- /dev/null +++ b/papers/variational_smoother/changelog.txt @@ -0,0 +1,34 @@ +Change Log +----------- + +* elsarticle.dtx + +1. Frontmatter: Overfull \hbox has occurred while \output is active + +https://tex.stackexchange.com/questions/514218/elsarticle-frontmatter-overfull-hbox-has-occurred-while-output-is-active/515199 + +2. Footnotes: Updated to use non Arabic footnote numbers. + +https://tex.stackexchange.com/questions/669879/elsarticle-changing-symbol-used-in-fnref + +3. Author-affiliation: Updated for author-wise affiliation coding. +Last author affiliation repeating for all authors problem is fixed. + +4. Accent characters in address: A bug fix. Accented characters in +organisation field showed error. Hence loaded fontenc package. + +5. Updated for accent problems in TeXLive 2022. Font encoding T1 used +by default + +6. Removed extra space appearing after 'Appendix' label + +7. updated for listing author affiliation below author names if +\affiliation command is used immediately after \author (To match +behaviour of \address command) + +* elsarticle-template-harv.tex, \ + elsarticle-template-num-names.tex, \ + elsarticle-template-num.tex + +1. Added examples for figures, tables and equations +------------------------------------------------------------------------ diff --git a/papers/variational_smoother/doc/1pseperateaug.pdf b/papers/variational_smoother/doc/1pseperateaug.pdf new file mode 100644 index 0000000..c3e49ea Binary files /dev/null and b/papers/variational_smoother/doc/1pseperateaug.pdf differ diff --git a/papers/variational_smoother/doc/1psingleauthorgroup.pdf b/papers/variational_smoother/doc/1psingleauthorgroup.pdf new file mode 100644 index 0000000..4dd7c45 Binary files /dev/null and b/papers/variational_smoother/doc/1psingleauthorgroup.pdf differ diff --git a/papers/variational_smoother/doc/elsdoc.pdf b/papers/variational_smoother/doc/elsdoc.pdf new file mode 100644 index 0000000..a97fc2e Binary files /dev/null and b/papers/variational_smoother/doc/elsdoc.pdf differ diff --git a/papers/variational_smoother/doc/elsdoc.tex b/papers/variational_smoother/doc/elsdoc.tex new file mode 100644 index 0000000..fd97421 --- /dev/null +++ b/papers/variational_smoother/doc/elsdoc.tex @@ -0,0 +1,850 @@ +%% +%% Copyright 2007-2024 Elsevier Ltd +%% +%% This file is part of the 'Elsarticle Bundle'. +%% --------------------------------------------- +%% +%% It may be distributed under the conditions of the LaTeX Project Public +%% License, either version 1.3 of this license or (at your option) any +%% later version. The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3 or later is part of all distributions of LaTeX +%% version 1999/12/01 or later. +%% +%% The list of all files belonging to the 'Elsarticle Bundle' is +%% given in the file `manifest.txt'. +%% +%% $Id: elsdoc.tex 261 2024-04-09 06:37:35Z rishi $ +%% +\documentclass[a4paper,12pt]{article} + +\usepackage[xcolor,qtwo]{rvdtx} +\usepackage{multicol} +\usepackage{color} +\usepackage{xspace} +\usepackage{pdfwidgets} +\usepackage{enumerate} + +\def\ttdefault{cmtt} + +\headsep4pc + +\makeatletter +\def\bs{\expandafter\@gobble\string\\} +\def\lb{\expandafter\@gobble\string\{} +\def\rb{\expandafter\@gobble\string\}} +\def\@pdfauthor{C.V.Radhakrishnan} +\def\@pdftitle{elsarticle.cls -- A documentation} +\def\@pdfsubject{Document formatting with elsarticle.cls} +\def\@pdfkeywords{LaTeX, Elsevier Ltd, document class} +\def\file#1{\textsf{#1}\xspace} + +%\def\LastPage{19} + +\DeclareRobustCommand{\LaTeX}{L\kern-.26em% + {\sbox\z@ T% + \vbox to\ht\z@{\hbox{\check@mathfonts + \fontsize\sf@size\z@ + \math@fontsfalse\selectfont + A\,}% + \vss}% + }% + \kern-.15em% + \TeX} +\makeatother + +\def\figurename{Clip} + +\setcounter{tocdepth}{1} + +\begin{document} + +\def\testa{This is a specimen document. } +\def\testc{\testa\testa\testa\testa} +\def\testb{\testc\testc\testc\testc\testc} +\long\def\test{\testb\par\testb\par\testb\par} + +\pinclude{\copy\contbox\printSq{\LastPage}} + +\title{elsarticle.cls -- A better way to format your document} + +\author{Elsevier Ltd} +\contact{elsarticle@stmdocs.in} + +\version{3.4} +\date{\today} +\maketitle + +\section{Introduction} + +\file{elsarticle.cls} is a thoroughly re-written document class +for formatting \LaTeX{} submissions to Elsevier journals. +The class uses the environments and commands defined in \LaTeX{} kernel +without any change in the signature so that clashes with other +contributed \LaTeX{} packages such as \file{hyperref.sty}, +\file{preview-latex.sty}, etc., will be minimal. +\file{elsarticle.cls} is primarily built upon the default +\file{article.cls}. This class depends on the following packages +for its proper functioning: + +\begin{enumerate} +\item \file{natbib.sty} for citation processing; +\item \file{geometry.sty} for margin settings; +\item \file{fleqn.clo} for left aligned equations; +\item \file{graphicx.sty} for graphics inclusion; +\item \file{txfonts.sty} optional font package, if the document is to + be formatted with Times and compatible math fonts; +\item \file{hyperref.sty} optional packages if hyperlinking is + required in the document; +%*% +\item \file{endfloat.sty} optional packages if floats to be placed at + end of the PDF. +\end{enumerate} + +All the above packages (except some optional packages) are part of any +standard \LaTeX{} installation. Therefore, the users need not be +bothered about downloading any extra packages. Furthermore, users are +free to make use of \textsc{ams} math packages such as +\file{amsmath.sty}, \file{amsthm.sty}, \file{amssymb.sty}, +\file{amsfonts.sty}, etc., if they want to. All these packages work in +tandem with \file{elsarticle.cls} without any problems. + +\section{Major Differences} + +Following are the major differences between \file{elsarticle.cls} +and its predecessor package, \file{elsart.cls}: + +\begin{enumerate}[\textbullet] +\item \file{elsarticle.cls} is built upon \file{article.cls} +while \file{elsart.cls} is not. \file{elsart.cls} redefines +many of the commands in the \LaTeX{} classes/kernel, which can +possibly cause surprising clashes with other contributed +\LaTeX{} packages; + +\item provides preprint document formatting by default, and +optionally formats the document as per the final +style of models $1+$, $3+$ and $5+$ of Elsevier journals; + +\item some easier ways for formatting \verb+list+ and +\verb+theorem+ environments are provided while people can still +use \file{amsthm.sty} package; + +\item \file{natbib.sty} is the main citation processing package + which can comprehensively handle all kinds of citations and +works perfectly with \file{hyperref.sty} in combination with +\file{hypernat.sty}; + +\item long title pages are processed correctly in preprint and + final formats. + +\end{enumerate} + +\section{Installation} + +The package is available at author resources page at Elsevier +(\url{http://www.elsevier.com/locate/latex}). +It can also be found in Comprehensive +\TeX{} Archive Network (\textsc{ctan}), +\url{https://ctan.org/pkg/elsarticle}. + +Please download the \file{elsarticle.dtx} which is a composite +class with documentation and \file{elsarticle.ins} which is the +\LaTeX{} installer file. When we compile the +\file{elsarticle.ins} with \LaTeX{} it provides the class file, +\file{elsarticle.cls} by +stripping off all the documentation from the \verb+*.dtx+ file. +The class may be moved or copied to a place, usually, +\verb+$TEXMF/tex/latex/+ %$%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\verb+elsevier/+, +or a folder which will be read +by \LaTeX{} during document compilation. The \TeX{} file +database needs updation after moving/copying class file. Usually, +we use commands like \verb+mktexlsr+ or \verb+texhash+ depending +upon the distribution and operating system. + + +\section{Usage}\label{sec:usage} +The class should be loaded with the command: + +\begin{vquote} + \documentclass[]{elsarticle} +\end{vquote} + +\noindent where the \verb+options+ can be the following: + + +\begin{description} + +\item [{\tt\color{verbcolor} preprint}] default option which format the + document for submission to Elsevier journals. + +\item [{\tt\color{verbcolor} review}] similar to the \verb+preprint+ +option, but increases the baselineskip to facilitate easier review +process. + +\item [{\tt\color{verbcolor} 1p}] formats the article to the look and +feel of the final format of model 1+ journals. This is always single +column style. + +\item [{\tt\color{verbcolor} 3p}] formats the article to the look and +feel of the final format of model 3+ journals. If the journal is a two +column model, use \verb+twocolumn+ option in combination. + +\item [{\tt\color{verbcolor} 5p}] formats for model 5+ journals. This +is always of two column style. + +\item [{\tt\color{verbcolor} authoryear}] author-year citation style of +\file{natbib.sty}. If you want to add extra options of +\file{natbib.sty}, you may use the options as comma delimited strings +as arguments to \verb+\biboptions+ command. An example would be: +\end{description} + +\begin{vquote} + \biboptions{longnamesfirst,angle,semicolon} +\end{vquote} + +\begin{description} +\item [{\tt\color{verbcolor} number}] numbered citation style. Extra options + can be loaded with\linebreak \verb+\biboptions+ command. + +\item [{\tt\color{verbcolor} sort\&compress}] sorts and compresses the +numbered citations. For example, citation [1,2,3] will become [1--3]. + +\item [{\tt\color{verbcolor} longtitle}] if front matter is unusually long, use + this option to split the title page across pages with the correct +placement of title and author footnotes in the first page. + +\item [{\tt\color{verbcolor} times}] loads \file{txfonts.sty}, if +available in the system to use Times and compatible math fonts. + +%*% +\item [{\tt\color{verbcolor} reversenotenum}] Use alphabets as +author--affiliation linking labels and use numbers for author +footnotes. By default, numbers will be used as author--affiliation +linking labels and alphabets for author footnotes. + +\item [{\tt\color{verbcolor} lefttitle}] To move title and +author/affiliation block to flushleft. \verb+centertitle+ is the +default option which produces center alignment. + +\item [{\tt\color{verbcolor} endfloat}] To place all floats at the end +of the document. + +\item [{\tt\color{verbcolor} nonatbib}] To unload natbib.sty. +%*% + +\item [{\tt\color{verbcolor} doubleblind}] To hide author name, +affiliation, email address etc. for double blind refereeing purpose. +%*% + +\item[] All options of \file{article.cls} can be used with this + document class. + +\item[] The default options loaded are \verb+a4paper+, \verb+10pt+, + \verb+oneside+, \verb+onecolumn+ and \verb+preprint+. + +\end{description} + +\section{Frontmatter} + +There are two types of frontmatter coding: +\begin{enumerate}[(1)] +\item each author is +connected to an affiliation with a footnote marker; hence all +authors are grouped together and affiliations follow; +%\pagebreak +\item authors of same affiliations are grouped together and the +relevant affiliation follows this group. +\end{enumerate} + +An example of coding the first type is provided below. + +\begin{vquote} + \title{This is a specimen title\tnoteref{t1,t2}} + \tnotetext[t1]{This document is the results of the research + project funded by the National Science Foundation.} + \tnotetext[t2]{The second title footnote which is a longer + text matter to fill through the whole text width and + overflow into another line in the footnotes area of the + first page.} +\end{vquote} + +\begin{vquote} +\author[1]{Jos Migchielsen\corref{cor1}% + \fnref{fn1}} +\ead{J.Migchielsen@elsevier.com} + +\author[2]{CV Radhakrishnan\fnref{fn2}} +\ead{cvr@sayahna.org} + +\author[3]{CV Rajagopal\fnref{fn1,fn3}} +\ead[url]{www.stmdocs.in} + + \cortext[cor1]{Corresponding author} + \fntext[fn1]{This is the first author footnote.} + \fntext[fn2]{Another author footnote, this is a very long + footnote and it should be a really long footnote. But this + footnote is not yet sufficiently long enough to make two + lines of footnote text.} + \fntext[fn3]{Yet another author footnote.} +\end{vquote} + +\begin{vquote} + + \affiliation[1]{organization={Elsevier B.V.}, + addressline={Radarweg 29}, + postcode={1043 NX}, + city={Amsterdam}, + country={The Netherlands}} + + \affiliation[2]{organization={Sayahna Foundation}, + addressline={JWRA 34, Jagathy}, + city={Trivandrum}, + postcode={695014}, + country={India}} + + + \affiliation[3]{organization={STM Document Engineering + Pvt Ltd.}, + addressline={Mepukada, Malayinkil}, + city={Trivandrum} + postcode={695571}, + country={India}} +\end{vquote} + +The output of the above \TeX{} source is given in Clips~\ref{clip1} and +\ref{clip2}. The header portion or title area is given in +Clip~\ref{clip1} and the footer area is given in Clip~\ref{clip2}. + +\vspace*{1pc} + +\def\rulecolor{blue!70} +\src{Header of the title page.} +\includeclip{1}{130 612 477 707}{1psingleauthorgroup.pdf}%%{elstest-1p.pdf}%single author group +\def\rulecolor{orange} + +\pagebreak + +\def\rulecolor{blue!70} +\src{Footer of the title page.} +\includeclip{1}{93 135 499 255}{1pseperateaug.pdf}%%{elstest-1p.pdf}%single author group +\def\rulecolor{orange} + +Most of the commands such as \verb+\title+, \verb+\author+, +\verb+\affiliation+ are self explanatory. Various components are +linked to each other by a label--reference mechanism; for +instance, title footnote is linked to the title with a footnote +mark generated by referring to the \verb+\label+ string of +the \verb=\tnotetext=. We have used similar commands +such as \verb=\tnoteref= (to link title note to title); +\verb=\corref= (to link corresponding author text to +corresponding author); \verb=\fnref= (to link footnote text to +the relevant author names). \TeX{} needs two compilations to +resolve the footnote marks in the preamble part. +Given below are the syntax of various note marks and note texts. + + +\begin{vquote} + \tnoteref{} + \corref{} + \fnref{} + \tnotetext[