Changeset 5bee29a in flex_extract.git for Documentation/html/Support

Timestamp:

Jun 1, 2020, 8:41:16 PM (4 years ago)

Author:

anphi <anne.philipp@…>

Branches:

master, ctbto, dev

Children:

8a53342

Parents:

a9d33f6

Message:

new compilation of Sphinx

Location:

Documentation/html/Support

Files:

• faq.html (modified) (6 diffs)
• known_bugs_issues.html (modified) (7 diffs)

Documentation/html/Support/faq.html

@@ -9 +9 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>FAQ - Frequently asked questions &mdash; flex_extract 7.1 alpha documentation</title>
+  <title>FAQ - Frequently asked questions &mdash; flex_extract 7.1.1 documentation</title>
   
 
@@ -64 +64 @@
             
               <div class="version">
-                7.1
+                7.1.1
               </div>
             
@@ -90 +90 @@
               <p class="caption"><span class="caption-text">Table of Contents:</span></p>
 <ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../ecmwf_data.html">ECMWF Data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../installation.html">Installation</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">Quick Start</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../ecmwf_data.html">ECMWF Data</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../documentation.html">Documentation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">Usage</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../documentation.html">Code-Level Documentation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../evaluation.html">Evaluation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../dev_guide.html">Developer Guide</a></li>
@@ -99 +99 @@
 <li class="toctree-l1"><a class="reference internal" href="../support.html">Support</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">FAQ - Frequently asked questions</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="#what-can-i-do-if-i-can-t-install-the-third-party-libraries-from-distribution-packages">What can I do if I can’t install the third party libraries from distribution packages?</a><ul class="simple">
+<li class="toctree-l2"><a class="reference internal" href="#what-can-i-do-if-i-can-t-install-the-third-party-libraries-from-distribution-packages">What can I do if I can’t install the third-party libraries from distribution packages?</a><ul class="simple">
 </ul>
 </li>
@@ -173 +173 @@
 <div class="contents local topic" id="contents">
 <ul class="simple">
-<li><p><a class="reference internal" href="#what-can-i-do-if-i-can-t-install-the-third-party-libraries-from-distribution-packages" id="id1">What can I do if I can’t install the third party libraries from distribution packages?</a></p></li>
+<li><p><a class="reference internal" href="#what-can-i-do-if-i-can-t-install-the-third-party-libraries-from-distribution-packages" id="id1">What can I do if I can’t install the third-party libraries from distribution packages?</a></p></li>
 </ul>
 </div>
 <div class="section" id="what-can-i-do-if-i-can-t-install-the-third-party-libraries-from-distribution-packages">
-<h2><a class="toc-backref" href="#id1">What can I do if I can’t install the third party libraries from distribution packages?</a><a class="headerlink" href="#what-can-i-do-if-i-can-t-install-the-third-party-libraries-from-distribution-packages" title="Permalink to this headline">¶</a></h2>
-<p>This can be the case if the user does not have admin rights.
-It is possible to install the necessary libraries locally from source.
-For this case you should follow the following steps:</p>
+<h2><a class="toc-backref" href="#id1">What can I do if I can’t install the third-party libraries from distribution packages?</a><a class="headerlink" href="#what-can-i-do-if-i-can-t-install-the-third-party-libraries-from-distribution-packages" title="Permalink to this headline">¶</a></h2>
+<p>This can be the case if the user does not have admin rights and the sysadmins would not want to provide the libraries.
+In this case, a workaround is to install the necessary libraries from source into a user directory, following these steps:</p>
 <dl class="simple">
-<dt>Installation hints:</dt><dd><ol class="arabic simple">
+<dt>Steps to install libraries from source:</dt><dd><ol class="arabic simple">
 <li><p><a class="reference external" href="https://software.ecmwf.int/wiki/display/EMOS/Emoslib">Read Emoslib installation instructions</a></p></li>
 <li><p><a class="reference external" href="https://software.ecmwf.int/wiki/display/SUP/2015/05/11/Building+ECMWF+software+with+gfortran">Read ECMWF blog about gfortran</a></p></li>
 <li><p><a class="reference external" href="http://www.fftw.org">Install FFTW</a></p></li>
