CAMELS-DE: hydrometeorological time series and attributes for 1582 catchments in Germany

<h2>Description</h2> <p>CAMELS-DE provides a comprehensive collection of hydro-meteorological timeseries data (e.g. discharge, water level, precipitation, air temperature) and catchment attributes for 1582 streamflow gauges across Germany. The time series data is in daily resolution and spans up to 70 years, from January 1951 to December 2020. The static catchment attributes include information on topography, soils, land cover, hydrogeology and human influences. Additionally, the dataset includes discharge simulations from a regional Long-Short Term Memory (LSTM) network and a conceptual hydrological model (HBV), providing benchmark data for future hydrological modelling studies in Germany.</p> <p>The accompanying data description gives information on data sources, the structure of the data set and contains extensive information on time series and catchment attribute variables. In addition, up-to-date benchmark results of the LSTM and HBV are provided.</p> <blockquote> <p><strong><strong>Important: As CAMELS-DE is continuously developed and updated, please ensure that you cite the correct version of the dataset that you are using.<br><br></strong></strong><strong>The CAMELS-DE data description paper is available here: <a href="https://doi.org/10.5194/essd-16-5625-2024">https://doi.org/10.5194/essd-16-5625-2024</a>.</strong></p> </blockquote> <p>Information about the code and methods for generating CAMELS-DE can be found here: <a title="CAMELS-DE Processing Pipeline" href="https://doi.org/10.5281/zenodo.12760336" target="_blank" rel="noopener">CAMELS-DE Processing Pipeline</a>.</p> <p>CAMELS-DE is also part of the Caravan project, a global hydrological dataset. Due to the use of data products that are available beyond the Germany national boundaries, Caravan-DE includes&nbsp; 305 additional streamflow gauges, resulting in a total of 1887 streamflow gauges: <a href="https://doi.org/10.5281/zenodo.13320514">https://doi.org/10.5281/zenodo.13320514</a>.</p> <h3>Disclaimer for discharge and water level data provided by the German federal state agencies:</h3> <p>english:<em><br>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.</em></p> <p>german:<em><br>Die L&auml;ndes&auml;mter gew&auml;hrleisten nicht die Genauigkeit oder Vollst&auml;ndigkeit der bereitgestellten Abfluss oder Wasserstandsdaten. Zudem k&ouml;nnen alle hydrologischen Daten zuk&uuml;nftigen &Uuml;berarbeitungen unterliegen, einschlie&szlig;lich Anpassungen der Wasserstands-Abflussbeziehung oder der Korrektur von Fehlern. Daher ist es notwendig, die aktuellsten Abflusszeitreihen direkt bei den Landesbeh&ouml;rden zu beziehen, falls Wasserrechtsgenehmigungen erforderlich sind. Zus&auml;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&ouml;rden ausdr&uuml;cklich jegliche Gew&auml;hrleistung hinsichtlich der Genauigkeit oder Vollst&auml;ndigkeit der Daten ausschlie&szlig;en und somit auch jegliche Haftungsanspr&uuml;che gegen&uuml;ber einem der Bundesl&auml;nder ausgeschlossen sind.</em></p> <h3>Changelog</h3> <ul> <li><strong>v1.1.0</strong> <ul> <li>LSTM benchmark results are now based on a <strong>LSTM with 10 ensemble members</strong>, changing the median NSE in the testing period from 0.83 to 0.85 <div> <ul> <li>The columns <em>discharge_spec_sim_lstm</em> and <em>discharge_vol_sim_lstm</em> in <em>timeseries_simulated</em> are now based on the median values of the 10 ensemble members.</li> <li>The column <em>NSE_lstm</em> in <em>CAMELS_DE_simulation_benchmark.csv</em> is now calculated from the median simulations of the 10 ensemble members</li> <li><em>model_parameters/LSTM/CAMELS_DE_epochs_training_lstm.zip</em>&nbsp;now contains the epochs of the 10 ensemble members</li> </ul> </div> </li> <li>The columns <em>NSE_lstm</em>, <em>NSE_hbv</em> and <em>training_perc_complete</em> in <em>CAMELS_DE_simulation_benchmark.csv</em> were calculated from 2001 - 2020, now corrected to 2000 - 2020</li> <li>Fixed a bug in the calculation of <em>high_prec_dur</em> and <em>low_prec_dur</em> in <em>CAMELS_DE_climatic_attributes.csv</em> calculation (thank you to Bastian Klein from BfG for reporting this issue)</li> <li>Bayern: removed blank space after gauge and water body name and removed water body name from some gauge names, where it was included as "[gauge_name]_[water_body_name]", e.g. "W&uuml;rzburg_Main" -&gt; "W&uuml;rzburg", water body name is now only included in the `water_body_name` column in<code> </code><em>CAMELS_DE_topographic_attributes.csv</em></li> <li>Nordrhein-Westfalen: corrected some wrong river names in <em>CAMELS_DE_topographic_attributes.csv</em></li> <li>Sachsen: added `gauge_elevation_metadata` information to <em>CAMELS_DE_topographic_attributes.csv</em></li> </ul> </li> </ul> <ul> <li><strong>v1.0.0</strong> <ul> <li>CAMELS-DE v1.0.0 is the version of the dataset that is described by the <a href="https://doi.org/10.5194/essd-2024-318">CAMELS-DE data description paper</a>.</li> <li>Addition of the federal state of Saarland, resulting in 27 additional catchments and coverage of all federal states except the city states of Berlin, Bremen and Hamburg. This also leads to a change in the title of the dataset from 1555 catchments to 1582 catchments.</li> <li>Addition of HBV model parameters and LSTM model training period epochs.</li> <li>Catchment DE911970: Removal of erroneous zero discharge values at the beginning of the measurement period.</li> <li>Minor fixes such as the elimination of discrepancies between the variable names in the dataset and in the data description.</li> <li>We were able to identify and fix some of these problems based on the feedback from the community, thank you very much!</li> </ul> </li> </ul>