|
20 | 20 | " - [Datasets and Properties](#Datasets-and-Properties)\n", |
21 | 21 | "- [Basic impact calculation](#Basic-impact-calculation)\n", |
22 | 22 | " - [Wrapper functions to open datasets as CLIMADA objects](#Wrapper-functions-to-open-datasets-as-CLIMADA-objects)\n", |
| 23 | + " - [Calculate the impact](#Calculate-the-impact)\n", |
23 | 24 | "- [Technical Information](#Technical-Information)\n", |
24 | 25 | " - [Server](#Server)\n", |
25 | 26 | " - [Client](#Client)\n", |
|
31 | 32 | "cell_type": "markdown", |
32 | 33 | "metadata": {}, |
33 | 34 | "source": [ |
34 | | - "# Finding datasets" |
| 35 | + "## Finding datasets" |
35 | 36 | ] |
36 | 37 | }, |
37 | 38 | { |
|
48 | 49 | "cell_type": "markdown", |
49 | 50 | "metadata": {}, |
50 | 51 | "source": [ |
51 | | - "## Data types and data type groups\n", |
| 52 | + "### Data types and data type groups\n", |
52 | 53 | "The datasets are first separated into 'data_type_groups', which represent the main classes of CLIMADA (exposures, hazard, vulnerability, ...). So far, data is available for exposures and hazard. Then, data is separated into data_types, representing the different hazards and exposures available in CLIMADA" |
53 | 54 | ] |
54 | 55 | }, |
|
173 | 174 | "cell_type": "markdown", |
174 | 175 | "metadata": {}, |
175 | 176 | "source": [ |
176 | | - "## Datasets and Properties\n", |
| 177 | + "### Datasets and Properties\n", |
177 | 178 | "For each data type, the single datasets can be differentiated based on properties. The following function provides a table listing the properties and possible values. This table does not provide information on properties that can be combined but the search can be refined in order to find properties to query a unique dataset. Note that a maximum of 10 property values are shown here, but many more countries are available for example." |
178 | 179 | ] |
179 | 180 | }, |
|
219 | 220 | "cell_type": "markdown", |
220 | 221 | "metadata": {}, |
221 | 222 | "source": [ |
222 | | - "### Refining the search:" |
| 223 | + "#### Refining the search:" |
223 | 224 | ] |
224 | 225 | }, |
225 | 226 | { |
|
280 | 281 | "cell_type": "markdown", |
281 | 282 | "metadata": {}, |
282 | 283 | "source": [ |
283 | | - "# Basic impact calculation\n", |
| 284 | + "## Basic impact calculation\n", |
284 | 285 | "We here show how to make a basic impact calculation with tropical cyclones for Haiti, for the year 2040, rcp4.5 and generated with 10 synthetic tracks. For more technical details on the API, see below.\n", |
285 | 286 | "\n" |
286 | 287 | ] |
|
289 | 290 | "cell_type": "markdown", |
290 | 291 | "metadata": {}, |
291 | 292 | "source": [ |
292 | | - "## Wrapper functions to open datasets as CLIMADA objects" |
| 293 | + "### Wrapper functions to open datasets as CLIMADA objects" |
293 | 294 | ] |
294 | 295 | }, |
295 | 296 | { |
296 | 297 | "cell_type": "markdown", |
297 | 298 | "metadata": {}, |
298 | 299 | "source": [ |
299 | | - "### The wrapper functions client.get_hazard() \n", |
| 300 | + "#### The wrapper functions client.get_hazard() \n", |
300 | 301 | "gets the dataset information, downloads the data and opens it as a hazard instance\n" |
301 | 302 | ] |
302 | 303 | }, |
|
368 | 369 | "cell_type": "markdown", |
369 | 370 | "metadata": {}, |
370 | 371 | "source": [ |
371 | | - "### The wrapper functions client.get_litpop_default() \n", |
| 372 | + "#### The wrapper functions client.get_litpop_default() \n", |
372 | 373 | "gets the default litpop, with exponents (1,1) and 'produced capital' as financial mode. If no country is given, the global dataset will be downloaded." |
373 | 374 | ] |
374 | 375 | }, |
|
396 | 397 | "cell_type": "markdown", |
397 | 398 | "metadata": {}, |
398 | 399 | "source": [ |
399 | | - "### Get the default impact function for tropical cyclones" |
| 400 | + "#### Get the default impact function for tropical cyclones" |
400 | 401 | ] |
401 | 402 | }, |
402 | 403 | { |
|
459 | 460 | "cell_type": "markdown", |
460 | 461 | "metadata": {}, |
461 | 462 | "source": [ |
462 | | - "### Getting other Exposures" |
| 463 | + "#### Getting other Exposures" |
463 | 464 | ] |
464 | 465 | }, |
465 | 466 | { |
|
500 | 501 | "cell_type": "markdown", |
501 | 502 | "metadata": {}, |
502 | 503 | "source": [ |
503 | | - "# Technical Information\n", |
| 504 | + "## Technical Information\n", |
504 | 505 | "\n", |
505 | 506 | "For programmatical access to the CLIMADA data API there is a specific REST call wrapper class: `climada.util.client.Client`." |
506 | 507 | ] |
|
509 | 510 | "cell_type": "markdown", |
510 | 511 | "metadata": {}, |
511 | 512 | "source": [ |
512 | | - "## Server\n", |
| 513 | + "### Server\n", |
513 | 514 | "The CLIMADA data file server is hosted on https://data.iac.ethz.ch that can be accessed via a REST API at https://climada.ethz.ch.\n", |
514 | 515 | "For REST API details, see the [documentation](https:/climada.ethz.ch/rest/docs)." |
515 | 516 | ] |
|
518 | 519 | "cell_type": "markdown", |
519 | 520 | "metadata": {}, |
520 | 521 | "source": [ |
521 | | - "## Client" |
| 522 | + "### Client" |
522 | 523 | ] |
523 | 524 | }, |
524 | 525 | { |
|
595 | 596 | "tags": [] |
596 | 597 | }, |
597 | 598 | "source": [ |
598 | | - "## Metadata\n", |
| 599 | + "### Metadata\n", |
599 | 600 | "\n", |
600 | | - "### Unique Identifiers\n", |
| 601 | + "#### Unique Identifiers\n", |
601 | 602 | "Any dataset can be identified with **data_type**, **name** and **version**. The combination of the three is unique in the API servers' underlying database.\n", |
602 | 603 | "However, sometimes the name is already enough for identification.\n", |
603 | 604 | "All datasets have a UUID, a universally unique identifier, which is part of their individual url. \n", |
|
638 | 639 | "tags": [] |
639 | 640 | }, |
640 | 641 | "source": [ |
641 | | - "### Data Set Status\n", |
| 642 | + "#### Data Set Status\n", |
642 | 643 | "The datasets of climada.ethz.ch may have the following stati:\n", |
643 | 644 | "- **active**: the deault for real life data\n", |
644 | 645 | "- **preliminary**: when the dataset is already uploaded but some information or file is still missing\n", |
|
651 | 652 | "cell_type": "markdown", |
652 | 653 | "metadata": {}, |
653 | 654 | "source": [ |
654 | | - "### DatasetInfo Objects and DataFrames\n", |
| 655 | + "#### DatasetInfo Objects and DataFrames\n", |
655 | 656 | "\n", |
656 | 657 | "As stated above `get_dataset` (or `get_dataset_by_uuid`) return a `DatasetInfo` object and `get_datasets` a list thereof." |
657 | 658 | ] |
|
952 | 953 | "tags": [] |
953 | 954 | }, |
954 | 955 | "source": [ |
955 | | - "## Download\n", |
| 956 | + "### Download\n", |
956 | 957 | "\n", |
957 | 958 | "The wrapper functions get_exposures or get_hazard fetch the information, download the file and opens the file as a climada object. But one can also just download dataset files using the method `download_dataset` which takes a `DatasetInfo` object as argument and downloads all files of the dataset to a directory in the local file system." |
958 | 959 | ] |
|
0 commit comments