From 5505a49e1e90f88df824a4997ccb07852534da18 Mon Sep 17 00:00:00 2001
From: efletcherPIFSC <efletcherPIFSC@users.noreply.github.com>
Date: Fri, 16 Feb 2024 21:39:52 +0000
Subject: [PATCH] Built site for ss3diags: 2.2.0@98ea41e

---
 404.html                                      |   2 +-
 CODE_OF_CONDUCT.html                          |   2 +-
 CONTRIBUTING.html                             |   2 +-
 articles/Jitter.html                          |  12 ++++-----
 articles/Retrospective-Analysis.html          |   4 +--
 articles/aspm.html                            |   4 +--
 articles/hcxval.html                          |   2 +-
 articles/index.html                           |   2 +-
 articles/likelihood.html                      |   4 +--
 articles/residuals.html                       |   2 +-
 .../figure-html/unnamed-chunk-6-1.png         | Bin 92874 -> 93097 bytes
 authors.html                                  |   6 ++---
 index.html                                    |   2 +-
 news/index.html                               |  24 +++++++++++++++++-
 pkgdown.yml                                   |   2 +-
 reference/SScompsTA1.8.html                   |   2 +-
 reference/SSdeltaMVLN.html                    |   2 +-
 reference/SSdeltaMVLN_old.html                |   2 +-
 reference/SSdiagsMCMC.html                    |   2 +-
 reference/SSdiagsMCMC_ancient.html            |   2 +-
 reference/SShcbias.html                       |   2 +-
 reference/SSmase.html                         |   2 +-
 reference/SSplotEnsemble.html                 |   2 +-
 reference/SSplotGeneric.html                  |   2 +-
 reference/SSplotGenericLegend.html            |   2 +-
 reference/SSplotGenericPar.html               |   2 +-
 reference/SSplotGenericUncertainty.html       |   2 +-
 reference/SSplotHCxval.html                   |   2 +-
 reference/SSplotJABBAres.html                 |   2 +-
 reference/SSplotKobe.html                     |   2 +-
 reference/SSplotModelcomp.html                |   2 +-
 reference/SSplotRetro.html                    |   2 +-
 reference/SSplotRunstest.html                 |   2 +-
 reference/SSreadMCMC.html                     |   2 +-
 reference/SSretroComps.html                   |   2 +-
 reference/SSrmse.html                         |   2 +-
 reference/SSrunstest.html                     |   2 +-
 reference/SSsettingsBratioF.html              |   2 +-
 reference/ensemble_plot_index.html            |   2 +-
 reference/index.html                          |   2 +-
 reference/ssruns_sig3.html                    |   2 +-
 search.json                                   |   2 +-
 42 files changed, 73 insertions(+), 51 deletions(-)

diff --git a/404.html b/404.html
index 68f480b..a27a2c6 100644
--- a/404.html
+++ b/404.html
@@ -31,7 +31,7 @@
     
     <a class="navbar-brand me-2" href="https://pifscstockassessments.github.io/ss3diags/index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/CODE_OF_CONDUCT.html b/CODE_OF_CONDUCT.html
index 1bc1f34..aae12c5 100644
--- a/CODE_OF_CONDUCT.html
+++ b/CODE_OF_CONDUCT.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/CONTRIBUTING.html b/CONTRIBUTING.html
index 5f19ebd..657d6a5 100644
--- a/CONTRIBUTING.html
+++ b/CONTRIBUTING.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/Jitter.html b/articles/Jitter.html
index 70ddc30..ef57a61 100644
--- a/articles/Jitter.html
+++ b/articles/Jitter.html
@@ -33,7 +33,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -137,7 +137,7 @@ <h2 id="model-inputs">Model inputs<a class="anchor" aria-label="anchor" href="#m
 <code>r4ss</code> function <code><a href="https://r4ss.github.io/r4ss/reference/get_ss3_exe.html" class="external-link">get_ss3_exe()</a></code>.</p>
 <div class="sourceCode" id="cb4"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">r4ss</span><span class="fu">::</span><span class="fu"><a href="https://r4ss.github.io/r4ss/reference/get_ss3_exe.html" class="external-link">get_ss3_exe</a></span><span class="op">(</span>dir <span class="op">=</span> <span class="va">dir_jitter</span>, version <span class="op">=</span> <span class="st">"v3.30.21"</span><span class="op">)</span></span>
-<span><span class="co">#&gt; The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/Rtmp6Xyarr/jitter/ss3</span></span></code></pre></div>
+<span><span class="co">#&gt; The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/Rtmp2ZDhQV/jitter/ss3</span></span></code></pre></div>
 <p>We will run the model in <code>dir_jitter</code> first to produce the
 necessary output files. It is recommended to do jitter runs in a
 subdirectory of your model run. This will keep all of the output files
@@ -206,13 +206,13 @@ <h2 id="jitter">Jitter<a class="anchor" aria-label="anchor" href="#jitter"></a>
 <span><span class="co">#&gt;      replist18    replist19    replist20    replist21    replist22    replist23</span></span>
 <span><span class="co">#&gt; 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02</span></span>
 <span><span class="co">#&gt; 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10</span></span>
-<span><span class="co">#&gt; 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01</span></span>
+<span><span class="co">#&gt; 3  1.74852e-01  1.74852e-01  1.74853e-01  1.74852e-01  1.74852e-01  1.74852e-01</span></span>
 <span><span class="co">#&gt; 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00</span></span>
 <span><span class="co">#&gt; 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02</span></span>
 <span><span class="co">#&gt; 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02</span></span>
 <span><span class="co">#&gt;      replist24    replist25    replist26    replist27    replist28    replist29</span></span>
 <span><span class="co">#&gt; 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02</span></span>
-<span><span class="co">#&gt; 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10</span></span>
+<span><span class="co">#&gt; 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33480e-10  1.33479e-10</span></span>
 <span><span class="co">#&gt; 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01</span></span>
 <span><span class="co">#&gt; 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00</span></span>
 <span><span class="co">#&gt; 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02</span></span>
@@ -226,7 +226,7 @@ <h2 id="jitter">Jitter<a class="anchor" aria-label="anchor" href="#jitter"></a>
 <span><span class="co">#&gt; 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02</span></span>
 <span><span class="co">#&gt;      replist36    replist37    replist38    replist39    replist40    replist41</span></span>
 <span><span class="co">#&gt; 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02</span></span>
-<span><span class="co">#&gt; 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10</span></span>
+<span><span class="co">#&gt; 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33480e-10  1.33479e-10</span></span>
 <span><span class="co">#&gt; 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01</span></span>
 <span><span class="co">#&gt; 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00</span></span>
 <span><span class="co">#&gt; 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02</span></span>
@@ -241,7 +241,7 @@ <h2 id="jitter">Jitter<a class="anchor" aria-label="anchor" href="#jitter"></a>
 <span><span class="co">#&gt;      replist48    replist49    replist50       Label</span></span>
 <span><span class="co">#&gt; 1  7.54302e+02  7.54302e+02  7.54302e+02       TOTAL</span></span>
 <span><span class="co">#&gt; 2  1.33479e-10  1.33479e-10  1.33479e-10       Catch</span></span>
-<span><span class="co">#&gt; 3  1.74852e-01  1.74852e-01  1.74852e-01 Equil_catch</span></span>
+<span><span class="co">#&gt; 3  1.74853e-01  1.74852e-01  1.74852e-01 Equil_catch</span></span>
 <span><span class="co">#&gt; 4 -7.11813e+00 -7.11813e+00 -7.11813e+00      Survey</span></span>
 <span><span class="co">#&gt; 5  3.66756e+02  3.66756e+02  3.66756e+02 Length_comp</span></span>
 <span><span class="co">#&gt; 6  2.31845e+02  2.31845e+02  2.31845e+02    Age_comp</span></span>
diff --git a/articles/Retrospective-Analysis.html b/articles/Retrospective-Analysis.html
index b7e7f9b..c8d816d 100644
--- a/articles/Retrospective-Analysis.html
+++ b/articles/Retrospective-Analysis.html
@@ -33,7 +33,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -134,7 +134,7 @@ <h2 id="model-inputs">Model inputs<a class="anchor" aria-label="anchor" href="#m
 <code>r4ss</code> function <code><a href="https://r4ss.github.io/r4ss/reference/get_ss3_exe.html" class="external-link">get_ss3_exe()</a></code>.</p>
 <div class="sourceCode" id="cb4"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">r4ss</span><span class="fu">::</span><span class="fu"><a href="https://r4ss.github.io/r4ss/reference/get_ss3_exe.html" class="external-link">get_ss3_exe</a></span><span class="op">(</span>dir <span class="op">=</span> <span class="va">dir_retro</span>, version <span class="op">=</span> <span class="st">"v3.30.21"</span><span class="op">)</span></span>
-<span><span class="co">#&gt; The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/RtmpUqXETR/retrospectives/ss3</span></span></code></pre></div>
+<span><span class="co">#&gt; The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/RtmpWMaip6/retrospectives/ss3</span></span></code></pre></div>
 </div>
 <div class="section level2">
 <h2 id="retrospective-analysis">Retrospective Analysis<a class="anchor" aria-label="anchor" href="#retrospective-analysis"></a>
diff --git a/articles/aspm.html b/articles/aspm.html
index 81f0d54..ec4641c 100644
--- a/articles/aspm.html
+++ b/articles/aspm.html
@@ -33,7 +33,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -134,7 +134,7 @@ <h2 id="model-inputs">Model inputs<a class="anchor" aria-label="anchor" href="#m
 <code>r4ss</code> function <code><a href="https://r4ss.github.io/r4ss/reference/get_ss3_exe.html" class="external-link">get_ss3_exe()</a></code>.</p>
 <div class="sourceCode" id="cb6"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">r4ss</span><span class="fu">::</span><span class="fu"><a href="https://r4ss.github.io/r4ss/reference/get_ss3_exe.html" class="external-link">get_ss3_exe</a></span><span class="op">(</span>dir <span class="op">=</span> <span class="va">dir_tmp</span>, version <span class="op">=</span> <span class="st">"v3.30.21"</span><span class="op">)</span></span></code></pre></div>
-<pre><code><span><span class="co">## The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/Rtmpb2T15m/ss3</span></span></code></pre>
+<pre><code><span><span class="co">## The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/RtmpOZxxeY/ss3</span></span></code></pre>
 </div>
 <div class="section level2">
 <h2 id="aspm">ASPM<a class="anchor" aria-label="anchor" href="#aspm"></a>
diff --git a/articles/hcxval.html b/articles/hcxval.html
index 4762ed7..34d076c 100644
--- a/articles/hcxval.html
+++ b/articles/hcxval.html
@@ -33,7 +33,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/index.html b/articles/index.html
index 4217cfc..e2c3493 100644
--- a/articles/index.html
+++ b/articles/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/likelihood.html b/articles/likelihood.html
index eb2f6d7..948dba9 100644
--- a/articles/likelihood.html
+++ b/articles/likelihood.html
@@ -33,7 +33,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -135,7 +135,7 @@ <h2 id="model-inputs">Model inputs<a class="anchor" aria-label="anchor" href="#m
 <code>r4ss</code> function <code><a href="https://r4ss.github.io/r4ss/reference/get_ss3_exe.html" class="external-link">get_ss3_exe()</a></code>.</p>
 <div class="sourceCode" id="cb4"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu">r4ss</span><span class="fu">::</span><span class="fu"><a href="https://r4ss.github.io/r4ss/reference/get_ss3_exe.html" class="external-link">get_ss3_exe</a></span><span class="op">(</span>dir <span class="op">=</span> <span class="va">dir_tmp</span>, version <span class="op">=</span> <span class="st">"v3.30.21"</span><span class="op">)</span></span>
-<span><span class="co">#&gt; The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/RtmpakzV4r/ss3</span></span></code></pre></div>
+<span><span class="co">#&gt; The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/RtmpnhVp2Y/ss3</span></span></code></pre></div>
 </div>
 <div class="section level2">
 <h2 id="running-a-profile-on-r0">Running a Profile on R<sub>0</sub><a class="anchor" aria-label="anchor" href="#running-a-profile-on-r0"></a>
diff --git a/articles/residuals.html b/articles/residuals.html
index 2251506..c65b157 100644
--- a/articles/residuals.html
+++ b/articles/residuals.html
@@ -33,7 +33,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/residuals_files/figure-html/unnamed-chunk-6-1.png b/articles/residuals_files/figure-html/unnamed-chunk-6-1.png
index fedb09865a64e6fa20eff538a507faf5a825842b..712ab11b558fdb933a699f578e9467012c9e86cc 100644
GIT binary patch
literal 93097
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
R%%Itwni^Xe)m?B+_z%SI@sR)k

literal 92874
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
Lbakk)3%K-O@IxM5

diff --git a/authors.html b/authors.html
index 7ad3c4a..2116ec5 100644
--- a/authors.html
+++ b/authors.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -89,13 +89,13 @@ <h2 id="citation">Citation</h2>
 
       <p>Winker H, Carvalho F, Cardinale M, Kell L, Oshima M, Fletcher E (2024).
 <em>ss3diags: Stock Synthesis Model Diagnostics for Intergated Stock Assessments</em>.
