Skip to content

Commit

Permalink
Deploying to gh-pages from @ 68a5d85 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
e-perl-NOAA committed Dec 4, 2023
1 parent 1df269f commit 48f6e00
Show file tree
Hide file tree
Showing 7 changed files with 34 additions and 34 deletions.
20 changes: 10 additions & 10 deletions Getting_Started_SS3.html

Large diffs are not rendered by default.

Binary file modified Getting_Started_SS3.pdf
Binary file not shown.
2 changes: 1 addition & 1 deletion SS330_User_Manual.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@
<meta http-equiv = "refresh" content = "3; url = https://nmfs-stock-synthesis.github.io/doc/SS330_User_Manual_release.html" />
</head>
<body>
<p>Redirecting to https://nmfs-stock-synthesis.github.io/doc/SS330_User_Manual_release.html</p>
<p>Redirecting to https://nmfs-ost.github.io/ss3-doc/SS330_User_Manual_release.html</p>
</body>
</html>
30 changes: 15 additions & 15 deletions SS330_User_Manual_release.html

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
* [Getting Started Tutorial](Getting_Started_SS3.html)
* [Building Your First SS3 Model Tutorial](ss3_model_tips.html)
* [Current User Manual (html)](SS330_User_Manual_release.html)
* [Current User Manual (pdf)](https://github.com/nmfs-stock-synthesis/stock-synthesis/releases/download/v3.30.22/SS330_User_Manual.pdf)
* [Current User Manual (pdf)](https://github.com/nmfs-ost/ss3-source-code/releases/download/v3.30.22/SS330_User_Manual.pdf)

## How to Cite the Stock Synthesis User Manual

Expand Down
14 changes: 7 additions & 7 deletions ss3_model_tips.html
Original file line number Diff line number Diff line change
Expand Up @@ -165,15 +165,15 @@

<h1 class="title toc-ignore">Developing your first Stock Synthesis (SS3) model</h1>
<h4 class="author">SS3 Development Team</h4>
<h4 class="date">Last Updated: November 30, 2023</h4>
<h4 class="date">Last Updated: December 04, 2023</h4>

</div>


<div id="scope" class="section level1" number="1">
<h1><span class="header-section-number">1</span> Scope</h1>
<p>The developing your first SS3 model guide teaches users how to develop a basic Stock Synthesis model. We assume that these users have had previous population dynamics modeling experience and already understand how to run an existing SS3 model.</p>
<p>If you are a new SS3 user who is not yet comfortable running an SS3 model, we suggest trying to run an example working model using advice in the <a href="https://nmfs-stock-synthesis.github.io/doc/Getting_Started_SS3.html">Getting Started guide</a> before attempting to develop and run your own model as outlined here.</p>
<p>If you are a new SS3 user who is not yet comfortable running an SS3 model, we suggest trying to run an example working model using advice in the <a href="https://nmfs-ost.github.io/ss3-doc/Getting_Started_SS3.html">Getting Started guide</a> before attempting to develop and run your own model as outlined here.</p>
<p>By the end of using this guide, you should be able to:</p>
<ol style="list-style-type: decimal">
<li>Develop your own SS3 model development workflow based on the tools and methods suggested</li>
Expand All @@ -186,12 +186,12 @@ <h1><span class="header-section-number">1</span> Scope</h1>
<h1><span class="header-section-number">2</span> How to create new SS3 models</h1>
<p>There are many potential workflows for developing a new SS3 model, but a common technique is to start with an existing model and change it in a piece-wise fashion. The basic technique is:</p>
<ol style="list-style-type: decimal">
<li>Find an existing working model (perhaps one of the SS3 example models available in the <a href="https://github.com/nmfs-stock-synthesis/user-examples">user-examples repository</a> or perhaps a model more similar in form to the model you plan to create).</li>
<li>Find an existing working model (perhaps one of the SS3 example models available in the <a href="https://github.com/nmfs-ost/ss3-user-examples">ss3-user-examples repository</a> or perhaps a model more similar in form to the model you plan to create).</li>
<li>Edit portions of the model and try running as you go to check that your inputs can be read correctly by SS3 and make logical sense (tip: use options <code>-stopph 0 -nohess</code> to reduce run time with each iteration of checking inputs by not estimating anything and not inverting the hessian).</li>
</ol>
<p>Some commonly used tools for editing the SS3 input files are:</p>
<ol style="list-style-type: decimal">
<li><a href="https://github.com/nmfs-stock-synthesis/ssi"><strong>Stock Synthesis Interface (SSI; the SS3 GUI)</strong></a>. The SSI allows you to read in a model, performs some checks to ensure valid inputs, make modifications to the model, and offers visualizations of inputs. You can also run models from SSI. Note that SSI is not maintained for Stock Synthesis versions after v.3.30.21.</li>
<li><a href="https://github.com/nmfs-ost/ssi"><strong>Stock Synthesis Interface (SSI; the SS3 GUI)</strong></a>. The SSI allows you to read in a model, performs some checks to ensure valid inputs, make modifications to the model, and offers visualizations of inputs. You can also run models from SSI. Note that SSI is not maintained for Stock Synthesis versions after v.3.30.21.</li>
<li><strong>Your favorite text editor</strong>.</li>
<li><strong>The <code>SS_read*</code> and <code>SS_write*</code> functions in the R package <a href="https://github.com/r4ss/r4ss">r4ss</a></strong>. These functions allow you to read in SS3 input files to R, manipulate them from within R, then write them out to a file. The <a href="https://r4ss.github.io/r4ss/vignettes/r4ss-intro-vignette.html#scripting-stock-synthesis-workflows-with-r4ss">r4ss vignette</a> demonstrates how to use these functions</li>
<li><strong>Stock Assessment Continuum Tool</strong>. Available through github at <a href="https://github.com/shcaba/SS-DL-tool" class="uri">https://github.com/shcaba/SS-DL-tool</a>.</li>
Expand All @@ -200,9 +200,9 @@ <h1><span class="header-section-number">2</span> How to create new SS3 models</h
<div id="guidance-on-model-specification" class="section level1" number="3">
<h1><span class="header-section-number">3</span> Guidance on model specification</h1>
<p>SS3 has a rich set of features. Some required inputs are conditional on other inputs, so it is important to be mindful that changing an option might result in SS3 expecting a different number of values in the input files than it did previously. Most of the time, these conditional inputs are read right after the option.</p>
<p>The <a href="https://github.com/nmfs-stock-synthesis/doc/releases">SS3 user manual</a> can be used as a guide to help you edit your model. Conditional inputs are noted in the manual. The SSI can also help guide you through changes in model inputs required as you select different SS3 model options.</p>
<p>The <a href="https://github.com/nmfs-ost/ss3-doc/releases">SS3 user manual</a> can be used as a guide to help you edit your model. Conditional inputs are noted in the manual. The SSI can also help guide you through changes in model inputs required as you select different SS3 model options.</p>
<p>If you are unsure if you got the setup right (e.g., adding the correct number of parameter lines for a chosen catchability setup), try running the model with <code>maxphase = 0</code> in the starter file and ADMB option <code>-nohess</code> (or for v.3.30.16 and greater, run the model with command line options <code>-stopph 0 -nohess</code>, no need to change the starter file). If the model run completes, you can compare the <strong>control.ss_new</strong> file and the first data set in <strong>data.ss_new</strong> to your SS3 input files to make sure SS3 interpreted the values as intended. If the run exits before completion, you can look at <strong>warning.sso</strong> and <strong>echoinput.sso</strong> for clues as to what was wrong with your setup.</p>
<p>For additional help with model specification, please post your questions in the GitHub <a href="https://github.com/nmfs-stock-synthesis/stock-synthesis/discussions">discussions</a> or on the vlab <a href="https://vlab.noaa.gov/web/stock-synthesis/public-forums">forums</a> (for registered SS3 users) or send an email to the SS3 team at <a href="mailto:[email protected]" class="email">[email protected]</a>.</p>
<p>For additional help with model specification, please post your questions in the GitHub <a href="https://github.com/nmfs-ost/ss3-source-code/discussions">discussions</a> or on the vlab <a href="https://vlab.noaa.gov/web/stock-synthesis/public-forums">forums</a> (for registered SS3 users) or send an email to the SS3 team at <a href="mailto:[email protected]" class="email">[email protected]</a>.</p>
</div>
<div id="phases-in-ss3-and-admb" class="section level1" number="4">
<h1><span class="header-section-number">4</span> Phases in SS3 and ADMB</h1>
Expand Down Expand Up @@ -314,7 +314,7 @@ <h2><span class="header-section-number">10.4</span> Did I fix variation in recru
<div id="where-to-get-additional-help" class="section level1" number="11">
<h1><span class="header-section-number">11</span> Where to get additional help</h1>
<ul>
<li>Post questions in the GitHub <a href="https://github.com/nmfs-stock-synthesis/stock-synthesis/discussions">discussions</a> or to the <a href="https://vlab.noaa.gov/web/stock-synthesis/public-forums">forums</a> or send an emails to the team at <a href="mailto:[email protected]" class="email">[email protected]</a> for assistance.</li>
<li>Post questions in the GitHub <a href="https://github.com/nmfs-ost/ss3-source-code/discussions">discussions</a> or to the <a href="https://vlab.noaa.gov/web/stock-synthesis/public-forums">forums</a> or send an emails to the team at <a href="mailto:[email protected]" class="email">[email protected]</a> for assistance.</li>
<li><a href="https://doi.org/10.1016/j.fishres.2021.105959">Carvalho et al. 2021</a> contains guidance on developing stock assessments.</li>
</ul>
</div>
Expand Down
Binary file modified ss3_model_tips.pdf
Binary file not shown.

0 comments on commit 48f6e00

Please sign in to comment.