Changeset 5bee29a in flex_extract.git for Documentation/html/Installation/local.html


Ignore:
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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • Documentation/html/Installation/local.html

    r5920b7f r5bee29a  
    99  <meta name="viewport" content="width=device-width, initial-scale=1.0">
    1010 
    11   <title>Local mode installation &mdash; flex_extract 7.1 alpha documentation</title>
     11  <title>Local mode installation &mdash; flex_extract 7.1.1 documentation</title>
    1212 
    1313
    … …  
    3939    <link rel="index" title="Index" href="../genindex.html" />
    4040    <link rel="search" title="Search" href="../search.html" />
    41     <link rel="next" title="Quick Start" href="../quick_start.html" />
     41    <link rel="next" title="Usage" href="../quick_start.html" />
    4242    <link rel="prev" title="Gateway mode installation" href="gateway.html" />
    4343</head>
    … …  
    6464           
    6565              <div class="version">
    66                 7.1
     66                7.1.1
    6767              </div>
    6868           
    … …  
    9090              <p class="caption"><span class="caption-text">Table of Contents:</span></p>
    9191<ul class="current">
     92<li class="toctree-l1"><a class="reference internal" href="../ecmwf_data.html">ECMWF Data</a></li>
    9293<li class="toctree-l1 current"><a class="reference internal" href="../installation.html">Installation</a><ul class="current">
    9394<li class="toctree-l2"><a class="reference internal" href="../installation.html#registration-at-ecmwf">Registration at ECMWF</a></li>
    … …  
    111112</ul>
    112113</li>
    113 <li class="toctree-l1"><a class="reference internal" href="../quick_start.html">Quick Start</a></li>
    114 <li class="toctree-l1"><a class="reference internal" href="../ecmwf_data.html">ECMWF Data</a></li>
    115 <li class="toctree-l1"><a class="reference internal" href="../documentation.html">Documentation</a></li>
     114<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">Usage</a></li>
     115<li class="toctree-l1"><a class="reference internal" href="../documentation.html">Code-Level Documentation</a></li>
    116116<li class="toctree-l1"><a class="reference internal" href="../evaluation.html">Evaluation</a></li>
    117117<li class="toctree-l1"><a class="reference internal" href="../dev_guide.html">Developer Guide</a></li>
    … …  
    197197<table class="docutils align-default">
    198198<colgroup>
    199 <col style="width: 74%" />
    200 <col style="width: 26%" />
     199<col style="width: 75%" />
     200<col style="width: 25%" />
    201201</colgroup>
    202202<tbody>
    203 <tr class="row-odd"><td><p>Python part</p></td>
    204 <td><p>Fortran part</p></td>
     203<tr class="row-odd"><td><p>Python code</p></td>
     204<td><p>Fortran code</p></td>
    205205</tr>
    206 <tr class="row-even"><td><ol class="arabic simple">
    207 <li><p><a class="reference external" href="https://www.python.org/downloads/">Python3</a></p></li>
     206<tr class="row-even"><td><ul class="simple">
     207<li><p><a class="reference external" href="https://www.python.org/">Python3</a></p></li>
    208208<li><p><a class="reference external" href="http://www.numpy.org/">numpy</a></p></li>
    209209<li><p><a class="reference external" href="https://genshi.edgewall.org/">genshi</a></p></li>
    210 <li><p><a class="reference external" href="https://packages.debian.org/sid/python3-eccodes">eccodes for python</a></p></li>
     210<li><p><a class="reference external" href="https://pypi.org/project/eccodes-python/">eccodes for python</a></p></li>
    211211<li><p><a class="reference external" href="https://confluence.ecmwf.int/display/WEBAPI/ECMWF+Web+API+Home">ecmwf-api-client</a> (everything except ERA5)</p></li>
    212212<li><p><a class="reference external" href="https://cds.climate.copernicus.eu/api-how-to">cdsapi</a> (just for ERA5 and member user)</p></li>
    213 </ol>
     213</ul>
    214214</td>
    215 <td><ol class="arabic simple">
     215<td><ul class="simple">
    216216<li><p><a class="reference external" href="https://gcc.gnu.org/wiki/GFortran">gfortran</a></p></li>
    217217<li><p><a class="reference external" href="http://www.fftw.org">fftw3</a></p></li>
    218218<li><p><a class="reference external" href="https://software.ecmwf.int/wiki/display/ECC">eccodes</a></p></li>
    219219<li><p><a class="reference external" href="https://software.ecmwf.int/wiki/display/EMOS/Emoslib">emoslib</a></p></li>
    220 </ol>
     220</ul>
    221221</td>
    222222</tr>
    … …  
    394394<div class="section" id="local-installation">
    395395<span id="ref-install-local"></span><h2>Local installation<a class="headerlink" href="#local-installation" title="Permalink to this headline">¶</a></h2>
    396 <p>First, adapt the Fortran <code class="docutils literal notranslate"><span class="pre">makefile</span></code> for your environment (if necessary) and insert it into <code class="docutils literal notranslate"><span class="pre">setup.sh</span></code> script (see <a class="reference internal" href="../Documentation/Input/fortran_makefile.html#ref-convert"><span class="std std-ref">Fortran Makefile</span></a> for more information).
    397 They can be found at <code class="docutils literal notranslate"><span class="pre">flex_extract_vX.X/Source/Fortran/</span></code>, where <code class="docutils literal notranslate"><span class="pre">vX.X</span></code> should be substituted by the current flex_extract version number.</p>
    398 <div class="admonition caution">
    399 <p class="admonition-title">Caution</p>
    400 <p>It is necessary to adapt <strong>ECCODES_INCLUDE_DIR</strong> and <strong>ECCODES_LIB</strong> in these
    401 <code class="docutils literal notranslate"><span class="pre">makefiles</span></code> if other than standard paths are used.</p>
    402 </div>
    403 <p>Thus, go to the <code class="docutils literal notranslate"><span class="pre">Fortran</span></code> source directory and open the <code class="docutils literal notranslate"><span class="pre">makefile</span></code> of your
    404 choice, and check / modify with an editor of your choice:</p>
    405 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">cd</span> flex_extract_vX.X/Source/Fortran
    406 nedit makefile_fast
    407 </pre></div>
    408 </div>
    409 <p>Set the paths to the <code class="docutils literal notranslate"><span class="pre">eccodes</span></code> library on your local machine, if necessary.</p>
    410 <div class="admonition caution">
    411 <p class="admonition-title">Caution</p>
    412 <p>This can vary from system to system.
    413 It is suggested to use a command like</p>
    414 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># for the ECCODES_INCLUDE_DIR path do:</span>
    415 $ dpkg -L libeccodes-dev <span class="p">|</span> grep eccodes.mod
    416 <span class="c1"># for the ECCODES_LIB path do:</span>
    417 $ dpkg -L libeccodes-dev <span class="p">|</span> grep libeccodes.so
    418 </pre></div>
    419 </div>
    420 <p>to find out the path to the <code class="docutils literal notranslate"><span class="pre">eccodes</span></code> library.</p>
    421 </div>
    422 <p>Assign these paths to the parameters <strong>ECCODES_INCLUDE_DIR</strong>
    423 and <strong>ECCODES_LIB</strong> in the makefile, and save it.</p>
    424 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># these are the paths on Debian Buster:</span>
    425 <span class="nv">ECCODES_INCLUDE_DIR</span><span class="o">=</span>/usr/lib/x86_64-linux-gnu/fortran/gfortran-mod-15/
    426 <span class="nv">ECCODES_LIB</span><span class="o">=</span> -L/usr/lib -leccodes_f90 -leccodes -lm
    427 </pre></div>
    428 </div>
    429396<p>The Fortran program called <code class="docutils literal notranslate"><span class="pre">calc_etadot</span></code> will be compiled during the
    430 installation process. Therefore, the name of the <code class="docutils literal notranslate"><span class="pre">makefile</span></code> to be used needs to be given in  <code class="docutils literal notranslate"><span class="pre">setup.sh</span></code>.</p>
     397installation process. A suitable makefile (<code class="docutils literal notranslate"><span class="pre">makefile_local_gfortran</span></code>) for the compilation is set by default.
     398This may be overwritten by the <code class="docutils literal notranslate"><span class="pre">MAKEFILE</span></code> parameter in <code class="docutils literal notranslate"><span class="pre">setup.sh</span></code>.</p>
     399<p>However, you may have to adapt the makefile for your environment (the current default makefile works on Debian stretch and similar GNU/Linux distributions). If you use a new name for it, you will have to insert it into <code class="docutils literal notranslate"><span class="pre">setup.sh</span></code>
     400For details on the makefile and how to adapt them, see <a class="reference internal" href="../Documentation/Input/fortran_makefile.html#ref-convert"><span class="std std-ref">Fortran Makefile</span></a>.</p>
    431401<p>In the root directory of <code class="docutils literal notranslate"><span class="pre">flex_extract</span></code>, open the <code class="docutils literal notranslate"><span class="pre">setup.sh</span></code> script
    432402with an editor and adapt the installation parameters in the section labelled with
    … …  
    441411<span class="c1">#</span>
    442412<span class="nv">TARGET</span><span class="o">=</span><span class="s1">&#39;local&#39;</span>
    443 <span class="nv">MAKEFILE</span><span class="o">=</span><span class="s1">&#39;makefile_fast&#39;</span>
    444413<span class="nv">ECUID</span><span class="o">=</span>None
    445414<span class="nv">ECGID</span><span class="o">=</span>None
    … …  
    463432    Install flex_extract_v7.1 software at <span class="nb">local</span> in directory &lt;path-to-flex_extract&gt;/flex_extract_v7.1
    464433
    465     Using makefile: makefile_fast
     434    Using makefile: makefile_local_gfortran
    466435    gfortran   -O3 -march<span class="o">=</span>native -Bstatic -leccodes_f90 -leccodes -Bdynamic -lm -ljasper -lemosR64 -I. -I/usr/local/include -fdefault-real-8 -fopenmp -fconvert<span class="o">=</span>big-endian   -c     ./rwgrib2.f90
    467436    gfortran   -O3 -march<span class="o">=</span>native -Bstatic -leccodes_f90 -leccodes -Bdynamic -lm -ljasper -lemosR64 -I. -I/usr/local/include -fdefault-real-8 -fopenmp -fconvert<span class="o">=</span>big-endian   -c     ./phgrreal.f90
    … …  
    487456    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
    488457     
    489         <a href="../quick_start.html" class="btn btn-neutral float-right" title="Quick Start" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
     458        <a href="../quick_start.html" class="btn btn-neutral float-right" title="Usage" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
    490459     
    491460     
    … …  
    499468  <div role="contentinfo">
    500469    <p>
    501         &copy; Copyright 2020, Anne Philipp and Leopold Haimberger
     470        &copy; Copyright 2020, Anne Philipp, Leopold Haimberger and Petra Seibert
    502471
    503472    </p>
Note: See TracChangeset for help on using the changeset viewer.
hosted by ZAMG