=========
ESM Tools
=========
Documentation
-------------
.. 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.
How to cite this software
-------------------------
To cite ESM-Tools, please use the following DOI: https://zenodo.org/doi/10.5281/zenodo.3737927. This DOI represents all versions of the software, and will always pointing to the latest version available on https://zenodo.org.
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:
albedo::
$ module load git
$ module load python
levante.dkrz.de::
$ module load git
$ module load python3
glogin.hlrn.de / blogin.hlrn.de::
$ module load git
$ module load anaconda3
juwels.fz-juelich.de::
$ module load Stages/2022
$ module load git
$ module load Python/3.9.6
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.
=======
History
=======
0.1.0 (2020-02-17)
------------------
* First release on gitlab.awi.de.
Raw data
{
"_id": null,
"home_page": "https://github.com/esm-tools/esm_tools",
"name": "esm-tools",
"maintainer": null,
"docs_url": null,
"requires_python": "<=3.11,>=3.6",
"maintainer_email": null,
"keywords": "esm_tools",
"author": "The ESM Tools Team",
"author_email": "['dirk.barbi@awi.de', 'paul.gierz@awi.de', 'miguel.andres-martinez@awi.de', 'deniz.ural@awi.de', 'jan.streffing@awi.de', 'sebastian.wahl@geomar.de', 'kai.himstedt@dkrz.de']",
"download_url": "https://files.pythonhosted.org/packages/17/2e/e98b1e2e50684a4cc0d46b95f93fc34fa38f5f63c03b1c2a0af518c204aa/esm-tools-6.43.0.tar.gz",
"platform": null,
"description": "=========\nESM Tools\n=========\n\nDocumentation\n-------------\n\n.. image:: https://readthedocs.org/projects/esm-tools/badge/?version=latest\n\nFor our complete documentation, please check https://esm-tools.readthedocs.io/en/latest/index.html.\n\nHow to cite this software\n-------------------------\nTo cite ESM-Tools, please use the following DOI: https://zenodo.org/doi/10.5281/zenodo.3737927. This DOI represents all versions of the software, and will always pointing to the latest version available on https://zenodo.org.\n\n\nBefore you continue\n-------------------\n\nYou 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:\n\nalbedo::\n\n $ module load git\n $ module load python\n\nlevante.dkrz.de::\n\n $ module load git\n $ module load python3\n\nglogin.hlrn.de / blogin.hlrn.de::\n\n $ module load git\n $ module load anaconda3\n\njuwels.fz-juelich.de::\n\n $ module load Stages/2022\n $ module load git\n $ module load Python/3.9.6\n\naleph::\n\n $ module load git\n $ module load python\n\nNote 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``::\n\n $ module unload netcdf_c\n $ module load anaconda3\n\n\n\nInstalling\n----------\n\n1. First, make sure you add the following lines to one of your login or profile files, i.e. ``~/.bash_profile``, ``~/.bashrc``, ``~/.profile``, etc.::\n\n $ export PATH=$PATH:~/.local/bin\n $ export LC_ALL=en_US.UTF-8\n $ export LANG=en_US.UTF-8\n\n2. 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).\n\n3. 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``).\n\n4. To use the new version of the ESM-Tools, now rewritten in Python, clone this repository::\n\n $ git clone https://github.com/esm-tools/esm_tools.git\n\n5. Then, run the ``install.sh``::\n\n $ ./install.sh\n\nYou should now have the command line tools ``esm_master`` and ``esm_runscripts``, which replace the old version.\n\n\n=======\nHistory\n=======\n\n0.1.0 (2020-02-17)\n------------------\n\n* First release on gitlab.awi.de.\n\n\n",
"bugtrack_url": null,
"license": "GNU General Public License v2",
"summary": "ESM Tools external infrastructure for Earth System Modelling",
"version": "6.43.0",
"project_urls": {
"Homepage": "https://github.com/esm-tools/esm_tools"
},
"split_keywords": [
"esm_tools"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c72f42b14c76aa4e3812006464069cb9942c9abfd5eea3572623864282f0857a",
"md5": "95ea988ce4d75ab7257b7decba9a0ca4",
"sha256": "96ef9fa7f0a9ca2a4bc25e874db42e19e86284879fb0d16d7254912bfb51413c"
},
"downloads": -1,
"filename": "esm_tools-6.43.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "95ea988ce4d75ab7257b7decba9a0ca4",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": "<=3.11,>=3.6",
"size": 3655129,
"upload_time": "2024-11-27T13:38:28",
"upload_time_iso_8601": "2024-11-27T13:38:28.233873Z",
"url": "https://files.pythonhosted.org/packages/c7/2f/42b14c76aa4e3812006464069cb9942c9abfd5eea3572623864282f0857a/esm_tools-6.43.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "172ee98b1e2e50684a4cc0d46b95f93fc34fa38f5f63c03b1c2a0af518c204aa",
"md5": "f0653c9b19b75bba63810d085594640b",
"sha256": "57828001f15d3c8e56f1a71e53e2153576e78a24b3df003e1a20fa99f879dfff"
},
"downloads": -1,
"filename": "esm-tools-6.43.0.tar.gz",
"has_sig": false,
"md5_digest": "f0653c9b19b75bba63810d085594640b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<=3.11,>=3.6",
"size": 3049022,
"upload_time": "2024-11-27T13:38:30",
"upload_time_iso_8601": "2024-11-27T13:38:30.365142Z",
"url": "https://files.pythonhosted.org/packages/17/2e/e98b1e2e50684a4cc0d46b95f93fc34fa38f5f63c03b1c2a0af518c204aa/esm-tools-6.43.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-27 13:38:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "esm-tools",
"github_project": "esm_tools",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "esm-tools"
}
JSON
