added variables maxdischarge: maximimum discharge of a day (of all substeps)

and avgdischarge of a day (of all substeps)

Some changes in the documentation

Author: PeterBurek

Toolkit/documentation/10_zambezi.rst

@@ -1,3 +1,14 @@
+.. raw:: html
+
+   <pre style="font-size: 0.7em;">
+   Todo en la tierra se encrespó, la zarza
+   clavó y el hilo verde
+   mordía, el pétalo cayó cayendo
+   hasta que única flor fue la caída
+   Pablo Neruda Agua
+   </pre>
+
+
 #######################
 **10. Example Zambezi**
 #######################

Toolkit/documentation/13_glossary.rst

@@ -200,7 +200,7 @@ I
 =
 
 **IIASA**
-   International Institute for Applied Systems Analysis - Austrian research institute that developed and maintains CWatM.
+   International Institute for Applied Systems Analysis - Research institute based in Austria that developed and maintains CWatM.
 
 **Infiltration**
    Process of water entering soil from the surface. Rate depends on soil properties, moisture content, and surface conditions.

Toolkit/documentation/1_introduction.rst

@@ -1,3 +1,12 @@
+.. raw:: html
+
+   <pre style="font-size: 0.7em;">
+   Per correr miglior acque alza le vel
+   omai la navicella del mio ingegno
+   Dante Alighieri, Purgatorio, 1-2 
+   </pre>
+
+
 
 ###################
 **1. Introduction**

Toolkit/documentation/2_news.rst

@@ -1,3 +1,12 @@
+.. raw:: html
+
+   <pre style="font-size: 0.7em;">
+   La mar es el origen de todas lasaguas,
+   y el corazon del hombre, el origen de
+   todas los males
+   Miguel de Cervantes, Don Quijote
+   </pre>
+
 
 ###########
 **2. NEWS**

Toolkit/documentation/3_modeldesign.rst

@@ -1,3 +1,13 @@
+.. raw:: html
+
+   <pre style="font-size: 0.7em;">
+   A lake is the landscape's most beautiful
+   and expressive feature. It is Earth's eye;
+   looking into which the beholder measures
+   the depth of his own nature
+   Henry David Thoreau, Walden
+   </pre>
+
 ################################
 **3. The Community Water Model**
 ################################

Toolkit/documentation/4_UsingCwatM.rst

@@ -1,3 +1,12 @@
+.. raw:: html
+
+   <pre style="font-size: 0.7em;">
+   古池や
+   蛙飛びこむ
+   水の音
+   Matsuo Bashō
+   </pre>
+
 
 ##################
 **4. Using CWatM**
@@ -22,6 +31,9 @@ Guillaumot, L., Smilovic, M., Burek, P., de Bruijn, J., Greve, P., Kahil, T., an
 
 Burek, P., Smilovic, M., Guillaumot, L., de Bruijn, J., Greve, P., Satoh, Y., Islaam, A., Virgen-Urcelay, A., Tang, T., Kahil, T., and Wada, Y.: Community Water Model CWatM Manual, Laxenburg, Austria, IIASA Report, 2020.
 
+If you use CWatM with wastewater or with pySnowClim (publication soon) please cite those publications, too.
+
+Fridman, D., Smilovic, M., Burek, P., Tramberend, S., and Kahil, T.: Wastewater matters: incorporating wastewater treatment and reuse into a process-based hydrological model (CWatM v1.08), Geosci. Model Dev., 18, 3735–3754, https://doi.org/10.5194/gmd-18-3735-2025
 
 
 Downloading CWatM
@@ -53,20 +65,20 @@ OGGM
 
 "OGGM is an open source modelling framework for glaciers. The model can simulate past and future mass-balance, volume and geometry of (almost) any glacier in the world in a fully automated and extensible workflow. OGGM is modular and supports novel modelling workflows: it loves to be remixed and reused! OGGM also brings together a vibrant and friendly community of scientists, modellers and educators." https://oggm.org/ (24/10/25)
 
