HydPy 6.2.dev1__cp313-cp313-win_amd64.whl

hydpy/docs/bib/refs.bib

@@ -0,0 +1,566 @@
+@Book{Allen1998,
+  author    = {Allen, Richard G. and Pareira, Luis S. and Raes, Dirk and Smith, Martin},
+  publisher = {FAO - Food and Agriculture Organization of the United Nations},
+  title     = {Crop Evapotranspiration - Guidelines for Computing Crop Water Requirements},
+  year      = {1998},
+  isbn      = {978-9-251-04219-9},
+  url       = {http://www.fao.org/3/x0490e/x0490e00.htm},
+}
+
+@Manual{DVWK,
+  title        = {ATV-DVWK-M 504 - Verdunstung in Bezug zu Landnutzung, Bewuchs und Boden},
+  author       = {ATV-DVWK},
+  isbn         = {978-3-936514-03-2},
+  organization = {Deutsche Vereinigung für Wasserwirtschaft, Abwasser und Abfall},
+  year         = {2002},
+  url          = {https://webshop.dwa.de/de/merkblatt-atv-dvwk-m-504-september-2002.html},
+}
+
+@Manual{LARSIM,
+  title        = {Das Wasserhaushaltsmodell LARSIM},
+  author       = {LEG},
+  organization = {LARSIM-Entwicklergemeinschaft - Hochwasserzentralen LUBW, BLfU, LfU RP, HLNUG, BAFU},
+  year         = {2020},
+  url          = {https://www.larsim.info/dokumentation/LARSIM-Dokumentation.pdf},
+}
+
+@Manual{LARSIM-Hilfe,
+  title        = {LARSIM-Hilfe},
+  author       = {LEG},
+  edition      = {Revision 233},
+  organization = {LARSIM-Entwicklergemeinschaft - Hochwasserzentralen LUBW, BLfU, LfU RP, HLNUG, BAFU},
+  year         = {2020},
+  url          = {https://larsim.info/larsimhilfe/hh_start.htm},
+}
+
+@Unpublished{LUBW2006b,
+  author = {LUBW},
+  title  = {{Zusätzliche} {LARSIM}-{Routinen} zur {Simulation} der {Schneedynamik}, des {Bodenwärmestroms} und der {Frostversiegelung}.},
+  note   = {{Ing.}-{Büro} {Dr.}-{Ing.} {Karl} {Ludwig} im {Auftrag} der {Landesanstalt} für {Umwelt}, {Messungen} und {Naturschutz} {Baden}-{Württemberg}},
+  year   = {2006},
+}
+
+@Unpublished{LUBW2006a,
+  author = {LUBW},
+  title  = {{Weiterentwicklung} des {Schneemodells} und {Vereinheitlichung} der {Energiebilanzansätze} in {Larsim}},
+  note   = {{Ing.}-{Büro} {Dr.}-{Ing.} {Karl} {Ludwig} im {Auftrag} der {Landesanstalt} für {Umwelt}, {Messungen} und {Naturschutz} {Baden}-{Württemberg}},
+  year   = {2006},
+}
+
+@Unpublished{LUBWLUWG2015,
+  author       = {LUBW \& LUWG},
+  title        = {{Auswertung} von {Messungen} aus dem {Rain}-on-{Snow}-{Projekt} der {Universität} {Freiburg} zur {Verbesserung} der {Schneesimulation} in {LARSIM}},
+  note         = {HYDRON GmbH im Auftrag der LUBW und des LUWG},
+  year         = {2015},
+  howpublished = {unpublished},
+}
+
+@Book{Thompson1981,
+  title      = {The Meteorological Office rainfall and evaporation calculation system: MORECS},
+  publisher  = {Meteorological Office},
+  year       = {1981},
+  author     = {Thompson, N and Barrie, I. A. and Ayles, M.},
+  address    = {London},
+  note       = {OCLC: 59090884},
+}
+
+@InCollection{Dickinson1984,
+  author    = {Dickinson, Robert E.},
+  booktitle = {Climate Processes and Climate Sensitivity},
+  publisher = {American Geophysical Union (AGU)},
+  title     = {Modeling Evapotranspiration for Three-Dimensional Global Climate Models},
+  year      = {1984},
+  isbn      = {9781118666036},
+  pages     = {58--72},
+  copyright = {Copyright 1984 by the American Geophysical Union.},
+  doi       = {10.1029/GM029p0058},
+  file      = {Full Text PDF:https\://agupubs.onlinelibrary.wiley.com/doi/pdfdirect/10.1029/GM029p0058:application/pdf},
+}
+
+@Book{Weischet1983,
+  author     = {Weischet, Wolfgang and Endlicher, Wilfried},
+  publisher  = {Teubner Studienbücher der Geographie},
+  title      = {Einführung in die Allgemeine Klimatologie Physikalische und meteorologische Grundlagen},
+  year       = {1983},
+  url        = {https://www.zvab.com/9783519434047/Einf%C3%BChrung-Allgemeine-Klimatologie-Physikalische-meteorologische-3519434040/plp},
+}
+
+@Book{DWD1987,
+  title     = {Leitfäden für die Ausbildung im DWD},
+  publisher = {Deutscher Wetterdienst},
+  year      = {1987},
+  author    = {DWD},
+  volume    = {Band 1},
+  isbn      = {3-88148-236-9},
+}
+
+@Article{Grant1975,
+  author   = {Grant, D. R.},
+  journal  = {Agricultural Meteorology},
+  title    = {Comparison of evaporation from barley with Penman estimates},
+  year     = {1975},
+  issn     = {0002-1571},
+  number   = {1},
+  pages    = {49--60},
+  volume   = {15},
+  doi      = {10.1016/0002-1571(75)90017-5},
+}
+
+@Book{DVWK1996,
+  title     = {Merkblatt DVWK-M 238 - Ermittlung der Verdunstung von Land- und Wasserflächen},
+  publisher = {Deutscher Verband für Wasserwirtschaft und Kulturbau e.V. -DVWK-, Bonn; Gesellschaft zur Förderung der Abwassertechnik e.V. -GFA-, Hennef},
+  year      = {1996},
+  author    = {DVWK},
+}
+
+@Article{Lindstrom1997HBV96,
+  author   = {Lindström, Göran and Johansson, Barbro and Persson, Magnus and Gardelin, Marie and Bergström, Sten},
+  journal  = {Journal of Hydrology},
+  title    = {Development and test of the distributed HBV-96 hydrological model},
+  year     = {1997},
+  issn     = {0022-1694},
+  number   = {1},
+  pages    = {272 - 288},
+  volume   = {201},
+  doi      = {10.1016/S0022-1694(97)00041-3},
+}
+
+@Book{Tyralla2013,
+  author   = {Tyralla, Christoph},
+  title    = {HydPy - ein interaktiv nutzbares Framework zur Erstellung und Anwendung hydrologischer Modelle},
+  publisher = {Bundesanstalt für Gewässerkunde},
+  year     = {2013},
+  doi      = {10.5675/BfG-1795},
+}
+
+@Article{Kling2012,
+  author   = {Kling, Harald and Fuchs, Martin and Paulin, Maria},
+  journal  = {Journal of Hydrology},
+  title    = {Runoff conditions in the upper {Danube} basin under an ensemble of climate change scenarios},
+  year     = {2012},
+  issn     = {0022-1694},
+  pages    = {264--277},
+  volume   = {424-425},
+  doi      = {10.1016/j.jhydrol.2012.01.011},
+}
+
+@Article{zhao1977flood,
+  author  = {Zhao, Ren-Jun},
+  journal = {East China College of Hydraulic Engineering, Nanjing, China},
+  title   = {Flood forecasting method for humid regions of China},
+  year    = {1977},
+}
+
+@Article{Wigmosta1994,
+  author    = {Wigmosta, Mark S. and Vail, Lance W. and Lettenmaier, Dennis P.},
+  journal   = {Water Resources Research},
+  title     = {A distributed hydrology-vegetation model for complex terrain},
+  year      = {1994},
+  number    = {6},
+  pages     = {1665--1679},
+  volume    = {30},
+  publisher = {Wiley Online Library},
+  doi       = {10.1029/94WR00436},
+}
+
+@Article{Penman1948,
+  author    = {Penman, Howard Latimer},
+  journal   = {Proceedings of the Royal Society of London. Series A. Mathematical and Physical Sciences},
+  title     = {Natural evaporation from open water, bare soil and grass},
+  year      = {1948},
+  number    = {1032},
+  pages     = {120--145},
+  volume    = {193},
+  publisher = {The Royal Society London},
+}
+
+@Book{Quast1997,
+  author  = {Quast, J. and Böhm, G.},
+  title   = {Ermittlung der realen Evapotranspiration von Niedermoorgebieten unter den hydroklimatischen Bedingungen Nordostdeutschlands am Beispiel des Rhinluchs},
+  publisher = {Leibniz Centre for Agricultural Landscape Research (ZALF)},
+  year    = {1997},
+}
+
+@Article{Brauer2014,
+  author = {Brauer, C. C. and Teuling, A. J. and Torfs, P. J. J. F. and Uijlenhoet, R.},
+  title = {The Wageningen Lowland Runoff Simulator (WALRUS): a lumped rainfall–runoff model for catchments with shallow groundwater},
+  journal = {Geoscientific Model Development},
+  volume = {7},
+  year = {2014},
+  number = {5},
+  pages = {2313--2332},
+  url = {https://gmd.copernicus.org/articles/7/2313/2014/},
+  doi = {10.5194/gmd-7-2313-2014}
+}
+
+@Article{Viviroli2009PREVAH,
+  author    = {Viviroli, Daniel and Zappa, Massimiliano and Gurtz, Joachim and Weingartner, Rolf},
+  journal   = {Environmental Modelling \& Software},
+  title     = {An introduction to the hydrological modelling system PREVAH and its pre-and post-processing-tools},
+  year      = {2009},
+  number    = {10},
+  pages     = {1209--1222},
+  volume    = {24},
+  publisher = {Elsevier},
+}
+
+@TechReport{Kling2005,
+  author      = {Kling, Harald and Fürst, Josef and Nachtnebel, Hans Peter},
+  institution = {Institute of Water Management, Hydrology and Hydraulic Engineering, University of Natural Resources and Life Sciences, Vienna},
+  title       = {Spatio-temporal water balance Danube--A methodology for the spatially distributed, seasonal water balance of the Danube basin},
+  year        = {2005},
+  pages       = {112},
+}
+
+@Book{Kling2006,
+  author = {Kling, Harald},
+  publisher = {Institute of Water Management, Hydrology and Hydraulic Engineering, University of Natural Resources and Life Sciences, Vienna},
+  title  = {Spatio-temporal modelling of the water balance of Austria},
+  year   = {2006},
+}
+
+@Article{Frey2015CoseroSnow,
+  author    = {Frey, Simon and Holzmann, Hubert},
+  journal   = {Hydrology and Earth System Sciences},
+  title     = {A conceptual, distributed snow redistribution model},
+  year      = {2015},
+  number    = {11},
+  pages     = {4517--4530},
+  volume    = {19},
+  publisher = {Copernicus GmbH},
+  doi       = {10.5194/hess-19-4517-2015},
+}
+
+@Book{McCarthy1940,
+  author    = {McCarthy, G. T.},
+  publisher = {The Engineer School, Fort Belvoir, Virginia},
+  title     = {Flood Control},
+  year      = {1940},
+}
+
+@Article{Cunge1969,
+  author  = {Cunge, J. A.},
+  journal = {Journal of Hydraulic Research},
+  title   = {On The Subject Of A Flood Propagation Computation Method (Muskingum Method)},
+  year    = {1969},
+  volume  = {7},
+  issue   = {2},
+  pages   = {205--230},
+  url     = {https://www.tandfonline.com/doi/abs/10.1080/00221686909500264},
+}
+
+@Article{Todini2007,
+  author  = {Todini, Ezio},
+  journal = {Hydrology and Earth System Sciences},
+  title   = {A mass conservative and water storage consistent variable parameter Muskingum-Cunge approach},
+  year    = {2007},
+  volume  = {11},
+  issue   = {5},
+  pages   = {1645--1659},
+  doi     = {10.5194/hess-11-1645-2007},
+}
+
+
+@Article{Dowell1972,
+  author  = {Dowell, M. and Jarratt, P.},
+  journal = {BIT Numerical Mathematics},
+  title   = {The “Pegasus” method for computing the root of an equation},
+  year    = {1972},
+  volume  = {12},
+  issue   = {4},
+  pages   = {503--508},
+  url     = {https://link.springer.com/article/10.1007/BF01932959},
+}
+
+@Article{Clark2010,
+  author  = {Clark, Martyn P. and Kavetski, Dimitri},
+  journal = {Water Resources Research},
+  title   = {Ancient numerical daemons of conceptual hydrological modeling: 1. Fidelity and efficiency of time stepping schemes},
+  year    = {2010},
+  volume  = {46},
+  issue   = {10},
+  doi     = {10.1029/2009WR008894},
+}
+
+@Book{Tyralla2016,
+  author   = {Tyralla, Christoph},
+  publisher = {Ruhr-University Bochum},
+  title    = {Identifikation und Reduktion struktureller Unsicherheiten in hydrologischen Modellen},
+  year     = {2016},
+  url      = {https://hss-opus.ub.ruhr-uni-bochum.de/opus4/frontdoor/index/index/docId/5056},
+}
+
+@Article{Lai2015,
+  author    = {Lai, Wencong and Ogden, Fred L. and Steinke, Robert C. and Talbot, Cary A.},
+  journal   = {Water Resources Research},
+  title     = {An efficient and guaranteed stable numerical method for continuous modeling of infiltration and redistribution with a shallow dynamic water table},
+  year      = {2015},
+  number    = {3},
+  pages     = {1514-1528},
+  volume    = {51},
+  publisher = {Wiley Online Library},
+  doi       = {10.1002/2014WR016487},
+}
+
+@Article{Talbot2008,
+  author    = {Talbot, Cary A. and Ogden, Fred L.},
+  journal   = {Water Resources Research},
+  title     = {A method for computing infiltration and redistribution in a discretized moisture content domain},
+  year      = {2008},
+  number    = {10},
+  volume    = {44},
+  publisher = {Wiley Online Library},
+  doi       = {10.1029/2008WR006815},
+}
+
+@Article{Brooks1966,
+  author    = {Brooks, R. H. and Corey, A. T.},
+  journal   = {Journal of the Irrigation and Drainage Division},
+  title     = {Properties of Porous Media Affecting Fluid Flow.},
+  year      = {1966},
+  number    = {92},
+  pages     = {61-90},
+  doi       = {10.1061/JRCEA4.0000425},
+}
+
+@phdthesis{Valery,
+author = {Valéry, Alexis},
+year = {2010},
+month = {01},
+school = {AgroParisTech},
+pages = {},
+title = {Modélisation précipitations débit sous influence nivale : Elaboration d'un module neige et évaluation sur 380 bassins versants}
+}
+
+@article{Turcotte2007,
+author = {Turcotte, Richard and Fortin, L.-G and Fortin, Vincent and Fortin, J.-P and Villeneuve, Jean-Pierre},
+year = {2007},
+month = {08},
+pages = {},
+title = {Operational analysis of the spatial distribution and the temporal evolution of the snowpack water equivalent in southern Québec, Canada},
+volume = {38},
+journal = {Water Policy},
+doi = {10.2166/nh.2007.009}
+}
+
+@TechReport{USACE1956,
+  author      = {United States Army Corps of Engineers},
+  institution = {United States Army.Corps of Engineers. Portland District},
+  title       = {Snow hydrology: Summary report of the snow investigations},
+  year        = {1956},
+  pages       = {437},
+}
+
+@Article{airGR2017,
+title = {The Suite of Lumped {GR} Hydrological Models in an {R}
+  package},
+author = {L. Coron and G. Thirel and O. Delaigue and C. Perrin and
+  V. Andréassian},
+journal = {Environmental Modelling and Software},
+year = {2017},
+pages = {166-171},
+volume = {94},
+doi = {10.1016/j.envsoft.2017.05.002},
+}
+
+@Manual{airGRManual,
+title = {{airGR}: Suite of {GR} Hydrological Models for
+  Precipitation-Runoff Modelling},
+author = {L. Coron and O. Delaigue and G. Thirel and D. Dorchies
+  and C. Perrin and C. Michel},
+journal = {R News},
+year = {2023},
+note = {R package version 1.7.4},
+doi = {10.15454/EX11NA},
+url = {https://CRAN.R-project.org/package=airGR},
+}
+
+@article{Perrin2003,
+author = {Perrin, Charles and Michel, Claude and Andréassian, Vazken},
+year = {2003},
+month = {08},
+pages = {275-289},
+title = {Improvement of a Parsimonious Model for Streamflow Simulation},
+volume = {279},
+journal = {Journal of Hydrology},
+doi = {10.1016/S0022-1694(03)00225-7}
+}
+
+@phdthesis{Moine2008,
+  title={Le bassin versant de surface vu par le souterrain: une voie d'am{\'e}lioration des performances et du r{\'e}alisme des mod{\`e}les pluie-d{\'e}bit?},
+  author={Le Moine, Nicolas},
+  year={2008},
+  school={Doctorat G{\'e}osciences et Ressources Naturelles, Universit{\'e} Pierre et Marie~…}
+}
+
+@article{Pushpalatha2011,
+title = {A downward structural sensitivity analysis of hydrological models to improve low-flow simulation},
+journal = {Journal of Hydrology},
+volume = {411},
+number = {1},
+pages = {66-76},
+year = {2011},
+issn = {0022-1694},
+doi = {https://doi.org/10.1016/j.jhydrol.2011.09.034},
+url = {https://www.sciencedirect.com/science/article/pii/S0022169411006846},
+author = {Raji Pushpalatha and Charles Perrin and Nicolas {Le Moine} and Thibault Mathevet and Vazken Andréassian},
+keywords = {Low flows, Simulation, Lumped model, Model efficiency, Uncertainty, Downward approach},
+abstract = {Summary
+Better simulation and earlier prediction of river low flows are needed for improved water management. Here, a top–down structural analysis to improve a hydrological model in a low-flow simulation perspective is presented. Starting from a simple but efficient rainfall–runoff model (GR5J), we analyse the sensitivity of low-flow simulations to progressive modifications of the model’s structure. These modifications correspond to the introduction of more complex routing schemes and/or the addition of simple representations of groundwater–surface water exchanges. In these tests, we wished to improve low-flow simulation while avoiding performance losses in high-flow conditions, i.e. keeping a general model. In a typical downward modelling perspective, over 60 versions of the model were tested on a large set of French catchments corresponding to various low-flow conditions, and performance was evaluated using criteria emphasising errors in low-flow conditions. The results indicate that several best performing structures yielded quite similar levels of efficiency. The addition of a new flow component to the routing part of the model yielded the most significant improvement. In spite of the close performance of several model structures, we conclude by proposing a modified model version of GR5J with a single additional parameter.}
+}
+
+@Article{Minhas1974,
+  author    = {Minhas, B. S. and Parikh, K. S. and Srinivasan, T. N.},
+  journal   = {Water Resources Research},
+  title     = {Toward the structure of a production function for wheat yields with dated inputs of irrigation water},
+  year      = {1974},
+  number    = {3},
+  volume    = {10},
+  pages     = {383-393},
+  publisher = {Wiley Online Library},
+  doi       = {10.1029/WR010i003p00383},
+}
+
+@Book{DVWK2002,
+  title     = {Merkblatt ATV-DVWK-M 504 - Verdunstung in Bezug zu Landnutzung, Bewuchs und Boden},
+  publisher = {Deutsche Vereinigung für Wasserwirtschaft, Abwasser und Abfall},
+  year      = {2002},
+  author    = {Bernhofer, C. and Glugla, G., and Golf, W., and Günther, R., and Jankiewicz, P., and Klämt, A., and Menzel, L., and Miegel, K., and Olbrisch, H.-D., and Wendling, U.},
+}
+
+@Book{Disse1995,
+  author   = {Disse, Markus},
+  title    = {Modellierung der Verdunstung und der Grundwasserneubildung in ebenen Einzugsgebieten},
+  publisher = {Universität Fridericiana zu Karlsruhe (TH)},
+  year     = {1995},
+}
+
+@Article{Bates2010,
+  author    = {Bates, Paul D. and Horritt, Matthew S. and Fewtrell, Timothy J.},
+  journal   = {Journal of Hydrology},
+  title     = {A simple inertial formulation of the shallow water equations for efficient two-dimensional flood inundation modelling},
+  year      = {2010},
+  number    = {1-2},
+  volume    = {387},
+  pages     = {33-45},
+  doi       = {10.1016/j.jhydrol.2010.03.027},
+}
+
+@Article{Almeida2012,
+  author    = {de Almeida, Gustavo A. M. and Bates, Paul and Freer, Jim E. and Souvignet, M.},
+  journal   = {Water Resources Research},
+  title     = {Improving the stability of a simple formulation of the shallow water equations for 2-D flood modeling},
+  year      = {2012},
+  volume    = {48},
+  publisher = {Wiley Online Library},
+  doi       = {10.1029/2011WR011570},
+}
+
+@TechReport{Löpmeier2014,
+  author      = {Löpmeier, Franz-Josef},
+  institution = {Deutscher Wetterdienst},
+  title       = {Agrarmeteorologisches Modell zur Berechnung der aktuellen Verdunstung (AMBAV)},
+  year        = {2014},
+  pages       = {39},
+}
+
+@Article{Oliver1974,
+  author    = {Oliver, H., R.},
+  journal   = {Meteorological Magazine},
+  title     = {Wind speed modification by a very rought surface},
+  year      = {1974},
+  volume    = {103},
+}
+
+@article{Holtslag1981,
+author = {Holtslag, Bert and de Bruin, Henk and Ulden, A.P.},
+year = {1981},
+month = {01},
+pages = {401-407},
+title = {Estimation of the Sensible Heat Flux from Standard Meteorological Data for Stability Calculations During Daytime},
+isbn = {978-1-4613-3346-3},
+journal = {Air Pollution Modeling and its Application I},
+doi = {10.1007/978-1-4613-3344-9_26}
+}
+
+@article{Idso1969,
+  title={Thermal radiation from the atmosphere},
+  author={Idso, Sherwood B and Jackson, Ray D},
+  journal={Journal of geophysical research},
+  volume={74},
+  number={23},
+  pages={5397--5403},
+  year={1969},
+  publisher={Wiley Online Library}
+}
+
+@Book{Sellers1960,
+  title={Physical climatology},
+  author={Sellers, William D},
+  year={1960},
+  publisher={The University of Chicago Press}
+}
+
+@article{Oudin2005,
+  title={Which potential evapotranspiration input for a lumped rainfall--runoff model?: Part 2—Towards a simple and efficient potential evapotranspiration model for rainfall--runoff modelling},
+  author={Oudin, Ludovic and Hervieu, Fr{\'e}d{\'e}ric and Michel, Claude and Perrin, Charles and Andr{\'e}assian, Vazken and Anctil, Fran{\c{c}}ois and Loumagne, C{\'e}cile},
+  journal={Journal of hydrology},
+  volume={303},
+  number={1-4},
+  pages={290--306},
+  year={2005},
+  publisher={Elsevier}
+}
+
+@book{Harlin1992,
+  title={Hydrological modelling of extreme floods in Sweden},
+  author={Harlin, Joakim},
+  year={1992},
+  publisher={SMHI}
+}
+
+@article{Perrin2007,
+  title={Mod{\`e}les hydrologiques du g{\'e}nie rural (GR)},
+  author={Perrin, Charles and Michel, Claude and Andr{\'e}assian, Vazken},
+  journal={Cemagref, UR Hydrosyst{\`e}mes et Bioproc{\'e}d{\'e}s},
+  volume={16},
+  year={2007}
+}
+
+@article{Williams1969,
+  title={Flood Routing With Variable Travel Time or Variable Storage Coefficients},
+  author={Williams, J., R.},
+  journal={Transactions of the ASAE},
+  volume={12},
+  issue={1},
+  year={1969}
+}
+
+@phdthesis{Ficchí2017,
+author = {Ficchí, Andrea},
+year = {2017},
+school = {Université Pierre et Marie Curie - Paris VI},
+title = {An adaptive hydrological model for multiple time-steps : diagnostics and improvements based on fluxes consistency.}
+}
+
+@Comment{jabref-meta: databaseType:bibtex;}
+
+@Comment{jabref-meta: grouping:
+0 AllEntriesGroup:;
+1 StaticGroup:Markings\;2\;1\;\;\;\;;
+}
+
+@book{Armbruster2002,
+  title={Grundwasserneubildung in Baden-Württemberg},
+  author={Armbruster, Volker},
+  year={2002},
+  publisher={Institut für Hydrologie der Universität Freiburg i. Br.}
+}
+
+@book{Probst2002,
+  title={Der Einfluss des Grundwasserhaushalts auf das Abflussverhalten kleiner Einzugsgebiete im Festgesteinsbereich der Mittelgebirge},
+  author={Probst, Michael},
+  year={2002},
+  publisher={Fachgebiet Wasserbau und Wasserwirtschaft der Universität Kaiserslautern}
+}
+

hydpy/docs/combine_docversions.py

@@ -0,0 +1,133 @@
+"""Combine the currently generated documentation with the existing ones of the
+`available_doc_versions` branch and update this branch (which delete its history
+entirely).
+
+This script works on Travis-CI.  To use it somewhere else, set the environment variable
+`TRAVIS_BRANCH` to the current branch name.  But we aware of the "git config..."
+command below.  I do not know if it modifies  your git configuration permanently.
+
+This script does not push anything to Github-Pages.
+"""
+
+import os
+import shutil
+import sys
+
+
+def print_(*message: str) -> None:
+    """Print immediately."""
+    print(*message)
+    sys.stdout.flush()
+
+
+def call(command: str) -> None:
+    """`os.system` with direct termination in the event of an error."""
+    code = os.system(command)
+    if code:
+        sys.exit(1)
+
+
+shutil.copy("hydpy/docs/publish_docs.py", "publish_docs_copy.py")
+
+print_('Check out the "available_doc_versions" branch:')
+call("git config --replace-all remote.origin.fetch +refs/heads/*:refs/remotes/origin/*")
+call("git fetch --all")
+call("git checkout --track origin/available_doc_versions")
+
+branch2version: dict[str, str] = {}
+with open("relevant_branches.txt", encoding="utf-8") as file_:
+    for line in file_.readlines()[1:]:
+        try:
+            branch, version = line.split()
+        except TypeError:
+            continue
+        else:
+            branch2version[branch] = version
+
+print_("Relevant branch/version names:")
+for branch, version in branch2version.items():
+    print_("\t", branch, version)
+
+actual_branch = os.environ["TRAVIS_BRANCH"]
+print_("Actual branch name:")
+print_(f"\t{actual_branch}")
+if actual_branch not in branch2version:
+    sys.exit(0)
+
+actual_version = branch2version[actual_branch]
+if os.path.exists(actual_version):
+    print_("Remove the old documentation of branch", actual_branch)
+    shutil.rmtree(actual_version)
+print_("Activate the new documentation of branch", actual_branch)
+for dirpath, _, _ in os.walk(os.path.join(".nox", "sphinx")):
+    if os.path.split(dirpath)[-1] == "site-packages":
+        buildpath = os.path.join(dirpath, "hydpy", "docs", "auto", "build")
+        if os.path.exists(buildpath):
+            break
+else:
+    raise RuntimeError("Cannot find Sphinx's build path.")
+shutil.move(buildpath, actual_version)
+
+print_("Update and squash the remote `available_doc_versions` branch:")
+call(f"git add {actual_version}")
+call(f'git commit -m "update branch {actual_branch}"')
+call("git checkout 57c347f3c01818777aeea4e71c4f5bb884e48216 -b temp")
+call("git merge --squash available_doc_versions")
+call('git commit -m "update docs"')
+
+if (token := os.environ.get("GH_TOKEN")) is None:
+    print_("Not authorised to push to branch `available_doc_versions`")
+else:
+    repo = os.environ["TRAVIS_REPO_SLUG"]
+    remote = f"https://{token}@github.com/{repo}.git"
+    call(f"git push {remote} temp:available_doc_versions -f")
+
+print_("Move everything relevant to the final results folder:")
+os.makedirs("result")
+shutil.copy(".gitignore", "result/.gitignore")
+shutil.copy("relevant_branches.txt", "result/relevant_branches.txt")
+shutil.copy("index.html", "result/index.html")
+for version in branch2version.values():
+    target = os.path.join("result", version)
+    print_(f"\t{version} --> {target}")
+    shutil.move(version, target)
+
+print_("Search for the relevant HTML files:")
+version2htmls: dict[str, tuple[str, ...]] = {}
+for version in branch2version.values():
+    print_(f"\tversion {version}")
+    folderpath = os.path.join("result", version)
+    version2htmls[version] = tuple(
+        filename for filename in os.listdir(folderpath) if filename.endswith(".html")
+    )
+
+print_("Update all relevant HTML files:")
+for version1, htmls1 in version2htmls.items():
+    print_(f"\tUpdate version {version1}")
+    for html1 in htmls1:
+        filepath1 = os.path.join("result", version1, html1)
+        with open(filepath1, encoding="utf-8-sig") as file_:
+            text = file_.read()
+        try:
+            idx = text.index('<div id="searchbox"')
+        except ValueError:
+            continue
+        if idx <= 0:
+            continue
+        links: list[str] = []
+        for version2, htmls2 in version2htmls.items():
+            if html1 in htmls2:
+                links.append(f'<li><a href="../{version2}/{html1}">{version2}</a></li>')
+        if not links:
+            continue
+        print_(f"\t\tUpdate file {html1}")
+        above = text[:idx]
+        below = text[idx:]
+        jdx = above.rfind("</div>")
+        below = f"{above[jdx:]}{below}"
+        above = above[:jdx]
+        text = "\n".join(
+            (above, "<h3>Versions</h3>", "<ul>", "\n".join(links), "</ul>", below)
+        )
+        with open(filepath1, "w", encoding="utf-8-sig") as file_:
+            file_.write(text)