README.md 2.32 KB
Newer Older
Cecilia Nievas's avatar
Cecilia Nievas committed
1
2
# gde-importer

Cecilia Nievas's avatar
Cecilia Nievas committed
3
4
5
Importer of aggregated exposure models to serve as input for the Global Dynamic Exposure (GDE)
model.

6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

## Installing obmgapanalysis
### Software dependencies

- Python >= 3.7

### Python libraries

- `numpy`
- `pandas`
- `pyyaml`
- `openpyxl`

### Install
```bash
git clone https://git.gfz-potsdam.de/dynamicexposure/globaldynamicexposure/gde-importer.git
cd gde-importer
pip3 install -e .
```

## Running gde-importer

To run the gde-importer for the exposure model of the European Seismic Risk Model 2020 (ESRM20):

1. Clone the ESRM20 repository to a local path of your choice following these 
[instructions](https://git.gfz-potsdam.de/dynamicexposure/datasources/-/tree/master/esrm20).
2. Copy the file `config-example.yml` to your working directory as `config.yml` and provide the 
necessary parameters:
  - exposure_format: esrm20
  - metadata_filepath: /local/path/to/cloned/European_Exposure_Model_Data_Inputs_Sources.xlsx
3. From the working directory (where you placed `config.yml`), run the code by typing:
```
gdeimporter
```

Cecilia Nievas's avatar
Cecilia Nievas committed
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
## Copyright and copyleft

Copyright (C) 2021

* Helmholtz-Zentrum Potsdam Deutsches GeoForschungsZentrum GFZ

This program is free software: you can redistribute it and/or modify it
under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero
General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see http://www.gnu.org/licenses/.

Also add information on how to contact you by electronic and paper mail.

If your software can interact with users remotely through a computer
network, you should also make sure that it provides a way for users to
get its source. For example, if your program is a web application, its
interface could display a "Source" link that leads users to an archive
of the code. There are many ways you could offer source, and different
solutions will be better for different programs; see section 13 for the
specific requirements.

See the [LICENSE](./LICENSE) for the full license text.