# Digital Earth Flood Event Explorer

## fee-climate-change-workflow

`fee-climate-change-workflow` is part of the Flood Event Explorer (FEE, https://git.geomar.de/digital-earth/flood-event-explorer, https://doi.org/10.5880/GFZ.1.4.2022.001), 
developed at the GFZ German Research Centre for Geosciences (https://www.gfz-potsdam.de) in close collaboration with Helmholtz-Zentrum Hereon (https://www.hereon.de), Climate Service Center Germany (GERICS, https://www.climate-service-center.de/).  
It is funded by the Initiative and Networking Fund of the Helmholtz Association through the Digital Earth project 
(https://www.digitalearth-hgf.de/).

The goal of the Climate Change Workflow is to support the analysis of climate-driven changes in flood-generating climate variables, such as precipitation or soil moisture, using regional climate model simulations from the Earth System Grid Federation (ESGF) data archive.  
It should support to answer the geoscientific question `How does precipitation change over the course of the 21st century under different climate scenarios, compared to a 30-year reference period over a certain region?`

Extraction of locally relevant data over a region of interest (ROI) requires climate expert knowledge and data processing training to correctly process large ensembles of climate model simulations, the Climate Change Workflow tackles this problem. It supports scientists to define the regions of interest, customize their ensembles from the climate model simulations available on the Earth System Grid Federation (ESGF), define variables of interest, and relevant time ranges. 

The Climate Change Workflow provides: (1) a weighted mask of the ROI ; (2) weighted climate data of the ROI; (3) time series evolution of the climate over the ROI for each ensemble member; (4) ensemble statistics of the projected change; and lastly, (5) an interactive visualization of the region’s precipitation change projected by the ensemble of selected climate model simulations for different Representative Concentration Pathways (RCPs). The visualization includes the temporal evolution of precipitation change over the course of the 21st century and statistical characteristics of the ensembles for two selected 30 year time periods for the mid and the end of the 21st century (e.g. median and various percentiles).

The added value of the Climate Change Workflow is threefold. First, there is a reduction in the number of different software programs necessary to extract locally relevant data. Second, the intuitive generation and access to the weighted mask allows for the further development of locally relevant climate indices. Third, by allowing access to the locally relevant data at different stages of the data processing chain, scientists can work with a vastly reduced data volume allowing for a greater number of climate model ensembles to be studied; which translates into greater scientific robustness. Thus, the Climate Change Workflow provides much easier access to an ensemble of high-resolution simulations of precipitation, over a given ROI, presenting the region’s projected precipitation change using standardized approaches and supporting the development of additional locally relevant climate indices.

### dependencies

All components of the Flood Event Explorer are developed with the Data Analytics Software Framework (DASF) 
> Eggert, Daniel; Dransch, Doris (2021): DASF: A data analytics software framework for distributed environments. GFZ Data Services. https://doi.org/10.5880/GFZ.1.4.2021.004

This workflow uses the climate change backend module: https://git.geomar.de/digital-earth/de-climate-change

### build and deploy
The dependencies are managed by npm (nodejs version 12, there appear to be 
problems with version 13 for now).

1. install nodejs v12 (if not already) and update npm

```bash
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install -y nodejs

# Update npm
npm install -g npm@latest
```

2. clone the `fee-climate-change-workflow` repository

3. cd into the `fee-climate-change-workflow` folder and install dependencies via

```bash
npm install
```

4. build deployable package via

```bash
npm run build
```

The built files can be found in the `dist` folder. Simply copy the contents to
a webserver to deploy them.

5. alternatively, for local development and testing the web application can
be run in development mode via
```bash
npm run dev
```

### Recommended Software Citation

`Eggert, Daniel; Nam, Christine (2022): The Climate Change Workflow of the Flood Event Explorer: Analysis of climate-driven changes in flood-generating climate variables. GFZ Data Services. https://doi.org/10.5880/GFZ.1.4.2022.002`

### License
```
Copyright 2022 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany / DE Flood Event Explorer

Licensed under the Apache License, Version 2.0 (the "License");
you may not use these files except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

### Contacts
Dr.-Ing. Daniel Eggert  
eMail: <daniel.eggert@gfz-potsdam.de>


Helmholtz Centre Potsdam GFZ German Research Centre for Geoscienes  
Section 1.4 Remote Sensing & Geoinformatics  
Telegrafenberg  
14473 Potsdam  
Germany

---

Dr. Christine Nam  
eMail: <christine.nam@hereon.de>  

Helmholtz-Zentrum hereon GmbH  
Climate Service Center Germany (GERICS)  
Fischertwiete 1  
20095 Hamburg  
Germany  
