Metadata-Version: 2.1
Name: esm-tools
Version: 6.6.1
Summary: ESM Tools external infrastructure for Earth System Modelling
Home-page: https://github.com/esm-tools/esm_tools
Author: Dirk Barbi
Author-email: dirk.barbi@awi.de
License: GNU General Public License v2
Keywords: esm_tools
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6, <3.10
Requires-Dist: Click (>=7.0)
Requires-Dist: PyGithub
Requires-Dist: colorama
Requires-Dist: coloredlogs
Requires-Dist: emoji
Requires-Dist: f90nml
Requires-Dist: gfw-creator
Requires-Dist: gitpython
Requires-Dist: loguru
Requires-Dist: numpy
Requires-Dist: packaging
Requires-Dist: pandas (>=1.0)
Requires-Dist: psutil
Requires-Dist: pyyaml
Requires-Dist: pyyaml (>=5.1)
Requires-Dist: questionary
Requires-Dist: semver
Requires-Dist: six
Requires-Dist: sqlalchemy
Requires-Dist: tabulate
Requires-Dist: tqdm
Requires-Dist: typing-extensions (>=3.10.0.0)
Requires-Dist: xdgenvpy

=========
ESM Tools
=========

.. image:: https://readthedocs.org/projects/esm-tools/badge/?version=latest

For our complete documentation, please check https://esm-tools.readthedocs.io/en/latest/index.html.


Before you continue
-------------------

You will need python 3 (possibly version 3.6 or newer), a version of git that is not ancient (everything newer than 2.10 should be good), and up-to-date pip (``pip install -U pip``) to install the `esm_tools`. That means that on the supported machines, you could for example use the following settings:

ollie.awi.de::

    $ module load git
    $ module load python3

mistral.dkrz.de::

    $ module load git
    $ module unload netcdf_c
    $ module load anaconda3

glogin.hlrn.de / blogin.hlrn.de::

    $ module load git
    $ module load anaconda3

juwels.fz-juelich.de::

    $ module load git
    $ module load Python-3.6.8

aleph::

    $ module load git
    $ module load python

Note that some machines might raise an error ``conflict netcdf_c`` when loading ``anaconda3``. In that case you will need to swap ``netcdf_c`` with ``anaconda3``::

    $ module unload netcdf_c
    $ module load anaconda3



Installing
----------

1. First, make sure you add the following lines to one of your login or profile files, i.e. ``~/.bash_profile``, ``~/.bashrc``, ``~/.profile``, etc.::

        $ export PATH=$PATH:~/.local/bin
        $ export LC_ALL=en_US.UTF-8
        $ export LANG=en_US.UTF-8

2. Inside the same login or profile file, add also the ``module`` commands necessary for the HPC system you are using (find the lines in the section above).

3. You can choose to source now your login or profile file, so that the ``module`` and ``export`` commands are run (e.g. ``$ source ~/.bash_profile``).

4. To use the new version of the ESM-Tools, now rewritten in Python, clone this repository::

        $ git clone https://github.com/esm-tools/esm_tools.git

5. Then, run the ``install.sh``::

        $ ./install.sh

You should now have the command line tools ``esm_master`` and ``esm_runscripts``, which replace the old version.

You may have to add the installation path to your ``PATH`` variable::

    $ export PATH=~/.local/bin:$PATH


=======
History
=======

0.1.0 (2020-02-17)
------------------

* First release on gitlab.awi.de.


