Caravan-DE: Caravan extension Germany - German dataset for large-sample hydrology

Caravan is an open community dataset of meteorological forcing data, catchment attributes, and discharge data for catchments around the world: https://zenodo.org/record/6578598. We have employed the published code to derive meteorological forcing data and catchment attributes from global data sources to extend Caravan with data for 1887 catchments in Germany. The time series data are in daily resolution and span up to 70 years, from January 1951 to December 2020. Most of the catchments in Caravan-DE are also part of the CAMELS-DE dataset (10.5281/zenodo.13837553, 1582 catchments). As CAMELS-DE relies on meteorological forcing data that is only available within the borders of Germany, catchments going beyond the German national borders had to be discarded. Caravan uses global data products for the meteorological forcing data and catchment attributes, which is why Caravan-DE includes these catchments that are partly located outside of Germany. As catchments in Caravan-DE and CAMELS-DE are identified by the same ID, the datasets can be used together.Please refer to the CAMELS-DE paper (https://doi.org/10.5194/essd-2024-318) for information about discharge data and the catchment geometries used for both Caravan-DE and CAMELS-DE. For the processing of the data the following guide was followed step by step: https://github.com/kratzert/Caravan/wiki/Extending-Caravan-with-new-basins Disclaimer for discharge and water level data provided by the German federal state agencies: english:The state agencies do not guarantee the accuracy or completeness of the discharge or water level data provided. In addition, all hydrological data may be subject to future revisions, including adjustments to the rating curves or corrections of errors. Therefore, it is necessary to obtain the most recent discharge time series directly from the federal state authorities for projects that require water law permits. Additionally, the regulations of the respective federal state apply and specific enquiries should be made as needed. It is also important to note that the state agencies explicitly disclaim any warranty as to the accuracy or completeness of the data and therefore any liability claims against any of the federal states are also excluded. german:Die Ländesämter gewährleisten nicht die Genauigkeit oder Vollständigkeit der bereitgestellten Abfluss oder Wasserstandsdaten. Zudem können alle hydrologischen Daten zukünftigen Überarbeitungen unterliegen, einschließlich Anpassungen der Wasserstands-Abflussbeziehung oder der Korrektur von Fehlern. Daher ist es notwendig, die aktuellsten Abflusszeitreihen direkt bei den Landesbehörden zu beziehen, falls Wasserrechtsgenehmigungen erforderlich sind. Zusätzlich gelten die Vorschriften des jeweiligen Bundeslandes, und spezifische Anfragen sollten bei Bedarf gestellt werden. Es ist ebenfalls wichtig zu beachten, dass die staatlichen Behörden ausdrücklich jegliche Gewährleistung hinsichtlich der Genauigkeit oder Vollständigkeit der Daten ausschließen und somit auch jegliche Haftungsansprüche gegenüber einem der Bundesländer ausgeschlossen sind. Changelog v1.0.1 Small changes to be consistent with other Caravan extensions (see https://github.com/kratzert/Caravan/issues/35): camelsde_basin_shapes.shp: removed column gauge_name attributes_other_camelsde.csv: added river name to gauge_name column v1.1.0 Added FAO Penman-Monteith PET (potential_evaporation_sum_FAO_PENMAN_MONTEITH) and renamed the ERA5-LAND potential_evaporation band to potential_evaporation_sum_ERA5_LAND. Also added all PET-related climate indices derived with the Penman-Monteith PET band (suffix "_FAO_PM") and renamed the old PET-related indices accordingly (suffix "_ERA5_LAND"). This was conducted to be consistent with Caravan version 1.5. v1.1.1 By mistake, the new variables for v1.1.0 were missing in the climatic indices, these have now been added.Caravan是一款面向全球流域的开源社区数据集，包含气象强迫数据（meteorological forcing data）、流域属性（catchment attributes）与径流数据（discharge data），其托管地址为https://zenodo.org/record/6578598。本研究采用已发表的代码，从全球数据源中提取气象强迫数据与流域属性，为Caravan新增了德国境内1887个流域的数据集。该时间序列数据为日分辨率，时间跨度最长达70年，覆盖1951年1月至2020年12月。 Caravan-DE中的多数流域同时也是CAMELS-DE数据集的组成部分（共1582个流域，对应DOI：10.5281/zenodo.13837553）。由于CAMELS-DE依赖仅在德国境内可用的气象强迫数据，因此超出德国国界的流域被剔除。而Caravan采用全球数据产品生成气象强迫与流域属性，因此Caravan-DE包含了部分位于德国境外的流域。由于Caravan-DE与CAMELS-DE采用相同的流域ID进行标识，二者可联合使用。有关两个数据集所采用的径流数据与流域几何信息，请参考CAMELS-DE相关论文（https://doi.org/10.5194/essd-2024-318）。 本数据集的处理严格遵循以下官方指南：https://github.com/kratzert/Caravan/wiki/Extending-Caravan-with-new-basins ### 德国联邦州机构提供的径流与水位数据免责声明 德国各州主管部门不保证所提供的径流或水位数据的准确性与完整性。此外，所有水文数据可能在未来进行修订，包括对水位-流量关系曲线的调整或错误修正。因此，若项目需要获取水法许可，需直接从各州主管部门获取最新的径流时间序列。此外，各联邦州的相关法规适用，如有特定疑问应按需咨询相关机构。同时需注意，各州主管部门明确声明不对数据的准确性或完整性提供任何担保，因此任何针对联邦各州的索赔请求均不予受理。 ### 更新日志 #### v1.0.1 为与其他Caravan扩展版本保持一致（详见https://github.com/kratzert/Caravan/issues/35），进行了小幅调整： - camelsde_basin_shapes.shp：移除了gauge_name列 - attributes_other_camelsde.csv：在gauge_name列中新增了河流名称 #### v1.1.0 新增FAO Penman-Monteith潜在蒸散发（potential_evaporation_sum_FAO_PENMAN_MONTEITH），并将ERA5-LAND潜在蒸散发波段重命名为potential_evaporation_sum_ERA5_LAND。同时新增了基于FAO Penman-Monteith潜在蒸散发波段计算的所有蒸散发相关气候指数（后缀为"_FAO_PM"），并对原有的蒸散发相关指数进行了重命名（后缀改为"_ERA5_LAND"），此举旨在与Caravan 1.5版本保持兼容。 #### v1.1.1 修复了v1.1.0版本新增变量未被纳入气候指数的问题，现已补充完整。