Skip to content

Commit

Permalink
deploy: fde119e
Browse files Browse the repository at this point in the history
  • Loading branch information
larsbuntemeyer committed Jan 27, 2025
1 parent 1b38f3f commit b85986a
Show file tree
Hide file tree
Showing 10 changed files with 689 additions and 27 deletions.
583 changes: 583 additions & 0 deletions README.html

Large diffs are not rendered by default.

91 changes: 91 additions & 0 deletions _sources/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
<img src="https://mirrors.creativecommons.org/presskit/logos/cc.logo.large.png" width="150" align="right"/>

# Joint evaluation

<img src="https://imgs.xkcd.com/comics/data_trap.png" width="300" align="right"/>

Joint evaluation of the CMIP6 downscaling within EURO-CORDEX.

This repository is supposed to help in organizing the EURO-CORDEX joint evaluation, e.g., it holds meta data like tables, and catalogs, but also README files and [issues](https://github.com/euro-cordex/joint-evaluation/issues) regarding evaluation. If you have any topics, questions or suggestions, please don't hesitate to [open a new issue](https://github.com/euro-cordex/joint-evaluation/issues/new)! There is also the possibility to [join a team](https://github.com/orgs/euro-cordex/teams) to stay in touch easily if you want.

For a broader overview, you can also have a look at the [project board](https://github.com/orgs/euro-cordex/projects/5).

There is also a repository ([evaltools](https://github.com/euro-cordex/evaltools)) that might hold useful code used in the evaluation analysis. This is separated for better maintainability.

[xkcd](https://xkcd.com) comic used under [CC BY-NC 2.5 license](https://xkcd.com/license.html)

## Data exchange
Some storage space on the existing jsc-cordex data exchange infrastructure at Jülich Supercomputing Centre (JSC) is available and may be used to provide some intermediate, temporary, limited storage for the first joint analyses publications of CORDEX-CMIP6 simulations before data will be stored longer-term on ESGF-related storage at the respective centres.

Access to storate at JSC is decribed [here](https://github.com/euro-cordex/jsc-cordex) (private repo until this is released to the community).

The variables requested for this joint evaluation, along their corresponding metadata, are available in this repository, under the file [dreq_EUR_joint_evaluation.csv](https://github.com/euro-cordex/joint-evaluation/blob/main/dreq_EUR_joint_evaluation.csv). This file can be explored using the search box in Github; e.g. search for "Overview" to filter the variables currently requested for the overview evaluation work. This file can also be downloaded [here](https://raw.githubusercontent.com/euro-cordex/joint-evaluation/refs/heads/main/dreq_EUR_joint_evaluation.csv), to use it in your data uploading scripts.

```python
import pandas as pd

pd.read_csv("https://raw.githubusercontent.com/euro-cordex/joint-evaluation/refs/heads/main/dreq_EUR_joint_evaluation.csv")
```
```
out_name frequency units long_name standard_name cell_methods priority comment
0 clt mon % Total Cloud Cover Percentage cloud_area_fraction area: time: mean Trends NaN
1 hurs 1hr % Near-Surface Relative Humidity relative_humidity area: mean time: point FWI NaN
2 hurs day % Near-Surface Relative Humidity relative_humidity area: time: mean FWI NaN
3 hus1000 6hr 1 Specific Humidity specific_humidity area: mean time: point AtmRivers NaN
4 hus200 6hr 1 Specific Humidity specific_humidity area: mean time: point AtmRivers NaN
.. ... ... ... ... ... ... ... ...
63 va700 6hr m s-1 Northward Wind northward_wind area: mean time: point AtmRivers NaN
64 va850 6hr m s-1 Northward Wind northward_wind area: mean time: point AtmRivers NaN
65 va925 6hr m s-1 Northward Wind northward_wind area: mean time: point AtmRivers NaN
66 vas mon m s-1 Northward Near-Surface Wind northward_wind area: time: mean Trends NaN
67 zg500 mon m Geopotential Height geopotential_height area: time: mean Trends NaN
```

## Catalog
A catalog of available data at JSC-CORDEX is available from this repository. For example,
```python
import intake

cat = intake.open_esm_datastore("https://raw.githubusercontent.com/euro-cordex/joint-evaluation/refs/heads/main/CORDEX-CMIP6.json")
cat.keys()
```
gives
```
['CORDEX.EUR-12.GERICS.ERA5.evaluation.r1i1p1f1.REMO2020.v1.mon.hurs.v20240529',
'CORDEX.EUR-12.GERICS.ERA5.evaluation.r1i1p1f1.REMO2020.v1.mon.pr.v20240529',
'CORDEX.EUR-12.GERICS.ERA5.evaluation.r1i1p1f1.REMO2020.v1.mon.prsn.v20240529',
'CORDEX.EUR-12.GERICS.ERA5.evaluation.r1i1p1f1.REMO2020.v1.mon.ps.v20240529',
'CORDEX.EUR-12.GERICS.ERA5.evaluation.r1i1p1f1.REMO2020.v1.mon.tas.v20240529',
'CORDEX.EUR-12.GERICS.ERA5.evaluation.r1i1p1f1.REMO2020.v1.mon.tasmax.v20240529',
'CORDEX.EUR-12.GERICS.ERA5.evaluation.r1i1p1f1.REMO2020.v1.mon.tasmin.v20240529',
'CORDEX.EUR-12.GERICS.ERA5.evaluation.r1i1p1f1.REMO2020.v1.mon.uas.v20240529',
'CORDEX.EUR-12.GERICS.ERA5.evaluation.r1i1p1f1.REMO2020.v1.mon.vas.v20240529']
```
You can filter and load datasets using, e.g.,:
```python
dataset_dict = cat.search(variable_id=["tas", "orog", "sftlf"]).to_dataset_dict()
```
and you will get a dictionary of datasets back. Note that this, for now, will only work when you are logged in to `jsc-cordex` since datasets reside on the local filesystem. For more info about `intake-esm`, please also see the [documentation](https://intake-esm.readthedocs.io/en/stable/how-to/understand-keys-and-how-to-change-them.html).

## Starting Jupyter Lab

If you want to work interactively on jsc-cordex, you can use jupyterlab via ssh (right now, jsc-cordex is not available from [Jupyter-JSC](https://jupyter.jsc.fz-juelich.de)).
> [!NOTE]
> You need to activate a virtual environemt, e.g., using `conda activate base`, or any other environment in which you have installed your requirements including `conda install juypterlab`. The current base environment only contains some basic requirements, usually, you might want to setup a dedicated environment for yourself. Please consult the [README](https://github.com/euro-cordex/jsc-cordex?tab=readme-ov-file#conda).
Once you are logged in to jsc-cordex and set up, you can start the jupyter server (without a browser) like this:
```
jupyter lab --no-browser
```
Note the port in the URL, e.g. `http://localhost:8888` (the port can be different if several servers are running) and start an ssh tunnel with port forwarding on your local computer:
```
ssh -N -L 8000:localhost:8888 jsc-cordex
```
The jupyterlab should then be available in your local browser at `https://localhost:8000/`. The login token can also be found in the URL on the jsc-terminal. Please don't forget to kill your server once you are finished. It will be killed automatically if you close the terminal in which you started the server.

## Plots

These plots show some preliminary results from available data at `jsc-cordex` and show regional and yearly means in the PRUDENCE regions. These plots give an overview of what data is available and are [updated](https://github.com/euro-cordex/joint-evaluation/blob/main/code/timeseries.py) once new data comes in.

<img src="https://raw.githubusercontent.com/euro-cordex/joint-evaluation/main/plots/timeseries-prudence-tas.png">
<img src="https://raw.githubusercontent.com/euro-cordex/joint-evaluation/main/plots/timeseries-prudence-pr.png">
4 changes: 2 additions & 2 deletions eobs.html
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@



<a class="navbar-brand logo" href="intro.html">
<a class="navbar-brand logo" href="README.html">



Expand Down Expand Up @@ -163,7 +163,7 @@

<ul class="nav bd-sidenav bd-sidenav__home-link">
<li class="toctree-l1">
<a class="reference internal" href="intro.html">
<a class="reference internal" href="README.html">
Joint evaluation
</a>
</li>
Expand Down
8 changes: 4 additions & 4 deletions eobs.nbconvert.html
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@
<script>DOCUMENTATION_OPTIONS.pagename = 'eobs.nbconvert';</script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="prev" title="Joint evaluation" href="intro.html" />
<link rel="prev" title="Joint evaluation" href="README.html" />
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<meta name="docsearch:language" content="en"/>
<meta name="docsearch:version" content="" />
Expand Down Expand Up @@ -134,7 +134,7 @@



<a class="navbar-brand logo" href="intro.html">
<a class="navbar-brand logo" href="README.html">



Expand Down Expand Up @@ -162,7 +162,7 @@

<ul class="nav bd-sidenav bd-sidenav__home-link">
<li class="toctree-l1">
<a class="reference internal" href="intro.html">
<a class="reference internal" href="README.html">
Joint evaluation
</a>
</li>
Expand Down Expand Up @@ -2361,7 +2361,7 @@ <h4 style="margin-bottom: 0px; display: inline;">Worker: 15</h4>

<div class="prev-next-area">
<a class="left-prev"
href="intro.html"
href="README.html"
title="previous page">
<i class="fa-solid fa-angle-left"></i>
<div class="prev-next-info">
Expand Down
4 changes: 2 additions & 2 deletions genindex.html
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@



<a class="navbar-brand logo" href="intro.html">
<a class="navbar-brand logo" href="README.html">



Expand Down Expand Up @@ -162,7 +162,7 @@

<ul class="nav bd-sidenav bd-sidenav__home-link">
<li class="toctree-l1">
<a class="reference internal" href="intro.html">
<a class="reference internal" href="README.html">
Joint evaluation
</a>
</li>
Expand Down
2 changes: 1 addition & 1 deletion index.html
Original file line number Diff line number Diff line change
@@ -1 +1 @@
<meta http-equiv="Refresh" content="0; url=intro.html" />
<meta http-equiv="Refresh" content="0; url=README.html" />
18 changes: 3 additions & 15 deletions intro.html
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,6 @@
<script>DOCUMENTATION_OPTIONS.pagename = 'intro';</script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="EOBS seasonal means" href="eobs.nbconvert.html" />
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<meta name="docsearch:language" content="en"/>
<meta name="docsearch:version" content="" />
Expand Down Expand Up @@ -136,7 +135,7 @@



<a class="navbar-brand logo" href="#">
<a class="navbar-brand logo" href="README.html">



Expand All @@ -163,8 +162,8 @@
<div class="bd-toc-item navbar-nav active">

<ul class="nav bd-sidenav bd-sidenav__home-link">
<li class="toctree-l1 current active">
<a class="reference internal" href="#">
<li class="toctree-l1">
<a class="reference internal" href="README.html">
Joint evaluation
</a>
</li>
Expand Down Expand Up @@ -372,8 +371,6 @@ <h1>Joint evaluation<a class="headerlink" href="#joint-evaluation" title="Link t
<p class="admonition-title">Note</p>
<p>This is a note.</p>
</div>
<div class="toctree-wrapper compound">
</div>
</section>

<script type="text/x-thebe-config">
Expand Down Expand Up @@ -406,15 +403,6 @@ <h1>Joint evaluation<a class="headerlink" href="#joint-evaluation" title="Link t
<footer class="prev-next-footer d-print-none">

<div class="prev-next-area">
<a class="right-next"
href="eobs.nbconvert.html"
title="next page">
<div class="prev-next-info">
<p class="prev-next-subtitle">next</p>
<p class="prev-next-title">EOBS seasonal means</p>
</div>
<i class="fa-solid fa-angle-right"></i>
</a>
</div>
</footer>

Expand Down
Binary file modified objects.inv
Binary file not shown.
4 changes: 2 additions & 2 deletions search.html
Original file line number Diff line number Diff line change
Expand Up @@ -136,7 +136,7 @@



<a class="navbar-brand logo" href="intro.html">
<a class="navbar-brand logo" href="README.html">



Expand Down Expand Up @@ -164,7 +164,7 @@

<ul class="nav bd-sidenav bd-sidenav__home-link">
<li class="toctree-l1">
<a class="reference internal" href="intro.html">
<a class="reference internal" href="README.html">
Joint evaluation
</a>
</li>
Expand Down
2 changes: 1 addition & 1 deletion searchindex.js

Large diffs are not rendered by default.

0 comments on commit b85986a

Please sign in to comment.