-<li><p><a class="reference external" href="https://software.ecmwf.int/wiki/display/EMOS/Emoslib">Install EMOSLIB</a> (2 times make! one without any options and one with single precision option)</p></li>
+<li><p><a class="reference external" href="https://software.ecmwf.int/wiki/display/EMOS/Emoslib">Install EMOSLIB</a> (execute <code class="docutils literal notranslate"><span class="pre">make</span></code> two times! One time without any options, and another time with the single-precision option.)</p></li>
 <li><p><a class="reference external" href="https://software.ecmwf.int/wiki/display/ECC">Install ECCODES</a></p></li>
-<li><p>Register at Mars (<a class="reference internal" href="../installation.html#ref-registration"><span class="std std-ref">Registration at ECMWF</span></a>)</p></li>
+<li><p>Register for MARS access (<a class="reference internal" href="../installation.html#ref-registration"><span class="std std-ref">Registration at ECMWF</span></a>)</p></li>
 <li><p>Install Web API’s <a class="reference external" href="https://cds.climate.copernicus.eu/api-how-to">CDS API</a> and <a class="reference external" href="https://confluence.ecmwf.int/display/WEBAPI/ECMWF+Web+API+Home">ECMWF Web API</a></p></li>
-<li><p>Check LD_LIBRARY_PATH environment variable if it contains all paths to the libs</p></li>
-<li><p>Check available python packages (e.g. import eccodes / import grib_api / import ecmwfapi)</p></li>
-<li><p>Start test retrieval (<a class="reference internal" href="../Installation/local.html#ref-test-local"><span class="std std-ref">Test local environment</span></a>)</p></li>
+<li><p>Check whether LD_LIBRARY_PATH environment variable contains the paths to all the libs</p></li>
+<li><p>Check available Python packages (e.g. <code class="docutils literal notranslate"><span class="pre">import</span> <span class="pre">eccodes</span></code> / <code class="docutils literal notranslate"><span class="pre">import</span> <span class="pre">grib_api</span></code> / <code class="docutils literal notranslate"><span class="pre">import</span> <span class="pre">ecmwfapi</span></code>)</p></li>
+<li><p>Start test retrieval (<a class="reference internal" href="../Installation/local.html#ref-test-local"><span class="std std-ref">Testing the local environment</span></a>)</p></li>
 <li><p>Install <code class="docutils literal notranslate"><span class="pre">flex_extract</span></code> (<a class="reference internal" href="../installation.html"><span class="doc">Installation</span></a>)</p></li>
 </ol>
@@ -230 +229 @@
   <div role="contentinfo">
     <p>
-        &copy; Copyright 2020, Anne Philipp and Leopold Haimberger
+        &copy; Copyright 2020, Anne Philipp, Leopold Haimberger and Petra Seibert
 
     </p>

Documentation/html/Support/known_bugs_issues.html

@@ -9 +9 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Known Bugs and Issues &mdash; flex_extract 7.1 alpha documentation</title>
+  <title>Known Bugs and Issues &mdash; flex_extract 7.1.1 documentation</title>
   
 
@@ -62 +62 @@
             
               <div class="version">
-                7.1
+                7.1.1
               </div>
             
@@ -88 +88 @@
               <p class="caption"><span class="caption-text">Table of Contents:</span></p>
 <ul>
+<li class="toctree-l1"><a class="reference internal" href="../ecmwf_data.html">ECMWF Data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../installation.html">Installation</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">Quick Start</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../ecmwf_data.html">ECMWF Data</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../documentation.html">Documentation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">Usage</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../documentation.html">Code-Level Documentation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../evaluation.html">Evaluation</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../dev_guide.html">Developer Guide</a></li>
@@ -175 +175 @@
 <h3>Installation problems with <code class="docutils literal notranslate"><span class="pre">GATEWAY</span></code> and <code class="docutils literal notranslate"><span class="pre">DESTINATION</span></code> parameters<a class="headerlink" href="#installation-problems-with-gateway-and-destination-parameters" title="Permalink to this headline">¶</a></h3>
 <blockquote>
-<div><p>See ticket <a class="reference external" href="https://www.flexpart.eu/ticket/263">#263</a>  on flexpart.eu for information.</p>
+<div><p>See ticket <a class="reference external" href="https://www.flexpart.eu/ticket/263">#263</a>  on flexpart.eu for information. Fixed in v7.1.1.</p>
 </div></blockquote>
 </div>