-R package version 2.1.1, <a href="https://github.com/PIFSCstockassessments/ss3diags" class="external-link">https://github.com/PIFSCstockassessments/ss3diags</a>. 
+R package version 2.2.0, <a href="https://github.com/PIFSCstockassessments/ss3diags" class="external-link">https://github.com/PIFSCstockassessments/ss3diags</a>. 
 </p>
       <pre>@Manual{,
   title = {ss3diags: Stock Synthesis Model Diagnostics for Intergated Stock Assessments},
   author = {Henning Winker and Felipe Carvalho and Massimiliano Cardinale and Laurence Kell and Megumi Oshima and Eric Fletcher},
   year = {2024},
-  note = {R package version 2.1.1},
+  note = {R package version 2.2.0},
   url = {https://github.com/PIFSCstockassessments/ss3diags},
 }</pre>
     </div>
diff --git a/index.html b/index.html
index f434341..6886240 100644
--- a/index.html
+++ b/index.html
@@ -37,7 +37,7 @@
     
     <a class="navbar-brand me-2" href="index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/news/index.html b/news/index.html
index 55fd9aa..52ebe50 100644
--- a/news/index.html
+++ b/news/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -55,6 +55,28 @@
       <small>Source: <a href="https://github.com/PIFSCstockassessments/ss3diags/blob/HEAD/NEWS.md" class="external-link"><code>NEWS.md</code></a></small>
     </div>
 
+    <div class="section level2">
+<h2 class="pkg-version" data-toc-text="2.2.0" id="ss3diags-220">ss3diags 2.2.0<a class="anchor" aria-label="anchor" href="#ss3diags-220"></a></h2>
+<ul><li>Add vignettes tutorials for implementing and interpreting diagnostic analyses (<a href="https://github.com/PIFSCstockassessments/ss3diags/issues/78" class="external-link">#78</a>, <a href="https://github.com/PIFSCstockassessments/ss3diags/issues/75" class="external-link">#75</a>, <a href="https://github.com/PIFSCstockassessments/ss3diags/issues/73" class="external-link">#73</a>, and <a href="https://github.com/PIFSCstockassessments/ss3diags/issues/68" class="external-link">#68</a>). The vignettes replaced the “Cookbook recipe” R scripts with updated code.</li>
+<li>Removed Rdata files (ss3diags::simple, ss3diags::retroSimple, and ss3diags::mcmcSimple). These objects are now automatically produced in the vignettes.</li>
+<li>Removed deprecated data objects from function arguments (<a href="https://github.com/PIFSCstockassessments/ss3diags/issues/100" class="external-link">#100</a>).</li>
+<li>Created generic functions to re-use common parameter documentation via roxygen tag <a href="https://github.com/inheritParams" class="external-link">@inheritParams</a> (<a href="https://github.com/PIFSCstockassessments/ss3diags/issues/66" class="external-link">#66</a> and <a href="https://github.com/PIFSCstockassessments/ss3diags/issues/2" class="external-link">#2</a>).</li>
+<li>Update r4ss dependency.</li>
+<li>Replacing installation of SS3 in container during R-CMD-Check GitHub Action workflow to use r4ss::get_ss_exe() (<a href="https://github.com/PIFSCstockassessments/ss3diags/issues/97" class="external-link">#97</a>).</li>
+</ul></div>
+    <div class="section level2">
+<h2 class="pkg-version" data-toc-text="2.1.1" id="ss3diags-211">ss3diags 2.1.1<a class="anchor" aria-label="anchor" href="#ss3diags-211"></a></h2>
+<ul><li>Added new logo. Thanks <a href="https://github.com/pdimens" class="external-link">@pdimens</a> (<a href="https://github.com/PIFSCstockassessments/ss3diags/issues/76" class="external-link">#76</a>, <a href="https://github.com/PIFSCstockassessments/ss3diags/issues/77" class="external-link">#77</a>)</li>
+<li>Added options to <code>SSdeltaMVLN</code> for Variance-Coveriance approximation and bias correction. Thanks <a href="https://github.com/N-DucharmeBarth-NOAA" class="external-link">@N-DucharmeBarth-NOAA</a> (<a href="https://github.com/PIFSCstockassessments/ss3diags/issues/64" class="external-link">#64</a>)</li>
+<li>Updated r4ss dependency (<a href="https://github.com/PIFSCstockassessments/ss3diags/issues/84" class="external-link">#84</a>)
+<ul><li>Dependency resolves r4ss function name conflicts w/ dplyr and kableExtra libraries (<a href="https://github.com/PIFSCstockassessments/ss3diags/issues/83" class="external-link">#83</a>). Side effect of nmfs-fish-tools/ghactions4r#69</li>
+</ul></li>
+<li>Removed <code>dplyr</code> from NAMESPACE. Removed roxygen import calls from <code><a href="../reference/SSplotJABBAres.html">SSplotJABBAres()</a></code> and <code><a href="../reference/SSrmse.html">SSrmse()</a></code>, and appended <strong>dplyr</strong> function calls with the double colon operator (<code>dplyr::</code>) (<a href="https://github.com/PIFSCstockassessments/ss3diags/issues/82" class="external-link">#82</a>)</li>
+<li>Updated default <strong>summaryoutput</strong> used in <code>SSplotModelComp()</code> for <code>ss3diags::retroSimple</code> and default <strong>ss3rep</strong> used in <code>SSplotRunsTest()</code> for <code>ss3diags::simple</code>
+</li>
+<li>Updated ss3diags citation.</li>
+<li>Minor documentation link fixes.</li>
+</ul></div>
     <div class="section level2">
 <h2 class="pkg-version" data-toc-text="2.1.0" id="ss3diags-210">ss3diags 2.1.0<a class="anchor" aria-label="anchor" href="#ss3diags-210"></a></h2>
 <ul><li>RMSE calculations are modularized as a standalone function that can be called independently from <code><a href="../reference/SSplotJABBAres.html">SSplotJABBAres()</a></code> as <code><a href="../reference/SSrmse.html">SSrmse()</a></code>. (<a href="https://github.com/PIFSCstockassessments/ss3diags/issues/50" class="external-link">#50</a>)</li>
diff --git a/pkgdown.yml b/pkgdown.yml
index 803622e..061eae9 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -8,7 +8,7 @@ articles:
   hcxval: hcxval.html
   likelihood: likelihood.html
   residuals: residuals.html
-last_built: 2024-02-16T20:40Z
+last_built: 2024-02-16T21:28Z
 urls:
   reference: https://pifscstockassessments.github.io/ss3diags/reference
   article: https://pifscstockassessments.github.io/ss3diags/articles
diff --git a/reference/SScompsTA1.8.html b/reference/SScompsTA1.8.html
index 9c1400a..6149d2a 100644
--- a/reference/SScompsTA1.8.html
+++ b/reference/SScompsTA1.8.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSdeltaMVLN.html b/reference/SSdeltaMVLN.html
index 991662f..e53a9c0 100644
--- a/reference/SSdeltaMVLN.html
+++ b/reference/SSdeltaMVLN.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSdeltaMVLN_old.html b/reference/SSdeltaMVLN_old.html
index 3d47c66..a286a20 100644
--- a/reference/SSdeltaMVLN_old.html
+++ b/reference/SSdeltaMVLN_old.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSdiagsMCMC.html b/reference/SSdiagsMCMC.html
index 5695475..775900c 100644
--- a/reference/SSdiagsMCMC.html
+++ b/reference/SSdiagsMCMC.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSdiagsMCMC_ancient.html b/reference/SSdiagsMCMC_ancient.html
index 936b406..4bef435 100644
--- a/reference/SSdiagsMCMC_ancient.html
+++ b/reference/SSdiagsMCMC_ancient.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SShcbias.html b/reference/SShcbias.html
index 65d558d..88a19a6 100644
--- a/reference/SShcbias.html
+++ b/reference/SShcbias.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSmase.html b/reference/SSmase.html
index 53c51d0..2174959 100644
--- a/reference/SSmase.html
+++ b/reference/SSmase.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotEnsemble.html b/reference/SSplotEnsemble.html
index 4628a16..c59d54a 100644
--- a/reference/SSplotEnsemble.html
+++ b/reference/SSplotEnsemble.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotGeneric.html b/reference/SSplotGeneric.html
index d8852a3..11c542f 100644
--- a/reference/SSplotGeneric.html
+++ b/reference/SSplotGeneric.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotGenericLegend.html b/reference/SSplotGenericLegend.html
index 0ff4497..0d2a66c 100644
--- a/reference/SSplotGenericLegend.html
+++ b/reference/SSplotGenericLegend.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotGenericPar.html b/reference/SSplotGenericPar.html
index 190cc20..255dcfe 100644
--- a/reference/SSplotGenericPar.html
+++ b/reference/SSplotGenericPar.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotGenericUncertainty.html b/reference/SSplotGenericUncertainty.html
index b8f7376..20eb0bc 100644
--- a/reference/SSplotGenericUncertainty.html
+++ b/reference/SSplotGenericUncertainty.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotHCxval.html b/reference/SSplotHCxval.html
index 668b98b..e31b751 100644
--- a/reference/SSplotHCxval.html
+++ b/reference/SSplotHCxval.html
@@ -20,7 +20,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotJABBAres.html b/reference/SSplotJABBAres.html
index 709af01..1fee3f6 100644
--- a/reference/SSplotJABBAres.html
+++ b/reference/SSplotJABBAres.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotKobe.html b/reference/SSplotKobe.html
index 2de7b71..5ca8ca2 100644
--- a/reference/SSplotKobe.html
+++ b/reference/SSplotKobe.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotModelcomp.html b/reference/SSplotModelcomp.html
index 167dc19..74d3bdb 100644
--- a/reference/SSplotModelcomp.html
+++ b/reference/SSplotModelcomp.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotRetro.html b/reference/SSplotRetro.html
index 85d1ef5..eb90da2 100644
--- a/reference/SSplotRetro.html
+++ b/reference/SSplotRetro.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSplotRunstest.html b/reference/SSplotRunstest.html
index 70e47ba..242ce5b 100644
--- a/reference/SSplotRunstest.html
+++ b/reference/SSplotRunstest.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSreadMCMC.html b/reference/SSreadMCMC.html
index 72d7bba..8492dc1 100644
--- a/reference/SSreadMCMC.html
+++ b/reference/SSreadMCMC.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSretroComps.html b/reference/SSretroComps.html
index 6b8381f..24638e6 100644
--- a/reference/SSretroComps.html
+++ b/reference/SSretroComps.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSrmse.html b/reference/SSrmse.html
index e1428e1..5c432ad 100644
--- a/reference/SSrmse.html
+++ b/reference/SSrmse.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSrunstest.html b/reference/SSrunstest.html
index 84e5f54..c83443a 100644
--- a/reference/SSrunstest.html
+++ b/reference/SSrunstest.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SSsettingsBratioF.html b/reference/SSsettingsBratioF.html
index de452b5..68d1737 100644
--- a/reference/SSsettingsBratioF.html
+++ b/reference/SSsettingsBratioF.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/ensemble_plot_index.html b/reference/ensemble_plot_index.html
index b65fa53..519dd35 100644
--- a/reference/ensemble_plot_index.html
+++ b/reference/ensemble_plot_index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/index.html b/reference/index.html
index 029d6b2..345c663 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/ssruns_sig3.html b/reference/ssruns_sig3.html
index d9751fe..2d99411 100644
--- a/reference/ssruns_sig3.html
+++ b/reference/ssruns_sig3.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">ss3diags</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.2.0</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/search.json b/search.json
index 97d6002..202cce3 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":"https://pifscstockassessments.github.io/ss3diags/CODE_OF_CONDUCT.html","id":null,"dir":"","previous_headings":"","what":"Code of Conduct","title":"Code of Conduct","text":"follow NFMS Fisheries Toolbox Code Conduct. NFMS Fisheries Toolbox Code Conduct adapted Contributor Covenant, version 1.4, available https://www.contributor-covenant.org/version/1/4/code--conduct.html answers common questions code conduct, see https://www.contributor-covenant.org/faq","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/CONTRIBUTING.html","id":null,"dir":"","previous_headings":"","what":"Contributing to ss3diags","title":"Contributing to ss3diags","text":"Thank interest contributing! strive follow NMFS Fisheries Toolbox Contribution Guide. Note guidelines, rules, open collaborations ways may work better . Please feel free reach us opening issue repository emailing project maintatainer megumi.oshima@noaa.gov. project everyone participating governed NMFS Fisheries Toolbox Code Conduct. participating, expected uphold code. Please report unacceptable behavior fisheries.toolbox@noaa.gov. Note maintainers ss3diags access email account, unacceptable behavior maintainers can also reported .","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Jitter.html","id":"model-inputs","dir":"Articles","previous_headings":"","what":"Model inputs","title":"Jitter Analysis","text":"run Stock Synthesis model, four input files required: starter.ss, forecast.ss, control.ss, data.ss. input files example model can found within ss3diags package accessed shown . Also, r4ss package installed, need install tutorial. need make sure SS executable file either path directory running retrospective (case dir_jitter). easy way get latest release stock synthesis use r4ss function get_ss3_exe(). run model dir_jitter first produce necessary output files. recommended jitter runs subdirectory model run. keep output files separate diagnostic tests may run.","code":"install_github(\"r4ss/r4ss\") library(r4ss)  files_path <- system.file(\"extdata\", package = \"ss3diags\") dir_jitter <- file.path(tempdir(check = TRUE), \"jitter\") dir.create(dir_jitter, showWarnings = FALSE, recursive = TRUE) list.files(files_path) #> [1] \"control.ss\"  \"data.ss\"     \"forecast.ss\" \"starter.ss\" file.copy(from = list.files(files_path, full.names = TRUE), to = dir_jitter) #> [1] TRUE TRUE TRUE TRUE r4ss::get_ss3_exe(dir = dir_jitter, version = \"v3.30.21\") #> The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/Rtmp6Xyarr/jitter/ss3 r4ss::run(dir = dir_jitter, exe = \"ss3\", verbose = FALSE) #> [1] \"ran model\""},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Jitter.html","id":"jitter","dir":"Articles","previous_headings":"","what":"Jitter","title":"Jitter Analysis","text":"example, run 50 jitters. jitter() function automates entire process need give arguments run produce total likelihoods run. Full documentation jitter() function can found r4ss website. analyze output 50 runs, use r4ss::SSgetoutput() r4ss::SSsummarize() shown . key sections may want check compare across models , likelihoods, derived quantities, estimated parameters. may also want check models converged. can check maximum gradients make sure small (< 0.0001). can also compare estimated spawning biomass, extreme values (+2x <0.5x base spawning biomass) suggests model didn’t converge.","code":"Njitter <- 50 jit.likes <- r4ss::jitter(   dir = dir_jitter,   Njitter = Njitter,   init_values_src = 1,   jitter_fraction = 0.1,   exe = \"ss3\",   printlikes = FALSE,   verbose = FALSE ) jit_mods <- SSgetoutput(   keyvec = 0:Njitter, # 0 to include reference run (Report0.sso)   getcomp = FALSE,   dirvec = dir_jitter,   getcovar = FALSE,   verbose = FALSE ) jit_summary <- SSsummarize(jit_mods, verbose = FALSE) head(jit_summary$likelihoods) #>       replist0     replist1     replist2     replist3     replist4     replist5 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>       replist6     replist7     replist8     replist9    replist10    replist11 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist12    replist13    replist14    replist15    replist16    replist17 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist18    replist19    replist20    replist21    replist22    replist23 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist24    replist25    replist26    replist27    replist28    replist29 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist30    replist31    replist32    replist33    replist34    replist35 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist36    replist37    replist38    replist39    replist40    replist41 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist42    replist43    replist44    replist45    replist46    replist47 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist48    replist49    replist50       Label #> 1  7.54302e+02  7.54302e+02  7.54302e+02       TOTAL #> 2  1.33479e-10  1.33479e-10  1.33479e-10       Catch #> 3  1.74852e-01  1.74852e-01  1.74852e-01 Equil_catch #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00      Survey #> 5  3.66756e+02  3.66756e+02  3.66756e+02 Length_comp #> 6  2.31845e+02  2.31845e+02  2.31845e+02    Age_comp head(jit_summary$quants) #>   replist0 replist1 replist2 replist3 replist4 replist5 replist6 replist7 #> 1  54773.8  54773.8  54773.8  54773.8  54773.8  54773.8  54773.8  54773.8 #> 2  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4 #> 3  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4 #> 4  24096.1  24096.1  24096.1  24096.1  24096.1  24096.1  24096.1  24096.1 #> 5  22126.1  22126.1  22126.1  22126.1  22126.1  22126.1  22126.1  22126.1 #> 6  20143.5  20143.5  20143.5  20143.5  20143.5  20143.5  20143.5  20143.5 #>   replist8 replist9 replist10 replist11 replist12 replist13 replist14 replist15 #> 1  54773.8  54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2  26071.4  26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3  26071.4  26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4  24096.1  24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5  22126.1  22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6  20143.5  20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>   replist16 replist17 replist18 replist19 replist20 replist21 replist22 #> 1   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>   replist23 replist24 replist25 replist26 replist27 replist28 replist29 #> 1   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>   replist30 replist31 replist32 replist33 replist34 replist35 replist36 #> 1   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>   replist37 replist38 replist39 replist40 replist41 replist42 replist43 #> 1   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>   replist44 replist45 replist46 replist47 replist48 replist49 replist50 #> 1   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>         Label   Yr #> 1  SSB_Virgin   NA #> 2 SSB_Initial   NA #> 3    SSB_2011 2011 #> 4    SSB_2012 2012 #> 5    SSB_2013 2013 #> 6    SSB_2014 2014 head(jit_summary$pars) #>    replist0  replist1  replist2  replist3  replist4  replist5  replist6 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>    replist7  replist8  replist9 replist10 replist11 replist12 replist13 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist14 replist15 replist16 replist17 replist18 replist19 replist20 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist21 replist22 replist23 replist24 replist25 replist26 replist27 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist28 replist29 replist30 replist31 replist32 replist33 replist34 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist35 replist36 replist37 replist38 replist39 replist40 replist41 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist42 replist43 replist44 replist45 replist46 replist47 replist48 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist49 replist50                 Label Yr recdev #> 1  0.100000  0.100000 NatM_uniform_Fem_GP_1 NA  FALSE #> 2 22.769000 22.769000    L_at_Amin_Fem_GP_1 NA  FALSE #> 3 71.807200 71.807200    L_at_Amax_Fem_GP_1 NA  FALSE #> 4  0.142165  0.142165    VonBert_K_Fem_GP_1 NA  FALSE #> 5  0.100000  0.100000     CV_young_Fem_GP_1 NA  FALSE #> 6  0.100000  0.100000       CV_old_Fem_GP_1 NA  FALSE # Maximum gradient converged_grad <- which(jit_summary$maxgrad < 0.0001)  converged_ssb <- jit_summary$SpawnBio %>%   mutate(across(c(1:(Njitter + 1)),     .fns = ~ . / replist0   )) %>% # for each column, divide SSB by SSB from the reference run (replist)   select(-Label) %>%   pivot_longer(col = c(1:(Njitter + 1)), names_to = \"jitter\", values_to = \"SSB\") %>%   pivot_wider(names_from = Yr, values_from = SSB) %>%   mutate(rownumber = seq(1, nrow(.))) %>%   tibble::column_to_rownames(\"jitter\") %>%   filter_at(vars(1:(ncol(.) - 1)), all_vars((.) < 2 & (.) > 0.5)) %>% # keep only rows where SSB is a reasonable value   select(rownumber) %>%   pull(rownumber) converged_mods <- intersect(converged_grad, converged_ssb) # getting which models are in both groups converged_jitters <- jit_mods[converged_grad] converged_sum <- SSsummarize(converged_jitters, verbose = FALSE)"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Jitter.html","id":"visualizing-output","dir":"Articles","previous_headings":"","what":"Visualizing Output","title":"Jitter Analysis","text":"compare likelihoods runs, plot shown . built functions (writing vignette) r4ss ss3diags generate likelihood plot, therefore provide code tidyverse syntax (using ggplot2) visualize results.  figure plots total likelihood jitter run red line indicates total likelihood value reference run. runs points red line, use converged parameter values run lowest likelihood value starting values base model. can also use r4ss::SSplotComparisons() compare spawning biomass trajectories jitter runs see impact different parameter values estimated quantities.","code":"converged_sum$likelihoods %>%   filter(str_detect(Label, \"TOTAL\")) %>%   select(-Label) %>%   pivot_longer(cols = everything(), names_to = \"jitter\", values_to = \"likelihood\") %>%   separate(jitter, into = c(\"replist\", \"jitter\"), sep = \"(?<=[A-Za-z])(?=[0-9])\") %>%   mutate(jitter = as.numeric(jitter)) %>%   ggplot(aes(x = jitter, y = likelihood)) +   geom_point(size = 3) +   geom_hline(aes(yintercept = likelihood[1]), color = \"red\") +   theme_classic() +   labs(     y = \"Total Likelihood\",     x = \"Jitter runs at a converged solution\"   ) SSplotComparisons(converged_sum,   subplots = 2,   ylimAdj = 1,   new = FALSE ) #> showing uncertainty for all models #> subplot 2: spawning biomass with uncertainty intervals"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Retrospective-Analysis.html","id":"model-inputs","dir":"Articles","previous_headings":"","what":"Model inputs","title":"Retrospective Analysis","text":"run stock synthesis model, 4 input files required: starter.ss, forecast.ss, control.ss, data.ss. input files example model can found within ss3diags package accessed shown . Also, r4ss package installed, need install tutorial. need make sure SS executable file either path directory running retrospective (case dir_retro). easy way get latest release stock synthesis use r4ss function get_ss3_exe().","code":"install.packages(\"pak\") pak::pkg_install(\"r4ss/r4ss\") library(r4ss)  files_path <- system.file(\"extdata\", package = \"ss3diags\") dir_retro <- file.path(tempdir(check = TRUE), \"retrospectives\") dir.create(dir_retro, showWarnings = FALSE) list.files(files_path) #> [1] \"control.ss\"  \"data.ss\"     \"forecast.ss\" \"starter.ss\" file.copy(from = list.files(files_path, full.names = TRUE), to = dir_retro) #> [1] TRUE TRUE TRUE TRUE r4ss::get_ss3_exe(dir = dir_retro, version = \"v3.30.21\") #> The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/RtmpUqXETR/retrospectives/ss3"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Retrospective-Analysis.html","id":"retrospective-analysis","dir":"Articles","previous_headings":"","what":"Retrospective Analysis","title":"Retrospective Analysis","text":"4 input files SS executable file, can run retrospective analysis shown . running five one-year peels, run, one five years data removed reference model model re-run total five times (.e. peel 1 removes last year data, peel 2 removes last 2 years data, etc.) . number year peels can adjusted years argument. SS executable file using named something “ss3” (e.g. ss_opt_win.exe), need specify argument exe = \"ss_opt_win\". Full documentation retro() function can found r4ss website.","code":"r4ss::retro(dir = dir_retro, exe = \"ss3\", years = 0:-5, verbose = FALSE) #> Warning in base::sink(type = \"output\", split = FALSE): no sink to remove"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Retrospective-Analysis.html","id":"visualizing-output","dir":"Articles","previous_headings":"","what":"Visualizing Output","title":"Retrospective Analysis","text":"visualize outputted results inspect retrospective patterns, need load report files R use SSplotRetro() function ss3diags. easiest way load multiple report files using r4ss::SSgetoutput() r4ss::SSsummarize() functions. default sub-directories peel, 0 5, labeled retro0 retro-5.  default settings plot spawning stock biomass time series peel, reference run (.e. original, full time series model) “Ref” line successive peel colored lines labeled terminal year value. solid line ends terminal year followed dashed line extending circle representing one year forecast estimate. Displaying projected SSB value helps assessing forecast bias. note, forecasts done automatically using r4ss::retro() based settings forecast.ss. grey shaded area represents 95% confidence intervals uncertainty around spawning biomass time series. Displayed center plot combined Mohn’s \\(\\rho\\) retrospective runs, parentheses forecast Mohn’s \\(\\rho\\).","code":"retro_mods <- r4ss::SSgetoutput(dirvec = file.path(dir_retro, \"retrospectives\", paste0(\"retro\", seq(0, -5, by = -1))), verbose = F) retroSummary <- r4ss::SSsummarize(retro_mods, verbose = F) SSplotRetro(retroSummary, subplots = \"SSB\", add = TRUE) #> Mohn's Rho stats, including one step ahead forecasts: #>   type     peel         Rho  ForecastRho #> 1  SSB     2021 -0.20753686 -0.221050163 #> 2  SSB     2020 -0.19601072 -0.227304734 #> 3  SSB     2019 -0.29238505 -0.338600758 #> 4  SSB     2018 -0.00474920 -0.007462034 #> 5  SSB     2017  0.08716428  0.098849082 #> 6  SSB Combined -0.12270351 -0.139113722"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Retrospective-Analysis.html","id":"customizing-the-plot","dir":"Articles","previous_headings":"Visualizing Output","what":"Customizing the Plot","title":"Retrospective Analysis","text":"Retro plots can customized many ways, common features may want specify : removing uncertainty intervals adjusting years shown x-axis turning 1-year ahead forecasting displaying combined \\(\\rho\\) value plot Examples changes shown , incrementally making adjustment.  Additionally, fishing mortality can plotted instead spawning biomass replacing subplots = \"SSB\" subplots = \"F\"","code":"r4ss::sspar(mfrow = c(2, 2), plot.cex = 0.8) retro1 <- SSplotRetro(retroSummary, subplots = \"SSB\", add = TRUE, uncertainty = FALSE) #> Mohn's Rho stats, including one step ahead forecasts: retro2 <- SSplotRetro(retroSummary, subplots = \"SSB\", add = TRUE, uncertainty = FALSE, xlim = c(2015, 2022)) #> Mohn's Rho stats, including one step ahead forecasts: retro3 <- SSplotRetro(retroSummary, subplots = \"SSB\", add = TRUE, uncertainty = FALSE, xlim = c(2015, 2022), forecast = FALSE) #> Mohn's Rho stats, including one step ahead forecasts: retro4 <- SSplotRetro(retroSummary, subplots = \"SSB\", add = TRUE, uncertainty = FALSE, xlim = c(2015, 2022), forecast = FALSE, showrho = FALSE, forecastrho = FALSE) #> Mohn's Rho stats, including one step ahead forecasts:"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Retrospective-Analysis.html","id":"summary-table","dir":"Articles","previous_headings":"Visualizing Output","what":"Summary Table","title":"Retrospective Analysis","text":"addition retrospective plots, summary statistics table can produced using SShcbias(). table includes type estimate (SSB F) year removed “peel” Mohn’s \\(\\rho\\) forecast bias year overall (“Combined”). Mohn’s \\(\\rho\\) measure severity bias retrospective patterns forecast bias estimate bias forecasted quantities years data removed. rule thumb proposed Hurtado-Ferror et al. (2014) Mohn’s \\(\\rho\\) values long-lived species, \\(\\rho\\) value fall -0.15 0.20.","code":"SShcbias(retroSummary) #> Mohn's Rho stats, including one step ahead forecasts: #>    type     peel         Rho   ForcastRho #> 1   SSB     2021 -0.20753686 -0.221050163 #> 2   SSB     2020 -0.19601072 -0.227304734 #> 3   SSB     2019 -0.29238505 -0.338600758 #> 4   SSB     2018 -0.00474920 -0.007462034 #> 5   SSB     2017  0.08716428  0.098849082 #> 6   SSB Combined -0.12270351 -0.139113722 #> 7     F     2021  0.28425747  0.285936183 #> 8     F     2020  0.30941305  0.349748774 #> 9     F     2019  0.52629045  0.632574831 #> 10    F     2018  0.01822898  0.022822958 #> 11    F     2017 -0.04896989 -0.053882358 #> 12    F Combined  0.21784401  0.247440078"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"model-inputs","dir":"Articles","previous_headings":"","what":"Model inputs","title":"ASPM","text":"run Stock Synthesis model, four input files required: starter.ss, forecast.ss, control.ss, data.ss. input files example model can found within ss3diags package accessed shown . Also, r4ss package installed, need install tutorial. need make sure SS executable file either path directory running ASPM (case dir_aspm). easy way get latest release stock synthesis use r4ss function get_ss3_exe().","code":"install.packages(\"pak\") pak::pkg_install(\"r4ss/r4ss\") library(r4ss)  files_path <- system.file(\"extdata\", package = \"ss3diags\") dir_tmp <- tempdir(check = TRUE) dir_aspm <- file.path(dir_tmp, \"aspm\") dir.create(dir_aspm, showWarnings = FALSE, recursive = TRUE) list.files(files_path) ## [1] \"control.ss\"  \"data.ss\"     \"forecast.ss\" \"starter.ss\" file.copy(from = list.files(files_path, full.names = TRUE), to = dir_tmp) ## [1] TRUE TRUE TRUE TRUE r4ss::get_ss3_exe(dir = dir_tmp, version = \"v3.30.21\") ## The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/Rtmpb2T15m/ss3"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"aspm","dir":"Articles","previous_headings":"","what":"ASPM","title":"ASPM","text":"4 input files, need determine components need turned run ASPM. ASPM depend index abundance catch data, composition data, recruitment deviations, etc. need turned . provide example includes multiple types data recruitment deviations, however, exact steps necessary individual model may vary depending complexity components included. Therefore steps may fully comprehensive model sure check components may need change. , show use r4ss functions make necessary changes control.ss ss.par files.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"generate-files","dir":"Articles","previous_headings":"ASPM","what":"Generate files","title":"ASPM","text":"order get ss.par file, need run model . also produce new data control file use input files. run model dir_tmp copy new files dir_aspm.","code":"r4ss::run(dir = dir_tmp, verbose = FALSE, exe = \"ss3\") ## [1] \"ran model\" files <- c(\"data_echo.ss_new\", \"control.ss_new\", \"starter.ss\", \"forecast.ss\", \"ss.par\", \"ss3\") file.copy(from = file.path(dir_tmp, files), to = dir_aspm) ## [1] TRUE TRUE TRUE TRUE TRUE TRUE"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"recruitment-deviations","dir":"Articles","previous_headings":"ASPM","what":"Recruitment Deviations","title":"ASPM","text":"Set recruitment devations ss.par 0.","code":"par <- SS_readpar_3.30(   parfile = file.path(dir_aspm, \"ss.par\"),   datsource = file.path(dir_aspm, \"data_echo.ss_new\"),   ctlsource = file.path(dir_aspm, \"control.ss_new\"),   verbose = FALSE ) par$recdev1 ##       year      recdev ##  [1,] 2011 -0.06005247 ##  [2,] 2012 -0.01284866 ##  [3,] 2013  0.13478706 ##  [4,] 2014  0.11410144 ##  [5,] 2015 -0.08325396 ##  [6,] 2016  0.14556845 ##  [7,] 2017 -0.12973978 ##  [8,] 2018 -0.18308123 ##  [9,] 2019  0.02442762 ## [10,] 2020 -0.08979813 ## [11,] 2021 -0.07812317 ## [12,] 2022  0.21801284 par$recdev_forecast ##       year recdev ##  [1,] 2023      0 ##  [2,] 2024      0 ##  [3,] 2025      0 ##  [4,] 2026      0 ##  [5,] 2027      0 ##  [6,] 2028      0 ##  [7,] 2029      0 ##  [8,] 2030      0 ##  [9,] 2031      0 ## [10,] 2032      0 par$recdev1[, \"recdev\"] <- 0  # Would run if forecasts recdevs were not already 0 # par$recdev_forecast[,\"recdev\"] <- 0 SS_writepar_3.30(   parlist = par,   outfile = file.path(dir_aspm, \"ss.par\"),   overwrite = T, verbose = FALSE ) ## $headerlines ## [1] \"# Number of parameters = 32 Objective function value = 754.301687441726  Maximum gradient component = 8.77017492766611e-07\" ## [2] \"# dummy_parm:\"                                                                                                              ## [3] \"1.00000000000\"                                                                                                              ##  ## $MG_parms ##                            INIT       ESTIM ## NatM_p_1_Fem_GP_1    0.10000000  0.10000000 ## L_at_Amin_Fem_GP_1  22.76900000 22.76899194 ## L_at_Amax_Fem_GP_1  71.80720000 71.80721125 ## VonBert_K_Fem_GP_1   0.14216500  0.14216482 ## CV_young_Fem_GP_1    0.10000000  0.10000000 ## CV_old_Fem_GP_1      0.10000000  0.10000000 ## Wtlen_1_Fem_GP_1     0.00000244  0.00000244 ## Wtlen_2_Fem_GP_1     3.34694000  3.34694000 ## Mat50%_Fem_GP_1     55.00000000 55.00000000 ## Mat_slope_Fem_GP_1  -0.25000000 -0.25000000 ## Eggs_alpha_Fem_GP_1  1.00000000  1.00000000 ## Eggs_beta_Fem_GP_1   0.00000000  0.00000000 ## NatM_p_1_Mal_GP_1    0.00000000  0.00000000 ## L_at_Amin_Mal_GP_1   0.00000000  0.00000000 ## L_at_Amax_Mal_GP_1   0.00000000  0.00000000 ## VonBert_K_Mal_GP_1   0.00000000  0.00000000 ## CV_young_Mal_GP_1    0.00000000  0.00000000 ## CV_old_Mal_GP_1      0.00000000  0.00000000 ## Wtlen_1_Mal_GP_1     0.00000244  0.00000244 ## Wtlen_2_Mal_GP_1     3.34694000  3.34694000 ## CohortGrowDev        1.00000000  1.00000000 ## FracFemale_GP_1      0.50000000  0.50000000 ##  ## $SR_parms ##               INIT    ESTIM ## SR_LN(R0)   8.9274 8.927395 ## SR_BH_steep 0.8000 0.800000 ## SR_sigmaR   0.6000 0.600000 ## SR_regime   0.0000 0.000000 ## SR_autocorr 0.0000 0.000000 ##  ## $recdev1 ##       year recdev ##  [1,] 2011      0 ##  [2,] 2012      0 ##  [3,] 2013      0 ##  [4,] 2014      0 ##  [5,] 2015      0 ##  [6,] 2016      0 ##  [7,] 2017      0 ##  [8,] 2018      0 ##  [9,] 2019      0 ## [10,] 2020      0 ## [11,] 2021      0 ## [12,] 2022      0 ##  ## $recdev_forecast ##       year recdev ##  [1,] 2023      0 ##  [2,] 2024      0 ##  [3,] 2025      0 ##  [4,] 2026      0 ##  [5,] 2027      0 ##  [6,] 2028      0 ##  [7,] 2029      0 ##  [8,] 2030      0 ##  [9,] 2031      0 ## [10,] 2032      0 ##  ## $init_F ## [1] 0.1 ##  ## $Q_parms ##                           INIT      ESTIM ## LnQ_base_SURVEY1(2)   0.476759  0.4767585 ## Q_extraSD_SURVEY1(2)  0.000000  0.0000000 ## LnQ_base_SURVEY2(3)  -6.304070 -6.3040672 ##  ## $S_parms ##                            INIT     ESTIM ## SizeSel_P_1_FISHERY(1) 56.51380 56.513807 ## SizeSel_P_2_FISHERY(1) 20.17930 20.179340 ## SizeSel_P_1_SURVEY1(2) 36.02330 36.023325 ## SizeSel_P_2_SURVEY1(2)  5.33502  5.335021 ## AgeSel_P_1_SURVEY2(3)   0.00000  0.000000 ## AgeSel_P_2_SURVEY2(3)   0.00000  0.000000"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"starter-file","dir":"Articles","previous_headings":"ASPM","what":"Starter File","title":"ASPM","text":"Change starter file read ss.par (init_values_src = 1) use new data control files.","code":"starter <- SS_readstarter(file = file.path(dir_aspm, \"starter.ss\"), verbose = FALSE) starter$datfile <- \"data_echo.ss_new\" starter$ctlfile <- \"control.ss_new\" starter$init_values_src <- 1 SS_writestarter(starter,   dir = dir_aspm,   overwrite = TRUE,   verbose = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"control-file","dir":"Articles","previous_headings":"ASPM","what":"Control File","title":"ASPM","text":"estimation phases following parameters may need changed: length selectivity age selectivity size selectivity steepness sigmaR recruitment deviations Additionally, likelihood components may need turned well. can using lambda options control file. examples include: length-composition data age-composition data size-composition data initial F","code":"control <- SS_readctl_3.30(   file = file.path(dir_aspm, \"control.ss_new\"),   datlist = file.path(dir_aspm, \"data_echo.ss_new\"),   verbose = FALSE )  control$SR_parms ##               LO HI   INIT PRIOR PR_SD PR_type PHASE env_var&link dev_link ## SR_LN(R0)    6.0 12 8.9274  10.3  10.0       0     1            0        0 ## SR_BH_steep  0.2  1 0.8000   0.8   1.0       0    -4            0        0 ## SR_sigmaR    0.0  2 0.6000   0.8   0.8       0    -4            0        0 ## SR_regime   -5.0  5 0.0000   0.0   1.0       0    -4            0        0 ## SR_autocorr  0.0  0 0.0000   0.0   0.0       0   -99            0        0 ##             dev_minyr dev_maxyr dev_PH Block Block_Fxn ## SR_LN(R0)           0         0      0     0         0 ## SR_BH_steep         0         0      0     0         0 ## SR_sigmaR           0         0      0     0         0 ## SR_regime           0         0      0     0         0 ## SR_autocorr         0         0      0     0         0 # Would need to run if PHASES were positive for \"steep\" and \"sigmaR\" # control$SR_parms[c(2,3),\"PHASE\"] <- c(-4,-4) control$age_selex_parms ##                       LO HI INIT PRIOR PR_SD PR_type PHASE env_var&link ## AgeSel_P_1_SURVEY2(3)  0 20    0     5    99       0   -99            0 ## AgeSel_P_2_SURVEY2(3)  0 20    0     6    99       0   -99            0 ##                       dev_link dev_minyr dev_maxyr dev_PH Block Block_Fxn ## AgeSel_P_1_SURVEY2(3)        0         0         0      0     0         0 ## AgeSel_P_2_SURVEY2(3)        0         0         0      0     0         0 # would need to run if PHASES were positive for age selectivity # control$age_selex_parms[,\"PHASE\"] <- control$age_selex_parms[,\"PHASE\"] * -1 control$size_selex_parms[, \"PHASE\"] <- control$size_selex_parms[, \"PHASE\"] * -1 control$recdev_early_phase <- -4 control$recdev_phase <- -2  new_lambdas <- data.frame(   like_comp = c(4, 4, 5, 5, 7, 7, 9, 9, 9, 10),   fleet = c(1, 2, 1, 2, 1, 2, 1, 2, 3, 1),   phase = rep(1, 10),   value = rep(0, 10),   sizefreq_method = rep(1, 10) ) new_lambdas ##    like_comp fleet phase value sizefreq_method ## 1          4     1     1     0               1 ## 2          4     2     1     0               1 ## 3          5     1     1     0               1 ## 4          5     2     1     0               1 ## 5          7     1     1     0               1 ## 6          7     2     1     0               1 ## 7          9     1     1     0               1 ## 8          9     2     1     0               1 ## 9          9     3     1     0               1 ## 10        10     1     1     0               1 control$lambdas <- new_lambdas control$N_lambdas <- nrow(new_lambdas) SS_writectl_3.30(control,   outfile = file.path(dir_aspm, \"control.ss_new\"),   overwrite = TRUE, verbose = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"run-aspm","dir":"Articles","previous_headings":"ASPM","what":"Run ASPM","title":"ASPM","text":"","code":"r4ss::run(dir = dir_aspm, exe = \"ss3\", skipfinished = FALSE, verbose = FALSE) ## [1] \"ran model\""},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"visualize-results","dir":"Articles","previous_headings":"ASPM","what":"Visualize Results","title":"ASPM","text":"compare ASPM model age-structured model, can use SSplotComparisons(). Comparing spawning biomass F estimates two models fits indices abundance can help understand enough information indices inform production function.","code":"mods <- SSgetoutput(dirvec = c(   dir_tmp,   dir_aspm ), verbose = FALSE)  mods_sum <- SSsummarize(mods, verbose = FALSE)  SSplotComparisons(mods_sum,   legendlabels = c(\"Ref\", \"ASPM\"),   subplots = c(2, 8, 14), new = F ) ## showing uncertainty for all models ## subplot 2: spawning biomass with uncertainty intervals ## subplot 8: F value with uncertainty ## subplot 14: index fits on a log scale"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/hcxval.html","id":"visualizing-output","dir":"Articles","previous_headings":"","what":"Visualizing Output","title":"Hindcast Cross-Validation","text":"HCxval implemented using ss3diags::SSplotHCxval(), produces novel HCxval diagnostic plot computes MASE scores indices abundance, mean lengths, mean ages observations falling within hindcast evaluation period.  plots , see , fleets, model fairly good prediction skills index abundance data (compared random walk). plots, white points white dashed line observed data included model truncated time series. larger colored points observed data retrospective peel (.e. data removed peel). smaller colored points dashed lines show model predicted values. “Ref” line model run complete time series data. grey shaded areas represent uncertainty data, darker portion indicating portion included model lighter portion indicating ones removed projected. MASE scores displayed MASE adjusted MASE parentheses.","code":"r4ss::sspar(mfrow = c(1, 2)) SSplotHCxval(retroSummary, subplots = \"cpue\", add = TRUE) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with only 1 of 5  prediction residuals for Index SURVEY1  #>  #>  Warning:  Unequal spacing of naive predictions residuals may influence the interpretation of MASE #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index SURVEY2 #>  #> MASE stats by Index: #>     Index Season      MASE     MAE.PR  MAE.base  MASE.adj n.eval #> 1 SURVEY1      1 0.5026435 0.08879379 0.1766536 0.5026435      1 #> 2 SURVEY2      1 0.6149530 0.37737925 0.6136717 0.6149530      5"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/hcxval.html","id":"composition-data","dir":"Articles","previous_headings":"Visualizing Output","what":"Composition Data","title":"Hindcast Cross-Validation","text":"visualize mean length mean age, need add additional step. forecast length- age-composition information stored “ghost files” SS report.sso file, need use ss3diags::SSretroComps() extract summarize information creating plots.","code":"retroSummary_comps <- SSretroComps(retro_mods)  r4ss::sspar(mfrow = c(1, 2)) hcl <- SSplotHCxval(retroSummary_comps, subplots = \"len\", add = TRUE, ylim = c(40, 75)) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index FISHERY #>  #>  Computing MASE with only 1 of 5  prediction residuals for Index SURVEY1  #>  #>  Warning:  Unequal spacing of naive predictions residuals may influence the interpretation of MASE #>  #> MASE stats by Index:"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/hcxval.html","id":"customizing-the-plot","dir":"Articles","previous_headings":"Visualizing Output","what":"Customizing the Plot","title":"Hindcast Cross-Validation","text":"HCxval plots can customized many ways, common features may want specify : displaying specific fleet removing uncertainty intervals adjusting x- y-axis displaying adjusted MASE value plot Examples changes shown , incrementally making adjustment.","code":"r4ss::sspar(mfrow = c(2, 2)) SSplotHCxval(retroSummary_comps, subplots = \"len\", add = TRUE, indexselect = 1) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index FISHERY #>  #> MASE stats by Index: #>     Index Season      MASE     MAE.PR   MAE.base  MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.1034467      5 SSplotHCxval(retroSummary_comps,   subplots = \"len\", add = TRUE,   indexselect = 1, indexUncertainty = FALSE ) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index FISHERY #>  #> MASE stats by Index: #>     Index Season      MASE     MAE.PR   MAE.base  MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.1034467      5 SSplotHCxval(retroSummary_comps,   subplots = \"len\", add = TRUE,   indexselect = 1, indexUncertainty = FALSE, ylim = c(45, 70) ) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index FISHERY #>  #> MASE stats by Index: #>     Index Season      MASE     MAE.PR   MAE.base  MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.1034467      5 SSplotHCxval(retroSummary_comps,   subplots = \"len\", add = TRUE,   indexselect = 1, indexUncertainty = FALSE, ylim = c(45, 70), show.mase.adj = F ) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index FISHERY #>  #> MASE stats by Index: #>     Index Season      MASE     MAE.PR   MAE.base  MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.1034467      5"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/hcxval.html","id":"summary-table","dir":"Articles","previous_headings":"","what":"Summary Table","title":"Hindcast Cross-Validation","text":"addition HCxval plots, summary statistics table can produced using ss3diags::SSmase(). table includes: Index - fleet Season MASE - MASE score MAE.PR - mean absolute error prediction residuals MASE.base - naive prediction MASE.adj - adjusted MASE score n.eval - number points prediction skill calculated Adjusted MASE gets invoked cases inter-annual variation observed values small (default MAE < 0.1 naive predictions log(y[t+1])-log(y[t])). reasoning prediction residuals must already accurate fall threshold. adjusted MASE essential keep naive prediction MAE denominator MASE maximum. show effect changing adjustment threshold default MAE.base.adj = 0.1 larger value MAE.base.adj = 0.15 MASE ratio mean absolute error prediction residuals MAE.PR residuals naive predictions MAE.base MASE.adj","code":"mase1 <- SSmase(retroSummary_comps, quant = \"len\", MAE.base.adj = 0.1) mase1 #>     Index Season      MASE     MAE.PR   MAE.base  MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.1034467      5 #> 2 SURVEY1      1 0.6526074 0.05142002 0.07879167 0.5142002      1 #> 3   joint        0.4628955 0.01719056 0.03713702 0.1719056      6 SSmase(retroSummary_comps, quant = \"len\", MAE.base.adj = 0.15) #>     Index Season      MASE     MAE.PR   MAE.base   MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.06896444      5 #> 2 SURVEY1      1 0.6526074 0.05142002 0.07879167 0.34280015      1 #> 3   joint        0.4628955 0.01719056 0.03713702 0.11460372      6 mase1$MAE.PR / mase1$MAE.base #> [1] 0.3591138 0.6526074 0.4628955 mase1$MASE #> [1] 0.3591138 0.6526074 0.4628955 mase1$MAE.PR / pmax(mase1$MAE.base, 0.1) #> [1] 0.1034467 0.5142002 0.1719056 mase1$MASE.adj #> [1] 0.1034467 0.5142002 0.1719056"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/likelihood.html","id":"model-inputs","dir":"Articles","previous_headings":"","what":"Model inputs","title":"Likelihood Profile","text":"run Stock Synthesis model, four input files required: starter.ss, forecast.ss, control.ss, data.ss. input files example model can found within ss3diags package accessed shown . Also, r4ss package installed, need install tutorial. need make sure SS executable file either path directory running profile (case dir_profile). easy way get latest release stock synthesis use r4ss function get_ss3_exe().","code":"install.packages(\"pak\") pak::pkg_install(\"r4ss/r4ss\") library(r4ss)  files_path <- system.file(\"extdata\", package = \"ss3diags\") dir_tmp <- tempdir(check = TRUE) dir_profile <- file.path(dir_tmp, \"profile\") dir.create(dir_profile, showWarnings = FALSE, recursive = TRUE) list.files(files_path) #> [1] \"control.ss\"  \"data.ss\"     \"forecast.ss\" \"starter.ss\" file.copy(from = list.files(files_path, full.names = TRUE), to = dir_tmp) #> [1] TRUE TRUE TRUE TRUE r4ss::get_ss3_exe(dir = dir_tmp, version = \"v3.30.21\") #> The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/RtmpakzV4r/ss3"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/likelihood.html","id":"running-a-profile-on-r0","dir":"Articles","previous_headings":"","what":"Running a Profile on R0","title":"Likelihood Profile","text":"four input files SS executable file, can run likelihood profile shown . first step run model like profile . dir_tmp copy necessary files dir_profile. ’s best run profile subdirectory main model run keep output files separate diagnostic tests may run. input files dir_profile directory, need create vector values profile across. range increments choose depend model resolution want analyze likelihood profile. example use fairly coarse resolution speed total run time. also need modify starter file changing name control file read making sure likelihood calculated non-estimated quantities. run profile, use r4ss::profile() need specify partial string name parameter profiling (case “SR_LN” match “SR_LN(R0)”), vector values profile across. newctlfile control file adjusted values profilevec can named anything prefer, just needs match put starter file “ctlfile”. Full documentation profile() function can found r4ss website.","code":"r4ss::run(dir = dir_tmp, exe = \"ss3\", verbose = FALSE) #> [1] \"ran model\" files <- c(\"data.ss\", \"control.ss_new\", \"starter.ss\", \"forecast.ss\", \"ss.par\", \"ss3\") file.copy(from = file.path(dir_tmp, files), to = dir_profile) #> [1] TRUE TRUE TRUE TRUE TRUE TRUE CTL <- SS_readctl_3.30(file = file.path(dir_profile, \"control.ss_new\"), datlist = file.path(dir_profile, \"data.ss\"))  CTL$SR_parms #>               LO HI   INIT PRIOR PR_SD PR_type PHASE env_var&link dev_link #> SR_LN(R0)    6.0 12 8.9274  10.3  10.0       0     1            0        0 #> SR_BH_steep  0.2  1 0.8000   0.8   1.0       0    -4            0        0 #> SR_sigmaR    0.0  2 0.6000   0.8   0.8       0    -4            0        0 #> SR_regime   -5.0  5 0.0000   0.0   1.0       0    -4            0        0 #> SR_autocorr  0.0  0 0.0000   0.0   0.0       0   -99            0        0 #>             dev_minyr dev_maxyr dev_PH Block Block_Fxn #> SR_LN(R0)           0         0      0     0         0 #> SR_BH_steep         0         0      0     0         0 #> SR_sigmaR           0         0      0     0         0 #> SR_regime           0         0      0     0         0 #> SR_autocorr         0         0      0     0         0 # getting the estimated r0 value r0 <- CTL$SR_parms$INIT[1] # creating a vector that is +/- 1 unit away from the estimated value in increments of 0.2 r0_vec <- seq(r0 - 1, r0 + 1, by = 0.2) r0_vec #>  [1] 7.9274 8.1274 8.3274 8.5274 8.7274 8.9274 9.1274 9.3274 9.5274 9.7274 #> [11] 9.9274 START <- SS_readstarter(file = file.path(dir_profile, \"starter.ss\"), verbose = FALSE) START$prior_like <- 1 START$ctlfile <- \"control_modified.ss\" SS_writestarter(START, dir = dir_profile, overwrite = TRUE, verbose = F) profile(   dir = dir_profile,   newctlfile = \"control_modified.ss\",   string = \"SR_LN\",   profilevec = r0_vec,   exe = \"ss3\",   verbose = FALSE ) #> running profile i=1/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.9274  7.9274        1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=2/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  7.9274  8.1274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=3/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.1274  8.3274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=4/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.3274  8.5274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=5/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.5274  8.7274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=6/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.7274  8.9274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=7/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.9274  9.1274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=8/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  9.1274  9.3274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=9/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  9.3274  9.5274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=10/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  9.5274  9.7274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=11/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  9.7274  9.9274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #>     Value converged[whichruns]    TOTAL       Catch Equil_catch    Survey #> 1  7.9274                 TRUE 1067.570 4.40715e-01   16.620400  6.065520 #> 2  8.1274                 TRUE  940.077 2.29735e-01   12.985200  1.965820 #> 3  8.3274                 TRUE  844.236 1.08857e-01    9.799480 -2.132340 #> 4  8.5274                 TRUE  790.513 9.17170e-06    3.930790 -5.726270 #> 5  8.7274                 TRUE  762.562 6.48948e-08    0.271032 -7.140910 #> 6  8.9274                 TRUE  754.302 1.33458e-10    0.174869 -7.118110 #> 7  9.1274                 TRUE  758.927 2.10816e-13    1.337060 -6.106700 #> 8  9.3274                 TRUE  767.708 1.90347e-13    3.424990 -4.917570 #> 9  9.5274                 TRUE  777.243 1.15331e-13    6.433440 -3.857200 #> 10 9.7274                 TRUE  787.189 6.73658e-14   10.382600 -2.563580 #> 11 9.9274                 TRUE  798.152 4.05051e-14   15.279300 -0.380771 #>    Length_comp Age_comp Size_at_age Recruitment InitEQ_Regime #> 1      453.198  341.340     230.715   19.181500   0.00000e+00 #> 2      418.750  291.595     201.557   12.989400   0.00000e+00 #> 3      393.384  257.968     179.068    6.036600   0.00000e+00 #> 4      379.721  243.456     167.416    1.713560   1.54502e-30 #> 5      370.420  234.970     163.525    0.515980   1.54502e-30 #> 6      366.756  231.845     162.399    0.244060   1.54502e-30 #> 7      367.497  233.210     162.675    0.312441   0.00000e+00 #> 8      369.543  235.957     163.170    0.529082   0.00000e+00 #> 9      371.605  238.622     163.598    0.839498   1.54502e-30 #> 10     373.376  240.872     163.942    1.178030   0.00000e+00 #> 11     374.815  242.718     164.208    1.510550   0.00000e+00 #>    Forecast_Recruitment Parm_priors Parm_softbounds Parm_devs Crash_Pen #> 1                     0           0      0.00756177         0         0 #> 2                     0           0      0.00433602         0         0 #> 3                     0           0      0.00337783         0         0 #> 4                     0           0      0.00197985         0         0 #> 5                     0           0      0.00143663         0         0 #> 6                     0           0      0.00141332         0         0 #> 7                     0           0      0.00150262         0         0 #> 8                     0           0      0.00159065         0         0 #> 9                     0           0      0.00166199         0         0 #> 10                    0           0      0.00171844         0         0 #> 11                    0           0      0.00176282         0         0"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/likelihood.html","id":"visualizing-output","dir":"Articles","previous_headings":"","what":"Visualizing Output","title":"Likelihood Profile","text":"profile finished running, can visualize results determine conflict data sources. data sources reach negative log-likelihood (NLL) minimum R0 value, indicates good agreement . However, likely, one reach NLL minimum different R0 values global R0 value. sign conflict data sources may require consider data weighting.  profile plot shows changes log-likelihood across selected range values contributing data components. adjustable minimum contribution threshold component must meet appear figure (data source model show plot, contribution total likelihood may large enough). steepness trajectory indicates informative () data source . example, age data plot much steeper left side minimum R0 value index data, suggests age composition data informative model. can also plot data-type fleet-specific profiles using r4ss::PinerPlot(). plotting profile length composition data fleet likelihood survey data fleet. allow us see conflicts sources main drivers.","code":"profile_mods <- SSgetoutput(dirvec = dir_profile, keyvec = 1:length(r0_vec), verbose = FALSE) profile_mods_sum <- SSsummarize(profile_mods, verbose = FALSE) SSplotProfile(profile_mods_sum,   profile.string = \"SR_LN\",   profile.label = \"SR_LN(R0)\" ) #> Parameter matching profile.string=SR_LN: SR_LN(R0) #> Parameter values (after subsetting based on input 'models'): 7.9274, 8.1274, 8.3274, 8.5274, 8.7274, 8.9274, 9.1274, 9.3274, 9.5274, 9.7274, 9.9274 #> Likelihood components showing max change as fraction of total change. #> To change which components are included, change input 'minfraction'. #>                      frac_change include                            label #> TOTAL                     1.0000    TRUE                            Total #> Catch                     0.0014   FALSE                            Catch #> Equil_catch               0.0525    TRUE                Equilibrium catch #> Survey                    0.0422    TRUE                       Index data #> Length_comp               0.2759    TRUE                      Length data #> Age_comp                  0.3495    TRUE                         Age data #> Size_at_age               0.2181    TRUE                 Size-at-age data #> Recruitment               0.0605    TRUE                      Recruitment #> InitEQ_Regime             0.0000   FALSE Initital equilibrium recruitment #> Forecast_Recruitment      0.0000   FALSE             Forecast recruitment #> Parm_priors               0.0000   FALSE                           Priors #> Parm_softbounds           0.0000   FALSE                      Soft bounds #> Parm_devs                 0.0000   FALSE             Parameter deviations #> Crash_Pen                 0.0000   FALSE                    Crash penalty sspar(mfrow = c(1, 2)) PinerPlot(profile_mods_sum,   component = \"Length_like\",   main = \"Length\" ) #> Parameter matching profile.string = 'R0': 'SR_LN(R0) #> Parameter values (after subsetting based on input 'models'): 7.9274, 8.1274, 8.3274, 8.5274, 8.7274, 8.9274, 9.1274, 9.3274, 9.5274, 9.7274, 9.9274, #> Fleet-specific likelihoods showing max change as fraction of total change. #> To change which components are included, change input 'minfraction'. #>         frac_change include #> FISHERY      0.6825    TRUE #> SURVEY1      0.3208    TRUE #> SURVEY2      0.0000   FALSE PinerPlot(profile_mods_sum,   component = \"Surv_like\",   main = \"Survey\" ) #> Parameter matching profile.string = 'R0': 'SR_LN(R0) #> Parameter values (after subsetting based on input 'models'): 7.9274, 8.1274, 8.3274, 8.5274, 8.7274, 8.9274, 9.1274, 9.3274, 9.5274, 9.7274, 9.9274, #> Fleet-specific likelihoods showing max change as fraction of total change. #> To change which components are included, change input 'minfraction'. #>         frac_change include #> FISHERY      0.0000   FALSE #> SURVEY1      0.3218    TRUE #> SURVEY2      0.9202    TRUE"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/residuals.html","id":"runs-test","dir":"Articles","previous_headings":"","what":"Runs Test","title":"Residual Analyses","text":"runs test nonparametric hypothesis test randomness data sequence calculates 2-sided p-value estimate number runs (.e., sequences values sign) reference value. runs test can diagnose model misspecification using residuals fits index composition data (Carvalho et al. 2017) testing non-random patterns residuals. addition, three-sigma limits can considered useful identifying potential outliers data point three standard deviations away expected residual process average unlikely given random process error observed residual distribution. example using “simple_small” SS model included within r4ss package. can read report file model output using r4ss::SS_output() function shown .  output SSplotRunstest() includes plot residuals fleet table results runs test ‘three-sigma limit’ values. plots , shaded area represents ‘three-sigma limit’, three residual standard deviations zero. individual residual points fall outside three-sigma limit, colored red. Green shaded area indicates residuals randomly distributed (p-value >= 0.05) whereas red shaded area indicates residuals randomly distributed. Failing runs test (p-value < 0.05) can indicative misspecification conflict indices composition data.","code":"library(r4ss)  files_path <- system.file(\"extdata\", \"simple_small\", package = \"r4ss\") report <- SS_output(dir = files_path, verbose = FALSE, printstats = FALSE) sspar(mfrow = c(1, 2)) SSplotRunstest(report, add = TRUE) #> Running Runs Test Diagnostics w/ plots forIndex #> Plotting Residual Runs Tests #> Residual Runs Test (/w plot) stats by Index: #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 SURVEY1  0.159 Passed -0.7301441 0.7301441 cpue #> 2 SURVEY2  0.887 Passed -1.1052361 1.1052361 cpue"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/residuals.html","id":"customizing-the-plot","dir":"Articles","previous_headings":"Runs Test","what":"Customizing the Plot","title":"Residual Analyses","text":"Runs test plots can customized needed. common features may want specify : plotting data types (default Index Abundance) plotting specific fleet(s) adjusting y-axis range Examples changes shown , incrementally making adjustment. plot data types, can specified subplots argument, options include “cpue”, “len”, “age”, “size”, “con”. “con” conditional size--age data “size” generalized size composition data. Fleets can specified using indexselect() function, takes vector fleet numbers plot.  Note small adjustment automatically added ylim provide extra white space. third plot, even though set y-axis range -0.5 0.5, y-axis goes -0.6 0.6. want extra space, set ylimAdj = 1 done 4th plot.","code":"sspar(mfrow = c(2, 2)) SSplotRunstest(report, subplots = \"len\", indexselect = 1, add = TRUE) #> Running Runs Test Diagnostics w/ plots forMean length #> Plotting Residual Runs Tests #> Residual Runs Test (/w plot) stats by Mean length: #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 FISHERY  0.126 Passed -0.0613176 0.0613176  len SSplotRunstest(report, subplots = \"age\", indexselect = 2, add = TRUE) #> Running Runs Test Diagnostics w/ plots forMean age #> Plotting Residual Runs Tests #> Residual Runs Test (/w plot) stats by Mean age: #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 SURVEY1   0.11 Passed -0.2743816 0.2743816  age SSplotRunstest(report, subplots = \"age\", indexselect = 2, add = TRUE, ylim = c(-0.5, 0.5)) #> Running Runs Test Diagnostics w/ plots forMean age #> Plotting Residual Runs Tests #> Residual Runs Test (/w plot) stats by Mean age: #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 SURVEY1   0.11 Passed -0.2743816 0.2743816  age SSplotRunstest(report, subplots = \"age\", indexselect = 2, add = TRUE, ylim = c(-0.5, 0.5), ylimAdj = 1) #> Running Runs Test Diagnostics w/ plots forMean age #> Plotting Residual Runs Tests #> Residual Runs Test (/w plot) stats by Mean age: #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 SURVEY1   0.11 Passed -0.2743816 0.2743816  age"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/residuals.html","id":"summary-table","dir":"Articles","previous_headings":"Runs Test","what":"Summary Table","title":"Residual Analyses","text":"addition residual plots, SSplotRunstest() produces summary table runs test output values, including: p-value runs test test passed failed (indicated green red shading plot) upper lower limits 3-sigma interval type data tested (CPUE, length-composition, age-composition, conditional age--length) produce summary table skip plot, e.g. faciliate automated processing, use SSrunstest().","code":"rcpue <- SSrunstest(report, quants = \"cpue\") #> Running Runs Test Diagnosics for Index #> Computing Residual Runs Tests #> Residual Runs Test stats by Index: rlen <- SSrunstest(report, quants = \"len\") #> Running Runs Test Diagnosics for Mean length #> Computing Residual Runs Tests #> Residual Runs Test stats by Mean length: rbind(rcpue, rlen) #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 SURVEY1  0.159 Passed -0.7301441 0.7301441 cpue #> 2 SURVEY2  0.887 Passed -1.1052361 1.1052361 cpue #> 3 FISHERY  0.126 Passed -0.0613176 0.0613176  len #> 4 SURVEY1  0.841 Passed -0.1725225 0.1725225  len"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/residuals.html","id":"rmse","dir":"Articles","previous_headings":"","what":"RMSE","title":"Residual Analyses","text":"RMSE root mean square error useful evaluating far predictions fall observed data. ss3diags::SSplotJABBAres() function allows visualize full time series residuals fleets indicated data (index abundance composition). example , plot residuals index abundance, mean age (age-composition), mean length (length composition) fleets.  plots , point represents difference observed expected value (residual) color-coded correspond specific fleet. solid, color-coded vertical lines horizontal dashed line (y = 0) show distance 0 residual value. Box plots summarize spread residual values across fleets within year thick solid black line loess smoother fit residual points. Total RMSE displayed top right corner. assessing plot, important see patterns trends residuals, large overall RMSE , whether data different fleets generally agrees conflicts . retrieve just RMSE residual values without generating plot, SSrmse() produces named list 2 objects, RMSE residuals. can accessed shown . function useful automating analyses.","code":"sspar(mfrow = c(2, 2)) SSplotJABBAres(report, subplots = \"cpue\", add = TRUE) #> Plotting JABBA residual plot. #> is plot TRUE? TRUE #> drawing plot at #> Plot exists: #> RMSE stats by Index: #> # A tibble: 3 × 3 #>   Fleet    RMSE.perc  Nobs #>   <chr>        <dbl> <int> #> 1 SURVEY1       21.6     4 #> 2 SURVEY2       27.7    12 #> 3 Combined      26.3    16 SSplotJABBAres(report, subplots = \"age\", add = TRUE) #> Plotting JABBA residual plot. #> is plot TRUE? TRUE #> drawing plot at #> Plot exists: #> RMSE stats by Index: #> # A tibble: 3 × 3 #>   Fleet    RMSE.perc  Nobs #>   <chr>        <dbl> <int> #> 1 FISHERY        9      12 #> 2 SURVEY1        8.1     4 #> 3 Combined       8.8    16 SSplotJABBAres(report, subplots = \"len\", add = TRUE, ylim = c(-0.2, 0.2)) #> Plotting JABBA residual plot. #> is plot TRUE? TRUE #> drawing plot at #> Plot exists: #> RMSE stats by Index: #> # A tibble: 3 × 3 #>   Fleet    RMSE.perc  Nobs #>   <chr>        <dbl> <int> #> 1 FISHERY        2.1    12 #> 2 SURVEY1        3.4     4 #> 3 Combined       2.5    16 rmse <- SSrmse(report, quants = \"cpue\")$RMSE residuals <- SSrmse(report, quants = \"cpue\")$residuals  rmse #> # A tibble: 3 × 3 #>   Fleet    RMSE.perc  Nobs #>   <chr>        <dbl> <int> #> 1 SURVEY1       21.6     4 #> 2 SURVEY2       27.7    12 #> 3 Combined      26.3    16  head(residuals) #>     Fleet Fleet_name Area   Yr Seas Subseas Month   Time Vuln_bio         Obs #> 925     2    SURVEY1    1 2013    1       2     7 2013.5 62947.50 144745.0000 #> 926     2    SURVEY1    1 2016    1       2     7 2016.5 49335.70  63760.3000 #> 927     2    SURVEY1    1 2019    1       2     7 2019.5 38132.00  59242.9000 #> 928     2    SURVEY1    1 2022    1       2     7 2022.5 34045.80  49649.7000 #> 929     3    SURVEY2    1 2011    1       2     7 2011.5  6306.83     11.5668 #> 930     3    SURVEY2    1 2012    1       2     7 2012.5  6544.96     13.9955 #>             Exp     Calc_Q      Eff_Q  SE SE_input         Dev        Like #> 925 101399.0000 1.61084000 1.61084000 0.3      0.3  0.35591400 7.03749e-01 #> 926  79472.2000 1.61084000 1.61084000 0.3      0.3 -0.22027600 2.69564e-01 #> 927  61424.7000 1.61084000 1.61084000 0.3      0.3 -0.03616590 7.26653e-03 #> 928  54842.4000 1.61084000 1.61084000 0.3      0.3 -0.09947210 5.49706e-02 #> 929     11.5342 0.00182885 0.00182885 0.7      0.7  0.00281831 8.10497e-06 #> 930     11.9698 0.00182885 0.00182885 0.7      0.7  0.15635300 2.49451e-02 #>     Like+log(s) SuprPer Use    residuals #> 925   -0.500223      NA   1  0.355910344 #> 926   -0.934409      NA   1 -0.220276535 #> 927   -1.196710      NA   1 -0.036166093 #> 928   -1.149000      NA   1 -0.099471269 #> 929   -0.356667      NA   1  0.002822391 #> 930   -0.331730      NA   1  0.156349038"},{"path":"https://pifscstockassessments.github.io/ss3diags/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Henning Winker. Author. Felipe Carvalho. Author. Massimiliano Cardinale. Author. Laurence Kell. Author. Megumi Oshima. Author, maintainer. Eric Fletcher. Author.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Winker H, Carvalho F, Cardinale M, Kell L, Oshima M, Fletcher E (2024). ss3diags: Stock Synthesis Model Diagnostics Intergated Stock Assessments. R package version 2.1.1, https://github.com/PIFSCstockassessments/ss3diags.","code":"@Manual{,   title = {ss3diags: Stock Synthesis Model Diagnostics for Intergated Stock Assessments},   author = {Henning Winker and Felipe Carvalho and Massimiliano Cardinale and Laurence Kell and Megumi Oshima and Eric Fletcher},   year = {2024},   note = {R package version 2.1.1},   url = {https://github.com/PIFSCstockassessments/ss3diags}, }"},{"path":"https://pifscstockassessments.github.io/ss3diags/index.html","id":"ss3diags-","dir":"","previous_headings":"","what":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","title":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","text":"R package ss3diags enables users apply advanced diagnostics evaluate Stock Synthesis model. Diagnostics include residual analyses, hindcast cross-validation techniques, retrospective analyses. Functions also allow users reproduce key model diagnostics plots presented paper ‘Cookbook Using Model Diagnostics Integrated Stock Assessments’ (Carvalho et al. 2021). ss3diags Github repository provides step--step R recipes : Run jitter analysis Conduct retrospective analysis Use hindcast cross-validation log-likelood profiling R0 Run ASPM diagnostic Evaluate model fit Stock Synthesis making use comprehensive collection R functions available R packages r4ss ss3diags.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","text":"ss3diags currently supported CRAN. can install development version ss3diags GitHub : package installed can loaded : examples run common diagnostic tests SS models visualize results diagnostic tests using r4ss ss3diags packages, please refer articles package website.","code":"# install.packages(\"remotes\") remotes::install_github(\"PIFSCstockassessments/ss3diags\") library(ss3diags)"},{"path":"https://pifscstockassessments.github.io/ss3diags/index.html","id":"contributing-to-ss3diags","dir":"","previous_headings":"","what":"Contributing to ss3diags","title":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","text":"like contribute ss3diags suggestions diagnostic tests include package, can submit new issue email Meg megumi.oshima@noaa.gov.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/index.html","id":"reference","dir":"","previous_headings":"","what":"Reference","title":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","text":"cite ss3diags publication can use","code":"citation(\"ss3diags\") #> To cite package 'ss3diags' in publications use: #>  #>   Winker H, Carvalho F, Cardinale M, Kell L, Oshima M, Fletcher E #>   (2023). _ss3diags: Stock Synthesis Model Diagnostics for Intergated #>   Stock Assessments_. R package version 2.1.1, #>   <https://github.com/PIFSCstockassessments/ss3diags>. #>  #> A BibTeX entry for LaTeX users is #>  #>   @Manual{, #>     title = {ss3diags: Stock Synthesis Model Diagnostics for Intergated Stock Assessments}, #>     author = {Henning Winker and Felipe Carvalho and Massimiliano Cardinale and Laurence Kell and Megumi Oshima and Eric Fletcher}, #>     year = {2023}, #>     note = {R package version 2.1.1}, #>     url = {https://github.com/PIFSCstockassessments/ss3diags}, #>   }"},{"path":"https://pifscstockassessments.github.io/ss3diags/index.html","id":"disclaimer","dir":"","previous_headings":"","what":"Disclaimer","title":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","text":"United States Department Commerce (DOC) GitHub project code provided ‘’ basis user assumes responsibility use. DOC relinquished control information longer responsibility protect integrity, confidentiality, availability information. claims Department Commerce stemming use GitHub project governed applicable Federal law. reference specific commercial products, processes, services service mark, trademark, manufacturer, otherwise, constitute imply endorsement, recommendation favoring Department Commerce. Department Commerce seal logo, seal logo DOC bureau, shall used manner imply endorsement commercial product activity DOC United States Government.”","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":null,"dir":"Reference","previous_headings":"","what":"Francis Weighting for compositional data — SScompsTA1.8","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"TA1.8 Francis function modified r4ss::SSMethod.TA1.8 r4ss::SSMethod.Cond.TA1.8 apply Francis weighting method TA1.8 length-, age-, generalized size-composition data, conditional age--length data Stock Synthesis model. conditional age--length data, mean age year calculated based recommendations Punt (2015). main purpose create dataframe annual observed expected mean length age fleet used calculate residuals testing model fit. function used SSplotRunstest SSplotJABBAres.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"","code":"SScompsTA1.8(   ss3rep,   type = c(\"len\", \"age\", \"size\", \"con\"),   fleet = NULL,   seas = NULL,   plotit = FALSE,   maxpanel = 1000 )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"ss3rep Stock Synthesis output read r4SS function SS_output type string either 'len' (length composition data), 'size' (generalized size composition data), 'age' (age composition data), 'con' (conditional age length data) fleet vector one fleet numbers whose data analysed simultaneously, NULL, fleets analysed seas string indicating treat data multiple seasons 'comb' - combine seasonal data year plot Yr 'sep' - treat season separately, plotting Yr.S. .null(seas), assumed one season option 'comb' used. plotit TRUE, make illustrative plot like one panels Fig. 4 Francis (2011). maxpanel maximum number panels within plot, default 1000","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"ss_out data.frame observed, predicted mean length/age 95% confidence intervals based stage 1 stage 2 weighting runs_dat data.frame observed predicted mean length age year/fleet.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"Francis, R..C.C. (2011). Data weighting statistical fisheries stock assessment models. Canadian Journal Fisheries Aquatic Sciences 68: 1124-1138. #' Punt, .E. (2015). insights data weighting integrated stock assessments. Fish. Res. <http://dx.doi.org/10.1016/j.fishres.2015.12.006","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"Chris Francis, Andre Punt, Ian Taylor (modified Henning Winker Meg Oshima)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN.html","id":null,"dir":"Reference","previous_headings":"","what":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","text":"function generate joint distributions stock status ratios (SSB/SSBref F/Fref ref can MSY, SSB40, F40, etc.) using Multivariate Log-Normal Distribution. function produces Kobe plot, maximum likelihood estimates MVLN Monte-Carlo distributions Kobe values can input SSplotEnsemble().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","text":"","code":"SSdeltaMVLN(   ss3rep,   Fref = NULL,   years = NULL,   mc = 5000,   weight = 1,   run = \"MVLN\",   plot = TRUE,   addprj = FALSE,   ymax = NULL,   xmax = NULL,   legendcex = 1,   verbose = TRUE,   variance_method = \"ww2019\",   bias_correct_mean = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","text":"ss3rep r4ss::SS_output Fref Choice Fratio c(\"MSY\",\"Btgt\"), correponding F_MSY F_Btgt years single year vector years mvln mc number monte-carlo simulations weight weighting option model ensembles weight*mc run qualifier model run plot option show plot addprj include forecast years ymax ylim maximum xmax xlim maximum legendcex Allows adjust legend cex verbose Report progress R GUI? variance_method Specify method approximating variance covariance multivariate lognormal distribution ww2019 Use approximation Walter Winker 2019 (Default backwards compatibility). 2T Use delta-method 2nd order Taylor series approximation. bias_correct_mean Specify Stock Synthesis MLE estimates bias corrected used specify mean multivariate lognormal distribution FALSE apply bias correction (Default backwards compatibility). TRUE Apply bias correction.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","text":"output list maximum likelihood estimates MVLN Monte-Carlo distributions Kobe values, kobe plot","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","text":"Henning Winker (JRC-EC) Nicholas Ducharme-Barth (PIFSC)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN_old.html","id":null,"dir":"Reference","previous_headings":"","what":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","text":"function generate kobe pdfs Multivariate Log-Normal Distribution including plotting option. version used older versions Stock Synthesis. newer versions (v3.24 newer), use SSdeltaMVLN().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN_old.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","text":"","code":"SSdeltaMVLN_old(   ss3rep,   status = c(\"Bratio\", \"F\"),   quants = c(\"SSB\", \"Recr\"),   Fref = c(\"MSY\", \"Ftrg\"),   years = NULL,   mc = 5000,   weight = 1,   run = \"MVLN\",   plot = TRUE,   addtrj = TRUE,   ymax = NULL,   xmax = NULL,   legendcex = 1,   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN_old.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","text":"ss3rep r4ss::SSgetoutput()$replist1 status covarying stock status quantaties extract Hessian quants additional stock quantaties extract Hessian Fref Choice reference point stock SSB/XFref=c(\"MSY\",\"Ftrg\"),F_report_basis: 0 3 years single year vector years mvln mc number monte-carlo simulations weight weighting option model ensembles weight*mc run qualifier model run plot option show plot addtrj TRUE/FALSE add trajectory years. Default TRUE ymax ylim maximum xmax xlim maximum legendcex Allows adjust legend cex verbose Report progress R GUI?","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN_old.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","text":"output list kobe objects mle's","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN_old.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","text":"Henning Winker (JRC-EC)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC.html","id":null,"dir":"Reference","previous_headings":"","what":"MCMC Joint Distributions — SSdiagsMCMC","title":"MCMC Joint Distributions — SSdiagsMCMC","text":"function generate joint distributions stock status ratios (SSB/SSBref F/Fref ref can MSY, SSB40, F40, etc.) using MCMC. function produces Kobe plot, maximum likelihood estimates MVLN Monte-Carlo distributions Kobe values can input SSplotEnsemble().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"MCMC Joint Distributions — SSdiagsMCMC","text":"","code":"SSdiagsMCMC(   mcmc,   ss3rep,   Fref = NULL,   years = NULL,   run = \"MCMC\",   thin = 1,   plot = TRUE,   addprj = FALSE,   ymax = NULL,   xmax = NULL,   legendcex = 1,   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"MCMC Joint Distributions — SSdiagsMCMC","text":"mcmc file path folder derived_posteriors.sso file ss3rep r4ss::SS_output Fref Choice Fratio c(\"MSY\",\"Btgt), correponding F_MSY F_Btgt years single year vector years mvln run qualifier model run thin option use additional thinning plot option show plot addprj include forecast years ymax ylim maximum xmax xlim maximum legendcex Allows adjust legend cex verbose Report progress R GUI?","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"MCMC Joint Distributions — SSdiagsMCMC","text":"output list maximum likelihood estimates MCMC posterier distributions Kobe values Kobe plot","code":""},{"path":[]},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"MCMC Joint Distributions — SSdiagsMCMC","text":"Henning Winker (JRC-EC), Massimiliano Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC_ancient.html","id":null,"dir":"Reference","previous_headings":"","what":"MCMC Joint Distributions — SSdiagsMCMC_ancient","title":"MCMC Joint Distributions — SSdiagsMCMC_ancient","text":"function generate joint distributions stock status ratios (SSB/SSBref F/Fref ref can MSY, SSB40, F40, etc.) using MCMC. function produces Kobe plot, maximum likelihood estimates MVLN Monte-Carlo distributions Kobe values can input SSplotEnsemble(). Use Stock Synthesis models older 3.24, later versions use SSdiagsMCMC().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC_ancient.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"MCMC Joint Distributions — SSdiagsMCMC_ancient","text":"","code":"SSdiagsMCMC_ancient(   mcmc,   ss3rep,   Fref = NULL,   years = NULL,   run = \"MCMC\",   thin = 1,   plot = TRUE,   addprj = FALSE,   ymax = NULL,   xmax = NULL,   legendcex = 1,   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC_ancient.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"MCMC Joint Distributions — SSdiagsMCMC_ancient","text":"mcmc file path folder derived_posteriors.sso file ss3rep r4ss::SS_output Fref Choice Fratio c(\"MSY\",\"Btgt), correponding F_MSY F_Btgt years single year vector years mvln run qualifier model run thin option use additional thinning plot option show plot addprj include forecast years ymax ylim maximum xmax xlim maximum legendcex Allows adjust legend cex verbose Report progress R GUI?","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC_ancient.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"MCMC Joint Distributions — SSdiagsMCMC_ancient","text":"output list maximum likelihood estimates MCMC posterier distributions Kobe values Kobe plot","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC_ancient.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"MCMC Joint Distributions — SSdiagsMCMC_ancient","text":"Henning Winker (JRC-EC), Massimiliano Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SShcbias.html","id":null,"dir":"Reference","previous_headings":"","what":"Mohn's Rho and Forecast Bias — SShcbias","title":"Mohn's Rho and Forecast Bias — SShcbias","text":"function produces statistics retrospective analysis (Mohn's rho forecast bias). visualize retrospective forecasts Stock Synthesis model, use SSplotRetro().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SShcbias.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Mohn's Rho and Forecast Bias — SShcbias","text":"","code":"SShcbias(   summaryoutput,   quants = c(\"SSB\", \"F\"),   models = \"all\",   endyrvec = \"default\",   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SShcbias.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Mohn's Rho and Forecast Bias — SShcbias","text":"summaryoutput List created r4ss::SSsummarize() quants SSB F quantity models Optional subset models described r4ss function summaryoutput().  Either \"\" vector numbers indicating columns summary tables. endyrvec Optional single year vector years representing final year values show model. default set ending year specified model. verbose Report progress R GUI?","code":""},{"path":[]},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SShcbias.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Mohn's Rho and Forecast Bias — SShcbias","text":"Henning Winker (JRC-EC) Laurance Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":null,"dir":"Reference","previous_headings":"","what":"Mean Absolute Scaled Error — SSmase","title":"Mean Absolute Scaled Error — SSmase","text":"MASE one-step ahead hindcasting cross-validations computes MASE prediction residuals indices. MASE calculated average ratio mean absolute error (MAE) prediction residuals (MAE.PR) Naive Predictions (MAE.base) MASE.adj sets MAE.base minimum MAE.base.adj (default=0.1) MASE.adj allow passing (MASE<1) MAE.PE < 0.1 thus accurate, obs show extremely little variation","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Mean Absolute Scaled Error — SSmase","text":"","code":"SSmase(   retroSummary,   quants = c(\"cpue\", \"len\", \"age\", \"con\"),   Season = \"default\",   models = \"all\",   endyrvec = \"default\",   indexselect = NULL,   MAE.base.adj = 0.1,   residuals = FALSE,   verbose = FALSE,   indexfleets = 1 )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Mean Absolute Scaled Error — SSmase","text":"retroSummary raw list retrospective runs created r4ss::SSgetoutput(). Depending type data, function call r4ss::SSsummarize ss3diags:SSretroComps summarize list. quants data type, either \"cpue\" index data, \"len\" length composition data, \"age\" age composition data. Note, using \"age\" \"len\", SSretroComps() used extract summarize composition data first. Season option specify Season integer value 1-4 - Default uses first available, .e. usual Seas = 1 models Optional subset models described r4ss function summaryoutput().  Either \"\" vector numbers indicating columns summary tables. endyrvec Optional single year vector years representing final year values show model. default set ending year specified model. indexselect Vector fleet numbers model compare MAE.base.adj minimum MASE demoninator (naive predictions) MASE.adj (default = 0.1) residuals true, includes dataframe output prediction residuals naive prediction residuals. Default FALSE. verbose Report progress R GUI? indexfleets Single value vector length n = number models summary object fleet number(s) index compare.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Mean Absolute Scaled Error — SSmase","text":"MASE hcxval statistic","code":""},{"path":[]},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Mean Absolute Scaled Error — SSmase","text":"Henning Winker (JRC-EC) Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Mean Absolute Scaled Error — SSmase","text":"","code":"if (FALSE) { # calculate MASE for CPUE indices only for fleets 1 and 2 SSmase(retro.sma, quant = \"cpue\", indexselect = c(1:2)) }"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotEnsemble.html","id":null,"dir":"Reference","previous_headings":"","what":"Model ensemble plots — SSplotEnsemble","title":"Model ensemble plots — SSplotEnsemble","text":"Plots model ensembles forecasts uncertainty represented MVLN MCMC posteriors","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotEnsemble.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Model ensemble plots — SSplotEnsemble","text":"","code":"SSplotEnsemble(   kb,   subplots = c(\"stock\", \"harvest\", \"SSB\", \"F\", \"Recr\", \"Catch\"),   models = \"all\",   quantiles = list(c(0.025, 0.975)),   ylabs = NULL,   endyrvec = \"default\",   plot = TRUE,   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = FALSE,   use_pdf = FALSE,   col = NULL,   pch = NULL,   lty = 1,   lwd = 2,   tickEndYr = FALSE,   xlim = NULL,   ylimAdj = 1.05,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"l\",   uncertainty = TRUE,   legend = TRUE,   legendlabels = \"default\",   legendloc = \"topright\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.9,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   shadealpha = 0.3,   new = TRUE,   add = FALSE,   mcmcVec = FALSE,   indexQlabel = TRUE,   indexQdigits = 4,   legendindex = NULL )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotEnsemble.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Model ensemble plots — SSplotEnsemble","text":"kb kb type output created SSdeltaMVLN() subplots vector create subplots options: \"stock\" Fish Population \"harvest\" Harvest Rate \"SSB\" Spawning Stock Biomass \"F\" Fishing Mortality \"Recr\" Recruitment \"Catch\" Total Catch models option manually subset models kb[[\"run\"]] quantiles quantiles uncertainty plots. Input list, default 95TH percentile: list(c(0.025, 0.975)) ylabs y-axis labels quants endyrvec Optional single year vector years representing final year values show model. \"default\" set ending year specified model. plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot. uncertainty Logical flag enable plots uncertainty intervals. Either single TRUE/FALSE value, vector TRUE/FALSE values around SSB F estimated timeseries, set integers corresponding choice models. legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console shadealpha Transparency adjustment used make uncertainty regions, default 0.3 new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs mcmcVec Logical vector TRUE/FALSE values (single value) indicating whether input values MCMC use normal distribution around MLE. indexQlabel TRUE/FALSE include labels indices. Default TRUE (currently used) indexQdigits Number significant digits catchability legend. Default 4 legendindex Allows add legend selected indices (plots)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotEnsemble.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Model ensemble plots — SSplotEnsemble","text":"Mostly adopted r4ss::SSplotComparisons Taylor et al","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotEnsemble.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Model ensemble plots — SSplotEnsemble","text":"","code":"if (FALSE) {  mvln <- SSdeltaMVLN(simple, run = \"Simple\") sspar(mfrow = c(3, 2), plot.cex = 0.7) SSplotEnsemble(mvln[[\"kb\"]], ylabs = mvln[[\"labels\"]], add = T, verbose = F) }"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGeneric.html","id":null,"dir":"Reference","previous_headings":"","what":"Generic SSplot function — SSplotGeneric","title":"Generic SSplot function — SSplotGeneric","text":"Generalized version ss3diags SSplots functions. intended production","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGeneric.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generic SSplot function — SSplotGeneric","text":"","code":"SSplotGeneric(   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   plot = TRUE,   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = deprecated(),   use_pdf = FALSE,   new = TRUE,   add = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGeneric.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generic SSplot function — SSplotGeneric","text":"pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericLegend.html","id":null,"dir":"Reference","previous_headings":"","what":"Legend parameters for Generic SSplot — SSplotGenericLegend","title":"Legend parameters for Generic SSplot — SSplotGenericLegend","text":"Generalized version ss3diags SSplots functions specfic plot legend parameters. intended production.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericLegend.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Legend parameters for Generic SSplot — SSplotGenericLegend","text":"","code":"SSplotGenericLegend(   legend = TRUE,   legendlabels = \"default\",   legendloc = \"topright\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.9,   legendindex = NULL )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericLegend.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Legend parameters for Generic SSplot — SSplotGenericLegend","text":"legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels legendindex Allows add legend selected indices (plots)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericPar.html","id":null,"dir":"Reference","previous_headings":"","what":"Graphical Parameters for Stock Synthesis Generic plots. — SSplotGenericPar","title":"Graphical Parameters for Stock Synthesis Generic plots. — SSplotGenericPar","text":"Generalized version ss3diags SSplots functions specify par() pass plot attributes. intended production.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericPar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Graphical Parameters for Stock Synthesis Generic plots. — SSplotGenericPar","text":"","code":"SSplotGenericPar(   col = NULL,   pch = NULL,   lty = 1,   lwd = 2,   tickEndYr = FALSE,   xlim = NULL,   ylimAdj = 1.05,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"l\" )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericPar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Graphical Parameters for Stock Synthesis Generic plots. — SSplotGenericPar","text":"col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericUncertainty.html","id":null,"dir":"Reference","previous_headings":"","what":"Uncertainty parameters for Stock Synthesis Generic plots. — SSplotGenericUncertainty","title":"Uncertainty parameters for Stock Synthesis Generic plots. — SSplotGenericUncertainty","text":"Generalized version ss3diags SSplots functions specify uncertainty. intended production.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericUncertainty.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Uncertainty parameters for Stock Synthesis Generic plots. — SSplotGenericUncertainty","text":"","code":"SSplotGenericUncertainty(uncertainty = TRUE, mcmcVec = FALSE, models = \"all\")"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericUncertainty.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Uncertainty parameters for Stock Synthesis Generic plots. — SSplotGenericUncertainty","text":"uncertainty Logical flag enable plots uncertainty intervals. Either single TRUE/FALSE value, vector TRUE/FALSE values around SSB F estimated timeseries, set integers corresponding choice models. mcmcVec Logical vector TRUE/FALSE values (single value) indicating whether input values MCMC use normal distribution around MLE. models Optional subset models summaryoutput (similar field different name): list created function r4ss::SSsummarize. Either \"\" vector numbers indicating columns summary tables.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotHCxval.html","id":null,"dir":"Reference","previous_headings":"","what":"Hindcasting Cross-Validations of Multiple Models — SSplotHCxval","title":"Hindcasting Cross-Validations of Multiple Models — SSplotHCxval","text":"Plots one-step ahead hindcasting cross-validations computes MASE prediction residuals.MASE calculated average ratio mean absolute error (MAE) prediction residuals (MAE.PR) naive predictions (MAE.base). MASE.adj sets MAE.base minimum MAE.base.adj (default=0.1). MASE.adj allow passing (MASE<1) MAE.PE < 0.1 thus accurate obs show little annual variation","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotHCxval.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Hindcasting Cross-Validations of Multiple Models — SSplotHCxval","text":"","code":"SSplotHCxval(   retroSummary,   subplots = c(\"cpue\", \"len\", \"age\"),   Season = \"default\",   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = deprecated(),   use_pdf = FALSE,   models = \"all\",   endyrvec = \"default\",   xmin = NULL,   indexselect = NULL,   MAE.base.adj = 0.1,   show.mase.adj = TRUE,   indexUncertainty = TRUE,   col = NULL,   pch = NULL,   lty = 1,   lwd = 2,   tickEndYr = TRUE,   xlim = \"default\",   ylimAdj = 1.15,   ylim = NULL,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"o\",   uncertainty = TRUE,   legend = TRUE,   legendlabels = \"default\",   legendloc = \"topright\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.9,   legendindex = NULL,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   shadecol = grey(0.5, 0.4),   shadecol2 = grey(0.5, 0.4),   shadealpha = 0.3,   new = TRUE,   add = FALSE,   mcmcVec = FALSE,   indexQlabel = TRUE,   indexQdigits = 4,   indexfleets = 1,   plot = TRUE,   shadecol1 = grey(0.5, 0.4) )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotHCxval.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Hindcasting Cross-Validations of Multiple Models — SSplotHCxval","text":"retroSummary List created r4ss::SSsummarize() SSretroComps() subplots optional use following: \"cpue\" Index abundance data \"len\" Length-composition data \"age\" Age-composition data Season option specify Season integer value 1-4. Default uses first available, .e. usual Seas = 1 print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. models Optional subset models summaryoutput (similar field different name): list created function r4ss::SSsummarize. Either \"\" vector numbers indicating columns summary tables. endyrvec Optional single year vector years representing final year values show model. default set ending year specified model. xmin optional number first year shown plot (available) indexselect Vector fleet numbers model compare MAE.base.adj minimum MASE denominator (naive predictions) MASE.adj (default = 0.1) show.mase.adj TRUE, show mase.adj plot indexUncertainty Show fixed uncertainty intervals index (estimated) col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylimAdj Multiplier ylim parameter. Allows additional white space. ylim -write ylimAdj specified xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot. uncertainty Logical flag enable plots uncertainty intervals. Either single TRUE/FALSE value, vector TRUE/FALSE values around SSB F estimated timeseries, set integers corresponding choice models. legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels legendindex Allows add legend selected indices (plots) pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console shadecol uncertainty shading hcxval horizon shadecol2 color uncertainty early years affected hindcast shadealpha Transparency adjustment used make default shadecol. (currently used) new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs mcmcVec Logical vector TRUE/FALSE values (single value) indicating whether input values MCMC use normal distribution around MLE. indexQlabel Logical flag add catchability legend plot index fits. indexQdigits Number significant digits catchability legend indexfleets Fleet numbers model compare indices abundance. Can take different forms: integer: (default) create single comparison plot chosen index NULL: create separate plot index long fleet numbering across models. vector length equal number models: single fleet number model compared single plot list: list fleet numbers associated indices within model compared, list elements vector length names list elements matter can absent. plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version shadecol1 uncertainty shading early years affected hindcast (currently used)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotHCxval.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Hindcasting Cross-Validations of Multiple Models — SSplotHCxval","text":"Henning Winker (JRC-EC) Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotJABBAres.html","id":null,"dir":"Reference","previous_headings":"","what":"Residual plot — SSplotJABBAres","title":"Residual plot — SSplotJABBAres","text":"Plots residuals indices boxplot (color coded fleet) loess showing systematic trends time. function package JABBA (Just Another Bayesian Biomass Assessment).","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotJABBAres.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Residual plot — SSplotJABBAres","text":"","code":"SSplotJABBAres(   ss3rep,   subplots = c(\"cpue\", \"len\", \"age\", \"size\", \"con\")[1],   seas = NULL,   plot = TRUE,   print = lifecycle::deprecated(),   print_plot = FALSE,   png = lifecycle::deprecated(),   use_png = print_plot,   pdf = lifecycle::deprecated(),   use_pdf = FALSE,   indexselect = NULL,   miny = 3,   col = NULL,   pch = 21,   lty = 1,   lwd = 2,   tickEndYr = TRUE,   xlim = \"default\",   ylim = \"default\",   ylimAdj = 1.1,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"o\",   legend = TRUE,   legendlabels = \"default\",   legendloc = \"bottomleft\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.9,   legendindex = NULL,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   boxcol = grey(0.8, 0.5),   new = TRUE,   add = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotJABBAres.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Residual plot — SSplotJABBAres","text":"ss3rep Stock Synthesis output read r4ss::SS_output() subplots string type data plot: \"cpue\" Index abundance data \"len\" Length-composition data \"age\" Age-composition data \"size\" Generalized size composition data \"con\" Conditional age--length data. seas string indicating treat data multiple seasons: \"comb\" Combine seasonal data year plot Yr \"sep\" Treat season separately, plotting Yr.S. NULL NULL, assumed one season option \"comb\" used. plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. indexselect Vector fleet numbers model compare miny minimum abs values ylim col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylim Optional, min max values ylim override \"default\" value (-0.7, 0.5) ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag. Enables x- y-axis labels. type type plot drawn. details, see plot. legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels legendindex Allows add legend selected indices (plots) pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console boxcol color boxes new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotJABBAres.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Residual plot — SSplotJABBAres","text":"Henning Winker (JRC-EC)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotKobe.html","id":null,"dir":"Reference","previous_headings":"","what":"KOBE phase plot — SSplotKobe","title":"KOBE phase plot — SSplotKobe","text":"Generates Kobe plot phase plot illustrating stock status uncertainty SSB/SSBmsy F/Fmsy","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotKobe.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"KOBE phase plot — SSplotKobe","text":"","code":"SSplotKobe(   kb,   joint = TRUE,   year = NULL,   posterior = c(\"points\", \"kernel\"),   xlab = expression(SSB/SSB[MSY]),   ylab = expression(F/F[MSY]),   ylim = NULL,   xlim = NULL,   fill = TRUE,   showMedian = TRUE,   legend = TRUE,   legendpos = \"right\",   legendcex = 0.7,   legendruns = TRUE,   yr.label = TRUE,   yr.int = 5,   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotKobe.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"KOBE phase plot — SSplotKobe","text":"kb output SSdeltaMVLN()$kb joint option FALSE shows individual runs year option choose year kobe, last year default posterior visualization posterior c(\"points\",\"kernel\") xlab graphic parameter ylab graphic parameter ylim graphic parameter xlim graphic parameter fill shows color-coded quadrants showMedian option median trajectory. TRUE default legend option legend. TRUE default. legendpos legend position legendcex legend size legendruns show legend run labels yr.label show year along trajectory yr.int year intervals along trajectory verbose Output R console. Default TRUE","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotKobe.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"KOBE phase plot — SSplotKobe","text":"Kobe Quadrant percentages","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotModelcomp.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare Multiple SS Model Estimates — SSplotModelcomp","title":"Compare Multiple SS Model Estimates — SSplotModelcomp","text":"function plot SSB, B-ratio, F, Recruits, /Index Abundance fits multiple SS models. function uses object multiple SS models summarized r4ss::SSsummarize().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotModelcomp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare Multiple SS Model Estimates — SSplotModelcomp","text":"","code":"SSplotModelcomp(   summaryoutput,   plot = TRUE,   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = deprecated(),   use_pdf = FALSE,   models = \"all\",   subplots = c(\"SSB\", \"Bratio\", \"Fvalue\", \"Recruits\", \"Index\", \"RecDevs\"),   brp = c(\"msy\", \"btargs\"),   fmsy = TRUE,   ylabs = c(\"SSB (t)\", expression(SSB/SSB[MSY]), \"Fishing mortality F\",     \"Recruits ('000s)\", \"Index\", \"Recruitment Deviations\"),   endyrvec = \"default\",   xmin = NULL,   indexselect = NULL,   indexUncertainty = TRUE,   col = NULL,   pch = NULL,   lty = 1,   lwd = 2,   tickEndYr = FALSE,   xlim = \"default\",   ylimAdj = 1.05,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"l\",   uncertainty = TRUE,   legend = TRUE,   legendlabels = \"default\",   legendloc = \"topright\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.9,   legendindex = NULL,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   shadecol = NULL,   shadealpha = 0.3,   new = TRUE,   add = FALSE,   mcmcVec = FALSE,   indexQlabel = TRUE,   indexQdigits = 4,   indexfleets = 1 )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotModelcomp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare Multiple SS Model Estimates — SSplotModelcomp","text":"summaryoutput List created r4ss::SSsummarize() plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. models Optional subset models summaryoutput (similar field different name): list created function r4ss::SSsummarize. Either \"\" vector numbers indicating columns summary tables. subplots option \"SSB\",\"Bratio\",\"Fvalue\",\"Recruits\",\"Index\" \"SSB\" Spawning Stock Biomass \"Bratio\" Stock Biomass relative biomass reference point \"Fvalue\" Fishing Mortality \"Recruits\" Age-0 Recruits \"Index\" Index abundance \"RecDev\" Recruitment Deviations brp option set reference point c(\"msy\",\"btargs\") fmsy specify Fvalue F/Fmsy starter file setting ylabs yaxis labels quants final year values show model. default set endyrvec Optional single year vector years representing final year values show model. \"default\" set ending year specified model. xmin NULL optional number first year shown plot (available) indexselect Vector fleet numbers model compare indexUncertainty Show fixed uncertainty intervals index (estimated) col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot. uncertainty Logical flag enable plots uncertainty intervals. Either single TRUE/FALSE value, vector TRUE/FALSE values around SSB F estimated timeseries, set integers corresponding choice models. legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels legendindex Allows add legend selected indices (plots) pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console shadecol uncertainty shading hcxval horizon shadealpha Transparency adjustment used make default shadecol new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs mcmcVec Logical vector TRUE/FALSE values (single value) indicating whether input values MCMC use normal distribution around MLE. indexQlabel Logical. TRUE add catchability legend plot index fits (currently used) indexQdigits Number significant digits catchability legend indexfleets Fleet numbers model compare indices abundance. Can take different forms: integer (default): create single comparison plot chosen index NULL: create separate plot index long fleet numbering across models. vector length equal number models: single fleet number model compared single plot list: list fleet numbers associated indices within model compared, list elements vector length names list elements matter can absent.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotModelcomp.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Compare Multiple SS Model Estimates — SSplotModelcomp","text":"Mostly adopted r4ss::SSplotComparisons Taylor et al","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRetro.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrospective-Forecast with One-Step Ahead Hindcasting — SSplotRetro","title":"Retrospective-Forecast with One-Step Ahead Hindcasting — SSplotRetro","text":"Plots retrospective pattern, including (optional) one-step ahead forecast computes Mohn's Rho","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRetro.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrospective-Forecast with One-Step Ahead Hindcasting — SSplotRetro","text":"","code":"SSplotRetro(   summaryoutput,   subplots = c(\"SSB\", \"F\"),   plot = TRUE,   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = deprecated(),   use_pdf = FALSE,   models = \"all\",   endyrvec = \"default\",   xlim = NULL,   xmin = NULL,   labels = NULL,   ylim = NULL,   forecast = TRUE,   forecastrho = TRUE,   showrho = TRUE,   col = NULL,   pch = NULL,   lty = 1,   lwd = 2,   tickEndYr = TRUE,   ylimAdj = 1.05,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"o\",   uncertainty = TRUE,   legend = TRUE,   legendlabels = \"default\",   legendloc = \"topright\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.7,   legendindex = NULL,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   shadecol = grey(0.4, 0.6),   new = TRUE,   add = FALSE,   mcmcVec = FALSE,   shadecol1 = grey(0.5, 0.4),   indexQlabel = TRUE,   indexQdigits = 4,   shadealpha = 0.3 )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRetro.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrospective-Forecast with One-Step Ahead Hindcasting — SSplotRetro","text":"summaryoutput List created r4ss::SSsummarize() subplots Optional vector subplots created: \"SSB\" Spawning Stock Biomass \"F\" Fishing Mortality plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. models Optional subset models summaryoutput (similar field different name): list created function r4ss::SSsummarize. Either \"\" vector numbers indicating columns summary tables. endyrvec Optional single year vector years representing final year values show model. default set ending year specified model. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. xmin optional minimum year shown plot (default first yr) labels yaxis label biomass (bony fish sharks) ylim option specify ylim range forecast Logical. TRUE, one-step ahead forecasts shown plot forecastrho Logical. TRUE, one-step ahead forecast rho value denoted plot showrho Logical flag include Mohn's rho value. Defaults TRUE col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot. uncertainty Logical flag enable plots uncertainty intervals. Either single TRUE/FALSE value, vector TRUE/FALSE values around SSB F estimated timeseries, set integers corresponding choice models. legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels legendindex Allows add legend selected indices (plots) pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console shadecol uncertainty shading hcxval horizon new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs mcmcVec Logical vector TRUE/FALSE values (single value) indicating whether input values MCMC use normal distribution around MLE. shadecol1 uncertainty shading early years affected hindcast indexQlabel Logical. TRUE, add catchability legend plot index fits (currently used) indexQdigits Number significant digits catchability legend shadealpha set transparency level (alpha) area uncertainty. Defaults 0.3 (currently used)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRetro.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Retrospective-Forecast with One-Step Ahead Hindcasting — SSplotRetro","text":"Henning Winker (JRC-EC) Laurance Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRunstest.html","id":null,"dir":"Reference","previous_headings":"","what":"Residual Diagnostics — SSplotRunstest","title":"Residual Diagnostics — SSplotRunstest","text":"Function residual diagnostics. Plots residuals 3x sigma limits indices mean age length outputs runs test table. Note, want plot residuals, use SSrunstest().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRunstest.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Residual Diagnostics — SSplotRunstest","text":"","code":"SSplotRunstest(   ss3rep,   mixing = \"less\",   subplots = c(\"cpue\", \"len\", \"age\", \"size\", \"con\")[1],   plot = TRUE,   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = deprecated(),   use_pdf = FALSE,   indexselect = NULL,   miny = 1,   col = NULL,   pch = 21,   lty = 1,   lwd = 2,   tickEndYr = FALSE,   xlim = \"default\",   ylim = \"default\",   ylimAdj = 1.4,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"o\",   legend = TRUE,   legendloc = \"top\",   legendcex = 1,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   new = TRUE,   add = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRunstest.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Residual Diagnostics — SSplotRunstest","text":"ss3rep Stock Synthesis output read r4ss::SS_output() mixing c(\"less\",\"greater\",\"two.sided\"). Default less checking positive autocorrelation subplots optional flag : \"cpue\" Index abundance data \"len\" Length composition data \"size\" Generalized size composition data \"age\" Age composition data \"con\" Conditional age--length data plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. indexselect Vector fleet numbers model compare miny absolute value min max value ylim. Default 1 col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylim Optional, values y-axis range display plot. default: \"default\", range -1 1. ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot. legend Flag enable legend plot. TRUE default. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendcex Allows adjust legend cex pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRunstest.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Residual Diagnostics — SSplotRunstest","text":"dataframe runs test p-value, test passed failed, 3x sigma high low limits, type data used. Rows fleet. Note, runs test passed p-value > 0.05 (residuals random) failed p-value < 0.5 (residuals random)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRunstest.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Residual Diagnostics — SSplotRunstest","text":"Henning Winker (JRC-EC) Laurance Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSreadMCMC.html","id":null,"dir":"Reference","previous_headings":"","what":"Read SS MCMC — SSreadMCMC","title":"Read SS MCMC — SSreadMCMC","text":"function read mcmc file outputs Stock Synthesis model","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSreadMCMC.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Read SS MCMC — SSreadMCMC","text":"","code":"SSreadMCMC(mcmcdir)"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSreadMCMC.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Read SS MCMC — SSreadMCMC","text":"mcmcdir file path folder derived_posteriors.sso file","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSreadMCMC.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Read SS MCMC — SSreadMCMC","text":"Stock Synthesis mcmc output file","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSreadMCMC.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Read SS MCMC — SSreadMCMC","text":"Henning Winker (JRC-EC) & Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSretroComps.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Composition Data from Multiple SS Models — SSretroComps","title":"Retrieve Composition Data from Multiple SS Models — SSretroComps","text":"Wrapper get observed expected mean length/age multiple Stock Synthesis models.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSretroComps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Composition Data from Multiple SS Models — SSretroComps","text":"","code":"SSretroComps(retroModels)"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSretroComps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Composition Data from Multiple SS Models — SSretroComps","text":"retroModels object list replists r4ss::SSgetoutput()","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSretroComps.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Composition Data from Multiple SS Models — SSretroComps","text":"list observed expected mean Length/age comps (c.f. ss3rep[[\"cpue\"]])","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSretroComps.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Retrieve Composition Data from Multiple SS Models — SSretroComps","text":"Henning Winker","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrmse.html","id":null,"dir":"Reference","previous_headings":"","what":"Function for calculating RMSE\nused for SSplotJABBAres() — SSrmse","title":"Function for calculating RMSE\nused for SSplotJABBAres() — SSrmse","text":"Function calculating RMSE used SSplotJABBAres()","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrmse.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Function for calculating RMSE\nused for SSplotJABBAres() — SSrmse","text":"","code":"SSrmse(   ss3rep,   quants = c(\"cpue\", \"len\", \"age\", \"con\"),   seas = NULL,   indexselect = NULL )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrmse.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Function for calculating RMSE\nused for SSplotJABBAres() — SSrmse","text":"ss3rep output SS_output() quants dataset calculate RMSE . \"cpue\" index abundance, \"len\" length comp, \"age\" age composition, \"con\" conditional age--length. seas string indicating treat data multiple seasons 'comb' - combine seasonal data year plot Yr 'sep' - treat season separately, plotting Yr.S. .null(seas), assumed one season option 'comb' used. indexselect Vector fleet numbers model compare","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrmse.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Function for calculating RMSE\nused for SSplotJABBAres() — SSrmse","text":"returns list includes RMSE table output (fleet combined) dataframe residuals can used creating SSplotJABBAres() plot","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrunstest.html","id":null,"dir":"Reference","previous_headings":"","what":"Residual Diagnostics Plot — SSrunstest","title":"Residual Diagnostics Plot — SSrunstest","text":"Function residual diagnostics. Outputs runs test table gives runs test p-values, runs test passed (p-value > 0.05, residuals random) failed (p-value < 0.05, residuals random), 3x sigma limits indices mean age length type input data (cpue, length comp, age comp, size comp, conditional age--length).","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrunstest.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Residual Diagnostics Plot — SSrunstest","text":"","code":"SSrunstest(   ss3rep,   mixing = \"less\",   quants = c(\"cpue\", \"len\", \"age\", \"con\")[1],   indexselect = NULL,   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrunstest.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Residual Diagnostics Plot — SSrunstest","text":"ss3rep Stock Synthesis output read r4ss::SS_output() mixing c(\"less\",\"greater\",\"two.sided\"). Default less checking positive autocorrelation quants optional use c(\"cpue\",\"len\",\"age\",\"con\"), default uses \"cpue\". \"cpue\" Index abundance data \"len\" Length composition data \"age\" Age composition data \"con\" Conditional age--length data indexselect Vector fleet numbers model compare verbose Report progress R GUI?","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrunstest.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Residual Diagnostics Plot — SSrunstest","text":"dataframe runs test p-value, test passed failed, 3x sigma high low limits, type data used. Rows fleet. Note, runs test passed p-value > 0.05 (residuals random) failed p-value < 0.5 (residuals random)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrunstest.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Residual Diagnostics Plot — SSrunstest","text":"Henning Winker (JRC-EC) Laurance Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSsettingsBratioF.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Stock Status Settings — SSsettingsBratioF","title":"Get Stock Status Settings — SSsettingsBratioF","text":"function get Bratio F settings","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSsettingsBratioF.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Stock Status Settings — SSsettingsBratioF","text":"","code":"SSsettingsBratioF(ss3rep, status = c(\"Bratio\", \"F\"), verbose = TRUE)"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSsettingsBratioF.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Stock Status Settings — SSsettingsBratioF","text":"ss3rep r4ss::SSgetoutput() status covarying stock status quantaties extract Hessian verbose Report progress R GUI?","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSsettingsBratioF.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Stock Status Settings — SSsettingsBratioF","text":"output list Bratio F settings","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSsettingsBratioF.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Get Stock Status Settings — SSsettingsBratioF","text":"Henning Winker (JRC-EC)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ensemble_plot_index.html","id":null,"dir":"Reference","previous_headings":"","what":"Plot Indices — ensemble_plot_index","title":"Plot Indices — ensemble_plot_index","text":"function plot different fits single index abundance","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ensemble_plot_index.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plot Indices — ensemble_plot_index","text":"","code":"ensemble_plot_index(   summaryoutput,   varlist,   indexfleets = 1,   verbose = TRUE,   legendloc = \"topright\",   legendcex = 1,   legendsp = 0.9,   legendncol = 1,   type = \"l\" )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ensemble_plot_index.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plot Indices — ensemble_plot_index","text":"summaryoutput summaryoutput varlist variable list indexfleets Fleet vector index verbose Option output messages Rconsole legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See ?legend info string options. legendcex Allows adjust legend cex legendsp Space legend labels legendncol Number columns legend. type Type parameter passed points (default 'o' overplots points top lines)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":null,"dir":"Reference","previous_headings":"","what":"Runs Test for Residuals — ssruns_sig3","title":"Runs Test for Residuals — ssruns_sig3","text":"function uses randtests::runs.test perform runs test residuals determine randomly distributed. also calculates 3 x sigma limits","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Runs Test for Residuals — ssruns_sig3","text":"","code":"ssruns_sig3(x, type = NULL, mixing = \"less\")"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Runs Test for Residuals — ssruns_sig3","text":"x residuals CPUE fits type c(\"resid\",\"observations\") mixing c(\"less\",\"greater\",\"two.sided\"). Default less checking positive autocorrelation ","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Runs Test for Residuals — ssruns_sig3","text":"runs p value 3 x sigma limits","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Runs Test for Residuals — ssruns_sig3","text":"runs test conducted library(randtests)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Runs Test for Residuals — ssruns_sig3","text":"Henning Winker (JRC-EC) Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-210","dir":"Changelog","previous_headings":"","what":"ss3diags 2.1.0","title":"ss3diags 2.1.0","text":"RMSE calculations modularized standalone function can called independently SSplotJABBAres() SSrmse(). (#50) Bugfixes adjusting y-axis limits SSplotRunstest SSplotJABBAres: Use ylim parameter adjust y-axis limits. (#46) Added option remove median trajectory SSplotKobe() (#3) Added rlang, dplyr, magrittr dependencies. SSmase SSplotHcxval: Corrected validation messsage clarify validation issue fix issue code styler. (#33, #35) Added Date field DESCRIPTION. DESCRIPTION metadata now used generate package citations. (#25) Package vingettes formatted html_vignette reduce file size. Removed redundant PDF word document versions ss3diags_Handbook vignette. Enabled markdown support roxygen. Enabled Cross-reference links.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-203","dir":"Changelog","previous_headings":"","what":"ss3diags 2.0.3","title":"ss3diags 2.0.3","text":"Changed r4ss dependency 1.44.0 (CRAN version) . Replaced default R CMD CHECK workflow NOAA-fish-tools/ghactions4r’s version. Fixed Ensemble Quantile Shading Issues (#4) Replaced example datasets ss3diags cookbook, handbook current “simple” ensemble model. Fixup minor code documentation formatting issues. SSmase SSplotHcxval: Fixed code styler’s dollar subset conversion issues. example:`message(‘x$name 1,2,3,4’)`","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-202","dir":"Changelog","previous_headings":"","what":"ss3diags 2.0.2","title":"ss3diags 2.0.2","text":"Changed r4ss CRAN version (1.36.1) dependency development version legendfun -> r4ss::add_legend pngfun -> r4ss::save_png rc -> r4ss::rich_colors_short sspar -> r4ss::sspar Fix SSplotRetro.R indention causing issues code styler","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-201","dir":"Changelog","previous_headings":"","what":"ss3diags 2.0.1","title":"ss3diags 2.0.1","text":"Change SSplotJABBAres show combined seasonal data boxplots Fixup links Cookbook sripts. Formatted DESCRIPTION URL BugReports links PIFSCstockassessments repo add R package site.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-200","dir":"Changelog","previous_headings":"","what":"ss3diags 2.0.0","title":"ss3diags 2.0.0","text":"simple, cod-like, Stock Synthesis model, simulated via ss3sim, replaces Pacific North Hake (pac.hke) North Atlantic Shortfin Mako Shark (natl.sma) example datasets. SSplotRetro: fixed bug shading uncertainty area shows xlims specified. SSplotJABBAres: added ‘con’ option subplots argument conditional age--length data can plotted. Also added seas argument user can specify data combined across seasons within year kept separate. SScompsTA1.8: added seas argument users can specify data combined across seasons within year kept separate. SSplot functions (SSplotModelComp, SSplotEnsemble, SSplotHCxval, SSplotJABBAres, SSplotRetro): Marked plot, png, pdf, print, new deprecated. defunct future version. Added NEWS.md file track changes package.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-108","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.8","title":"ss3diags 1.0.8","text":"Fixed MASE","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-107","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.7","title":"ss3diags 1.0.7","text":"Bug fixes","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-106","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.6","title":"ss3diags 1.0.6","text":"Improved SSdiagsMCMC","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-105","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.5","title":"ss3diags 1.0.5","text":"Updated SSdeltaMVLN","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-104","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.4","title":"ss3diags 1.0.4","text":"Reference: authors changes","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-103","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.3","title":"ss3diags 1.0.3","text":"Added annF_ quantaties","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-102","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.2","title":"ss3diags 1.0.2","text":"Added aut","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-101","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.1","title":"ss3diags 1.0.1","text":"Added SSplotH","code":""}]
+[{"path":"https://pifscstockassessments.github.io/ss3diags/CODE_OF_CONDUCT.html","id":null,"dir":"","previous_headings":"","what":"Code of Conduct","title":"Code of Conduct","text":"follow NFMS Fisheries Toolbox Code Conduct. NFMS Fisheries Toolbox Code Conduct adapted Contributor Covenant, version 1.4, available https://www.contributor-covenant.org/version/1/4/code--conduct.html answers common questions code conduct, see https://www.contributor-covenant.org/faq","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/CONTRIBUTING.html","id":null,"dir":"","previous_headings":"","what":"Contributing to ss3diags","title":"Contributing to ss3diags","text":"Thank interest contributing! strive follow NMFS Fisheries Toolbox Contribution Guide. Note guidelines, rules, open collaborations ways may work better . Please feel free reach us opening issue repository emailing project maintatainer megumi.oshima@noaa.gov. project everyone participating governed NMFS Fisheries Toolbox Code Conduct. participating, expected uphold code. Please report unacceptable behavior fisheries.toolbox@noaa.gov. Note maintainers ss3diags access email account, unacceptable behavior maintainers can also reported .","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Jitter.html","id":"model-inputs","dir":"Articles","previous_headings":"","what":"Model inputs","title":"Jitter Analysis","text":"run Stock Synthesis model, four input files required: starter.ss, forecast.ss, control.ss, data.ss. input files example model can found within ss3diags package accessed shown . Also, r4ss package installed, need install tutorial. need make sure SS executable file either path directory running retrospective (case dir_jitter). easy way get latest release stock synthesis use r4ss function get_ss3_exe(). run model dir_jitter first produce necessary output files. recommended jitter runs subdirectory model run. keep output files separate diagnostic tests may run.","code":"install_github(\"r4ss/r4ss\") library(r4ss)  files_path <- system.file(\"extdata\", package = \"ss3diags\") dir_jitter <- file.path(tempdir(check = TRUE), \"jitter\") dir.create(dir_jitter, showWarnings = FALSE, recursive = TRUE) list.files(files_path) #> [1] \"control.ss\"  \"data.ss\"     \"forecast.ss\" \"starter.ss\" file.copy(from = list.files(files_path, full.names = TRUE), to = dir_jitter) #> [1] TRUE TRUE TRUE TRUE r4ss::get_ss3_exe(dir = dir_jitter, version = \"v3.30.21\") #> The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/Rtmp2ZDhQV/jitter/ss3 r4ss::run(dir = dir_jitter, exe = \"ss3\", verbose = FALSE) #> [1] \"ran model\""},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Jitter.html","id":"jitter","dir":"Articles","previous_headings":"","what":"Jitter","title":"Jitter Analysis","text":"example, run 50 jitters. jitter() function automates entire process need give arguments run produce total likelihoods run. Full documentation jitter() function can found r4ss website. analyze output 50 runs, use r4ss::SSgetoutput() r4ss::SSsummarize() shown . key sections may want check compare across models , likelihoods, derived quantities, estimated parameters. may also want check models converged. can check maximum gradients make sure small (< 0.0001). can also compare estimated spawning biomass, extreme values (+2x <0.5x base spawning biomass) suggests model didn’t converge.","code":"Njitter <- 50 jit.likes <- r4ss::jitter(   dir = dir_jitter,   Njitter = Njitter,   init_values_src = 1,   jitter_fraction = 0.1,   exe = \"ss3\",   printlikes = FALSE,   verbose = FALSE ) jit_mods <- SSgetoutput(   keyvec = 0:Njitter, # 0 to include reference run (Report0.sso)   getcomp = FALSE,   dirvec = dir_jitter,   getcovar = FALSE,   verbose = FALSE ) jit_summary <- SSsummarize(jit_mods, verbose = FALSE) head(jit_summary$likelihoods) #>       replist0     replist1     replist2     replist3     replist4     replist5 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>       replist6     replist7     replist8     replist9    replist10    replist11 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist12    replist13    replist14    replist15    replist16    replist17 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist18    replist19    replist20    replist21    replist22    replist23 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74853e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist24    replist25    replist26    replist27    replist28    replist29 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33480e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist30    replist31    replist32    replist33    replist34    replist35 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist36    replist37    replist38    replist39    replist40    replist41 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33480e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist42    replist43    replist44    replist45    replist46    replist47 #> 1  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02  7.54302e+02 #> 2  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10  1.33479e-10 #> 3  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01  1.74852e-01 #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 -7.11813e+00 #> 5  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02  3.66756e+02 #> 6  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02  2.31845e+02 #>      replist48    replist49    replist50       Label #> 1  7.54302e+02  7.54302e+02  7.54302e+02       TOTAL #> 2  1.33479e-10  1.33479e-10  1.33479e-10       Catch #> 3  1.74853e-01  1.74852e-01  1.74852e-01 Equil_catch #> 4 -7.11813e+00 -7.11813e+00 -7.11813e+00      Survey #> 5  3.66756e+02  3.66756e+02  3.66756e+02 Length_comp #> 6  2.31845e+02  2.31845e+02  2.31845e+02    Age_comp head(jit_summary$quants) #>   replist0 replist1 replist2 replist3 replist4 replist5 replist6 replist7 #> 1  54773.8  54773.8  54773.8  54773.8  54773.8  54773.8  54773.8  54773.8 #> 2  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4 #> 3  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4  26071.4 #> 4  24096.1  24096.1  24096.1  24096.1  24096.1  24096.1  24096.1  24096.1 #> 5  22126.1  22126.1  22126.1  22126.1  22126.1  22126.1  22126.1  22126.1 #> 6  20143.5  20143.5  20143.5  20143.5  20143.5  20143.5  20143.5  20143.5 #>   replist8 replist9 replist10 replist11 replist12 replist13 replist14 replist15 #> 1  54773.8  54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2  26071.4  26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3  26071.4  26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4  24096.1  24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5  22126.1  22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6  20143.5  20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>   replist16 replist17 replist18 replist19 replist20 replist21 replist22 #> 1   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>   replist23 replist24 replist25 replist26 replist27 replist28 replist29 #> 1   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>   replist30 replist31 replist32 replist33 replist34 replist35 replist36 #> 1   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>   replist37 replist38 replist39 replist40 replist41 replist42 replist43 #> 1   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>   replist44 replist45 replist46 replist47 replist48 replist49 replist50 #> 1   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8   54773.8 #> 2   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 3   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4   26071.4 #> 4   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1   24096.1 #> 5   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1   22126.1 #> 6   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5   20143.5 #>         Label   Yr #> 1  SSB_Virgin   NA #> 2 SSB_Initial   NA #> 3    SSB_2011 2011 #> 4    SSB_2012 2012 #> 5    SSB_2013 2013 #> 6    SSB_2014 2014 head(jit_summary$pars) #>    replist0  replist1  replist2  replist3  replist4  replist5  replist6 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>    replist7  replist8  replist9 replist10 replist11 replist12 replist13 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist14 replist15 replist16 replist17 replist18 replist19 replist20 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist21 replist22 replist23 replist24 replist25 replist26 replist27 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist28 replist29 replist30 replist31 replist32 replist33 replist34 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist35 replist36 replist37 replist38 replist39 replist40 replist41 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist42 replist43 replist44 replist45 replist46 replist47 replist48 #> 1  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 2 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 22.769000 #> 3 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 71.807200 #> 4  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165  0.142165 #> 5  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #> 6  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000  0.100000 #>   replist49 replist50                 Label Yr recdev #> 1  0.100000  0.100000 NatM_uniform_Fem_GP_1 NA  FALSE #> 2 22.769000 22.769000    L_at_Amin_Fem_GP_1 NA  FALSE #> 3 71.807200 71.807200    L_at_Amax_Fem_GP_1 NA  FALSE #> 4  0.142165  0.142165    VonBert_K_Fem_GP_1 NA  FALSE #> 5  0.100000  0.100000     CV_young_Fem_GP_1 NA  FALSE #> 6  0.100000  0.100000       CV_old_Fem_GP_1 NA  FALSE # Maximum gradient converged_grad <- which(jit_summary$maxgrad < 0.0001)  converged_ssb <- jit_summary$SpawnBio %>%   mutate(across(c(1:(Njitter + 1)),     .fns = ~ . / replist0   )) %>% # for each column, divide SSB by SSB from the reference run (replist)   select(-Label) %>%   pivot_longer(col = c(1:(Njitter + 1)), names_to = \"jitter\", values_to = \"SSB\") %>%   pivot_wider(names_from = Yr, values_from = SSB) %>%   mutate(rownumber = seq(1, nrow(.))) %>%   tibble::column_to_rownames(\"jitter\") %>%   filter_at(vars(1:(ncol(.) - 1)), all_vars((.) < 2 & (.) > 0.5)) %>% # keep only rows where SSB is a reasonable value   select(rownumber) %>%   pull(rownumber) converged_mods <- intersect(converged_grad, converged_ssb) # getting which models are in both groups converged_jitters <- jit_mods[converged_grad] converged_sum <- SSsummarize(converged_jitters, verbose = FALSE)"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Jitter.html","id":"visualizing-output","dir":"Articles","previous_headings":"","what":"Visualizing Output","title":"Jitter Analysis","text":"compare likelihoods runs, plot shown . built functions (writing vignette) r4ss ss3diags generate likelihood plot, therefore provide code tidyverse syntax (using ggplot2) visualize results.  figure plots total likelihood jitter run red line indicates total likelihood value reference run. runs points red line, use converged parameter values run lowest likelihood value starting values base model. can also use r4ss::SSplotComparisons() compare spawning biomass trajectories jitter runs see impact different parameter values estimated quantities.","code":"converged_sum$likelihoods %>%   filter(str_detect(Label, \"TOTAL\")) %>%   select(-Label) %>%   pivot_longer(cols = everything(), names_to = \"jitter\", values_to = \"likelihood\") %>%   separate(jitter, into = c(\"replist\", \"jitter\"), sep = \"(?<=[A-Za-z])(?=[0-9])\") %>%   mutate(jitter = as.numeric(jitter)) %>%   ggplot(aes(x = jitter, y = likelihood)) +   geom_point(size = 3) +   geom_hline(aes(yintercept = likelihood[1]), color = \"red\") +   theme_classic() +   labs(     y = \"Total Likelihood\",     x = \"Jitter runs at a converged solution\"   ) SSplotComparisons(converged_sum,   subplots = 2,   ylimAdj = 1,   new = FALSE ) #> showing uncertainty for all models #> subplot 2: spawning biomass with uncertainty intervals"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Retrospective-Analysis.html","id":"model-inputs","dir":"Articles","previous_headings":"","what":"Model inputs","title":"Retrospective Analysis","text":"run stock synthesis model, 4 input files required: starter.ss, forecast.ss, control.ss, data.ss. input files example model can found within ss3diags package accessed shown . Also, r4ss package installed, need install tutorial. need make sure SS executable file either path directory running retrospective (case dir_retro). easy way get latest release stock synthesis use r4ss function get_ss3_exe().","code":"install.packages(\"pak\") pak::pkg_install(\"r4ss/r4ss\") library(r4ss)  files_path <- system.file(\"extdata\", package = \"ss3diags\") dir_retro <- file.path(tempdir(check = TRUE), \"retrospectives\") dir.create(dir_retro, showWarnings = FALSE) list.files(files_path) #> [1] \"control.ss\"  \"data.ss\"     \"forecast.ss\" \"starter.ss\" file.copy(from = list.files(files_path, full.names = TRUE), to = dir_retro) #> [1] TRUE TRUE TRUE TRUE r4ss::get_ss3_exe(dir = dir_retro, version = \"v3.30.21\") #> The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/RtmpWMaip6/retrospectives/ss3"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Retrospective-Analysis.html","id":"retrospective-analysis","dir":"Articles","previous_headings":"","what":"Retrospective Analysis","title":"Retrospective Analysis","text":"4 input files SS executable file, can run retrospective analysis shown . running five one-year peels, run, one five years data removed reference model model re-run total five times (.e. peel 1 removes last year data, peel 2 removes last 2 years data, etc.) . number year peels can adjusted years argument. SS executable file using named something “ss3” (e.g. ss_opt_win.exe), need specify argument exe = \"ss_opt_win\". Full documentation retro() function can found r4ss website.","code":"r4ss::retro(dir = dir_retro, exe = \"ss3\", years = 0:-5, verbose = FALSE) #> Warning in base::sink(type = \"output\", split = FALSE): no sink to remove"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Retrospective-Analysis.html","id":"visualizing-output","dir":"Articles","previous_headings":"","what":"Visualizing Output","title":"Retrospective Analysis","text":"visualize outputted results inspect retrospective patterns, need load report files R use SSplotRetro() function ss3diags. easiest way load multiple report files using r4ss::SSgetoutput() r4ss::SSsummarize() functions. default sub-directories peel, 0 5, labeled retro0 retro-5.  default settings plot spawning stock biomass time series peel, reference run (.e. original, full time series model) “Ref” line successive peel colored lines labeled terminal year value. solid line ends terminal year followed dashed line extending circle representing one year forecast estimate. Displaying projected SSB value helps assessing forecast bias. note, forecasts done automatically using r4ss::retro() based settings forecast.ss. grey shaded area represents 95% confidence intervals uncertainty around spawning biomass time series. Displayed center plot combined Mohn’s \\(\\rho\\) retrospective runs, parentheses forecast Mohn’s \\(\\rho\\).","code":"retro_mods <- r4ss::SSgetoutput(dirvec = file.path(dir_retro, \"retrospectives\", paste0(\"retro\", seq(0, -5, by = -1))), verbose = F) retroSummary <- r4ss::SSsummarize(retro_mods, verbose = F) SSplotRetro(retroSummary, subplots = \"SSB\", add = TRUE) #> Mohn's Rho stats, including one step ahead forecasts: #>   type     peel         Rho  ForecastRho #> 1  SSB     2021 -0.20753686 -0.221050163 #> 2  SSB     2020 -0.19601072 -0.227304734 #> 3  SSB     2019 -0.29238505 -0.338600758 #> 4  SSB     2018 -0.00474920 -0.007462034 #> 5  SSB     2017  0.08716428  0.098849082 #> 6  SSB Combined -0.12270351 -0.139113722"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Retrospective-Analysis.html","id":"customizing-the-plot","dir":"Articles","previous_headings":"Visualizing Output","what":"Customizing the Plot","title":"Retrospective Analysis","text":"Retro plots can customized many ways, common features may want specify : removing uncertainty intervals adjusting years shown x-axis turning 1-year ahead forecasting displaying combined \\(\\rho\\) value plot Examples changes shown , incrementally making adjustment.  Additionally, fishing mortality can plotted instead spawning biomass replacing subplots = \"SSB\" subplots = \"F\"","code":"r4ss::sspar(mfrow = c(2, 2), plot.cex = 0.8) retro1 <- SSplotRetro(retroSummary, subplots = \"SSB\", add = TRUE, uncertainty = FALSE) #> Mohn's Rho stats, including one step ahead forecasts: retro2 <- SSplotRetro(retroSummary, subplots = \"SSB\", add = TRUE, uncertainty = FALSE, xlim = c(2015, 2022)) #> Mohn's Rho stats, including one step ahead forecasts: retro3 <- SSplotRetro(retroSummary, subplots = \"SSB\", add = TRUE, uncertainty = FALSE, xlim = c(2015, 2022), forecast = FALSE) #> Mohn's Rho stats, including one step ahead forecasts: retro4 <- SSplotRetro(retroSummary, subplots = \"SSB\", add = TRUE, uncertainty = FALSE, xlim = c(2015, 2022), forecast = FALSE, showrho = FALSE, forecastrho = FALSE) #> Mohn's Rho stats, including one step ahead forecasts:"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/Retrospective-Analysis.html","id":"summary-table","dir":"Articles","previous_headings":"Visualizing Output","what":"Summary Table","title":"Retrospective Analysis","text":"addition retrospective plots, summary statistics table can produced using SShcbias(). table includes type estimate (SSB F) year removed “peel” Mohn’s \\(\\rho\\) forecast bias year overall (“Combined”). Mohn’s \\(\\rho\\) measure severity bias retrospective patterns forecast bias estimate bias forecasted quantities years data removed. rule thumb proposed Hurtado-Ferror et al. (2014) Mohn’s \\(\\rho\\) values long-lived species, \\(\\rho\\) value fall -0.15 0.20.","code":"SShcbias(retroSummary) #> Mohn's Rho stats, including one step ahead forecasts: #>    type     peel         Rho   ForcastRho #> 1   SSB     2021 -0.20753686 -0.221050163 #> 2   SSB     2020 -0.19601072 -0.227304734 #> 3   SSB     2019 -0.29238505 -0.338600758 #> 4   SSB     2018 -0.00474920 -0.007462034 #> 5   SSB     2017  0.08716428  0.098849082 #> 6   SSB Combined -0.12270351 -0.139113722 #> 7     F     2021  0.28425747  0.285936183 #> 8     F     2020  0.30941305  0.349748774 #> 9     F     2019  0.52629045  0.632574831 #> 10    F     2018  0.01822898  0.022822958 #> 11    F     2017 -0.04896989 -0.053882358 #> 12    F Combined  0.21784401  0.247440078"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"model-inputs","dir":"Articles","previous_headings":"","what":"Model inputs","title":"ASPM","text":"run Stock Synthesis model, four input files required: starter.ss, forecast.ss, control.ss, data.ss. input files example model can found within ss3diags package accessed shown . Also, r4ss package installed, need install tutorial. need make sure SS executable file either path directory running ASPM (case dir_aspm). easy way get latest release stock synthesis use r4ss function get_ss3_exe().","code":"install.packages(\"pak\") pak::pkg_install(\"r4ss/r4ss\") library(r4ss)  files_path <- system.file(\"extdata\", package = \"ss3diags\") dir_tmp <- tempdir(check = TRUE) dir_aspm <- file.path(dir_tmp, \"aspm\") dir.create(dir_aspm, showWarnings = FALSE, recursive = TRUE) list.files(files_path) ## [1] \"control.ss\"  \"data.ss\"     \"forecast.ss\" \"starter.ss\" file.copy(from = list.files(files_path, full.names = TRUE), to = dir_tmp) ## [1] TRUE TRUE TRUE TRUE r4ss::get_ss3_exe(dir = dir_tmp, version = \"v3.30.21\") ## The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/RtmpOZxxeY/ss3"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"aspm","dir":"Articles","previous_headings":"","what":"ASPM","title":"ASPM","text":"4 input files, need determine components need turned run ASPM. ASPM depend index abundance catch data, composition data, recruitment deviations, etc. need turned . provide example includes multiple types data recruitment deviations, however, exact steps necessary individual model may vary depending complexity components included. Therefore steps may fully comprehensive model sure check components may need change. , show use r4ss functions make necessary changes control.ss ss.par files.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"generate-files","dir":"Articles","previous_headings":"ASPM","what":"Generate files","title":"ASPM","text":"order get ss.par file, need run model . also produce new data control file use input files. run model dir_tmp copy new files dir_aspm.","code":"r4ss::run(dir = dir_tmp, verbose = FALSE, exe = \"ss3\") ## [1] \"ran model\" files <- c(\"data_echo.ss_new\", \"control.ss_new\", \"starter.ss\", \"forecast.ss\", \"ss.par\", \"ss3\") file.copy(from = file.path(dir_tmp, files), to = dir_aspm) ## [1] TRUE TRUE TRUE TRUE TRUE TRUE"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"recruitment-deviations","dir":"Articles","previous_headings":"ASPM","what":"Recruitment Deviations","title":"ASPM","text":"Set recruitment devations ss.par 0.","code":"par <- SS_readpar_3.30(   parfile = file.path(dir_aspm, \"ss.par\"),   datsource = file.path(dir_aspm, \"data_echo.ss_new\"),   ctlsource = file.path(dir_aspm, \"control.ss_new\"),   verbose = FALSE ) par$recdev1 ##       year      recdev ##  [1,] 2011 -0.06005247 ##  [2,] 2012 -0.01284866 ##  [3,] 2013  0.13478706 ##  [4,] 2014  0.11410144 ##  [5,] 2015 -0.08325396 ##  [6,] 2016  0.14556845 ##  [7,] 2017 -0.12973978 ##  [8,] 2018 -0.18308123 ##  [9,] 2019  0.02442762 ## [10,] 2020 -0.08979813 ## [11,] 2021 -0.07812317 ## [12,] 2022  0.21801284 par$recdev_forecast ##       year recdev ##  [1,] 2023      0 ##  [2,] 2024      0 ##  [3,] 2025      0 ##  [4,] 2026      0 ##  [5,] 2027      0 ##  [6,] 2028      0 ##  [7,] 2029      0 ##  [8,] 2030      0 ##  [9,] 2031      0 ## [10,] 2032      0 par$recdev1[, \"recdev\"] <- 0  # Would run if forecasts recdevs were not already 0 # par$recdev_forecast[,\"recdev\"] <- 0 SS_writepar_3.30(   parlist = par,   outfile = file.path(dir_aspm, \"ss.par\"),   overwrite = T, verbose = FALSE ) ## $headerlines ## [1] \"# Number of parameters = 32 Objective function value = 754.301687441726  Maximum gradient component = 8.77017492766611e-07\" ## [2] \"# dummy_parm:\"                                                                                                              ## [3] \"1.00000000000\"                                                                                                              ##  ## $MG_parms ##                            INIT       ESTIM ## NatM_p_1_Fem_GP_1    0.10000000  0.10000000 ## L_at_Amin_Fem_GP_1  22.76900000 22.76899194 ## L_at_Amax_Fem_GP_1  71.80720000 71.80721125 ## VonBert_K_Fem_GP_1   0.14216500  0.14216482 ## CV_young_Fem_GP_1    0.10000000  0.10000000 ## CV_old_Fem_GP_1      0.10000000  0.10000000 ## Wtlen_1_Fem_GP_1     0.00000244  0.00000244 ## Wtlen_2_Fem_GP_1     3.34694000  3.34694000 ## Mat50%_Fem_GP_1     55.00000000 55.00000000 ## Mat_slope_Fem_GP_1  -0.25000000 -0.25000000 ## Eggs_alpha_Fem_GP_1  1.00000000  1.00000000 ## Eggs_beta_Fem_GP_1   0.00000000  0.00000000 ## NatM_p_1_Mal_GP_1    0.00000000  0.00000000 ## L_at_Amin_Mal_GP_1   0.00000000  0.00000000 ## L_at_Amax_Mal_GP_1   0.00000000  0.00000000 ## VonBert_K_Mal_GP_1   0.00000000  0.00000000 ## CV_young_Mal_GP_1    0.00000000  0.00000000 ## CV_old_Mal_GP_1      0.00000000  0.00000000 ## Wtlen_1_Mal_GP_1     0.00000244  0.00000244 ## Wtlen_2_Mal_GP_1     3.34694000  3.34694000 ## CohortGrowDev        1.00000000  1.00000000 ## FracFemale_GP_1      0.50000000  0.50000000 ##  ## $SR_parms ##               INIT    ESTIM ## SR_LN(R0)   8.9274 8.927395 ## SR_BH_steep 0.8000 0.800000 ## SR_sigmaR   0.6000 0.600000 ## SR_regime   0.0000 0.000000 ## SR_autocorr 0.0000 0.000000 ##  ## $recdev1 ##       year recdev ##  [1,] 2011      0 ##  [2,] 2012      0 ##  [3,] 2013      0 ##  [4,] 2014      0 ##  [5,] 2015      0 ##  [6,] 2016      0 ##  [7,] 2017      0 ##  [8,] 2018      0 ##  [9,] 2019      0 ## [10,] 2020      0 ## [11,] 2021      0 ## [12,] 2022      0 ##  ## $recdev_forecast ##       year recdev ##  [1,] 2023      0 ##  [2,] 2024      0 ##  [3,] 2025      0 ##  [4,] 2026      0 ##  [5,] 2027      0 ##  [6,] 2028      0 ##  [7,] 2029      0 ##  [8,] 2030      0 ##  [9,] 2031      0 ## [10,] 2032      0 ##  ## $init_F ## [1] 0.1 ##  ## $Q_parms ##                           INIT      ESTIM ## LnQ_base_SURVEY1(2)   0.476759  0.4767585 ## Q_extraSD_SURVEY1(2)  0.000000  0.0000000 ## LnQ_base_SURVEY2(3)  -6.304070 -6.3040672 ##  ## $S_parms ##                            INIT     ESTIM ## SizeSel_P_1_FISHERY(1) 56.51380 56.513807 ## SizeSel_P_2_FISHERY(1) 20.17930 20.179340 ## SizeSel_P_1_SURVEY1(2) 36.02330 36.023325 ## SizeSel_P_2_SURVEY1(2)  5.33502  5.335021 ## AgeSel_P_1_SURVEY2(3)   0.00000  0.000000 ## AgeSel_P_2_SURVEY2(3)   0.00000  0.000000"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"starter-file","dir":"Articles","previous_headings":"ASPM","what":"Starter File","title":"ASPM","text":"Change starter file read ss.par (init_values_src = 1) use new data control files.","code":"starter <- SS_readstarter(file = file.path(dir_aspm, \"starter.ss\"), verbose = FALSE) starter$datfile <- \"data_echo.ss_new\" starter$ctlfile <- \"control.ss_new\" starter$init_values_src <- 1 SS_writestarter(starter,   dir = dir_aspm,   overwrite = TRUE,   verbose = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"control-file","dir":"Articles","previous_headings":"ASPM","what":"Control File","title":"ASPM","text":"estimation phases following parameters may need changed: length selectivity age selectivity size selectivity steepness sigmaR recruitment deviations Additionally, likelihood components may need turned well. can using lambda options control file. examples include: length-composition data age-composition data size-composition data initial F","code":"control <- SS_readctl_3.30(   file = file.path(dir_aspm, \"control.ss_new\"),   datlist = file.path(dir_aspm, \"data_echo.ss_new\"),   verbose = FALSE )  control$SR_parms ##               LO HI   INIT PRIOR PR_SD PR_type PHASE env_var&link dev_link ## SR_LN(R0)    6.0 12 8.9274  10.3  10.0       0     1            0        0 ## SR_BH_steep  0.2  1 0.8000   0.8   1.0       0    -4            0        0 ## SR_sigmaR    0.0  2 0.6000   0.8   0.8       0    -4            0        0 ## SR_regime   -5.0  5 0.0000   0.0   1.0       0    -4            0        0 ## SR_autocorr  0.0  0 0.0000   0.0   0.0       0   -99            0        0 ##             dev_minyr dev_maxyr dev_PH Block Block_Fxn ## SR_LN(R0)           0         0      0     0         0 ## SR_BH_steep         0         0      0     0         0 ## SR_sigmaR           0         0      0     0         0 ## SR_regime           0         0      0     0         0 ## SR_autocorr         0         0      0     0         0 # Would need to run if PHASES were positive for \"steep\" and \"sigmaR\" # control$SR_parms[c(2,3),\"PHASE\"] <- c(-4,-4) control$age_selex_parms ##                       LO HI INIT PRIOR PR_SD PR_type PHASE env_var&link ## AgeSel_P_1_SURVEY2(3)  0 20    0     5    99       0   -99            0 ## AgeSel_P_2_SURVEY2(3)  0 20    0     6    99       0   -99            0 ##                       dev_link dev_minyr dev_maxyr dev_PH Block Block_Fxn ## AgeSel_P_1_SURVEY2(3)        0         0         0      0     0         0 ## AgeSel_P_2_SURVEY2(3)        0         0         0      0     0         0 # would need to run if PHASES were positive for age selectivity # control$age_selex_parms[,\"PHASE\"] <- control$age_selex_parms[,\"PHASE\"] * -1 control$size_selex_parms[, \"PHASE\"] <- control$size_selex_parms[, \"PHASE\"] * -1 control$recdev_early_phase <- -4 control$recdev_phase <- -2  new_lambdas <- data.frame(   like_comp = c(4, 4, 5, 5, 7, 7, 9, 9, 9, 10),   fleet = c(1, 2, 1, 2, 1, 2, 1, 2, 3, 1),   phase = rep(1, 10),   value = rep(0, 10),   sizefreq_method = rep(1, 10) ) new_lambdas ##    like_comp fleet phase value sizefreq_method ## 1          4     1     1     0               1 ## 2          4     2     1     0               1 ## 3          5     1     1     0               1 ## 4          5     2     1     0               1 ## 5          7     1     1     0               1 ## 6          7     2     1     0               1 ## 7          9     1     1     0               1 ## 8          9     2     1     0               1 ## 9          9     3     1     0               1 ## 10        10     1     1     0               1 control$lambdas <- new_lambdas control$N_lambdas <- nrow(new_lambdas) SS_writectl_3.30(control,   outfile = file.path(dir_aspm, \"control.ss_new\"),   overwrite = TRUE, verbose = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"run-aspm","dir":"Articles","previous_headings":"ASPM","what":"Run ASPM","title":"ASPM","text":"","code":"r4ss::run(dir = dir_aspm, exe = \"ss3\", skipfinished = FALSE, verbose = FALSE) ## [1] \"ran model\""},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/aspm.html","id":"visualize-results","dir":"Articles","previous_headings":"ASPM","what":"Visualize Results","title":"ASPM","text":"compare ASPM model age-structured model, can use SSplotComparisons(). Comparing spawning biomass F estimates two models fits indices abundance can help understand enough information indices inform production function.","code":"mods <- SSgetoutput(dirvec = c(   dir_tmp,   dir_aspm ), verbose = FALSE)  mods_sum <- SSsummarize(mods, verbose = FALSE)  SSplotComparisons(mods_sum,   legendlabels = c(\"Ref\", \"ASPM\"),   subplots = c(2, 8, 14), new = F ) ## showing uncertainty for all models ## subplot 2: spawning biomass with uncertainty intervals ## subplot 8: F value with uncertainty ## subplot 14: index fits on a log scale"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/hcxval.html","id":"visualizing-output","dir":"Articles","previous_headings":"","what":"Visualizing Output","title":"Hindcast Cross-Validation","text":"HCxval implemented using ss3diags::SSplotHCxval(), produces novel HCxval diagnostic plot computes MASE scores indices abundance, mean lengths, mean ages observations falling within hindcast evaluation period.  plots , see , fleets, model fairly good prediction skills index abundance data (compared random walk). plots, white points white dashed line observed data included model truncated time series. larger colored points observed data retrospective peel (.e. data removed peel). smaller colored points dashed lines show model predicted values. “Ref” line model run complete time series data. grey shaded areas represent uncertainty data, darker portion indicating portion included model lighter portion indicating ones removed projected. MASE scores displayed MASE adjusted MASE parentheses.","code":"r4ss::sspar(mfrow = c(1, 2)) SSplotHCxval(retroSummary, subplots = \"cpue\", add = TRUE) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with only 1 of 5  prediction residuals for Index SURVEY1  #>  #>  Warning:  Unequal spacing of naive predictions residuals may influence the interpretation of MASE #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index SURVEY2 #>  #> MASE stats by Index: #>     Index Season      MASE     MAE.PR  MAE.base  MASE.adj n.eval #> 1 SURVEY1      1 0.5026435 0.08879379 0.1766536 0.5026435      1 #> 2 SURVEY2      1 0.6149530 0.37737925 0.6136717 0.6149530      5"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/hcxval.html","id":"composition-data","dir":"Articles","previous_headings":"Visualizing Output","what":"Composition Data","title":"Hindcast Cross-Validation","text":"visualize mean length mean age, need add additional step. forecast length- age-composition information stored “ghost files” SS report.sso file, need use ss3diags::SSretroComps() extract summarize information creating plots.","code":"retroSummary_comps <- SSretroComps(retro_mods)  r4ss::sspar(mfrow = c(1, 2)) hcl <- SSplotHCxval(retroSummary_comps, subplots = \"len\", add = TRUE, ylim = c(40, 75)) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index FISHERY #>  #>  Computing MASE with only 1 of 5  prediction residuals for Index SURVEY1  #>  #>  Warning:  Unequal spacing of naive predictions residuals may influence the interpretation of MASE #>  #> MASE stats by Index:"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/hcxval.html","id":"customizing-the-plot","dir":"Articles","previous_headings":"Visualizing Output","what":"Customizing the Plot","title":"Hindcast Cross-Validation","text":"HCxval plots can customized many ways, common features may want specify : displaying specific fleet removing uncertainty intervals adjusting x- y-axis displaying adjusted MASE value plot Examples changes shown , incrementally making adjustment.","code":"r4ss::sspar(mfrow = c(2, 2)) SSplotHCxval(retroSummary_comps, subplots = \"len\", add = TRUE, indexselect = 1) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index FISHERY #>  #> MASE stats by Index: #>     Index Season      MASE     MAE.PR   MAE.base  MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.1034467      5 SSplotHCxval(retroSummary_comps,   subplots = \"len\", add = TRUE,   indexselect = 1, indexUncertainty = FALSE ) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index FISHERY #>  #> MASE stats by Index: #>     Index Season      MASE     MAE.PR   MAE.base  MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.1034467      5 SSplotHCxval(retroSummary_comps,   subplots = \"len\", add = TRUE,   indexselect = 1, indexUncertainty = FALSE, ylim = c(45, 70) ) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index FISHERY #>  #> MASE stats by Index: #>     Index Season      MASE     MAE.PR   MAE.base  MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.1034467      5 SSplotHCxval(retroSummary_comps,   subplots = \"len\", add = TRUE,   indexselect = 1, indexUncertainty = FALSE, ylim = c(45, 70), show.mase.adj = F ) #> Plotting Hindcast Cross-Validation (one-step-ahead)  #>  #>  Computing MASE with all 5 of 5  prediction residuals for Index FISHERY #>  #> MASE stats by Index: #>     Index Season      MASE     MAE.PR   MAE.base  MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.1034467      5"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/hcxval.html","id":"summary-table","dir":"Articles","previous_headings":"","what":"Summary Table","title":"Hindcast Cross-Validation","text":"addition HCxval plots, summary statistics table can produced using ss3diags::SSmase(). table includes: Index - fleet Season MASE - MASE score MAE.PR - mean absolute error prediction residuals MASE.base - naive prediction MASE.adj - adjusted MASE score n.eval - number points prediction skill calculated Adjusted MASE gets invoked cases inter-annual variation observed values small (default MAE < 0.1 naive predictions log(y[t+1])-log(y[t])). reasoning prediction residuals must already accurate fall threshold. adjusted MASE essential keep naive prediction MAE denominator MASE maximum. show effect changing adjustment threshold default MAE.base.adj = 0.1 larger value MAE.base.adj = 0.15 MASE ratio mean absolute error prediction residuals MAE.PR residuals naive predictions MAE.base MASE.adj","code":"mase1 <- SSmase(retroSummary_comps, quant = \"len\", MAE.base.adj = 0.1) mase1 #>     Index Season      MASE     MAE.PR   MAE.base  MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.1034467      5 #> 2 SURVEY1      1 0.6526074 0.05142002 0.07879167 0.5142002      1 #> 3   joint        0.4628955 0.01719056 0.03713702 0.1719056      6 SSmase(retroSummary_comps, quant = \"len\", MAE.base.adj = 0.15) #>     Index Season      MASE     MAE.PR   MAE.base   MASE.adj n.eval #> 1 FISHERY      1 0.3591138 0.01034467 0.02880609 0.06896444      5 #> 2 SURVEY1      1 0.6526074 0.05142002 0.07879167 0.34280015      1 #> 3   joint        0.4628955 0.01719056 0.03713702 0.11460372      6 mase1$MAE.PR / mase1$MAE.base #> [1] 0.3591138 0.6526074 0.4628955 mase1$MASE #> [1] 0.3591138 0.6526074 0.4628955 mase1$MAE.PR / pmax(mase1$MAE.base, 0.1) #> [1] 0.1034467 0.5142002 0.1719056 mase1$MASE.adj #> [1] 0.1034467 0.5142002 0.1719056"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/likelihood.html","id":"model-inputs","dir":"Articles","previous_headings":"","what":"Model inputs","title":"Likelihood Profile","text":"run Stock Synthesis model, four input files required: starter.ss, forecast.ss, control.ss, data.ss. input files example model can found within ss3diags package accessed shown . Also, r4ss package installed, need install tutorial. need make sure SS executable file either path directory running profile (case dir_profile). easy way get latest release stock synthesis use r4ss function get_ss3_exe().","code":"install.packages(\"pak\") pak::pkg_install(\"r4ss/r4ss\") library(r4ss)  files_path <- system.file(\"extdata\", package = \"ss3diags\") dir_tmp <- tempdir(check = TRUE) dir_profile <- file.path(dir_tmp, \"profile\") dir.create(dir_profile, showWarnings = FALSE, recursive = TRUE) list.files(files_path) #> [1] \"control.ss\"  \"data.ss\"     \"forecast.ss\" \"starter.ss\" file.copy(from = list.files(files_path, full.names = TRUE), to = dir_tmp) #> [1] TRUE TRUE TRUE TRUE r4ss::get_ss3_exe(dir = dir_tmp, version = \"v3.30.21\") #> The stock synthesis executable for Linux v3.30.21 was downloaded to: /tmp/RtmpnhVp2Y/ss3"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/likelihood.html","id":"running-a-profile-on-r0","dir":"Articles","previous_headings":"","what":"Running a Profile on R0","title":"Likelihood Profile","text":"four input files SS executable file, can run likelihood profile shown . first step run model like profile . dir_tmp copy necessary files dir_profile. ’s best run profile subdirectory main model run keep output files separate diagnostic tests may run. input files dir_profile directory, need create vector values profile across. range increments choose depend model resolution want analyze likelihood profile. example use fairly coarse resolution speed total run time. also need modify starter file changing name control file read making sure likelihood calculated non-estimated quantities. run profile, use r4ss::profile() need specify partial string name parameter profiling (case “SR_LN” match “SR_LN(R0)”), vector values profile across. newctlfile control file adjusted values profilevec can named anything prefer, just needs match put starter file “ctlfile”. Full documentation profile() function can found r4ss website.","code":"r4ss::run(dir = dir_tmp, exe = \"ss3\", verbose = FALSE) #> [1] \"ran model\" files <- c(\"data.ss\", \"control.ss_new\", \"starter.ss\", \"forecast.ss\", \"ss.par\", \"ss3\") file.copy(from = file.path(dir_tmp, files), to = dir_profile) #> [1] TRUE TRUE TRUE TRUE TRUE TRUE CTL <- SS_readctl_3.30(file = file.path(dir_profile, \"control.ss_new\"), datlist = file.path(dir_profile, \"data.ss\"))  CTL$SR_parms #>               LO HI   INIT PRIOR PR_SD PR_type PHASE env_var&link dev_link #> SR_LN(R0)    6.0 12 8.9274  10.3  10.0       0     1            0        0 #> SR_BH_steep  0.2  1 0.8000   0.8   1.0       0    -4            0        0 #> SR_sigmaR    0.0  2 0.6000   0.8   0.8       0    -4            0        0 #> SR_regime   -5.0  5 0.0000   0.0   1.0       0    -4            0        0 #> SR_autocorr  0.0  0 0.0000   0.0   0.0       0   -99            0        0 #>             dev_minyr dev_maxyr dev_PH Block Block_Fxn #> SR_LN(R0)           0         0      0     0         0 #> SR_BH_steep         0         0      0     0         0 #> SR_sigmaR           0         0      0     0         0 #> SR_regime           0         0      0     0         0 #> SR_autocorr         0         0      0     0         0 # getting the estimated r0 value r0 <- CTL$SR_parms$INIT[1] # creating a vector that is +/- 1 unit away from the estimated value in increments of 0.2 r0_vec <- seq(r0 - 1, r0 + 1, by = 0.2) r0_vec #>  [1] 7.9274 8.1274 8.3274 8.5274 8.7274 8.9274 9.1274 9.3274 9.5274 9.7274 #> [11] 9.9274 START <- SS_readstarter(file = file.path(dir_profile, \"starter.ss\"), verbose = FALSE) START$prior_like <- 1 START$ctlfile <- \"control_modified.ss\" SS_writestarter(START, dir = dir_profile, overwrite = TRUE, verbose = F) profile(   dir = dir_profile,   newctlfile = \"control_modified.ss\",   string = \"SR_LN\",   profilevec = r0_vec,   exe = \"ss3\",   verbose = FALSE ) #> running profile i=1/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.9274  7.9274        1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=2/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  7.9274  8.1274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=3/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.1274  8.3274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=4/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.3274  8.5274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=5/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.5274  8.7274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=6/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.7274  8.9274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=7/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  8.9274  9.1274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=8/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  9.1274  9.3274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=9/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  9.3274  9.5274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=10/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  9.5274  9.7274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #> running profile i=11/11 #> Parameter names in control file matching input vector  #> 'strings' (n=1): SR_LN(R0) #> line numbers in control file (n=1): 120 #> Wrote new file to control_modified.ss with the following changes: #>   oldvals newvals oldphase newphase oldlos newlos oldhis newhis oldprior #> 1  9.7274  9.9274       -1       -1      6      6     12     12     10.3 #>   newprior oldprsd newprsd oldprtype newprtype     comment #> 1     10.3      10      10         0         0 # SR_LN(R0) #>     Value converged[whichruns]    TOTAL       Catch Equil_catch    Survey #> 1  7.9274                 TRUE 1067.570 4.40715e-01   16.620400  6.065520 #> 2  8.1274                 TRUE  940.077 2.29735e-01   12.985200  1.965820 #> 3  8.3274                 TRUE  844.236 1.08857e-01    9.799480 -2.132340 #> 4  8.5274                 TRUE  790.513 9.17170e-06    3.930790 -5.726270 #> 5  8.7274                 TRUE  762.562 6.48948e-08    0.271032 -7.140910 #> 6  8.9274                 TRUE  754.302 1.33458e-10    0.174869 -7.118110 #> 7  9.1274                 TRUE  758.927 2.10816e-13    1.337060 -6.106700 #> 8  9.3274                 TRUE  767.708 1.90347e-13    3.424990 -4.917570 #> 9  9.5274                 TRUE  777.243 1.15331e-13    6.433440 -3.857200 #> 10 9.7274                 TRUE  787.189 6.73658e-14   10.382600 -2.563580 #> 11 9.9274                 TRUE  798.152 4.05051e-14   15.279300 -0.380771 #>    Length_comp Age_comp Size_at_age Recruitment InitEQ_Regime #> 1      453.198  341.340     230.715   19.181500   0.00000e+00 #> 2      418.750  291.595     201.557   12.989400   0.00000e+00 #> 3      393.384  257.968     179.068    6.036600   0.00000e+00 #> 4      379.721  243.456     167.416    1.713560   1.54502e-30 #> 5      370.420  234.970     163.525    0.515980   1.54502e-30 #> 6      366.756  231.845     162.399    0.244060   1.54502e-30 #> 7      367.497  233.210     162.675    0.312441   0.00000e+00 #> 8      369.543  235.957     163.170    0.529082   0.00000e+00 #> 9      371.605  238.622     163.598    0.839498   1.54502e-30 #> 10     373.376  240.872     163.942    1.178030   0.00000e+00 #> 11     374.815  242.718     164.208    1.510550   0.00000e+00 #>    Forecast_Recruitment Parm_priors Parm_softbounds Parm_devs Crash_Pen #> 1                     0           0      0.00756177         0         0 #> 2                     0           0      0.00433602         0         0 #> 3                     0           0      0.00337783         0         0 #> 4                     0           0      0.00197985         0         0 #> 5                     0           0      0.00143663         0         0 #> 6                     0           0      0.00141332         0         0 #> 7                     0           0      0.00150262         0         0 #> 8                     0           0      0.00159065         0         0 #> 9                     0           0      0.00166199         0         0 #> 10                    0           0      0.00171844         0         0 #> 11                    0           0      0.00176282         0         0"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/likelihood.html","id":"visualizing-output","dir":"Articles","previous_headings":"","what":"Visualizing Output","title":"Likelihood Profile","text":"profile finished running, can visualize results determine conflict data sources. data sources reach negative log-likelihood (NLL) minimum R0 value, indicates good agreement . However, likely, one reach NLL minimum different R0 values global R0 value. sign conflict data sources may require consider data weighting.  profile plot shows changes log-likelihood across selected range values contributing data components. adjustable minimum contribution threshold component must meet appear figure (data source model show plot, contribution total likelihood may large enough). steepness trajectory indicates informative () data source . example, age data plot much steeper left side minimum R0 value index data, suggests age composition data informative model. can also plot data-type fleet-specific profiles using r4ss::PinerPlot(). plotting profile length composition data fleet likelihood survey data fleet. allow us see conflicts sources main drivers.","code":"profile_mods <- SSgetoutput(dirvec = dir_profile, keyvec = 1:length(r0_vec), verbose = FALSE) profile_mods_sum <- SSsummarize(profile_mods, verbose = FALSE) SSplotProfile(profile_mods_sum,   profile.string = \"SR_LN\",   profile.label = \"SR_LN(R0)\" ) #> Parameter matching profile.string=SR_LN: SR_LN(R0) #> Parameter values (after subsetting based on input 'models'): 7.9274, 8.1274, 8.3274, 8.5274, 8.7274, 8.9274, 9.1274, 9.3274, 9.5274, 9.7274, 9.9274 #> Likelihood components showing max change as fraction of total change. #> To change which components are included, change input 'minfraction'. #>                      frac_change include                            label #> TOTAL                     1.0000    TRUE                            Total #> Catch                     0.0014   FALSE                            Catch #> Equil_catch               0.0525    TRUE                Equilibrium catch #> Survey                    0.0422    TRUE                       Index data #> Length_comp               0.2759    TRUE                      Length data #> Age_comp                  0.3495    TRUE                         Age data #> Size_at_age               0.2181    TRUE                 Size-at-age data #> Recruitment               0.0605    TRUE                      Recruitment #> InitEQ_Regime             0.0000   FALSE Initital equilibrium recruitment #> Forecast_Recruitment      0.0000   FALSE             Forecast recruitment #> Parm_priors               0.0000   FALSE                           Priors #> Parm_softbounds           0.0000   FALSE                      Soft bounds #> Parm_devs                 0.0000   FALSE             Parameter deviations #> Crash_Pen                 0.0000   FALSE                    Crash penalty sspar(mfrow = c(1, 2)) PinerPlot(profile_mods_sum,   component = \"Length_like\",   main = \"Length\" ) #> Parameter matching profile.string = 'R0': 'SR_LN(R0) #> Parameter values (after subsetting based on input 'models'): 7.9274, 8.1274, 8.3274, 8.5274, 8.7274, 8.9274, 9.1274, 9.3274, 9.5274, 9.7274, 9.9274, #> Fleet-specific likelihoods showing max change as fraction of total change. #> To change which components are included, change input 'minfraction'. #>         frac_change include #> FISHERY      0.6825    TRUE #> SURVEY1      0.3208    TRUE #> SURVEY2      0.0000   FALSE PinerPlot(profile_mods_sum,   component = \"Surv_like\",   main = \"Survey\" ) #> Parameter matching profile.string = 'R0': 'SR_LN(R0) #> Parameter values (after subsetting based on input 'models'): 7.9274, 8.1274, 8.3274, 8.5274, 8.7274, 8.9274, 9.1274, 9.3274, 9.5274, 9.7274, 9.9274, #> Fleet-specific likelihoods showing max change as fraction of total change. #> To change which components are included, change input 'minfraction'. #>         frac_change include #> FISHERY      0.0000   FALSE #> SURVEY1      0.3218    TRUE #> SURVEY2      0.9202    TRUE"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/residuals.html","id":"runs-test","dir":"Articles","previous_headings":"","what":"Runs Test","title":"Residual Analyses","text":"runs test nonparametric hypothesis test randomness data sequence calculates 2-sided p-value estimate number runs (.e., sequences values sign) reference value. runs test can diagnose model misspecification using residuals fits index composition data (Carvalho et al. 2017) testing non-random patterns residuals. addition, three-sigma limits can considered useful identifying potential outliers data point three standard deviations away expected residual process average unlikely given random process error observed residual distribution. example using “simple_small” SS model included within r4ss package. can read report file model output using r4ss::SS_output() function shown .  output SSplotRunstest() includes plot residuals fleet table results runs test ‘three-sigma limit’ values. plots , shaded area represents ‘three-sigma limit’, three residual standard deviations zero. individual residual points fall outside three-sigma limit, colored red. Green shaded area indicates residuals randomly distributed (p-value >= 0.05) whereas red shaded area indicates residuals randomly distributed. Failing runs test (p-value < 0.05) can indicative misspecification conflict indices composition data.","code":"library(r4ss)  files_path <- system.file(\"extdata\", \"simple_small\", package = \"r4ss\") report <- SS_output(dir = files_path, verbose = FALSE, printstats = FALSE) sspar(mfrow = c(1, 2)) SSplotRunstest(report, add = TRUE) #> Running Runs Test Diagnostics w/ plots forIndex #> Plotting Residual Runs Tests #> Residual Runs Test (/w plot) stats by Index: #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 SURVEY1  0.159 Passed -0.7301441 0.7301441 cpue #> 2 SURVEY2  0.887 Passed -1.1052361 1.1052361 cpue"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/residuals.html","id":"customizing-the-plot","dir":"Articles","previous_headings":"Runs Test","what":"Customizing the Plot","title":"Residual Analyses","text":"Runs test plots can customized needed. common features may want specify : plotting data types (default Index Abundance) plotting specific fleet(s) adjusting y-axis range Examples changes shown , incrementally making adjustment. plot data types, can specified subplots argument, options include “cpue”, “len”, “age”, “size”, “con”. “con” conditional size--age data “size” generalized size composition data. Fleets can specified using indexselect() function, takes vector fleet numbers plot.  Note small adjustment automatically added ylim provide extra white space. third plot, even though set y-axis range -0.5 0.5, y-axis goes -0.6 0.6. want extra space, set ylimAdj = 1 done 4th plot.","code":"sspar(mfrow = c(2, 2)) SSplotRunstest(report, subplots = \"len\", indexselect = 1, add = TRUE) #> Running Runs Test Diagnostics w/ plots forMean length #> Plotting Residual Runs Tests #> Residual Runs Test (/w plot) stats by Mean length: #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 FISHERY  0.126 Passed -0.0613176 0.0613176  len SSplotRunstest(report, subplots = \"age\", indexselect = 2, add = TRUE) #> Running Runs Test Diagnostics w/ plots forMean age #> Plotting Residual Runs Tests #> Residual Runs Test (/w plot) stats by Mean age: #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 SURVEY1   0.11 Passed -0.2743816 0.2743816  age SSplotRunstest(report, subplots = \"age\", indexselect = 2, add = TRUE, ylim = c(-0.5, 0.5)) #> Running Runs Test Diagnostics w/ plots forMean age #> Plotting Residual Runs Tests #> Residual Runs Test (/w plot) stats by Mean age: #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 SURVEY1   0.11 Passed -0.2743816 0.2743816  age SSplotRunstest(report, subplots = \"age\", indexselect = 2, add = TRUE, ylim = c(-0.5, 0.5), ylimAdj = 1) #> Running Runs Test Diagnostics w/ plots forMean age #> Plotting Residual Runs Tests #> Residual Runs Test (/w plot) stats by Mean age: #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 SURVEY1   0.11 Passed -0.2743816 0.2743816  age"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/residuals.html","id":"summary-table","dir":"Articles","previous_headings":"Runs Test","what":"Summary Table","title":"Residual Analyses","text":"addition residual plots, SSplotRunstest() produces summary table runs test output values, including: p-value runs test test passed failed (indicated green red shading plot) upper lower limits 3-sigma interval type data tested (CPUE, length-composition, age-composition, conditional age--length) produce summary table skip plot, e.g. faciliate automated processing, use SSrunstest().","code":"rcpue <- SSrunstest(report, quants = \"cpue\") #> Running Runs Test Diagnosics for Index #> Computing Residual Runs Tests #> Residual Runs Test stats by Index: rlen <- SSrunstest(report, quants = \"len\") #> Running Runs Test Diagnosics for Mean length #> Computing Residual Runs Tests #> Residual Runs Test stats by Mean length: rbind(rcpue, rlen) #>     Index runs.p   test  sigma3.lo sigma3.hi type #> 1 SURVEY1  0.159 Passed -0.7301441 0.7301441 cpue #> 2 SURVEY2  0.887 Passed -1.1052361 1.1052361 cpue #> 3 FISHERY  0.126 Passed -0.0613176 0.0613176  len #> 4 SURVEY1  0.841 Passed -0.1725225 0.1725225  len"},{"path":"https://pifscstockassessments.github.io/ss3diags/articles/residuals.html","id":"rmse","dir":"Articles","previous_headings":"","what":"RMSE","title":"Residual Analyses","text":"RMSE root mean square error useful evaluating far predictions fall observed data. ss3diags::SSplotJABBAres() function allows visualize full time series residuals fleets indicated data (index abundance composition). example , plot residuals index abundance, mean age (age-composition), mean length (length composition) fleets.  plots , point represents difference observed expected value (residual) color-coded correspond specific fleet. solid, color-coded vertical lines horizontal dashed line (y = 0) show distance 0 residual value. Box plots summarize spread residual values across fleets within year thick solid black line loess smoother fit residual points. Total RMSE displayed top right corner. assessing plot, important see patterns trends residuals, large overall RMSE , whether data different fleets generally agrees conflicts . retrieve just RMSE residual values without generating plot, SSrmse() produces named list 2 objects, RMSE residuals. can accessed shown . function useful automating analyses.","code":"sspar(mfrow = c(2, 2)) SSplotJABBAres(report, subplots = \"cpue\", add = TRUE) #> Plotting JABBA residual plot. #> is plot TRUE? TRUE #> drawing plot at #> Plot exists: #> RMSE stats by Index: #> # A tibble: 3 × 3 #>   Fleet    RMSE.perc  Nobs #>   <chr>        <dbl> <int> #> 1 SURVEY1       21.6     4 #> 2 SURVEY2       27.7    12 #> 3 Combined      26.3    16 SSplotJABBAres(report, subplots = \"age\", add = TRUE) #> Plotting JABBA residual plot. #> is plot TRUE? TRUE #> drawing plot at #> Plot exists: #> RMSE stats by Index: #> # A tibble: 3 × 3 #>   Fleet    RMSE.perc  Nobs #>   <chr>        <dbl> <int> #> 1 FISHERY        9      12 #> 2 SURVEY1        8.1     4 #> 3 Combined       8.8    16 SSplotJABBAres(report, subplots = \"len\", add = TRUE, ylim = c(-0.2, 0.2)) #> Plotting JABBA residual plot. #> is plot TRUE? TRUE #> drawing plot at #> Plot exists: #> RMSE stats by Index: #> # A tibble: 3 × 3 #>   Fleet    RMSE.perc  Nobs #>   <chr>        <dbl> <int> #> 1 FISHERY        2.1    12 #> 2 SURVEY1        3.4     4 #> 3 Combined       2.5    16 rmse <- SSrmse(report, quants = \"cpue\")$RMSE residuals <- SSrmse(report, quants = \"cpue\")$residuals  rmse #> # A tibble: 3 × 3 #>   Fleet    RMSE.perc  Nobs #>   <chr>        <dbl> <int> #> 1 SURVEY1       21.6     4 #> 2 SURVEY2       27.7    12 #> 3 Combined      26.3    16  head(residuals) #>     Fleet Fleet_name Area   Yr Seas Subseas Month   Time Vuln_bio         Obs #> 925     2    SURVEY1    1 2013    1       2     7 2013.5 62947.50 144745.0000 #> 926     2    SURVEY1    1 2016    1       2     7 2016.5 49335.70  63760.3000 #> 927     2    SURVEY1    1 2019    1       2     7 2019.5 38132.00  59242.9000 #> 928     2    SURVEY1    1 2022    1       2     7 2022.5 34045.80  49649.7000 #> 929     3    SURVEY2    1 2011    1       2     7 2011.5  6306.83     11.5668 #> 930     3    SURVEY2    1 2012    1       2     7 2012.5  6544.96     13.9955 #>             Exp     Calc_Q      Eff_Q  SE SE_input         Dev        Like #> 925 101399.0000 1.61084000 1.61084000 0.3      0.3  0.35591400 7.03749e-01 #> 926  79472.2000 1.61084000 1.61084000 0.3      0.3 -0.22027600 2.69564e-01 #> 927  61424.7000 1.61084000 1.61084000 0.3      0.3 -0.03616590 7.26653e-03 #> 928  54842.4000 1.61084000 1.61084000 0.3      0.3 -0.09947210 5.49706e-02 #> 929     11.5342 0.00182885 0.00182885 0.7      0.7  0.00281831 8.10497e-06 #> 930     11.9698 0.00182885 0.00182885 0.7      0.7  0.15635300 2.49451e-02 #>     Like+log(s) SuprPer Use    residuals #> 925   -0.500223      NA   1  0.355910344 #> 926   -0.934409      NA   1 -0.220276535 #> 927   -1.196710      NA   1 -0.036166093 #> 928   -1.149000      NA   1 -0.099471269 #> 929   -0.356667      NA   1  0.002822391 #> 930   -0.331730      NA   1  0.156349038"},{"path":"https://pifscstockassessments.github.io/ss3diags/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Henning Winker. Author. Felipe Carvalho. Author. Massimiliano Cardinale. Author. Laurence Kell. Author. Megumi Oshima. Author, maintainer. Eric Fletcher. Author.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Winker H, Carvalho F, Cardinale M, Kell L, Oshima M, Fletcher E (2024). ss3diags: Stock Synthesis Model Diagnostics Intergated Stock Assessments. R package version 2.2.0, https://github.com/PIFSCstockassessments/ss3diags.","code":"@Manual{,   title = {ss3diags: Stock Synthesis Model Diagnostics for Intergated Stock Assessments},   author = {Henning Winker and Felipe Carvalho and Massimiliano Cardinale and Laurence Kell and Megumi Oshima and Eric Fletcher},   year = {2024},   note = {R package version 2.2.0},   url = {https://github.com/PIFSCstockassessments/ss3diags}, }"},{"path":"https://pifscstockassessments.github.io/ss3diags/index.html","id":"ss3diags-","dir":"","previous_headings":"","what":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","title":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","text":"R package ss3diags enables users apply advanced diagnostics evaluate Stock Synthesis model. Diagnostics include residual analyses, hindcast cross-validation techniques, retrospective analyses. Functions also allow users reproduce key model diagnostics plots presented paper ‘Cookbook Using Model Diagnostics Integrated Stock Assessments’ (Carvalho et al. 2021). ss3diags Github repository provides step--step R recipes : Run jitter analysis Conduct retrospective analysis Use hindcast cross-validation log-likelood profiling R0 Run ASPM diagnostic Evaluate model fit Stock Synthesis making use comprehensive collection R functions available R packages r4ss ss3diags.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","text":"ss3diags currently supported CRAN. can install development version ss3diags GitHub : package installed can loaded : examples run common diagnostic tests SS models visualize results diagnostic tests using r4ss ss3diags packages, please refer articles package website.","code":"# install.packages(\"remotes\") remotes::install_github(\"PIFSCstockassessments/ss3diags\") library(ss3diags)"},{"path":"https://pifscstockassessments.github.io/ss3diags/index.html","id":"contributing-to-ss3diags","dir":"","previous_headings":"","what":"Contributing to ss3diags","title":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","text":"like contribute ss3diags suggestions diagnostic tests include package, can submit new issue email Meg megumi.oshima@noaa.gov.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/index.html","id":"reference","dir":"","previous_headings":"","what":"Reference","title":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","text":"cite ss3diags publication can use","code":"citation(\"ss3diags\") #> To cite package 'ss3diags' in publications use: #>  #>   Winker H, Carvalho F, Cardinale M, Kell L, Oshima M, Fletcher E #>   (2023). _ss3diags: Stock Synthesis Model Diagnostics for Intergated #>   Stock Assessments_. R package version 2.1.1, #>   <https://github.com/PIFSCstockassessments/ss3diags>. #>  #> A BibTeX entry for LaTeX users is #>  #>   @Manual{, #>     title = {ss3diags: Stock Synthesis Model Diagnostics for Intergated Stock Assessments}, #>     author = {Henning Winker and Felipe Carvalho and Massimiliano Cardinale and Laurence Kell and Megumi Oshima and Eric Fletcher}, #>     year = {2023}, #>     note = {R package version 2.1.1}, #>     url = {https://github.com/PIFSCstockassessments/ss3diags}, #>   }"},{"path":"https://pifscstockassessments.github.io/ss3diags/index.html","id":"disclaimer","dir":"","previous_headings":"","what":"Disclaimer","title":"Stock Synthesis Model Diagnostics for Intergated Stock Assessments","text":"United States Department Commerce (DOC) GitHub project code provided ‘’ basis user assumes responsibility use. DOC relinquished control information longer responsibility protect integrity, confidentiality, availability information. claims Department Commerce stemming use GitHub project governed applicable Federal law. reference specific commercial products, processes, services service mark, trademark, manufacturer, otherwise, constitute imply endorsement, recommendation favoring Department Commerce. Department Commerce seal logo, seal logo DOC bureau, shall used manner imply endorsement commercial product activity DOC United States Government.”","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":null,"dir":"Reference","previous_headings":"","what":"Francis Weighting for compositional data — SScompsTA1.8","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"TA1.8 Francis function modified r4ss::SSMethod.TA1.8 r4ss::SSMethod.Cond.TA1.8 apply Francis weighting method TA1.8 length-, age-, generalized size-composition data, conditional age--length data Stock Synthesis model. conditional age--length data, mean age year calculated based recommendations Punt (2015). main purpose create dataframe annual observed expected mean length age fleet used calculate residuals testing model fit. function used SSplotRunstest SSplotJABBAres.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"","code":"SScompsTA1.8(   ss3rep,   type = c(\"len\", \"age\", \"size\", \"con\"),   fleet = NULL,   seas = NULL,   plotit = FALSE,   maxpanel = 1000 )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"ss3rep Stock Synthesis output read r4SS function SS_output type string either 'len' (length composition data), 'size' (generalized size composition data), 'age' (age composition data), 'con' (conditional age length data) fleet vector one fleet numbers whose data analysed simultaneously, NULL, fleets analysed seas string indicating treat data multiple seasons 'comb' - combine seasonal data year plot Yr 'sep' - treat season separately, plotting Yr.S. .null(seas), assumed one season option 'comb' used. plotit TRUE, make illustrative plot like one panels Fig. 4 Francis (2011). maxpanel maximum number panels within plot, default 1000","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"ss_out data.frame observed, predicted mean length/age 95% confidence intervals based stage 1 stage 2 weighting runs_dat data.frame observed predicted mean length age year/fleet.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"Francis, R..C.C. (2011). Data weighting statistical fisheries stock assessment models. Canadian Journal Fisheries Aquatic Sciences 68: 1124-1138. #' Punt, .E. (2015). insights data weighting integrated stock assessments. Fish. Res. <http://dx.doi.org/10.1016/j.fishres.2015.12.006","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SScompsTA1.8.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Francis Weighting for compositional data — SScompsTA1.8","text":"Chris Francis, Andre Punt, Ian Taylor (modified Henning Winker Meg Oshima)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN.html","id":null,"dir":"Reference","previous_headings":"","what":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","text":"function generate joint distributions stock status ratios (SSB/SSBref F/Fref ref can MSY, SSB40, F40, etc.) using Multivariate Log-Normal Distribution. function produces Kobe plot, maximum likelihood estimates MVLN Monte-Carlo distributions Kobe values can input SSplotEnsemble().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","text":"","code":"SSdeltaMVLN(   ss3rep,   Fref = NULL,   years = NULL,   mc = 5000,   weight = 1,   run = \"MVLN\",   plot = TRUE,   addprj = FALSE,   ymax = NULL,   xmax = NULL,   legendcex = 1,   verbose = TRUE,   variance_method = \"ww2019\",   bias_correct_mean = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","text":"ss3rep r4ss::SS_output Fref Choice Fratio c(\"MSY\",\"Btgt\"), correponding F_MSY F_Btgt years single year vector years mvln mc number monte-carlo simulations weight weighting option model ensembles weight*mc run qualifier model run plot option show plot addprj include forecast years ymax ylim maximum xmax xlim maximum legendcex Allows adjust legend cex verbose Report progress R GUI? variance_method Specify method approximating variance covariance multivariate lognormal distribution ww2019 Use approximation Walter Winker 2019 (Default backwards compatibility). 2T Use delta-method 2nd order Taylor series approximation. bias_correct_mean Specify Stock Synthesis MLE estimates bias corrected used specify mean multivariate lognormal distribution FALSE apply bias correction (Default backwards compatibility). TRUE Apply bias correction.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","text":"output list maximum likelihood estimates MVLN Monte-Carlo distributions Kobe values, kobe plot","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN","text":"Henning Winker (JRC-EC) Nicholas Ducharme-Barth (PIFSC)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN_old.html","id":null,"dir":"Reference","previous_headings":"","what":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","text":"function generate kobe pdfs Multivariate Log-Normal Distribution including plotting option. version used older versions Stock Synthesis. newer versions (v3.24 newer), use SSdeltaMVLN().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN_old.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","text":"","code":"SSdeltaMVLN_old(   ss3rep,   status = c(\"Bratio\", \"F\"),   quants = c(\"SSB\", \"Recr\"),   Fref = c(\"MSY\", \"Ftrg\"),   years = NULL,   mc = 5000,   weight = 1,   run = \"MVLN\",   plot = TRUE,   addtrj = TRUE,   ymax = NULL,   xmax = NULL,   legendcex = 1,   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN_old.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","text":"ss3rep r4ss::SSgetoutput()$replist1 status covarying stock status quantaties extract Hessian quants additional stock quantaties extract Hessian Fref Choice reference point stock SSB/XFref=c(\"MSY\",\"Ftrg\"),F_report_basis: 0 3 years single year vector years mvln mc number monte-carlo simulations weight weighting option model ensembles weight*mc run qualifier model run plot option show plot addtrj TRUE/FALSE add trajectory years. Default TRUE ymax ylim maximum xmax xlim maximum legendcex Allows adjust legend cex verbose Report progress R GUI?","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN_old.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","text":"output list kobe objects mle's","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdeltaMVLN_old.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Joint Distributions for Stock Status Ratios — SSdeltaMVLN_old","text":"Henning Winker (JRC-EC)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC.html","id":null,"dir":"Reference","previous_headings":"","what":"MCMC Joint Distributions — SSdiagsMCMC","title":"MCMC Joint Distributions — SSdiagsMCMC","text":"function generate joint distributions stock status ratios (SSB/SSBref F/Fref ref can MSY, SSB40, F40, etc.) using MCMC. function produces Kobe plot, maximum likelihood estimates MVLN Monte-Carlo distributions Kobe values can input SSplotEnsemble().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"MCMC Joint Distributions — SSdiagsMCMC","text":"","code":"SSdiagsMCMC(   mcmc,   ss3rep,   Fref = NULL,   years = NULL,   run = \"MCMC\",   thin = 1,   plot = TRUE,   addprj = FALSE,   ymax = NULL,   xmax = NULL,   legendcex = 1,   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"MCMC Joint Distributions — SSdiagsMCMC","text":"mcmc file path folder derived_posteriors.sso file ss3rep r4ss::SS_output Fref Choice Fratio c(\"MSY\",\"Btgt), correponding F_MSY F_Btgt years single year vector years mvln run qualifier model run thin option use additional thinning plot option show plot addprj include forecast years ymax ylim maximum xmax xlim maximum legendcex Allows adjust legend cex verbose Report progress R GUI?","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"MCMC Joint Distributions — SSdiagsMCMC","text":"output list maximum likelihood estimates MCMC posterier distributions Kobe values Kobe plot","code":""},{"path":[]},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"MCMC Joint Distributions — SSdiagsMCMC","text":"Henning Winker (JRC-EC), Massimiliano Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC_ancient.html","id":null,"dir":"Reference","previous_headings":"","what":"MCMC Joint Distributions — SSdiagsMCMC_ancient","title":"MCMC Joint Distributions — SSdiagsMCMC_ancient","text":"function generate joint distributions stock status ratios (SSB/SSBref F/Fref ref can MSY, SSB40, F40, etc.) using MCMC. function produces Kobe plot, maximum likelihood estimates MVLN Monte-Carlo distributions Kobe values can input SSplotEnsemble(). Use Stock Synthesis models older 3.24, later versions use SSdiagsMCMC().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC_ancient.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"MCMC Joint Distributions — SSdiagsMCMC_ancient","text":"","code":"SSdiagsMCMC_ancient(   mcmc,   ss3rep,   Fref = NULL,   years = NULL,   run = \"MCMC\",   thin = 1,   plot = TRUE,   addprj = FALSE,   ymax = NULL,   xmax = NULL,   legendcex = 1,   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC_ancient.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"MCMC Joint Distributions — SSdiagsMCMC_ancient","text":"mcmc file path folder derived_posteriors.sso file ss3rep r4ss::SS_output Fref Choice Fratio c(\"MSY\",\"Btgt), correponding F_MSY F_Btgt years single year vector years mvln run qualifier model run thin option use additional thinning plot option show plot addprj include forecast years ymax ylim maximum xmax xlim maximum legendcex Allows adjust legend cex verbose Report progress R GUI?","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC_ancient.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"MCMC Joint Distributions — SSdiagsMCMC_ancient","text":"output list maximum likelihood estimates MCMC posterier distributions Kobe values Kobe plot","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSdiagsMCMC_ancient.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"MCMC Joint Distributions — SSdiagsMCMC_ancient","text":"Henning Winker (JRC-EC), Massimiliano Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SShcbias.html","id":null,"dir":"Reference","previous_headings":"","what":"Mohn's Rho and Forecast Bias — SShcbias","title":"Mohn's Rho and Forecast Bias — SShcbias","text":"function produces statistics retrospective analysis (Mohn's rho forecast bias). visualize retrospective forecasts Stock Synthesis model, use SSplotRetro().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SShcbias.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Mohn's Rho and Forecast Bias — SShcbias","text":"","code":"SShcbias(   summaryoutput,   quants = c(\"SSB\", \"F\"),   models = \"all\",   endyrvec = \"default\",   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SShcbias.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Mohn's Rho and Forecast Bias — SShcbias","text":"summaryoutput List created r4ss::SSsummarize() quants SSB F quantity models Optional subset models described r4ss function summaryoutput().  Either \"\" vector numbers indicating columns summary tables. endyrvec Optional single year vector years representing final year values show model. default set ending year specified model. verbose Report progress R GUI?","code":""},{"path":[]},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SShcbias.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Mohn's Rho and Forecast Bias — SShcbias","text":"Henning Winker (JRC-EC) Laurance Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":null,"dir":"Reference","previous_headings":"","what":"Mean Absolute Scaled Error — SSmase","title":"Mean Absolute Scaled Error — SSmase","text":"MASE one-step ahead hindcasting cross-validations computes MASE prediction residuals indices. MASE calculated average ratio mean absolute error (MAE) prediction residuals (MAE.PR) Naive Predictions (MAE.base) MASE.adj sets MAE.base minimum MAE.base.adj (default=0.1) MASE.adj allow passing (MASE<1) MAE.PE < 0.1 thus accurate, obs show extremely little variation","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Mean Absolute Scaled Error — SSmase","text":"","code":"SSmase(   retroSummary,   quants = c(\"cpue\", \"len\", \"age\", \"con\"),   Season = \"default\",   models = \"all\",   endyrvec = \"default\",   indexselect = NULL,   MAE.base.adj = 0.1,   residuals = FALSE,   verbose = FALSE,   indexfleets = 1 )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Mean Absolute Scaled Error — SSmase","text":"retroSummary raw list retrospective runs created r4ss::SSgetoutput(). Depending type data, function call r4ss::SSsummarize ss3diags:SSretroComps summarize list. quants data type, either \"cpue\" index data, \"len\" length composition data, \"age\" age composition data. Note, using \"age\" \"len\", SSretroComps() used extract summarize composition data first. Season option specify Season integer value 1-4 - Default uses first available, .e. usual Seas = 1 models Optional subset models described r4ss function summaryoutput().  Either \"\" vector numbers indicating columns summary tables. endyrvec Optional single year vector years representing final year values show model. default set ending year specified model. indexselect Vector fleet numbers model compare MAE.base.adj minimum MASE demoninator (naive predictions) MASE.adj (default = 0.1) residuals true, includes dataframe output prediction residuals naive prediction residuals. Default FALSE. verbose Report progress R GUI? indexfleets Single value vector length n = number models summary object fleet number(s) index compare.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Mean Absolute Scaled Error — SSmase","text":"MASE hcxval statistic","code":""},{"path":[]},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Mean Absolute Scaled Error — SSmase","text":"Henning Winker (JRC-EC) Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSmase.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Mean Absolute Scaled Error — SSmase","text":"","code":"if (FALSE) { # calculate MASE for CPUE indices only for fleets 1 and 2 SSmase(retro.sma, quant = \"cpue\", indexselect = c(1:2)) }"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotEnsemble.html","id":null,"dir":"Reference","previous_headings":"","what":"Model ensemble plots — SSplotEnsemble","title":"Model ensemble plots — SSplotEnsemble","text":"Plots model ensembles forecasts uncertainty represented MVLN MCMC posteriors","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotEnsemble.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Model ensemble plots — SSplotEnsemble","text":"","code":"SSplotEnsemble(   kb,   subplots = c(\"stock\", \"harvest\", \"SSB\", \"F\", \"Recr\", \"Catch\"),   models = \"all\",   quantiles = list(c(0.025, 0.975)),   ylabs = NULL,   endyrvec = \"default\",   plot = TRUE,   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = FALSE,   use_pdf = FALSE,   col = NULL,   pch = NULL,   lty = 1,   lwd = 2,   tickEndYr = FALSE,   xlim = NULL,   ylimAdj = 1.05,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"l\",   uncertainty = TRUE,   legend = TRUE,   legendlabels = \"default\",   legendloc = \"topright\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.9,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   shadealpha = 0.3,   new = TRUE,   add = FALSE,   mcmcVec = FALSE,   indexQlabel = TRUE,   indexQdigits = 4,   legendindex = NULL )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotEnsemble.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Model ensemble plots — SSplotEnsemble","text":"kb kb type output created SSdeltaMVLN() subplots vector create subplots options: \"stock\" Fish Population \"harvest\" Harvest Rate \"SSB\" Spawning Stock Biomass \"F\" Fishing Mortality \"Recr\" Recruitment \"Catch\" Total Catch models option manually subset models kb[[\"run\"]] quantiles quantiles uncertainty plots. Input list, default 95TH percentile: list(c(0.025, 0.975)) ylabs y-axis labels quants endyrvec Optional single year vector years representing final year values show model. \"default\" set ending year specified model. plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot. uncertainty Logical flag enable plots uncertainty intervals. Either single TRUE/FALSE value, vector TRUE/FALSE values around SSB F estimated timeseries, set integers corresponding choice models. legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console shadealpha Transparency adjustment used make uncertainty regions, default 0.3 new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs mcmcVec Logical vector TRUE/FALSE values (single value) indicating whether input values MCMC use normal distribution around MLE. indexQlabel TRUE/FALSE include labels indices. Default TRUE (currently used) indexQdigits Number significant digits catchability legend. Default 4 legendindex Allows add legend selected indices (plots)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotEnsemble.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Model ensemble plots — SSplotEnsemble","text":"Mostly adopted r4ss::SSplotComparisons Taylor et al","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotEnsemble.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Model ensemble plots — SSplotEnsemble","text":"","code":"if (FALSE) {  mvln <- SSdeltaMVLN(simple, run = \"Simple\") sspar(mfrow = c(3, 2), plot.cex = 0.7) SSplotEnsemble(mvln[[\"kb\"]], ylabs = mvln[[\"labels\"]], add = T, verbose = F) }"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGeneric.html","id":null,"dir":"Reference","previous_headings":"","what":"Generic SSplot function — SSplotGeneric","title":"Generic SSplot function — SSplotGeneric","text":"Generalized version ss3diags SSplots functions. intended production","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGeneric.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generic SSplot function — SSplotGeneric","text":"","code":"SSplotGeneric(   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   plot = TRUE,   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = deprecated(),   use_pdf = FALSE,   new = TRUE,   add = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGeneric.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generic SSplot function — SSplotGeneric","text":"pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericLegend.html","id":null,"dir":"Reference","previous_headings":"","what":"Legend parameters for Generic SSplot — SSplotGenericLegend","title":"Legend parameters for Generic SSplot — SSplotGenericLegend","text":"Generalized version ss3diags SSplots functions specfic plot legend parameters. intended production.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericLegend.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Legend parameters for Generic SSplot — SSplotGenericLegend","text":"","code":"SSplotGenericLegend(   legend = TRUE,   legendlabels = \"default\",   legendloc = \"topright\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.9,   legendindex = NULL )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericLegend.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Legend parameters for Generic SSplot — SSplotGenericLegend","text":"legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels legendindex Allows add legend selected indices (plots)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericPar.html","id":null,"dir":"Reference","previous_headings":"","what":"Graphical Parameters for Stock Synthesis Generic plots. — SSplotGenericPar","title":"Graphical Parameters for Stock Synthesis Generic plots. — SSplotGenericPar","text":"Generalized version ss3diags SSplots functions specify par() pass plot attributes. intended production.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericPar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Graphical Parameters for Stock Synthesis Generic plots. — SSplotGenericPar","text":"","code":"SSplotGenericPar(   col = NULL,   pch = NULL,   lty = 1,   lwd = 2,   tickEndYr = FALSE,   xlim = NULL,   ylimAdj = 1.05,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"l\" )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericPar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Graphical Parameters for Stock Synthesis Generic plots. — SSplotGenericPar","text":"col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericUncertainty.html","id":null,"dir":"Reference","previous_headings":"","what":"Uncertainty parameters for Stock Synthesis Generic plots. — SSplotGenericUncertainty","title":"Uncertainty parameters for Stock Synthesis Generic plots. — SSplotGenericUncertainty","text":"Generalized version ss3diags SSplots functions specify uncertainty. intended production.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericUncertainty.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Uncertainty parameters for Stock Synthesis Generic plots. — SSplotGenericUncertainty","text":"","code":"SSplotGenericUncertainty(uncertainty = TRUE, mcmcVec = FALSE, models = \"all\")"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotGenericUncertainty.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Uncertainty parameters for Stock Synthesis Generic plots. — SSplotGenericUncertainty","text":"uncertainty Logical flag enable plots uncertainty intervals. Either single TRUE/FALSE value, vector TRUE/FALSE values around SSB F estimated timeseries, set integers corresponding choice models. mcmcVec Logical vector TRUE/FALSE values (single value) indicating whether input values MCMC use normal distribution around MLE. models Optional subset models summaryoutput (similar field different name): list created function r4ss::SSsummarize. Either \"\" vector numbers indicating columns summary tables.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotHCxval.html","id":null,"dir":"Reference","previous_headings":"","what":"Hindcasting Cross-Validations of Multiple Models — SSplotHCxval","title":"Hindcasting Cross-Validations of Multiple Models — SSplotHCxval","text":"Plots one-step ahead hindcasting cross-validations computes MASE prediction residuals.MASE calculated average ratio mean absolute error (MAE) prediction residuals (MAE.PR) naive predictions (MAE.base). MASE.adj sets MAE.base minimum MAE.base.adj (default=0.1). MASE.adj allow passing (MASE<1) MAE.PE < 0.1 thus accurate obs show little annual variation","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotHCxval.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Hindcasting Cross-Validations of Multiple Models — SSplotHCxval","text":"","code":"SSplotHCxval(   retroSummary,   subplots = c(\"cpue\", \"len\", \"age\"),   Season = \"default\",   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = deprecated(),   use_pdf = FALSE,   models = \"all\",   endyrvec = \"default\",   xmin = NULL,   indexselect = NULL,   MAE.base.adj = 0.1,   show.mase.adj = TRUE,   indexUncertainty = TRUE,   col = NULL,   pch = NULL,   lty = 1,   lwd = 2,   tickEndYr = TRUE,   xlim = \"default\",   ylimAdj = 1.15,   ylim = NULL,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"o\",   uncertainty = TRUE,   legend = TRUE,   legendlabels = \"default\",   legendloc = \"topright\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.9,   legendindex = NULL,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   shadecol = grey(0.5, 0.4),   shadecol2 = grey(0.5, 0.4),   shadealpha = 0.3,   new = TRUE,   add = FALSE,   mcmcVec = FALSE,   indexQlabel = TRUE,   indexQdigits = 4,   indexfleets = 1,   plot = TRUE,   shadecol1 = grey(0.5, 0.4) )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotHCxval.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Hindcasting Cross-Validations of Multiple Models — SSplotHCxval","text":"retroSummary List created r4ss::SSsummarize() SSretroComps() subplots optional use following: \"cpue\" Index abundance data \"len\" Length-composition data \"age\" Age-composition data Season option specify Season integer value 1-4. Default uses first available, .e. usual Seas = 1 print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. models Optional subset models summaryoutput (similar field different name): list created function r4ss::SSsummarize. Either \"\" vector numbers indicating columns summary tables. endyrvec Optional single year vector years representing final year values show model. default set ending year specified model. xmin optional number first year shown plot (available) indexselect Vector fleet numbers model compare MAE.base.adj minimum MASE denominator (naive predictions) MASE.adj (default = 0.1) show.mase.adj TRUE, show mase.adj plot indexUncertainty Show fixed uncertainty intervals index (estimated) col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylimAdj Multiplier ylim parameter. Allows additional white space. ylim -write ylimAdj specified xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot. uncertainty Logical flag enable plots uncertainty intervals. Either single TRUE/FALSE value, vector TRUE/FALSE values around SSB F estimated timeseries, set integers corresponding choice models. legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels legendindex Allows add legend selected indices (plots) pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console shadecol uncertainty shading hcxval horizon shadecol2 color uncertainty early years affected hindcast shadealpha Transparency adjustment used make default shadecol. (currently used) new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs mcmcVec Logical vector TRUE/FALSE values (single value) indicating whether input values MCMC use normal distribution around MLE. indexQlabel Logical flag add catchability legend plot index fits. indexQdigits Number significant digits catchability legend indexfleets Fleet numbers model compare indices abundance. Can take different forms: integer: (default) create single comparison plot chosen index NULL: create separate plot index long fleet numbering across models. vector length equal number models: single fleet number model compared single plot list: list fleet numbers associated indices within model compared, list elements vector length names list elements matter can absent. plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version shadecol1 uncertainty shading early years affected hindcast (currently used)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotHCxval.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Hindcasting Cross-Validations of Multiple Models — SSplotHCxval","text":"Henning Winker (JRC-EC) Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotJABBAres.html","id":null,"dir":"Reference","previous_headings":"","what":"Residual plot — SSplotJABBAres","title":"Residual plot — SSplotJABBAres","text":"Plots residuals indices boxplot (color coded fleet) loess showing systematic trends time. function package JABBA (Just Another Bayesian Biomass Assessment).","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotJABBAres.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Residual plot — SSplotJABBAres","text":"","code":"SSplotJABBAres(   ss3rep,   subplots = c(\"cpue\", \"len\", \"age\", \"size\", \"con\")[1],   seas = NULL,   plot = TRUE,   print = lifecycle::deprecated(),   print_plot = FALSE,   png = lifecycle::deprecated(),   use_png = print_plot,   pdf = lifecycle::deprecated(),   use_pdf = FALSE,   indexselect = NULL,   miny = 3,   col = NULL,   pch = 21,   lty = 1,   lwd = 2,   tickEndYr = TRUE,   xlim = \"default\",   ylim = \"default\",   ylimAdj = 1.1,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"o\",   legend = TRUE,   legendlabels = \"default\",   legendloc = \"bottomleft\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.9,   legendindex = NULL,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   boxcol = grey(0.8, 0.5),   new = TRUE,   add = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotJABBAres.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Residual plot — SSplotJABBAres","text":"ss3rep Stock Synthesis output read r4ss::SS_output() subplots string type data plot: \"cpue\" Index abundance data \"len\" Length-composition data \"age\" Age-composition data \"size\" Generalized size composition data \"con\" Conditional age--length data. seas string indicating treat data multiple seasons: \"comb\" Combine seasonal data year plot Yr \"sep\" Treat season separately, plotting Yr.S. NULL NULL, assumed one season option \"comb\" used. plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. indexselect Vector fleet numbers model compare miny minimum abs values ylim col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylim Optional, min max values ylim override \"default\" value (-0.7, 0.5) ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag. Enables x- y-axis labels. type type plot drawn. details, see plot. legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels legendindex Allows add legend selected indices (plots) pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console boxcol color boxes new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotJABBAres.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Residual plot — SSplotJABBAres","text":"Henning Winker (JRC-EC)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotKobe.html","id":null,"dir":"Reference","previous_headings":"","what":"KOBE phase plot — SSplotKobe","title":"KOBE phase plot — SSplotKobe","text":"Generates Kobe plot phase plot illustrating stock status uncertainty SSB/SSBmsy F/Fmsy","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotKobe.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"KOBE phase plot — SSplotKobe","text":"","code":"SSplotKobe(   kb,   joint = TRUE,   year = NULL,   posterior = c(\"points\", \"kernel\"),   xlab = expression(SSB/SSB[MSY]),   ylab = expression(F/F[MSY]),   ylim = NULL,   xlim = NULL,   fill = TRUE,   showMedian = TRUE,   legend = TRUE,   legendpos = \"right\",   legendcex = 0.7,   legendruns = TRUE,   yr.label = TRUE,   yr.int = 5,   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotKobe.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"KOBE phase plot — SSplotKobe","text":"kb output SSdeltaMVLN()$kb joint option FALSE shows individual runs year option choose year kobe, last year default posterior visualization posterior c(\"points\",\"kernel\") xlab graphic parameter ylab graphic parameter ylim graphic parameter xlim graphic parameter fill shows color-coded quadrants showMedian option median trajectory. TRUE default legend option legend. TRUE default. legendpos legend position legendcex legend size legendruns show legend run labels yr.label show year along trajectory yr.int year intervals along trajectory verbose Output R console. Default TRUE","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotKobe.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"KOBE phase plot — SSplotKobe","text":"Kobe Quadrant percentages","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotModelcomp.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare Multiple SS Model Estimates — SSplotModelcomp","title":"Compare Multiple SS Model Estimates — SSplotModelcomp","text":"function plot SSB, B-ratio, F, Recruits, /Index Abundance fits multiple SS models. function uses object multiple SS models summarized r4ss::SSsummarize().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotModelcomp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare Multiple SS Model Estimates — SSplotModelcomp","text":"","code":"SSplotModelcomp(   summaryoutput,   plot = TRUE,   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = deprecated(),   use_pdf = FALSE,   models = \"all\",   subplots = c(\"SSB\", \"Bratio\", \"Fvalue\", \"Recruits\", \"Index\", \"RecDevs\"),   brp = c(\"msy\", \"btargs\"),   fmsy = TRUE,   ylabs = c(\"SSB (t)\", expression(SSB/SSB[MSY]), \"Fishing mortality F\",     \"Recruits ('000s)\", \"Index\", \"Recruitment Deviations\"),   endyrvec = \"default\",   xmin = NULL,   indexselect = NULL,   indexUncertainty = TRUE,   col = NULL,   pch = NULL,   lty = 1,   lwd = 2,   tickEndYr = FALSE,   xlim = \"default\",   ylimAdj = 1.05,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"l\",   uncertainty = TRUE,   legend = TRUE,   legendlabels = \"default\",   legendloc = \"topright\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.9,   legendindex = NULL,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   shadecol = NULL,   shadealpha = 0.3,   new = TRUE,   add = FALSE,   mcmcVec = FALSE,   indexQlabel = TRUE,   indexQdigits = 4,   indexfleets = 1 )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotModelcomp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare Multiple SS Model Estimates — SSplotModelcomp","text":"summaryoutput List created r4ss::SSsummarize() plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. models Optional subset models summaryoutput (similar field different name): list created function r4ss::SSsummarize. Either \"\" vector numbers indicating columns summary tables. subplots option \"SSB\",\"Bratio\",\"Fvalue\",\"Recruits\",\"Index\" \"SSB\" Spawning Stock Biomass \"Bratio\" Stock Biomass relative biomass reference point \"Fvalue\" Fishing Mortality \"Recruits\" Age-0 Recruits \"Index\" Index abundance \"RecDev\" Recruitment Deviations brp option set reference point c(\"msy\",\"btargs\") fmsy specify Fvalue F/Fmsy starter file setting ylabs yaxis labels quants final year values show model. default set endyrvec Optional single year vector years representing final year values show model. \"default\" set ending year specified model. xmin NULL optional number first year shown plot (available) indexselect Vector fleet numbers model compare indexUncertainty Show fixed uncertainty intervals index (estimated) col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot. uncertainty Logical flag enable plots uncertainty intervals. Either single TRUE/FALSE value, vector TRUE/FALSE values around SSB F estimated timeseries, set integers corresponding choice models. legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels legendindex Allows add legend selected indices (plots) pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console shadecol uncertainty shading hcxval horizon shadealpha Transparency adjustment used make default shadecol new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs mcmcVec Logical vector TRUE/FALSE values (single value) indicating whether input values MCMC use normal distribution around MLE. indexQlabel Logical. TRUE add catchability legend plot index fits (currently used) indexQdigits Number significant digits catchability legend indexfleets Fleet numbers model compare indices abundance. Can take different forms: integer (default): create single comparison plot chosen index NULL: create separate plot index long fleet numbering across models. vector length equal number models: single fleet number model compared single plot list: list fleet numbers associated indices within model compared, list elements vector length names list elements matter can absent.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotModelcomp.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Compare Multiple SS Model Estimates — SSplotModelcomp","text":"Mostly adopted r4ss::SSplotComparisons Taylor et al","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRetro.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrospective-Forecast with One-Step Ahead Hindcasting — SSplotRetro","title":"Retrospective-Forecast with One-Step Ahead Hindcasting — SSplotRetro","text":"Plots retrospective pattern, including (optional) one-step ahead forecast computes Mohn's Rho","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRetro.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrospective-Forecast with One-Step Ahead Hindcasting — SSplotRetro","text":"","code":"SSplotRetro(   summaryoutput,   subplots = c(\"SSB\", \"F\"),   plot = TRUE,   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = deprecated(),   use_pdf = FALSE,   models = \"all\",   endyrvec = \"default\",   xlim = NULL,   xmin = NULL,   labels = NULL,   ylim = NULL,   forecast = TRUE,   forecastrho = TRUE,   showrho = TRUE,   col = NULL,   pch = NULL,   lty = 1,   lwd = 2,   tickEndYr = TRUE,   ylimAdj = 1.05,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"o\",   uncertainty = TRUE,   legend = TRUE,   legendlabels = \"default\",   legendloc = \"topright\",   legendorder = \"default\",   legendncol = 1,   legendcex = 1,   legendsp = 0.7,   legendindex = NULL,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   shadecol = grey(0.4, 0.6),   new = TRUE,   add = FALSE,   mcmcVec = FALSE,   shadecol1 = grey(0.5, 0.4),   indexQlabel = TRUE,   indexQdigits = 4,   shadealpha = 0.3 )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRetro.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrospective-Forecast with One-Step Ahead Hindcasting — SSplotRetro","text":"summaryoutput List created r4ss::SSsummarize() subplots Optional vector subplots created: \"SSB\" Spawning Stock Biomass \"F\" Fishing Mortality plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. models Optional subset models summaryoutput (similar field different name): list created function r4ss::SSsummarize. Either \"\" vector numbers indicating columns summary tables. endyrvec Optional single year vector years representing final year values show model. default set ending year specified model. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. xmin optional minimum year shown plot (default first yr) labels yaxis label biomass (bony fish sharks) ylim option specify ylim range forecast Logical. TRUE, one-step ahead forecasts shown plot forecastrho Logical. TRUE, one-step ahead forecast rho value denoted plot showrho Logical flag include Mohn's rho value. Defaults TRUE col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot. uncertainty Logical flag enable plots uncertainty intervals. Either single TRUE/FALSE value, vector TRUE/FALSE values around SSB F estimated timeseries, set integers corresponding choice models. legend Flag enable legend plot. TRUE default. legendlabels Optional vector labels include legend. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendorder Optional vector model numbers can used legend display model names order different represented summary input object. legendncol Number columns legend. legendcex Allows adjust legend cex legendsp Space legend labels legendindex Allows add legend selected indices (plots) pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console shadecol uncertainty shading hcxval horizon new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs mcmcVec Logical vector TRUE/FALSE values (single value) indicating whether input values MCMC use normal distribution around MLE. shadecol1 uncertainty shading early years affected hindcast indexQlabel Logical. TRUE, add catchability legend plot index fits (currently used) indexQdigits Number significant digits catchability legend shadealpha set transparency level (alpha) area uncertainty. Defaults 0.3 (currently used)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRetro.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Retrospective-Forecast with One-Step Ahead Hindcasting — SSplotRetro","text":"Henning Winker (JRC-EC) Laurance Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRunstest.html","id":null,"dir":"Reference","previous_headings":"","what":"Residual Diagnostics — SSplotRunstest","title":"Residual Diagnostics — SSplotRunstest","text":"Function residual diagnostics. Plots residuals 3x sigma limits indices mean age length outputs runs test table. Note, want plot residuals, use SSrunstest().","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRunstest.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Residual Diagnostics — SSplotRunstest","text":"","code":"SSplotRunstest(   ss3rep,   mixing = \"less\",   subplots = c(\"cpue\", \"len\", \"age\", \"size\", \"con\")[1],   plot = TRUE,   print = deprecated(),   print_plot = FALSE,   png = deprecated(),   use_png = print_plot,   pdf = deprecated(),   use_pdf = FALSE,   indexselect = NULL,   miny = 1,   col = NULL,   pch = 21,   lty = 1,   lwd = 2,   tickEndYr = FALSE,   xlim = \"default\",   ylim = \"default\",   ylimAdj = 1.4,   xaxs = \"i\",   yaxs = \"i\",   xylabs = TRUE,   type = \"o\",   legend = TRUE,   legendloc = \"top\",   legendcex = 1,   pwidth = 6.5,   pheight = 5,   punits = \"in\",   res = 300,   ptsize = 10,   cex.main = 1,   plotdir = NULL,   filenameprefix = \"\",   par = list(mar = c(5, 4, 1, 1) + 0.1),   verbose = TRUE,   new = TRUE,   add = FALSE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRunstest.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Residual Diagnostics — SSplotRunstest","text":"ss3rep Stock Synthesis output read r4ss::SS_output() mixing c(\"less\",\"greater\",\"two.sided\"). Default less checking positive autocorrelation subplots optional flag : \"cpue\" Index abundance data \"len\" Length composition data \"size\" Generalized size composition data \"age\" Age composition data \"con\" Conditional age--length data plot DEPRECATED. default, TRUE, Plots (subplots) drawn plot device. option explicitly disable option (FALSE), implemented. option flag defunct future version print DEPRECATED, please use print_plot. print_plot Flag enable plot graphic device print PNG PNG files. png DEPRECATED. Please use use_png. use_png Enables plots generated PNG files. Defaults print value pdf DEPRECATED. Please use use_pdf. use_pdf Enables plots generated pdf file. indexselect Vector fleet numbers model compare miny absolute value min max value ylim. Default 1 col Optional vector colors used lines. Input NULL pch Optional vector plot character values lty Optional vector line types lwd Optional vector line widths tickEndYr Logical flag: set TRUE FALSE switch turn /extra axis mark final year timeseries plots. xlim Optional, years use x-axis. Default value NULL (\"default\"), uses years available. ylim Optional, values y-axis range display plot. default: \"default\", range -1 1. ylimAdj Multiplier ylim parameter. Allows additional white space. xaxs Choice xaxs parameter See ?par info. yaxs Choice yaxs parameter. See ?par info. xylabs Logical flag: set TRUE FALSE include x- y-axis labels plot. Defaults TRUE type type plot drawn. details, see plot. legend Flag enable legend plot. TRUE default. legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See help(\"legend\") info string options. legendcex Allows adjust legend cex pwidth Default width plot printed plot units punits pheight Height plot printed plot units punits punits Measurement units pwidth pheight. Default \"\". \"px\" (pixels) \"\" (inches) \"cm\" (centimeters) \"mm\" (millimeters) res Resolution plots printed files. ptsize Point size plotted text plots printed files. See help(\"png\") details cex.main Character expansion plot titles. plotdir Directory output plot file written. default, directory model run. filenameprefix Additional text append output plot file name. separated default name underscore. par numerical vector form c(bottom, left, top, right) gives number lines margin specified four sides plot,passed par(). Entering NULL passes plot's default par() values (depends whether main title included ) verbose Flag print additional diagnostic messages R console new Deprecated. New plot windows created default (TRUE), option disable , via FALSE, unused. add suppresses par() create multiplot figs","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRunstest.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Residual Diagnostics — SSplotRunstest","text":"dataframe runs test p-value, test passed failed, 3x sigma high low limits, type data used. Rows fleet. Note, runs test passed p-value > 0.05 (residuals random) failed p-value < 0.5 (residuals random)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSplotRunstest.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Residual Diagnostics — SSplotRunstest","text":"Henning Winker (JRC-EC) Laurance Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSreadMCMC.html","id":null,"dir":"Reference","previous_headings":"","what":"Read SS MCMC — SSreadMCMC","title":"Read SS MCMC — SSreadMCMC","text":"function read mcmc file outputs Stock Synthesis model","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSreadMCMC.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Read SS MCMC — SSreadMCMC","text":"","code":"SSreadMCMC(mcmcdir)"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSreadMCMC.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Read SS MCMC — SSreadMCMC","text":"mcmcdir file path folder derived_posteriors.sso file","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSreadMCMC.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Read SS MCMC — SSreadMCMC","text":"Stock Synthesis mcmc output file","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSreadMCMC.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Read SS MCMC — SSreadMCMC","text":"Henning Winker (JRC-EC) & Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSretroComps.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Composition Data from Multiple SS Models — SSretroComps","title":"Retrieve Composition Data from Multiple SS Models — SSretroComps","text":"Wrapper get observed expected mean length/age multiple Stock Synthesis models.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSretroComps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Composition Data from Multiple SS Models — SSretroComps","text":"","code":"SSretroComps(retroModels)"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSretroComps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Composition Data from Multiple SS Models — SSretroComps","text":"retroModels object list replists r4ss::SSgetoutput()","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSretroComps.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Composition Data from Multiple SS Models — SSretroComps","text":"list observed expected mean Length/age comps (c.f. ss3rep[[\"cpue\"]])","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSretroComps.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Retrieve Composition Data from Multiple SS Models — SSretroComps","text":"Henning Winker","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrmse.html","id":null,"dir":"Reference","previous_headings":"","what":"Function for calculating RMSE\nused for SSplotJABBAres() — SSrmse","title":"Function for calculating RMSE\nused for SSplotJABBAres() — SSrmse","text":"Function calculating RMSE used SSplotJABBAres()","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrmse.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Function for calculating RMSE\nused for SSplotJABBAres() — SSrmse","text":"","code":"SSrmse(   ss3rep,   quants = c(\"cpue\", \"len\", \"age\", \"con\"),   seas = NULL,   indexselect = NULL )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrmse.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Function for calculating RMSE\nused for SSplotJABBAres() — SSrmse","text":"ss3rep output SS_output() quants dataset calculate RMSE . \"cpue\" index abundance, \"len\" length comp, \"age\" age composition, \"con\" conditional age--length. seas string indicating treat data multiple seasons 'comb' - combine seasonal data year plot Yr 'sep' - treat season separately, plotting Yr.S. .null(seas), assumed one season option 'comb' used. indexselect Vector fleet numbers model compare","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrmse.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Function for calculating RMSE\nused for SSplotJABBAres() — SSrmse","text":"returns list includes RMSE table output (fleet combined) dataframe residuals can used creating SSplotJABBAres() plot","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrunstest.html","id":null,"dir":"Reference","previous_headings":"","what":"Residual Diagnostics Plot — SSrunstest","title":"Residual Diagnostics Plot — SSrunstest","text":"Function residual diagnostics. Outputs runs test table gives runs test p-values, runs test passed (p-value > 0.05, residuals random) failed (p-value < 0.05, residuals random), 3x sigma limits indices mean age length type input data (cpue, length comp, age comp, size comp, conditional age--length).","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrunstest.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Residual Diagnostics Plot — SSrunstest","text":"","code":"SSrunstest(   ss3rep,   mixing = \"less\",   quants = c(\"cpue\", \"len\", \"age\", \"con\")[1],   indexselect = NULL,   verbose = TRUE )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrunstest.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Residual Diagnostics Plot — SSrunstest","text":"ss3rep Stock Synthesis output read r4ss::SS_output() mixing c(\"less\",\"greater\",\"two.sided\"). Default less checking positive autocorrelation quants optional use c(\"cpue\",\"len\",\"age\",\"con\"), default uses \"cpue\". \"cpue\" Index abundance data \"len\" Length composition data \"age\" Age composition data \"con\" Conditional age--length data indexselect Vector fleet numbers model compare verbose Report progress R GUI?","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrunstest.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Residual Diagnostics Plot — SSrunstest","text":"dataframe runs test p-value, test passed failed, 3x sigma high low limits, type data used. Rows fleet. Note, runs test passed p-value > 0.05 (residuals random) failed p-value < 0.5 (residuals random)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSrunstest.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Residual Diagnostics Plot — SSrunstest","text":"Henning Winker (JRC-EC) Laurance Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSsettingsBratioF.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Stock Status Settings — SSsettingsBratioF","title":"Get Stock Status Settings — SSsettingsBratioF","text":"function get Bratio F settings","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSsettingsBratioF.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Stock Status Settings — SSsettingsBratioF","text":"","code":"SSsettingsBratioF(ss3rep, status = c(\"Bratio\", \"F\"), verbose = TRUE)"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSsettingsBratioF.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Stock Status Settings — SSsettingsBratioF","text":"ss3rep r4ss::SSgetoutput() status covarying stock status quantaties extract Hessian verbose Report progress R GUI?","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSsettingsBratioF.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Stock Status Settings — SSsettingsBratioF","text":"output list Bratio F settings","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/SSsettingsBratioF.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Get Stock Status Settings — SSsettingsBratioF","text":"Henning Winker (JRC-EC)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ensemble_plot_index.html","id":null,"dir":"Reference","previous_headings":"","what":"Plot Indices — ensemble_plot_index","title":"Plot Indices — ensemble_plot_index","text":"function plot different fits single index abundance","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ensemble_plot_index.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plot Indices — ensemble_plot_index","text":"","code":"ensemble_plot_index(   summaryoutput,   varlist,   indexfleets = 1,   verbose = TRUE,   legendloc = \"topright\",   legendcex = 1,   legendsp = 0.9,   legendncol = 1,   type = \"l\" )"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ensemble_plot_index.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plot Indices — ensemble_plot_index","text":"summaryoutput summaryoutput varlist variable list indexfleets Fleet vector index verbose Option output messages Rconsole legendloc Location legend. Either string like \"topleft\" vector two numeric values representing fraction maximum x y dimensions, respectively. See ?legend info string options. legendcex Allows adjust legend cex legendsp Space legend labels legendncol Number columns legend. type Type parameter passed points (default 'o' overplots points top lines)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":null,"dir":"Reference","previous_headings":"","what":"Runs Test for Residuals — ssruns_sig3","title":"Runs Test for Residuals — ssruns_sig3","text":"function uses randtests::runs.test perform runs test residuals determine randomly distributed. also calculates 3 x sigma limits","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Runs Test for Residuals — ssruns_sig3","text":"","code":"ssruns_sig3(x, type = NULL, mixing = \"less\")"},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Runs Test for Residuals — ssruns_sig3","text":"x residuals CPUE fits type c(\"resid\",\"observations\") mixing c(\"less\",\"greater\",\"two.sided\"). Default less checking positive autocorrelation ","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Runs Test for Residuals — ssruns_sig3","text":"runs p value 3 x sigma limits","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Runs Test for Residuals — ssruns_sig3","text":"runs test conducted library(randtests)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/reference/ssruns_sig3.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Runs Test for Residuals — ssruns_sig3","text":"Henning Winker (JRC-EC) Laurence Kell (Sea++)","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-220","dir":"Changelog","previous_headings":"","what":"ss3diags 2.2.0","title":"ss3diags 2.2.0","text":"Add vignettes tutorials implementing interpreting diagnostic analyses (#78, #75, #73, #68). vignettes replaced “Cookbook recipe” R scripts updated code. Removed Rdata files (ss3diags::simple, ss3diags::retroSimple, ss3diags::mcmcSimple). objects now automatically produced vignettes. Removed deprecated data objects function arguments (#100). Created generic functions re-use common parameter documentation via roxygen tag @inheritParams (#66 #2). Update r4ss dependency. Replacing installation SS3 container R-CMD-Check GitHub Action workflow use r4ss::get_ss_exe() (#97).","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-211","dir":"Changelog","previous_headings":"","what":"ss3diags 2.1.1","title":"ss3diags 2.1.1","text":"Added new logo. Thanks @pdimens (#76, #77) Added options SSdeltaMVLN Variance-Coveriance approximation bias correction. Thanks @N-DucharmeBarth-NOAA (#64) Dependency resolves r4ss function name conflicts w/ dplyr kableExtra libraries (#83). Side effect nmfs-fish-tools/ghactions4r#69 Removed dplyr NAMESPACE. Removed roxygen import calls SSplotJABBAres() SSrmse(), appended dplyr function calls double colon operator (dplyr::) (#82) Updated default summaryoutput used SSplotModelComp() ss3diags::retroSimple default ss3rep used SSplotRunsTest() ss3diags::simple Updated ss3diags citation. Minor documentation link fixes.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-210","dir":"Changelog","previous_headings":"","what":"ss3diags 2.1.0","title":"ss3diags 2.1.0","text":"RMSE calculations modularized standalone function can called independently SSplotJABBAres() SSrmse(). (#50) Bugfixes adjusting y-axis limits SSplotRunstest SSplotJABBAres: Use ylim parameter adjust y-axis limits. (#46) Added option remove median trajectory SSplotKobe() (#3) Added rlang, dplyr, magrittr dependencies. SSmase SSplotHcxval: Corrected validation messsage clarify validation issue fix issue code styler. (#33, #35) Added Date field DESCRIPTION. DESCRIPTION metadata now used generate package citations. (#25) Package vingettes formatted html_vignette reduce file size. Removed redundant PDF word document versions ss3diags_Handbook vignette. Enabled markdown support roxygen. Enabled Cross-reference links.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-203","dir":"Changelog","previous_headings":"","what":"ss3diags 2.0.3","title":"ss3diags 2.0.3","text":"Changed r4ss dependency 1.44.0 (CRAN version) . Replaced default R CMD CHECK workflow NOAA-fish-tools/ghactions4r’s version. Fixed Ensemble Quantile Shading Issues (#4) Replaced example datasets ss3diags cookbook, handbook current “simple” ensemble model. Fixup minor code documentation formatting issues. SSmase SSplotHcxval: Fixed code styler’s dollar subset conversion issues. example:`message(‘x$name 1,2,3,4’)`","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-202","dir":"Changelog","previous_headings":"","what":"ss3diags 2.0.2","title":"ss3diags 2.0.2","text":"Changed r4ss CRAN version (1.36.1) dependency development version legendfun -> r4ss::add_legend pngfun -> r4ss::save_png rc -> r4ss::rich_colors_short sspar -> r4ss::sspar Fix SSplotRetro.R indention causing issues code styler","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-201","dir":"Changelog","previous_headings":"","what":"ss3diags 2.0.1","title":"ss3diags 2.0.1","text":"Change SSplotJABBAres show combined seasonal data boxplots Fixup links Cookbook sripts. Formatted DESCRIPTION URL BugReports links PIFSCstockassessments repo add R package site.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-200","dir":"Changelog","previous_headings":"","what":"ss3diags 2.0.0","title":"ss3diags 2.0.0","text":"simple, cod-like, Stock Synthesis model, simulated via ss3sim, replaces Pacific North Hake (pac.hke) North Atlantic Shortfin Mako Shark (natl.sma) example datasets. SSplotRetro: fixed bug shading uncertainty area shows xlims specified. SSplotJABBAres: added ‘con’ option subplots argument conditional age--length data can plotted. Also added seas argument user can specify data combined across seasons within year kept separate. SScompsTA1.8: added seas argument users can specify data combined across seasons within year kept separate. SSplot functions (SSplotModelComp, SSplotEnsemble, SSplotHCxval, SSplotJABBAres, SSplotRetro): Marked plot, png, pdf, print, new deprecated. defunct future version. Added NEWS.md file track changes package.","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-108","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.8","title":"ss3diags 1.0.8","text":"Fixed MASE","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-107","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.7","title":"ss3diags 1.0.7","text":"Bug fixes","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-106","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.6","title":"ss3diags 1.0.6","text":"Improved SSdiagsMCMC","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-105","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.5","title":"ss3diags 1.0.5","text":"Updated SSdeltaMVLN","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-104","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.4","title":"ss3diags 1.0.4","text":"Reference: authors changes","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-103","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.3","title":"ss3diags 1.0.3","text":"Added annF_ quantaties","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-102","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.2","title":"ss3diags 1.0.2","text":"Added aut","code":""},{"path":"https://pifscstockassessments.github.io/ss3diags/news/index.html","id":"ss3diags-101","dir":"Changelog","previous_headings":"","what":"ss3diags 1.0.1","title":"ss3diags 1.0.1","text":"Added SSplotH","code":""}]