@@ -93,6 +93,16 @@ The TOAR database has only a limited number of workers for performing a statisti
The gridding uses a user defined grid to combine all stations in a cell.
Per cell mean, standard deviation and the number of stations are reported in the resulting xarray dataset.
## Contributors
The contributors include all projects, organizations and persons that are associated to any timeseries of a gridded data set as contributor or originator. In offline mode, this information is conserved in a dedicated by saving the timeseries IDs. In the metadata of a dataset, this filename is stated together with the contributors endpoint (at the moment: `https://toar-data.fz-juelich.de/api/v2/timeseries/request_contributors`; CAVE Endpoint is under development and expected to be published until 2024-07-31) to retrieve the actual names. Therefore, the created contributor file need to be submitted as a POST request.
The default output format is a json file, that contains the full information on all roles associated to the provided timeseries IDs. These data can be further processed as desired.
The second option provides a ready-to-use list of all programs, organizations and persons that contributed to this dataset. This requires setting the output format of the request to *TBD*.
The provided organizations include the affiliations of the individual persons, as provided to the TOAR database.
## Logging
Output created by the different modules and classes of this package use the python logging.
There is also a auxiliary class to reuse the same logger setup for examples and so over this script.
...
...
@@ -156,17 +166,6 @@ Notebook for downloading and visualization of data.
The data are downloaded and reused for subsequent executions of this notebook.
The gridding is done on the downloaded data. Gridded data are not saved to disc.
# Benchmarks
## Duration of Different Requests
```bash
jupyter notebook tests/benchmark.py
```
This script requests datasets with different durations (days to month) from the TOAR Database and saves them to disc.
It reports the duration for the different requests.
There is no gridding involved.
CAVE: This script can run several hours.
# Supported Grids
...
...
@@ -190,6 +189,18 @@ This will override the original file:
python toargridding/setupFunctions.py
```
# Benchmarks
## Duration of Different Requests
```bash
jupyter notebook tests/benchmark.py
```
This script requests datasets with different durations (days to month) from the TOAR Database and saves them to disc.
It reports the duration for the different requests.
There is no gridding involved.
CAVE: This script can run several hours.
# Documentation of Source Code:
At the moment Carsten Hinz is working on a documentation of the source code, while getting familiar with this project.
