Skip to main content

OptimESM Tools

DOI Coverage Status PyPI version shields.io Python Versions PyPI downloads CodeFactor

J.R. Angevaare (KNMI)

Software

This software is used in the scope of the OptimESM project. The scientific aim is to isolate regions of three dimensional earth science data (time, latitude and longitude) from CMIP6 and identify regions in latitude-longitude that show dramatic changes as function of time.

Setup and installation

This software requires cdo and cartopy, and preferably also latex.

To install cdo and py-cdo, we use miniforge, but alternative methods exits. To use miniforge (on linux):

wget https://github.com/conda-forge/miniforge/releases/download/25.3.0-3/Miniforge3-Linux-x86_64.sh
bash Miniforge3-Linux-x86_64.sh

Create an environment, e.g.:

conda create -n py310 python=3.10.13 cdo
# and activate
conda ativate py310
# install the software
pip install optim_esm_tools

You should be ready to go!

Testing installation (optional)

After installation, you could test that everything is properly installed and all the dependencies are working.

# Clone https://github.com/JoranAngevaare/optim_esm_tools
git clone https://github.com/JoranAngevaare/optim_esm_tools.git
cd optim_esm_tools
pytest -v --durations 0

You could even test that all the notebooks work out of the box with the jupyter setup in your environment:

# Clone https://github.com/JoranAngevaare/optim_esm_tools
git clone https://github.com/JoranAngevaare/optim_esm_tools.git
cd optim_esm_tools
pip install -r requirements_tests.txt
pytest optim_esm_tools -v --nbmake -n3 notebooks/*.ipynb --durations 0

Extended setup (optional)

For downloading CMIP6 data, synda is a useful tool, and few routines work best with the associated the ESGF-file structure. Since synda list is only supported in python 3.8, we created a separate repository optim_esm_base that has a working set of software versions that are compatible with these requirements.

Alternatively, setting up a miniforge/conda environment is documented in optim_esm_base.

Example

In the notebooks folder, we have an example notebook to help you get started. More advanced tutorials are also available in the notebooks folder.

Release files for optim-esm-tools 5.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for optim-esm-tools 5.0.0
File Size Uploaded
optim_esm_tools-5.0.0.tar.gz 88.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for optim-esm-tools 5.0.0
File Interpreter ABI Platform
optim_esm_tools-5.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 271.3 kB

Release files / optim_esm_tools-5.0.0.tar.gz

Download URL optim_esm_tools-5.0.0.tar.gz
Size 88.7 kB
Tags Source
SHA-256 checksum
How to use checksums
db971e2f00083fde5d9ad1d988d66814213dcb825e058c5268316dde8b8f0125
BLAKE2b-256 checksum
How to use checksums
ef40b2f27fa18dbddf813cde892502a77099845f3691809921a92276caaa0737
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.18

Release files / optim_esm_tools-5.0.0-py3-none-any.whl

Download URL optim_esm_tools-5.0.0-py3-none-any.whl
Size 182.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e4fdbf2d8b5753a18341923991760fbe5cdb3987ae0d136ad84bba70e59e0683
BLAKE2b-256 checksum
How to use checksums
9e3d3e6953ef368dc6649c077476b2cff3f45c469c756a0ddb710e99ec6dbb37
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.18

Release history Release notifications | RSS feed

This release

5.0.0 This release

2 release files

4.0.0

2 release files

3.1.0

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.1.1

2 release files

2.1.0

2 release files

1.7.0

2 release files

1.6.3

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.0

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page