Skip to content

Commit

Permalink
Built site for gh-pages
Browse files Browse the repository at this point in the history
  • Loading branch information
Quarto GHA Workflow Runner committed Jan 2, 2024
1 parent 4f64f9c commit a419a5c
Show file tree
Hide file tree
Showing 5 changed files with 141 additions and 13 deletions.
2 changes: 1 addition & 1 deletion .nojekyll
Original file line number Diff line number Diff line change
@@ -1 +1 @@
d8863f3c
9b0cc1ef
128 changes: 128 additions & 0 deletions content/gsi/05-tutorial.html
Original file line number Diff line number Diff line change
Expand Up @@ -470,6 +470,134 @@ <h3 class="anchored" data-anchor-id="did-it-work-1">Did it work?</h3>
</section>
<section id="running-gsi-using-the-fgat-method" class="level2">
<h2 class="anchored" data-anchor-id="running-gsi-using-the-fgat-method">Running GSI using the FGAT method</h2>
<p>The tutorial is configured to use the FGAT (First Guess at Appropriate Time) methods, this means that will GSI attempt to read multiple time level backgrounds a show in the following diagram.</p>
<div class="quarto-figure quarto-figure-center">
<figure class="figure">
<p><img src="img/fgat_diagram.png" class="img-fluid figure-img" alt="A diagram that shows the assimilation window of 1 h centered at 12 UTC. The observations are used every 10 minutes"></p>
<figcaption class="figure-caption">FGAT method</figcaption>
</figure>
</div>
<p>There is no option in the namelist or configuration files to use the FGAT method. To “activate” this option GSI needs to find the appropiate files in appropriate folder. In this example we have 7 files in total for each member, 1 background file at the assimilation time plus 3 files every 10 minutes before and after the assimilation time.</p>
<p>So, GSI will expect to find files called <code>wrf_inou1</code> to <code>wrf_inou7</code>. The fonder structure looks like this:</p>
<div class="sourceCode" id="cb5"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="ex">GUESS/</span></span>
<span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a><span class="ex">└──</span> 20181122120000</span>
<span id="cb5-3"><a href="#cb5-3" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> 00</span>
<span id="cb5-4"><a href="#cb5-4" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrfarw.ensmean</span>
<span id="cb5-5"><a href="#cb5-5" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrfarw.mem001</span>
<span id="cb5-6"><a href="#cb5-6" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrfarw.mem002</span>
<span id="cb5-7"><a href="#cb5-7" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrfarw.mem003</span>
<span id="cb5-8"><a href="#cb5-8" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrfarw.mem004</span>
<span id="cb5-9"><a href="#cb5-9" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrfarw.mem005</span>
<span id="cb5-10"><a href="#cb5-10" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrfarw.mem006</span>
<span id="cb5-11"><a href="#cb5-11" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrfarw.mem007</span>
<span id="cb5-12"><a href="#cb5-12" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrfarw.mem008</span>
<span id="cb5-13"><a href="#cb5-13" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrfarw.mem009</span>
<span id="cb5-14"><a href="#cb5-14" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> └── wrfarw.mem010</span>
<span id="cb5-15"><a href="#cb5-15" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> 01</span>
<span id="cb5-16"><a href="#cb5-16" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou1</span>
<span id="cb5-17"><a href="#cb5-17" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou2</span>
<span id="cb5-18"><a href="#cb5-18" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou3</span>
<span id="cb5-19"><a href="#cb5-19" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou4</span>
<span id="cb5-20"><a href="#cb5-20" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou5</span>
<span id="cb5-21"><a href="#cb5-21" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou6</span>
<span id="cb5-22"><a href="#cb5-22" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> └── wrf_inou7</span>
<span id="cb5-23"><a href="#cb5-23" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> 02</span>
<span id="cb5-24"><a href="#cb5-24" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou1</span>
<span id="cb5-25"><a href="#cb5-25" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou2</span>
<span id="cb5-26"><a href="#cb5-26" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou3</span>
<span id="cb5-27"><a href="#cb5-27" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou4</span>
<span id="cb5-28"><a href="#cb5-28" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou5</span>
<span id="cb5-29"><a href="#cb5-29" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou6</span>
<span id="cb5-30"><a href="#cb5-30" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> └── wrf_inou7</span>
<span id="cb5-31"><a href="#cb5-31" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> 03</span>
<span id="cb5-32"><a href="#cb5-32" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou1</span>
<span id="cb5-33"><a href="#cb5-33" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou2</span>
<span id="cb5-34"><a href="#cb5-34" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou3</span>
<span id="cb5-35"><a href="#cb5-35" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou4</span>
<span id="cb5-36"><a href="#cb5-36" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou5</span>
<span id="cb5-37"><a href="#cb5-37" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou6</span>
<span id="cb5-38"><a href="#cb5-38" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> └── wrf_inou7</span>
<span id="cb5-39"><a href="#cb5-39" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> 04</span>
<span id="cb5-40"><a href="#cb5-40" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou1</span>
<span id="cb5-41"><a href="#cb5-41" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou2</span>
<span id="cb5-42"><a href="#cb5-42" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou3</span>
<span id="cb5-43"><a href="#cb5-43" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou4</span>
<span id="cb5-44"><a href="#cb5-44" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou5</span>
<span id="cb5-45"><a href="#cb5-45" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou6</span>
<span id="cb5-46"><a href="#cb5-46" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> └── wrf_inou7</span>
<span id="cb5-47"><a href="#cb5-47" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> 05</span>
<span id="cb5-48"><a href="#cb5-48" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou1</span>
<span id="cb5-49"><a href="#cb5-49" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou2</span>
<span id="cb5-50"><a href="#cb5-50" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou3</span>
<span id="cb5-51"><a href="#cb5-51" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou4</span>
<span id="cb5-52"><a href="#cb5-52" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou5</span>
<span id="cb5-53"><a href="#cb5-53" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou6</span>
<span id="cb5-54"><a href="#cb5-54" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> └── wrf_inou7</span>
<span id="cb5-55"><a href="#cb5-55" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> 06</span>
<span id="cb5-56"><a href="#cb5-56" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou1</span>
<span id="cb5-57"><a href="#cb5-57" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou2</span>
<span id="cb5-58"><a href="#cb5-58" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou3</span>
<span id="cb5-59"><a href="#cb5-59" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou4</span>
<span id="cb5-60"><a href="#cb5-60" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou5</span>
<span id="cb5-61"><a href="#cb5-61" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou6</span>
<span id="cb5-62"><a href="#cb5-62" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> └── wrf_inou7</span>
<span id="cb5-63"><a href="#cb5-63" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> 07</span>
<span id="cb5-64"><a href="#cb5-64" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou1</span>
<span id="cb5-65"><a href="#cb5-65" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou2</span>
<span id="cb5-66"><a href="#cb5-66" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou3</span>
<span id="cb5-67"><a href="#cb5-67" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou4</span>
<span id="cb5-68"><a href="#cb5-68" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou5</span>
<span id="cb5-69"><a href="#cb5-69" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou6</span>
<span id="cb5-70"><a href="#cb5-70" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> └── wrf_inou7</span>
<span id="cb5-71"><a href="#cb5-71" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> 08</span>
<span id="cb5-72"><a href="#cb5-72" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou1</span>
<span id="cb5-73"><a href="#cb5-73" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou2</span>
<span id="cb5-74"><a href="#cb5-74" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou3</span>
<span id="cb5-75"><a href="#cb5-75" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou4</span>
<span id="cb5-76"><a href="#cb5-76" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou5</span>
<span id="cb5-77"><a href="#cb5-77" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou6</span>
<span id="cb5-78"><a href="#cb5-78" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> └── wrf_inou7</span>
<span id="cb5-79"><a href="#cb5-79" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> 09</span>
<span id="cb5-80"><a href="#cb5-80" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou1</span>
<span id="cb5-81"><a href="#cb5-81" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou2</span>
<span id="cb5-82"><a href="#cb5-82" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou3</span>
<span id="cb5-83"><a href="#cb5-83" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou4</span>
<span id="cb5-84"><a href="#cb5-84" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou5</span>
<span id="cb5-85"><a href="#cb5-85" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> ├── wrf_inou6</span>
<span id="cb5-86"><a href="#cb5-86" aria-hidden="true" tabindex="-1"></a> <span class="ex">│&nbsp;&nbsp;</span> └── wrf_inou7</span>
<span id="cb5-87"><a href="#cb5-87" aria-hidden="true" tabindex="-1"></a> <span class="ex">└──</span> 10</span>
<span id="cb5-88"><a href="#cb5-88" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> wrf_inou1</span>
<span id="cb5-89"><a href="#cb5-89" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> wrf_inou2</span>
<span id="cb5-90"><a href="#cb5-90" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> wrf_inou3</span>
<span id="cb5-91"><a href="#cb5-91" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> wrf_inou4</span>
<span id="cb5-92"><a href="#cb5-92" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> wrf_inou5</span>
<span id="cb5-93"><a href="#cb5-93" aria-hidden="true" tabindex="-1"></a> <span class="ex">├──</span> wrf_inou6</span>
<span id="cb5-94"><a href="#cb5-94" aria-hidden="true" tabindex="-1"></a> <span class="ex">└──</span> wrf_inou7</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>The files in folders <code>01</code> to <code>10</code> are the ones used during the assimilation. The files in fonder <code>00</code> where used to calculate the ensemble mean and can be also used to run GSI without the FGAT option. For that it is necessary to uncomment line 102 in the <code>run_gsi.sh</code> script:</p>
<div class="sourceCode" id="cb6"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="co"># BK_FILE_mem=${BK_ROOT}/wrfarw.mem</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>and change lines 600 and 601 from:</p>
<div class="sourceCode" id="cb7"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="fu">cp</span> <span class="va">${BK_ROOT}</span>/<span class="va">${ensmemid}</span>/wrf_inou<span class="pp">*</span> .</span>
<span id="cb7-2"><a href="#cb7-2" aria-hidden="true" tabindex="-1"></a><span class="va">BK_FILE_ANA</span><span class="op">=</span>wrf_inou4</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>to:</p>
<div class="sourceCode" id="cb8"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="fu">cp</span> <span class="va">${BK_ROOT}</span>/00/wrfarw_mem0<span class="va">${ensmemid}</span>.</span>
<span id="cb8-2"><a href="#cb8-2" aria-hidden="true" tabindex="-1"></a><span class="va">BK_FILE_ANA</span><span class="op">=</span><span class="va">${BK_FILE}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>That way, GSI will ignore the other folder and only use 1 background file for each member.</p>
<p>To check if GSI is doing what’s suppose to, we need to check the <code>stdout</code> file created during the observation operator step.</p>
<div class="sourceCode" id="cb9"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="ex">CONVERT_NETCDF_MASS:</span> problem with flnm1 = wrf_inou1, Status = <span class="at">-1021</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>Means that GSI did not find all the background files and only used the one at the analysis time.</p>
<p>Instead if you see something this:</p>
<div class="sourceCode" id="cb10"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="ex">convert</span> wrf_inou1 to sigf01</span>
<span id="cb10-2"><a href="#cb10-2" aria-hidden="true" tabindex="-1"></a> <span class="ex">iy,m,d,h,m,s=</span> 2018 11 22 11 30 0</span>
<span id="cb10-3"><a href="#cb10-3" aria-hidden="true" tabindex="-1"></a> <span class="ex">dh1</span> = 1</span>
<span id="cb10-4"><a href="#cb10-4" aria-hidden="true" tabindex="-1"></a> <span class="ex">rmse_var</span> = SMOIS</span>
<span id="cb10-5"><a href="#cb10-5" aria-hidden="true" tabindex="-1"></a> <span class="ex">ndim1</span> = 3</span>
<span id="cb10-6"><a href="#cb10-6" aria-hidden="true" tabindex="-1"></a> <span class="ex">ordering</span> = XYZ</span>
<span id="cb10-7"><a href="#cb10-7" aria-hidden="true" tabindex="-1"></a> <span class="ex">staggering</span> = N/A</span>
<span id="cb10-8"><a href="#cb10-8" aria-hidden="true" tabindex="-1"></a> <span class="ex">start_index</span> = 1 1 1 0</span>
<span id="cb10-9"><a href="#cb10-9" aria-hidden="true" tabindex="-1"></a> <span class="ex">end_index</span> = 199 239 4 0</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>You’ll know that GSI is using the FGAT method. The example here shows that GSI found the <code>wrf_inout1</code> file that is renaming to <code>sig01</code> and then, information related to the time and domain characteristics. This will be repeated for each background file. In this case the first file corresponds to th 11:30 UTC of November 2018 and after that there is 1 file every 10 minutes.</p>
<p>This period between background files (10 minutes) is defined by the user when saving the background files. Again there is no configuration option to do this. GSI relies on finding the files in the especified folder.</p>
<hr>
<div class="callout callout-style-default callout-important callout-titled">
<div class="callout-header d-flex align-content-center">
<div class="callout-icon-container">
Expand Down
Binary file added content/gsi/img/fgat_diagram.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit a419a5c

Please sign in to comment.