Skip to content

Commit

Permalink
Add hyperlinks to section names (#230)
Browse files Browse the repository at this point in the history
  • Loading branch information
e-perl-NOAA authored Jun 3, 2024
1 parent 86be001 commit faddf72
Show file tree
Hide file tree
Showing 19 changed files with 399 additions and 240 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/build-ss3-manual-pdf.yml
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ jobs:
id: spellcheck
with:
root_file: SS330_User_Manual.tex
args: --check en --dict dictionary.txt --ignore sh:nobreak,sh:stacked,sh:nsubdiv,sh:seclen,sh:nonp,sh:hctab,sh:figref,lt:en:UNIT_SPACE,lt:en:UPPERCASE_SENTENCE_START,lt:en:COMMA_COMPOUND_SENTENCE_2,lt:en:COMMA_COMPOUND_SENTENCE,lt:en:ENGLISH_WORD_REPEAT_BEGINNING_RULE,lt:en:ENGLISH_WORD_REPEAT_RULE,lt:en:ENTER_IN,lt:en:CD_NN,lt:en:PHRASE_REPETITION,lt:en:SETUP_VERB,lt:en:ONES
args: --check en --dict dictionary.txt --ignore sh:nobreak,sh:stacked,sh:nsubdiv,sh:seclen,sh:nonp,sh:hctab,sh:figref,lt:en:FILE_EXTENSIONS_CASE,lt:en:UNIT_SPACE,lt:en:STEPS_TO_DO,lt:en:UPPERCASE_SENTENCE_START,lt:en:COMMA_COMPOUND_SENTENCE_2,lt:en:COMMA_COMPOUND_SENTENCE,lt:en:ENGLISH_WORD_REPEAT_BEGINNING_RULE,lt:en:ENGLISH_WORD_REPEAT_RULE,lt:en:ENTER_IN,lt:en:CD_NN,lt:en:PHRASE_REPETITION,lt:en:SETUP_VERB,lt:en:ONES

- name: Print number of spellcheck warnings
run: 'echo "Number of spellcheck warnings: ${{ steps.spellcheck.outputs.num_warnings }}"'
Expand Down Expand Up @@ -73,5 +73,5 @@ jobs:
- name: Throw error if spellcheck warnings exist
# If the number of warnings goes up (in the previous step) and cannot be rectified, you can change
# the number below and increase the number of warnings that will trigger the action to fail
if: ${{ steps.spellcheck.outputs.num_warnings > 447 }}
if: ${{ steps.spellcheck.outputs.num_warnings > 588 }}
run: 'echo "::error file=main.tex::num_warnings: ${{ steps.spellcheck.outputs.num_warnings }}"; exit 1;'
11 changes: 7 additions & 4 deletions 10optional_inputs.tex
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
\section{Optional Inputs}
\hypertarget{OptionalInputs}{}
\section[Optional Inputs]{\protect\hyperlink{OptionalInputs}{Optional Inputs}}

\hypertarget{WAA}{}
\subsection{Empirical Weight-at-Age (\texttt{wtatage.ss})}
\subsection[Empirical Weight-at-Age (\texttt{wtatage.ss})]{\protect\hyperlink{WAA}{Empirical Weight-at-Age (\texttt{wtatage.ss})}}
The model has the capability to read empirical body weight at age for the population and each fleet, in lieu of generating these weights internally from the growth parameters, weight-at-length, and size-selectivity. Selection of this option is done by setting an explicit switch near the top of the control file. The values are read from a separate file named, \verb|wtatage.ss|. This file is only required to exist if this option is selected.

The first value read is a single integer for the maximum age used in reading this file. So if the maximum age is 40, there will be 41 columns of weight-at-age entries to read, with the first column being for age 0. If the number of ages specified in this table is greater than maximum age in the model, the extra weight-at-age values are ignored. If the number of ages in this table is less than maximum age in the model, the weight-at-age data for the number of ages in the file is filled in for all unread ages out to maximum age.
Expand Down Expand Up @@ -58,10 +59,12 @@ \subsection{Empirical Weight-at-Age (\texttt{wtatage.ss})}
\end{itemize}


\subsection{\texttt{runnumber.ss}}
\hypertarget{runnumber}{}
\subsection[\texttt{runnumber.ss}]{\protect\hyperlink{runnumber}{\texttt{runnumber.ss}}}
This file contains a single integer value. It is read when the program starts, incremented by 1, used when processing the profile value inputs (see below), used as an identifier in the batch output, then saved with the incremented value. Note that this incrementation may not occur if a run crashes.

\subsection{\texttt{profilevalues.ss}}
\hypertarget{profilevalues}{}
\subsection[\texttt{profilevalues.ss}]{\protect\hyperlink{profilevalues}{\texttt{profilevalues.ss}}}
This file contains information for changing the value of selected parameters for each run in a batch. In the control file, each parameter that will be subject to modification by \texttt{profilevalues.ss} is designated by setting its phase to -9999.

The first value in \texttt{profilevalues.ss} is the number of parameters to be batched. This value MUST match the number of parameters with phase set equal to -9999 in the control file. The program performs no checks for this equality. If the value is zero in the first field, then nothing else will be read. Otherwise, the model will read runnumber * Nparameters values and use the last Nparameters of these to replace the initial values of parameters designated with phase = --9999 in the control file.
Expand Down
11 changes: 6 additions & 5 deletions 11likelihoods.tex
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
\section{Likelihood components}
\hypertarget{LikeComp}{}
\section[Likelihood components]{\protect\hyperlink{LikeComp}{Likelihood components}}

The objective function $L$ is the weighted sum of the individual components
indexed by kind of data $i$, and fishery/survey $f$ as appropriate:
Expand Down Expand Up @@ -28,9 +29,9 @@ \section{Likelihood components}
$i$ & fishery/survey $f$ & Mean L (or W)-at-age & normal \Tstrut\\
$i$ & fishery/survey $f$ & Tag-recapture 1 & multinomial \Tstrut\\
$i$ & fishery/survey $f$ & Tag-recapture 2 & negative binomial \Tstrut\\
$i$ & fishery $f$ & Initial equilibrium catch & lognormal \Tstrut\\
$i$ & fishery $f$ & catch & lognormal \Tstrut\\
$R$ & & Recruitment Deviations & lognormal \Tstrut\\
$i$ & fishery $f$ & Initial equilibrium catch & log-normal \Tstrut\\
$i$ & fishery $f$ & catch & log-normal \Tstrut\\
$R$ & & Recruitment Deviations & log-normal \Tstrut\\
$P$ & & Random parameter devs & normal \Tstrut\\
$\theta$ & & Parameter priors & user choice \Tstrut\\
$F_B$ & & F ballpark penalty & \Tstrut\\
Expand All @@ -41,7 +42,7 @@ \section{Likelihood components}

%\subsection{CPUE or abundance index}

%The distribution for CPUE or abundance index data can be lognormal, student-t, or normal. The %lognormal likelihood formulation is:
%The distribution for CPUE or abundance index data can be log-normal, student-t, or normal. The %log-normal likelihood formulation is:

%\begin{equation} L_{i,f} = N(ln(\sigma)) + \sum_{y=1}^{N_y}\frac{(ln(I_{y,f})-ln(Q_f B_{y,f}))^2}{2\sigma^2}
%\end{equation}
Expand Down
Loading

0 comments on commit faddf72

Please sign in to comment.