From 49deefa67ed33872bbc6ff12e533e77e17a7c730 Mon Sep 17 00:00:00 2001 From: e-perl-NOAA Date: Tue, 3 Feb 2026 09:36:58 -0500 Subject: [PATCH 1/6] try removing mybox commands to see if it fixes latex creation --- 12runningSS3.tex | 4 ++-- 15special.tex | 7 ++++--- SS330_User_Manual.tex | 36 ++++++++++++++++++------------------ 3 files changed, 24 insertions(+), 23 deletions(-) diff --git a/12runningSS3.tex b/12runningSS3.tex index 3f64d59b..190a22f0 100644 --- a/12runningSS3.tex +++ b/12runningSS3.tex @@ -12,9 +12,9 @@ \end{verbatim} \end{quote} -\begin{mybox}{Note} +% \begin{mybox}{Note} If you are on a Windows system and get a warning about the Microsoft Defender SmartScreen preventing an unrecognized app from starting, follow \href{https://answers.microsoft.com/en-us/windows/forum/all/how-to-change-the-mode-of-smart-app-control-from/399a276f-5585-40fe-b72d-c014cac82b32}{these instructions} to turn the Smart App Control off. If you don't have permissions to do so, either contact your IT department to have them change the setting or use \texttt{r4ss::get\_ss3\_exe()} which seems to work in this case too. -\end{mybox} +% \end{mybox} On Mac and Linux computers, the executable name must be preceded by a period and slash (unless its location has been added to the user's PATH). Note that the user may need to change permissions for Stock Synthesis to be executable before running SS3 for the first time: diff --git a/15special.tex b/15special.tex index ff048e70..6e78dc82 100644 --- a/15special.tex +++ b/15special.tex @@ -139,9 +139,10 @@ \item 1 \#\_months/season \item \# resultant season duration = 0.08333 \end{itemize} - \begin{mybox}{\textbf{With continuous season option 1, the user will see this warning}} \\ + % \begin{mybox}{} + \textbf{With continuous season option 1, the user will see this warning} \\ Warning: Season durations sum to < 11.9, so SS3 assumes you are doing years as pseudo-seasons. There can be only 1 season in this time-step and SS3 will ignore month input and assume all observation occur at middle of this pseudo-year. Mortality, growth, and movement rates are per annum, so will get multiplied by the duration of this time-step as they are used. What gets reported as age is now age in time-steps; and input of age-specific $M$ or $K$ requires one entry per time-step. Similarly, output of age-specific quantities is in terms of number of time-steps, not real years. Spawn\_month and settlement\_month in control file are best set to 1.0 when doing years as pseudo-seasons. - \end{mybox} + % \end{mybox} \item \textbf{Option 3: Manual season duration adjustment} \hypertarget{option3}{} \\ This creates a continuous stream of seasons and each is treated as if it is a logical year of \underline{full} (12 month) duration. SS3 will not be able to detect that you are intending to use these years as seasons. All rate parameters will need to be divided by 12.0 by the user because the season duration is not being internally adjusted. \begin{itemize} @@ -184,7 +185,7 @@ \item Edit the recruitment deviation (rec\_dev) start and end years to be in terms of the model time steps. \item Parameters: \begin{itemize} - \item If using \hyperlink{option3}{option 3}, growth rate and any other rate parameters will need manual adjustment to be in terms of the duration of the season. + \item If using \hyperlink{option2}{option 2}, growth rate and any other rate parameters will need manual adjustment to be in terms of the duration of the season. \item Edit any age selectivity parameters that refer to age, because they are now in terms of quarters. \item Decrease the $R_{0}$ parameter starting value because it is now the average number of recruitments per quarter year. \item If there needs to be some degree of seasonality to a parameter, then you could create a cyclic pattern in the environmental input and make the parameter a function of this cyclic pattern. diff --git a/SS330_User_Manual.tex b/SS330_User_Manual.tex index b188e6b4..8d86cd90 100644 --- a/SS330_User_Manual.tex +++ b/SS330_User_Manual.tex @@ -47,24 +47,24 @@ \usepackage[most]{tcolorbox} % callout box % callout box controls -\tcbuselibrary{skins,breakable} -\newtcolorbox{mybox}[2][]{ - breakable, - sharp corners, - skin=enhancedmiddle jigsaw, - parbox=false, - boxrule=0mm, - leftrule=2mm, - boxsep=0mm, - arc=0mm, - outer arc=0mm, - attach title to upper, - after title={:\ }, - coltitle=black, - colback=gray!10, - colframe=black, - title={#2}, - fonttitle=\bfseries,#1} +% \tcbuselibrary{skins,breakable} +% \newtcolorbox{mybox}[2][]{ +% breakable, +% sharp corners, +% skin=enhancedmiddle jigsaw, +% parbox=false, +% boxrule=0mm, +% leftrule=2mm, +% boxsep=0mm, +% arc=0mm, +% outer arc=0mm, +% attach title to upper, +% after title={:\ }, +% coltitle=black, +% colback=gray!10, +% colframe=black, +% title={#2}, +% fonttitle=\bfseries,#1} % For tagging the pdf: https://github.com/jgm/pandoc/issues/5409#issuecomment-770417614 \ifluatex From 2a2fc0862492693caeb77c3bc9972597e02923fc Mon Sep 17 00:00:00 2001 From: e-perl-NOAA Date: Tue, 3 Feb 2026 09:47:49 -0500 Subject: [PATCH 2/6] fix item --- 15special.tex | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/15special.tex b/15special.tex index 6e78dc82..bf7420d6 100644 --- a/15special.tex +++ b/15special.tex @@ -140,8 +140,8 @@ \item \# resultant season duration = 0.08333 \end{itemize} % \begin{mybox}{} - \textbf{With continuous season option 1, the user will see this warning} \\ - Warning: Season durations sum to < 11.9, so SS3 assumes you are doing years as pseudo-seasons. There can be only 1 season in this time-step and SS3 will ignore month input and assume all observation occur at middle of this pseudo-year. Mortality, growth, and movement rates are per annum, so will get multiplied by the duration of this time-step as they are used. What gets reported as age is now age in time-steps; and input of age-specific $M$ or $K$ requires one entry per time-step. Similarly, output of age-specific quantities is in terms of number of time-steps, not real years. Spawn\_month and settlement\_month in control file are best set to 1.0 when doing years as pseudo-seasons. + \item \textbf{With continuous season option 1, the user will see this warning} \\ + Warning: Season durations sum to < 11.9, so SS3 assumes you are doing years as pseudo-seasons. There can be only 1 season in this time-step and SS3 will ignore month input and assume all observation occur at middle of this pseudo-year. Mortality, growth, and movement rates are per annum, so will get multiplied by the duration of this time-step as they are used. What gets reported as age is now age in time-steps; and input of age-specific $M$ or $K$ requires one entry per time-step. Similarly, output of age-specific quantities is in terms of number of time-steps, not real years. Spawn\_month and settlement\_month in control file are best set to 1.0 when doing years as pseudo-seasons. % \end{mybox} \item \textbf{Option 3: Manual season duration adjustment} \hypertarget{option3}{} \\ This creates a continuous stream of seasons and each is treated as if it is a logical year of \underline{full} (12 month) duration. SS3 will not be able to detect that you are intending to use these years as seasons. All rate parameters will need to be divided by 12.0 by the user because the season duration is not being internally adjusted. From d196e9110bce9499c1fd15dec99900280c908029 Mon Sep 17 00:00:00 2001 From: e-perl-NOAA Date: Tue, 3 Feb 2026 09:49:16 -0500 Subject: [PATCH 3/6] try again --- 12runningSS3.tex | 1 + 1 file changed, 1 insertion(+) diff --git a/12runningSS3.tex b/12runningSS3.tex index 190a22f0..86466083 100644 --- a/12runningSS3.tex +++ b/12runningSS3.tex @@ -13,6 +13,7 @@ \end{quote} % \begin{mybox}{Note} +\textbf{Note:} If you are on a Windows system and get a warning about the Microsoft Defender SmartScreen preventing an unrecognized app from starting, follow \href{https://answers.microsoft.com/en-us/windows/forum/all/how-to-change-the-mode-of-smart-app-control-from/399a276f-5585-40fe-b72d-c014cac82b32}{these instructions} to turn the Smart App Control off. If you don't have permissions to do so, either contact your IT department to have them change the setting or use \texttt{r4ss::get\_ss3\_exe()} which seems to work in this case too. % \end{mybox} From 35f83c488b2dad501870bef9a115ddb54660bbb5 Mon Sep 17 00:00:00 2001 From: e-perl-NOAA Date: Tue, 3 Feb 2026 10:00:16 -0500 Subject: [PATCH 4/6] try again --- SS330_User_Manual.tex | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/SS330_User_Manual.tex b/SS330_User_Manual.tex index 8d86cd90..ca3f1004 100644 --- a/SS330_User_Manual.tex +++ b/SS330_User_Manual.tex @@ -3,10 +3,10 @@ \RequirePackage{pdfmanagement-testphase} \PassOptionsToPackage{enable-debug}{expl3} %\DeclareDocumentMetadata { } -\DocumentMetadata{testphase={phase-III,math}} -\ExplSyntaxOn -\pdfmanagement_add:nnn{Catalog}{Lang}{(enUS)} -\ExplSyntaxOff +\DocumentMetadata{testphase={phase-III,math}, lang=en-US} +% \ExplSyntaxOn +% \pdfmanagement_add:nnn{Catalog}{Lang}{(enUS)} +% \ExplSyntaxOff % End accessibility options \documentclass[12pt]{article} \usepackage{sectsty} % Allows for different fonts for header and body @@ -68,6 +68,7 @@ % For tagging the pdf: https://github.com/jgm/pandoc/issues/5409#issuecomment-770417614 \ifluatex + \usepackage{tagpdf} \tagpdfsetup{ activate-all=true, interwordspace=true From 889349dc8e3024dad9e4b2470e2f28b6e7617040 Mon Sep 17 00:00:00 2001 From: e-perl-NOAA Date: Tue, 3 Feb 2026 10:07:11 -0500 Subject: [PATCH 5/6] try section by section --- SS330_User_Manual.tex | 50 +++++++++++++++++++++---------------------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/SS330_User_Manual.tex b/SS330_User_Manual.tex index ca3f1004..7f824504 100644 --- a/SS330_User_Manual.tex +++ b/SS330_User_Manual.tex @@ -9,11 +9,11 @@ % \ExplSyntaxOff % End accessibility options \documentclass[12pt]{article} -\usepackage{sectsty} % Allows for different fonts for header and body +\usepackage{sectsty} % Allows for different fonts for header and body \usepackage{natbib} \usepackage{multicol} \usepackage[margin=1in, includefoot]{geometry} -\usepackage{graphicx} %allows for impage import +\usepackage{graphicx} % Allows for impage import \graphicspath{{images/}} \usepackage{ragged2e} \usepackage{enumitem} @@ -212,29 +212,29 @@ \pagenumbering{arabic} \input{1_4sections} % ======== Section 5: Converting - \input{5converting} - % ======== Section 6: Starter File - \input{6starter} - % ======== Section 7: Forecast File - \input{7forecast} - % ======== Section 8: Data File - \input{8data} - % ======== Section 9: Control File - \input{9control} - % ======== Section 10: Optional Inputs - \input{10optional_inputs} - % ======== Section 11: Likelihoods - \input{11likelihoods} - %========= Section 12: Running SS - \input{12runningSS3} - % ======== Section 13: Output Files - \input{13output} - %========= Section 14: R4SS - \input{14r4ss} - %========= Section 15: Special Set-ups - \input{15special} - %========= Section 16: Essays - \input{16essays} + % \input{5converting} + % % ======== Section 6: Starter File + % \input{6starter} + % % ======== Section 7: Forecast File + % \input{7forecast} + % % ======== Section 8: Data File + % \input{8data} + % % ======== Section 9: Control File + % \input{9control} + % % ======== Section 10: Optional Inputs + % \input{10optional_inputs} + % % ======== Section 11: Likelihoods + % \input{11likelihoods} + % %========= Section 12: Running SS + % \input{12runningSS3} + % % ======== Section 13: Output Files + % \input{13output} + % %========= Section 14: R4SS + % \input{14r4ss} + % %========= Section 15: Special Set-ups + % \input{15special} + % %========= Section 16: Essays + % \input{16essays} %========= Glossary \hypertarget{Glossary}{} \addcontentsline{toc}{section}{Glossary} From 5082509fadef4fbf445bd1f3f868b9fdc9c5ae3f Mon Sep 17 00:00:00 2001 From: e-perl-NOAA Date: Mon, 9 Mar 2026 10:14:07 -0400 Subject: [PATCH 6/6] try fix --- SS330_User_Manual.tex | 111 ++++++++++++++++-------------------------- 1 file changed, 42 insertions(+), 69 deletions(-) diff --git a/SS330_User_Manual.tex b/SS330_User_Manual.tex index 7f824504..f3f170dc 100644 --- a/SS330_User_Manual.tex +++ b/SS330_User_Manual.tex @@ -1,9 +1,11 @@ % Preamble ========================================================================================= %Options added to improve pdf accessibility: -\RequirePackage{pdfmanagement-testphase} -\PassOptionsToPackage{enable-debug}{expl3} -%\DeclareDocumentMetadata { } -\DocumentMetadata{testphase={phase-III,math}, lang=en-US} +% \RequirePackage{pdfmanagement-testphase} +% \PassOptionsToPackage{enable-debug}{expl3} +% \DeclareDocumentMetadata { +% \DocumentMetadata{testphase={phase-III,math,table,title}} +\DocumentMetadata{lang=en-US,pdfversion=2.0} + % \ExplSyntaxOn % \pdfmanagement_add:nnn{Catalog}{Lang}{(enUS)} % \ExplSyntaxOff @@ -20,13 +22,10 @@ \usepackage{multirow} \usepackage{booktabs} \usepackage{fontspec} -% \usepackage{lmodern} \usepackage[none]{hyphenat} \usepackage{array} -% \usepackage{lscape} \usepackage{pdflscape} \usepackage{longtable} -% \usepackage[utf8]{inputenc} \usepackage[table]{xcolor} \usepackage{colortbl} \usepackage{hhline} @@ -66,13 +65,14 @@ % title={#2}, % fonttitle=\bfseries,#1} + % For tagging the pdf: https://github.com/jgm/pandoc/issues/5409#issuecomment-770417614 \ifluatex \usepackage{tagpdf} \tagpdfsetup{ - activate-all=true, - interwordspace=true - } + activate-all=true, + interwordspace=true + } \fi % End tagging the pdf @@ -82,22 +82,17 @@ %sectsty commands % all section headers use the same sans serif family - roboto -%\allsectionsfont{\sffamily\selectfont\roboto\mdseries\bfseries} \allsectionsfont{\sffamily\selectfont\roboto\mdseries\bfseries} % Set size and color of section header AL's H1 -%\sectionfont{\LARGE\nohang\centering\roboto\textcolor[cmyk]{0.90, 0.54, 0.28, 0.12}} \sectionfont{\LARGE\nohang\centering\roboto\textcolor[cmyk]{0.90, 0.54, 0.28, 0.12}} % Set size and color of subsection header AL's H2 -%\subsectionfont{\fontsize{18pt}{20pt}\selectfont\roboto\nohang\centering\textcolor[cmyk]{0.90, 0.54, 0.28, 0.12}} \subsectionfont{\fontsize{18pt}{20pt}\selectfont\roboto\nohang\centering\textcolor[cmyk]{0.90, 0.54, 0.28, 0.12}} % Set size and color of subsubsection header AL's H3 \subsubsectionfont{\hspace{0pt}\nohang\fontsize{16pt}{18pt}\selectfont\roboto\raggedright\textcolor[cmyk]{0.50, 0.05, 0.0, 0.40}} % Set size and color of paragraph header AL's H4 -%\paragraphfont{\fontsize{14pt}{16pt}\selectfont\robotocondensed\fontseries{bl}\selectfont\textcolor[cmyk]{0.50, 0.05, 0.0, 0.40}} \paragraphfont{\fontsize{14pt}{16pt}\selectfont\robotocondensed\fontseries{bl}\selectfont\textcolor[cmyk]{0.50, 0.05, 0.0, 0.40}} \newcolumntype{R}{>{\raggedright\arraybackslash}p{3cm}} -%\definecolor{lightgray}{gray}{0.92} \fancyhead{} \pagestyle{fancy} @@ -111,14 +106,6 @@ \hyphenpenalty=10000 \hbadness=10000 -%\hypersetup{% -% colorlinks=false,% hyperlinks will be black -% linkbordercolor=red,% hyperlink borders will be red -% pdfborderstyle={/S/U/W 1}% border style will be underline of width 1pt -%} - - - %%The following sets up how the pdf displays links and functions in Acrobat. \hypersetup{ bookmarks = true, % show bookmarks bar? @@ -144,24 +131,17 @@ \newcommand{\myparagraph}[1]{\paragraph{#1}\mbox{}\\} -% Define a term for SS3 abbreviation to use across document -% \newcommand{\SS}{SS3} - % Create custom font title of document % note the use of: %% \textcolor in the title itself -%% \maketitle BEFORE resetting the \fontfamily +%% \maketitle BEFORE resetting the \fontfamily \usepackage{xparse} \usepackage{xpatch} -\NewDocumentCommand{\TitlePageFont}{}{% - \sffamily\bfseries% - \fontsize{22pt}{24pt}% - \selectfont% -}% -% sets title for pdf reader -%\usepackage[pdftitle={Stock Synthesis User Manual}, -% pdfauthor={Richard D. Methot Jr., Chantel R. Wetzel, Ian G. Taylor, and Kathryn Doering}, -% pdfdisplaydoctitle=true]{hyperref} +\NewDocumentCommand{\TitlePageFont}{}{ + \sffamily\bfseries + \fontsize{22pt}{24pt} + \selectfont +} \xpretocmd{\maketitle}{\TitlePageFont}{}{} \title{\textcolor[cmyk]{1.00,0.83,0.41,0.36}{Stock Synthesis User Manual\\ Version 3.30.24.1}} \author{Richard D. Methot Jr., Chantel R. Wetzel, Ian G. Taylor, Kathryn L. Doering,\\Elizabeth F. Perl, and Kelli F. Johnson\\\\\\NOAA Fisheries\\Seattle, WA} @@ -181,17 +161,13 @@ \begin{center} \includegraphics[alt={Logo of the National Oceanic and Atmospheric Administration (NOAA)},height=2in]{noaalogo.jpg} \end{center} - %\caption{Logo of the National Oceanic and Atmospheric Administration (NOAA)} \label{fig:logo} \end{figure} \thispagestyle{empty} \newpage \normalfont % this sets the main font to crimson - \normalsize %% return the text to 12 point font - otherwise you end up with 22 point font! - % Set base font as serif - %\fontfamily{crimson}\selectfont - + \normalsize % return the text to 12 point font - otherwise you end up with 22 point font! % ====== Table of Contents =================================================== \glsaddall @@ -200,41 +176,38 @@ \thispagestyle{empty} \cleardoublepage \setcounter{secnumdepth}{0} - %\setcounter{page}{1} \newpage \raggedright % ==== List of figures ======================================================== \renewcommand{\headrulewidth}{0pt} % removes the top line across each page - %\listoffigures - %\addcontentsline{toc}{section}{\numberline{}List of Figures} \cleardoublepage % ====== Section 1 - 4 ============================================================= \pagenumbering{arabic} \input{1_4sections} - % ======== Section 5: Converting - % \input{5converting} - % % ======== Section 6: Starter File - % \input{6starter} - % % ======== Section 7: Forecast File - % \input{7forecast} - % % ======== Section 8: Data File - % \input{8data} - % % ======== Section 9: Control File - % \input{9control} - % % ======== Section 10: Optional Inputs - % \input{10optional_inputs} - % % ======== Section 11: Likelihoods - % \input{11likelihoods} - % %========= Section 12: Running SS - % \input{12runningSS3} - % % ======== Section 13: Output Files - % \input{13output} - % %========= Section 14: R4SS - % \input{14r4ss} - % %========= Section 15: Special Set-ups - % \input{15special} - % %========= Section 16: Essays - % \input{16essays} + ======== Section 5: Converting + \input{5converting} + % ======== Section 6: Starter File + \input{6starter} + % ======== Section 7: Forecast File + \input{7forecast} + % ======== Section 8: Data File + \input{8data} + % ======== Section 9: Control File + \input{9control} + % ======== Section 10: Optional Inputs + \input{10optional_inputs} + % ======== Section 11: Likelihoods + \input{11likelihoods} + %========= Section 12: Running SS + \input{12runningSS3} + % ======== Section 13: Output Files + \input{13output} + %========= Section 14: R4SS + \input{14r4ss} + %========= Section 15: Special Set-ups + \input{15special} + %========= Section 16: Essays + \input{16essays} %========= Glossary \hypertarget{Glossary}{} \addcontentsline{toc}{section}{Glossary} @@ -248,7 +221,7 @@ \newpage \bibliography{SS3} \bibliographystyle{JournalBiblio/cjfas} - \newpage + \newpage \end{document}