search-esgf

Installation

First make sure you have ESMValTool installed and configured.

Next you can install this searcher:

pip install https://github.com/WAM2layers/search-esgf/archive/refs/heads/main.zip

Usage

from search_esgf import search

from esmvalcore.config import CFG
CFG['search_esgf'] = 'always'

search.search_esgf(
    experiment="ssp585",
    frequency="day",
    variables=["pr", "tas", "rsdt", "orog"],
)

Will return something like:

{
    'MPI-ESM1-2-HR': {'r1i1p1f1', 'r2i1p1f1'},
    'MPI-ESM1-2-LR': {'r10i1p1f1', 'r11i1p1f1', ...  'r9i1p1f1'},
    'INM-CM4-8': {'r1i1p1f1'},
    'MRI-ESM2-0': {'r1i1p1f1', 'r2i1p1f1', 'r3i1p1f1', 'r4i1p1f1',
        'r5i1p1f1'},
    'IPSL-CM6A-LR': {'r1i1p1f1'},
    'GFDL-CM4': {'r1i1p1f1'},
}

Docker image

Installing ESMValTool can be a hassle. Alternatively you can use the docker image we have prepared:

docker run -it ghcr.io/wam2layers/search-esgf

And then run the Python code above.