-Sarah Hanus, University of Zurich, Switzerland, linked OGGM and CWatM:
+Sarah Hanus, University of Zurich, Switzerland, linked OGGM and CWatM (you run OGGM and postprocess the results with the tools from L. Schuster and S. Hanus and then you can load it into CWatM)
 
 Hanus, S., Schuster, L., Burek, P., Maussion, F., Wada, Y., and Viviroli, D.: Coupling a large-scale glacier and hydrological model (OGGM v1.5.3 and CWatM V1.08) – towards an improved representation of mountain water resources in global assessments, Geosci. Model Dev., 17, 5123–5144, https://doi.org/10.5194/gmd-17-5123-2024
 
 pySnowClim
 ----------
 
-Abby C. Lute and Aranildo Lima and her/his team coupled CWatM with a sophisticated energy-balanced snow model:
+Abby C. Lute, Aranildo Lima, Raj Shrestha and their team coupled CWatM with a sophisticated energy-balanced snow model:
 
 Lute, A. C., Abatzoglou, J., and Link, T.: SnowClim v1.0: high-resolution snow model and data for the western United States, Geosci. Model Dev., 15, 5045–5071, https://doi.org/10.5194/gmd-15-5045-202
 
-You now can choose if you want to use SnowClimPy or the degree-day approach.
+You now can choose if you want to use pySnowClim or the degree-day approach.
 
-.. note:: 24/10/25 Works but still testing
+.. attention:: 1/11/25 Works but still testing
 
 
 
@@ -79,7 +91,7 @@ Fork our code from https://github.com/iiasa/CWatM and create your own branch.
 
 .. note::  a good documention on this has: https://pandas.pydata.org/pandas-docs/stable/development/contributing.html and https://docs.oggm.org/en/stable/contributing.html
 
-We also have a pyTest framework
+We also have a pytest framework. See the :ref:`Testing framework <rst_testing>` for more information.
 
 .. _license:
 

Toolkit/documentation/52_settingsfile.rst

@@ -159,7 +159,7 @@ StepInit indicate the date(s) when initial conditions are saved::
 Calibration
 ************
 
-Any parameter can be used for calibration, but we used those which are most effective. Please have a look at  :ref:`rst_calibration` 
+Any parameter can be used for calibration, but we used those which are most effective. See the :ref:`Calibration <rst_calibration>` for more information.
 
 Calibration value can be a number (because it is not calibrated yet).
 

Toolkit/documentation/57_reproduce.rst

@@ -1,7 +1,7 @@
 
-#######
-Recover
-#######
+###################
+Recover former runs
+###################
 
 .. contents:: 
     :depth: 3

Toolkit/documentation/58_tricks.rst

@@ -8,6 +8,9 @@ Tips and Tricks
 
 Here we collect some tricks which may mentioned on other pages of the documentation, but are overseen and might be helpful.
 
+Settings file
+=============
+
 Notepad++ for settingsfile
 ---------------------------
 
@@ -31,9 +34,12 @@ of the basin and the upstream area
 .. note:: 
 
     | If you start with a basin defined by the outlet of a basin e.g. 6.25 51.75
-    | You can generate a new mask map for the following runs by:
-    | **savebasinmap = True** in [OPTIONS]
-    | a basin.tif is generated in the output folder, which you can copy and use next time as:
+    | You can generate a new mask map for the following runs by adding in:
+    | [OPTIONS]
+    | **savebasinmap = True** 
+
+    | a basin.tif and an upstream area map are generated in the output folder, which you can copy and use next time as:
+
     | **MaskMap = your_directory/basin.tif**
 	
 Placeholder in settingsfile

Toolkit/documentation/5_howto.rst

@@ -1,3 +1,15 @@
+.. raw:: html
+
+   <pre style="font-size: 0.7em;">
+   Des Menschen Seele gleicht dem Wasser:
+   Vom Himmel kommt es, zum Himmel steigt es,
+   und wieder nieder zur Erde muss es,
+   ewig wechselnd
+   Johann W. von Goethe
+   Gesang der Geister über dem Wasser 
+   </pre>
+
+
 
 #####################################
 **5. HOW-TO-GUIDE** Problem oriented