@@ -181 +181 @@
 <h3>Installation problems with the Fortran program <code class="docutils literal notranslate"><span class="pre">calc_etadot</span></code><a class="headerlink" href="#installation-problems-with-the-fortran-program-calc-etadot" title="Permalink to this headline">¶</a></h3>
 <blockquote>
-<div><p>See ticket <a class="reference external" href="https://www.flexpart.eu/ticket/264">#264</a>  on flexpart.eu for information.</p>
+<div><p>See ticket <a class="reference external" href="https://www.flexpart.eu/ticket/264">#264</a>  on flexpart.eu for information. Fixed in v7.1.1.</p>
 </div></blockquote>
 </div>
 <div class="section" id="eccodes-error-code-250">
 <h3>ECCODES Error Code 250<a class="headerlink" href="#eccodes-error-code-250" title="Permalink to this headline">¶</a></h3>
-<p>If you get an error message from ECCODES with code 250, locking like this:</p>
+<p>If you get an error message from ECCODES with code 250, looking like this:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ECCODES ERROR   :   wrong size <span class="o">(</span><span class="m">184</span><span class="o">)</span> <span class="k">for</span> pv it contains <span class="m">276</span> values
 ECCODES ERROR   :  get: pv Passed array is too small
@@ -196 +196 @@
 </div>
 <p>then you have set a wrong maximum level in the <code class="docutils literal notranslate"><span class="pre">CONTROL</span></code> file!
-It is important to properly select the maximum level depending on the data set you would like to retrieve. The following model level definitions (number of model levels available) are limited to [16, 19, 31, 40, 50, 60, 62, 91, 137]. The ERA-Interim data set uses 62 model levels and <em>ERA5</em> as well as <em>CERA-20C</em> uses 137. The operational data set uses different model levels depending on the date. For example, on the 25/06/2013 the operational system started to use 137 model levels. Therefore, everytime you extract data from a date later than 25/06/2013 you have to select LEVEL=137 in the <code class="docutils literal notranslate"><span class="pre">CONTROL</span></code> file or define a LEVELLIST=1/to/137. Of course you can stop before the top of the atmosphere, such as 60/to/137, but you have to select the maximum level number as the last one. Table 2 in the <a class="reference external" href="https://www.geosci-model-dev-discuss.net/gmd-2019-358/">scientific model description paper</a> gives an overview of the level lists and the corresponding introducstion date.</p>
+It is important to properly select the maximum level depending on the data set you would like to retrieve. Only the following values of the number of model levels available are valid: 16, 19, 31, 40, 50, 60, 62, 91, 137.</p>
+<p>The ERA-Interim data set uses 62 model levels and <em>ERA5</em> as well as <em>CERA-20C</em> uses 137.</p>
+<p>The operational data sets use different numbers, depending on the date. For example, from 25/06/2013 on, 137 model levels were used in the operational system. Therefore, every time you extract data from a date later than 25/06/2013 you have to select LEVEL=137 in the <code class="docutils literal notranslate"><span class="pre">CONTROL</span></code> file, or you have to define LEVELLIST=1/to/137. Of course, you can stop before the top of the atmosphere, such as 60/to/137, but you have to include the maximum level number (i. e., the lowest level, see note below!) number as the last one. Table 2 in the <a class="reference external" href="https://www.geosci-model-dev-discuss.net/gmd-2019-358/">scientific model description paper</a> gives an overview of the level lists and the corresponding date they were introduced.</p>
 <div class="admonition note">
 <p class="admonition-title">Note</p>
-<p>Remember that model level 1 corresponds to the top of the atmosphere and then increases in the direction of the surface.</p>
+<p>Be aware that the ECMWF model counts the levels from the top of the atmosphere downward to the surface. Level 1 is the topmost level, and e.g. 137 would be the level closest to the ground.</p>
 </div>
 </div>
@@ -216 +218 @@
   <div role="contentinfo">
     <p>
-        &copy; Copyright 2020, Anne Philipp and Leopold Haimberger
+        &copy; Copyright 2020, Anne Philipp, Leopold Haimberger and Petra Seibert
 
     </p>