HydPy 6.0.0__tar.gz → 6.0a0__tar.gz

{hydpy-6.0.0 → hydpy-6.0a0}/.gitignore

@@ -48,4 +48,3 @@ make_hydpy_installer.cfg
 lib/*
 temp/*
 hydpy/docs/bibliography/refs.bib.bak
-hydpy/docs/html_/plotly.min.js

{hydpy-6.0.0 → hydpy-6.0a0/HydPy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: HydPy
-Version: 6.0.0
+Version: 6.0a0
 Summary: A framework for the development and application of hydrological models.
 Home-page: https://github.com/hydpy-dev/hydpy
 Author: HydPy Developers

{hydpy-6.0.0 → hydpy-6.0a0}/HydPy.egg-info/SOURCES.txt

@@ -20,6 +20,7 @@ HydPy.egg-info/PKG-INFO
 hydpy/__init__.py
 hydpy/aliases.py
 hydpy/config.py
+hydpy/examples.py
 hydpy/py.typed
 hydpy/auxs/__init__.py
 hydpy/auxs/anntools.py
@@ -309,48 +310,48 @@ hydpy/cythons/autogen/sequenceutils.pyx
 hydpy/cythons/autogen/smoothutils.pxd
 hydpy/cythons/autogen/smoothutils.pyx
 hydpy/data/__init__.py
-hydpy/data/HydPy-H-Lahn/multiple_runs.xml
-hydpy/data/HydPy-H-Lahn/multiple_runs_alpha.xml
-hydpy/data/HydPy-H-Lahn/single_run.xml
-hydpy/data/HydPy-H-Lahn/single_run.xmlt
-hydpy/data/HydPy-H-Lahn/conditions/init_1996_01_01_00_00_00/land_dill_assl.py
-hydpy/data/HydPy-H-Lahn/conditions/init_1996_01_01_00_00_00/land_lahn_kalk.py
-hydpy/data/HydPy-H-Lahn/conditions/init_1996_01_01_00_00_00/land_lahn_leun.py
-hydpy/data/HydPy-H-Lahn/conditions/init_1996_01_01_00_00_00/land_lahn_marb.py
-hydpy/data/HydPy-H-Lahn/conditions/init_1996_01_01_00_00_00/stream_dill_assl_lahn_leun.py
-hydpy/data/HydPy-H-Lahn/conditions/init_1996_01_01_00_00_00/stream_lahn_leun_lahn_kalk.py
-hydpy/data/HydPy-H-Lahn/conditions/init_1996_01_01_00_00_00/stream_lahn_marb_lahn_leun.py
-hydpy/data/HydPy-H-Lahn/control/default/land.py
-hydpy/data/HydPy-H-Lahn/control/default/land_dill_assl.py
-hydpy/data/HydPy-H-Lahn/control/default/land_lahn_kalk.py
-hydpy/data/HydPy-H-Lahn/control/default/land_lahn_leun.py
-hydpy/data/HydPy-H-Lahn/control/default/land_lahn_marb.py
-hydpy/data/HydPy-H-Lahn/control/default/stream_dill_assl_lahn_leun.py
-hydpy/data/HydPy-H-Lahn/control/default/stream_lahn_leun_lahn_kalk.py
-hydpy/data/HydPy-H-Lahn/control/default/stream_lahn_marb_lahn_leun.py
-hydpy/data/HydPy-H-Lahn/network/default/headwaters.py
-hydpy/data/HydPy-H-Lahn/network/default/nonheadwaters.py
-hydpy/data/HydPy-H-Lahn/network/default/streams.py
-hydpy/data/HydPy-H-Lahn/series/default/evap_pet_hbv96_input_normalairtemperature.nc
-hydpy/data/HydPy-H-Lahn/series/default/evap_pet_hbv96_input_normalevapotranspiration.nc
-hydpy/data/HydPy-H-Lahn/series/default/hland_96_input_p.nc
-hydpy/data/HydPy-H-Lahn/series/default/hland_96_input_t.nc
-hydpy/data/HydPy-H-Lahn/series/default/land_dill_assl_evap_pet_hbv96_input_normalairtemperature.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_dill_assl_evap_pet_hbv96_input_normalevapotranspiration.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_dill_assl_hland_96_input_p.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_dill_assl_hland_96_input_t.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_kalk_evap_pet_hbv96_input_normalairtemperature.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_kalk_evap_pet_hbv96_input_normalevapotranspiration.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_kalk_hland_96_input_p.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_kalk_hland_96_input_t.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_leun_evap_pet_hbv96_input_normalairtemperature.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_leun_evap_pet_hbv96_input_normalevapotranspiration.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_leun_hland_96_input_p.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_leun_hland_96_input_t.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_marb_evap_pet_hbv96_input_normalairtemperature.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_marb_evap_pet_hbv96_input_normalevapotranspiration.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_marb_hland_96_input_p.asc
-hydpy/data/HydPy-H-Lahn/series/default/land_lahn_marb_hland_96_input_t.asc
+hydpy/data/LahnH/multiple_runs.xml
+hydpy/data/LahnH/multiple_runs_alpha.xml
+hydpy/data/LahnH/single_run.xml
+hydpy/data/LahnH/single_run.xmlt
+hydpy/data/LahnH/conditions/init_1996_01_01_00_00_00/land_dill.py
+hydpy/data/LahnH/conditions/init_1996_01_01_00_00_00/land_lahn_1.py
+hydpy/data/LahnH/conditions/init_1996_01_01_00_00_00/land_lahn_2.py
+hydpy/data/LahnH/conditions/init_1996_01_01_00_00_00/land_lahn_3.py
+hydpy/data/LahnH/conditions/init_1996_01_01_00_00_00/stream_dill_lahn_2.py
+hydpy/data/LahnH/conditions/init_1996_01_01_00_00_00/stream_lahn_1_lahn_2.py
+hydpy/data/LahnH/conditions/init_1996_01_01_00_00_00/stream_lahn_2_lahn_3.py
+hydpy/data/LahnH/control/default/land.py
+hydpy/data/LahnH/control/default/land_dill.py
+hydpy/data/LahnH/control/default/land_lahn_1.py
+hydpy/data/LahnH/control/default/land_lahn_2.py
+hydpy/data/LahnH/control/default/land_lahn_3.py
+hydpy/data/LahnH/control/default/stream_dill_lahn_2.py
+hydpy/data/LahnH/control/default/stream_lahn_1_lahn_2.py
+hydpy/data/LahnH/control/default/stream_lahn_2_lahn_3.py
+hydpy/data/LahnH/network/default/headwaters.py
+hydpy/data/LahnH/network/default/nonheadwaters.py
+hydpy/data/LahnH/network/default/streams.py
+hydpy/data/LahnH/series/default/evap_pet_hbv96_input_normalairtemperature.nc
+hydpy/data/LahnH/series/default/evap_pet_hbv96_input_normalevapotranspiration.nc
+hydpy/data/LahnH/series/default/hland_96_input_p.nc
+hydpy/data/LahnH/series/default/hland_96_input_t.nc
+hydpy/data/LahnH/series/default/land_dill_evap_pet_hbv96_input_normalairtemperature.asc
+hydpy/data/LahnH/series/default/land_dill_evap_pet_hbv96_input_normalevapotranspiration.asc
+hydpy/data/LahnH/series/default/land_dill_hland_96_input_p.asc
+hydpy/data/LahnH/series/default/land_dill_hland_96_input_t.asc
+hydpy/data/LahnH/series/default/land_lahn_1_evap_pet_hbv96_input_normalairtemperature.asc
+hydpy/data/LahnH/series/default/land_lahn_1_evap_pet_hbv96_input_normalevapotranspiration.asc
+hydpy/data/LahnH/series/default/land_lahn_1_hland_96_input_p.asc
+hydpy/data/LahnH/series/default/land_lahn_1_hland_96_input_t.asc
+hydpy/data/LahnH/series/default/land_lahn_2_evap_pet_hbv96_input_normalairtemperature.asc
+hydpy/data/LahnH/series/default/land_lahn_2_evap_pet_hbv96_input_normalevapotranspiration.asc
+hydpy/data/LahnH/series/default/land_lahn_2_hland_96_input_p.asc
+hydpy/data/LahnH/series/default/land_lahn_2_hland_96_input_t.asc
+hydpy/data/LahnH/series/default/land_lahn_3_evap_pet_hbv96_input_normalairtemperature.asc
+hydpy/data/LahnH/series/default/land_lahn_3_evap_pet_hbv96_input_normalevapotranspiration.asc
+hydpy/data/LahnH/series/default/land_lahn_3_hland_96_input_p.asc
+hydpy/data/LahnH/series/default/land_lahn_3_hland_96_input_t.asc
 hydpy/docs/__init__.py
 hydpy/docs/combine_docversions.py
 hydpy/docs/draw_model_sketches.py
@@ -364,15 +365,13 @@ hydpy/docs/bib/refs.bib
 hydpy/docs/figs/HydPy-H-HBV96-COSERO.png
 hydpy/docs/figs/HydPy-H-HBV96-PREVAH.png
 hydpy/docs/figs/HydPy-H-HBV96.png
-hydpy/docs/figs/HydPy-H-Lahn.png
 hydpy/docs/figs/HydPy-KinW-Williams.png
 hydpy/docs/figs/HydPy-L-DD.png
 hydpy/docs/figs/HydPy-W-Wag.png
 hydpy/docs/figs/HydPy_Logo.png
 hydpy/docs/figs/HydPy_Logo_Text.png
-hydpy/docs/figs/IDLE-editor.png
-hydpy/docs/figs/IDLE-shell.png
 hydpy/docs/figs/LAWA_river-basin-bumbers.png
+hydpy/docs/figs/LahnH.png
 hydpy/docs/figs/__init__.py
 hydpy/docs/html_/__init__.py
 hydpy/docs/rst/HydPy-ARMA.rst
@@ -395,38 +394,30 @@ hydpy/docs/rst/HydPy-WQ.rst
 hydpy/docs/rst/__init__.py
 hydpy/docs/rst/additional_repositories.rst
 hydpy/docs/rst/auxiliaries.rst
+hydpy/docs/rst/configuration.rst
 hydpy/docs/rst/continuous_integration.rst
 hydpy/docs/rst/core.rst
 hydpy/docs/rst/cythons.rst
-hydpy/docs/rst/definitions.rst
-hydpy/docs/rst/developer_guide.rst
-hydpy/docs/rst/example_projects.rst
+hydpy/docs/rst/development.rst
 hydpy/docs/rst/execution.rst
-hydpy/docs/rst/framework_tools.rst
-hydpy/docs/rst/how_to_read_the_reference_manual.rst
+hydpy/docs/rst/framework.rst
+hydpy/docs/rst/how_to.rst
 hydpy/docs/rst/hydpydependencies.rst
 hydpy/docs/rst/index.rst
-hydpy/docs/rst/installation.rst
-hydpy/docs/rst/model_families.rst
-hydpy/docs/rst/model_overview.rst
+hydpy/docs/rst/install.rst
+hydpy/docs/rst/interfaces.rst
+hydpy/docs/rst/modelcollection.rst
 hydpy/docs/rst/modelimports.rst
-hydpy/docs/rst/options.rst
 hydpy/docs/rst/programming_style.rst
-hydpy/docs/rst/project_structure.rst
 hydpy/docs/rst/quickstart.rst
-hydpy/docs/rst/reference_manual.rst
 hydpy/docs/rst/required_tools.rst
-hydpy/docs/rst/submodel_interfaces.rst
 hydpy/docs/rst/tests_and_documentation.rst
-hydpy/docs/rst/user_guide.rst
 hydpy/docs/rst/version_control.rst
 hydpy/docs/rst/zbibliography.rst
 hydpy/docs/sphinx/__init__.py
 hydpy/docs/sphinx/conf.py
 hydpy/docs/sphinx/defaultlinks_extension.py
 hydpy/docs/sphinx/integrationtest_extension.py
-hydpy/docs/sphinx/projectstructure_extension.py
-hydpy/docs/sphinx/submodelgraph_extension.py
 hydpy/docs/sphinx/_themes/basic_hydpy/defindex.html
 hydpy/docs/sphinx/_themes/basic_hydpy/domainindex.html
 hydpy/docs/sphinx/_themes/basic_hydpy/genindex-single.html

{hydpy-6.0.0/HydPy.egg-info → hydpy-6.0a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: HydPy
-Version: 6.0.0
+Version: 6.0a0
 Summary: A framework for the development and application of hydrological models.
 Home-page: https://github.com/hydpy-dev/hydpy
 Author: HydPy Developers

{hydpy-6.0.0 → hydpy-6.0a0}/appveyor.yml

@@ -1,5 +1,5 @@
 
-version: 6.0.0.{build}
+version: 6.0a0.{build}
 
 image: Visual Studio 2019
 
@@ -71,7 +71,7 @@ deploy:
   description: 'This is a draft.'
   provider: GitHub
   auth_token:
-    secure: awErmBBNP9Qq2n3+cbp64cT5s7d6LOI4hfMrYYSZZmIvmZuKeGx2X07p1vJJPd8a+f5wwFh8Ut8Ycu+ZcKlBPwX0K4vjV3t0yjdwg5cCPNokSe6JjtqUHIstLPz+i2tN
+    secure: awErmBBNP9Qq2n3+cbp64dKq8fXLlWJ+/uYg1oPuk4JVvQtldDBS7xANp64tOYMSW4yUrjGFD03uGg7ZuvrorLyCOfgT9EQ1WKey7T/9VrWwzGhDgtBRF8bp3VsfhW42
   artifact: Packages,Installer,XSDs
   draft: true
   prerelease: false

{hydpy-6.0.0 → hydpy-6.0a0}/hydpy/__init__.py

@@ -38,7 +38,6 @@ from hydpy.core.exceptiontools import HydPyDeprecationWarning
 from hydpy.core.hydpytools import HydPy
 from hydpy.core.importtools import prepare_model, reverse_model_wildcard_import
 from hydpy.core.itemtools import AddItem, GetItem, MultiplyItem, SetItem
-from hydpy.core.netcdftools import summarise_ncfile
 from hydpy.core.objecttools import classname, print_matrix, print_vector, round_, repr_
 from hydpy.core.parametertools import KeywordArguments
 from hydpy.core.selectiontools import Selection, Selections
@@ -117,7 +116,7 @@ from hydpy.exe.replacetools import xml_replace
 from hydpy.exe.servertools import await_server, start_server
 
 
-__version__ = "6.0.0"
+__version__ = "6.0a0"
 
 pub.options = optiontools.Options()
 pub.indexer = indextools.Indexer()
@@ -153,10 +152,9 @@ __all__ = [
     "GetItem",
     "MultiplyItem",
     "SetItem",
-    "summarise_ncfile",
-    "classname",
     "print_matrix",
     "print_vector",
+    "classname",
     "repr_",
     "round_",
     "KeywordArguments",
@@ -259,6 +257,7 @@ if config.USEAUTODOC:
                         f"{subpackage.__name__}.{filename[:-3]}"
                     )
                     autodoctools.autodoc_module(module)
+        autodoctools.autodoc_module(importlib.import_module("hydpy.examples"))
         modelpath: str = models.__path__[0]
         for filename in sorted(os.listdir(modelpath)):
             path = os.path.join(modelpath, filename)

{hydpy-6.0.0 → hydpy-6.0a0}/hydpy/auxs/calibtools.py

@@ -103,7 +103,7 @@ class SumAdaptor(Adaptor):
     model |hland_96| (assuming the nonlinearity parameter |hland_control.Alpha| to be
     zero):
 
-    >>> from hydpy.core.testtools import prepare_full_example_2
+    >>> from hydpy.examples import prepare_full_example_2
     >>> hp, pub, TestIO = prepare_full_example_2()
     >>> from hydpy import Replace, SumAdaptor
     >>> k = Replace(name="k",
@@ -131,7 +131,7 @@ class SumAdaptor(Adaptor):
     Calling method |Replace.apply_value| of the |Replace| objects makes our
     |SumAdaptor| object apply the sum of the values of all of its |Rule| objects:
 
-    >>> control = hp.elements.land_dill_assl.model.parameters.control
+    >>> control = hp.elements.land_dill.model.parameters.control
     >>> k.apply_value()
     >>> with pub.options.parameterstep("1d"):
     ...     control.k
@@ -167,7 +167,7 @@ class FactorAdaptor(Adaptor):
     To show how class |FactorAdaptor| works, we select another use-case based on the
     `Lahn` example project prepared by function |prepare_full_example_2|:
 
-    >>> from hydpy.core.testtools import prepare_full_example_2
+    >>> from hydpy.examples import prepare_full_example_2
     >>> hp, pub, TestIO = prepare_full_example_2()
 
     |hland_96| calculates the "normal" potential snow-melt with the degree-day factor
@@ -192,12 +192,12 @@ class FactorAdaptor(Adaptor):
 
     >>> gmelt.adaptor = FactorAdaptor(gmelt, "cfmax")
 
-    The `dill_assl` subcatchment, like the whole `Lahn` basin, does not contain any
+    The `Dill` subcatchment, like the whole `Lahn` basin, does not contain any
     glaciers.  Hence it defines (identical) |hland_control.CFMax| values for the zones
     of type |hland_constants.FIELD| and |hland_constants.FOREST| but must not specify
     any value for |hland_control.GMelt|:
 
-    >>> control = hp.elements.land_dill_assl.model.parameters.control
+    >>> control = hp.elements.land_dill.model.parameters.control
     >>> control.cfmax
     cfmax(field=4.55853, forest=2.735118)
     >>> control.gmelt
@@ -296,7 +296,7 @@ class Rule(abc.ABC, Generic[TypeParameter]):
     and use the `Lahn` example project, which we prepare by calling function
     |prepare_full_example_2|:
 
-    >>> from hydpy.core.testtools import prepare_full_example_2
+    >>> from hydpy.examples import prepare_full_example_2
     >>> hp, pub, TestIO = prepare_full_example_2()
 
     We define a |Rule| object supposed to replace the values of parameter
@@ -327,7 +327,7 @@ class Rule(abc.ABC, Generic[TypeParameter]):
 
     The initial value of parameter |hland_control.FC| is 206 mm:
 
-    >>> fc = hp.elements.land_lahn_marb.model.parameters.control.fc
+    >>> fc = hp.elements.land_lahn_1.model.parameters.control.fc
     >>> fc
     fc(206.0)
 
@@ -432,7 +432,7 @@ class Rule(abc.ABC, Generic[TypeParameter]):
         selections=("complete",),
     )
     >>> rule.apply_value()
-    >>> percmax = hp.elements.land_lahn_marb.model.parameters.control.percmax
+    >>> percmax = hp.elements.land_lahn_1.model.parameters.control.percmax
     >>> with pub.options.parameterstep("1d"):
     ...     percmax
     percmax(5.0)
@@ -470,8 +470,7 @@ via option `parameterstep`.
     ...                value=100.0,
     ...                model="hland_96")
     >>> rule.elements
-    Elements("land_dill_assl", "land_lahn_kalk", "land_lahn_leun",
-             "land_lahn_marb")
+    Elements("land_dill", "land_lahn_1", "land_lahn_2", "land_lahn_3")
 
     Alternatively, you can specify selections by passing themselves or their names (the
     latter requires them to be a member of `pub.selections`):
@@ -481,8 +480,7 @@ via option `parameterstep`.
     ...                value=100.0,
     ...                selections=[pub.selections.headwaters, "nonheadwaters"])
     >>> rule.elements
-    Elements("land_dill_assl", "land_lahn_kalk", "land_lahn_leun",
-             "land_lahn_marb")
+    Elements("land_dill", "land_lahn_1", "land_lahn_2", "land_lahn_3")
 
     When not using the model argument, you must ensure the selected elements handle the
     correct model instance:
@@ -493,8 +491,8 @@ via option `parameterstep`.
     Traceback (most recent call last):
     ...
     RuntimeError: While trying to initialise the `Replace` rule object `fc`, the \
-following error occurred: No (sub)model of element `stream_dill_assl_lahn_leun` \
-defines a control parameter named `fc`.
+following error occurred: No (sub)model of element `stream_dill_lahn_2` defines a \
+control parameter named `fc`.
 
     "Empty" rule objects are always considered erroneous:
 
@@ -515,7 +513,7 @@ handle any `musk_classic` model instances.
     ...                parameter="soilmoisturelimit",
     ...                value=0.8,
     ...                model="evap_aet_hbv96")
-    >>> submodel = hp.elements.land_lahn_marb.model.aetmodel
+    >>> submodel = hp.elements.land_lahn_1.model.aetmodel
     >>> soilmoisturelimit = submodel.parameters.control.soilmoisturelimit
     >>> soilmoisturelimit
     soilmoisturelimit(0.9)
@@ -534,13 +532,13 @@ handle any `musk_classic` model instances.
     Traceback (most recent call last):
     ...
     RuntimeError: While trying to initialise the `Replace` rule object `fc`, the \
-following error occurred: Model `evap_aet_hbv96` of element `land_dill_assl` does not \
+following error occurred: Model `evap_aet_hbv96` of element `land_dill` does not \
 define a control parameter named `fc`.
 
     We consider name clashes like the following made-up example unlikely but still
     carry out additional runtime type checks as a precaution:
 
-    >>> control = hp.elements.land_lahn_marb.model.parameters.control
+    >>> control = hp.elements.land_lahn_1.model.parameters.control
     >>> control.soilmoisturelimit = control.fc
     >>> rule = Replace(name="?",
     ...                parameter="soilmoisturelimit",
@@ -709,7 +707,7 @@ following error occurred: Parameter types are inconsistent: \
         and upper boundaries:
 
         >>> from hydpy import Replace
-        >>> from hydpy.core.testtools import prepare_full_example_2
+        >>> from hydpy.examples import prepare_full_example_2
         >>> hp, pub, TestIO = prepare_full_example_2()
         >>> rule = Replace(name="fc",
         ...                parameter="fc",
@@ -774,14 +772,14 @@ value `200.0` instead.
     def reset_parameters(self) -> None:
         """Reset all relevant parameter objects to their original states.
 
-        >>> from hydpy.core.testtools import prepare_full_example_2
+        >>> from hydpy.examples import prepare_full_example_2
         >>> hp, pub, TestIO = prepare_full_example_2()
         >>> from hydpy import Replace
         >>> rule = Replace(name="fc",
         ...                parameter="fc",
         ...                value=100.0,
         ...                model="hland_96")
-        >>> fc = hp.elements.land_lahn_marb.model.parameters.control.fc
+        >>> fc = hp.elements.land_lahn_1.model.parameters.control.fc
         >>> fc
         fc(206.0)
         >>> fc(100.0)
@@ -904,14 +902,14 @@ class Add(Rule[parametertools.Parameter]):
     The following |Add| object adds its current value to the parameter's original
     values:
 
-    >>> from hydpy.core.testtools import prepare_full_example_2
+    >>> from hydpy.examples import prepare_full_example_2
     >>> hp, pub, TestIO = prepare_full_example_2()
     >>> from hydpy import Add
     >>> rule = Add(name="fc",
     ...            parameter="fc",
     ...            value=100.0,
     ...            model="hland_96")
-    >>> fc = hp.elements.land_lahn_marb.model.parameters.control.fc
+    >>> fc = hp.elements.land_lahn_1.model.parameters.control.fc
     >>> fc
     fc(206.0)
     >>> rule.apply_value()
@@ -940,7 +938,7 @@ class Add(Rule[parametertools.Parameter]):
     ...            value=2.0,
     ...            model="hland_96",
     ...            parameterstep="2d")
-    >>> cfmax = hp.elements.land_lahn_marb.model.parameters.control.cfmax
+    >>> cfmax = hp.elements.land_lahn_1.model.parameters.control.cfmax
     >>> cfmax
     cfmax(field=5.0, forest=3.0)
     >>> rule.apply_value()
@@ -970,7 +968,7 @@ class Add(Rule[parametertools.Parameter]):
     ...            model="musk_classic",
     ...            parameterstep="2d")
     >>> nmbsegments = \
-hp.elements.stream_lahn_marb_lahn_leun.model.parameters.control.nmbsegments
+hp.elements.stream_lahn_1_lahn_2.model.parameters.control.nmbsegments
     >>> nmbsegments
     nmbsegments(lag=0.583)
     >>> rule.apply_value()
@@ -996,14 +994,14 @@ class Multiply(Rule[parametertools.Parameter]):
     The following |Multiply| object multiplies the parameter's original values by its
     current calibration factor:
 
-    >>> from hydpy.core.testtools import prepare_full_example_2
+    >>> from hydpy.examples import prepare_full_example_2
     >>> hp, pub, TestIO = prepare_full_example_2()
     >>> from hydpy import Add
     >>> rule = Multiply(name="fc",
     ...                 parameter="fc",
     ...                 value=2.0,
     ...                 model="hland_96")
-    >>> fc = hp.elements.land_lahn_marb.model.parameters.control.fc
+    >>> fc = hp.elements.land_lahn_1.model.parameters.control.fc
     >>> fc
     fc(206.0)
     >>> rule.apply_value()
@@ -1032,7 +1030,7 @@ class Multiply(Rule[parametertools.Parameter]):
     ...                 value=2.0,
     ...                 model="hland_96",
     ...                 parameterstep="2d")
-    >>> cfmax = hp.elements.land_lahn_marb.model.parameters.control.cfmax
+    >>> cfmax = hp.elements.land_lahn_1.model.parameters.control.cfmax
     >>> cfmax
     cfmax(field=5.0, forest=3.0)
     >>> rule.apply_value()
@@ -1064,7 +1062,7 @@ class Multiply(Rule[parametertools.Parameter]):
     ...            model="musk_classic",
     ...            parameterstep="2d")
     >>> nmbsegments = \
-hp.elements.stream_lahn_marb_lahn_leun.model.parameters.control.nmbsegments
+hp.elements.stream_lahn_1_lahn_2.model.parameters.control.nmbsegments
     >>> nmbsegments
     nmbsegments(lag=0.583)
     >>> rule.apply_value()
@@ -1089,7 +1087,7 @@ class CalibrationInterface(Generic[TypeRule1]):
 
     We work with the `Lahn` example project again:
 
-    >>> from hydpy.core.testtools import prepare_full_example_2
+    >>> from hydpy.examples import prepare_full_example_2
     >>> hp, pub, TestIO = prepare_full_example_2()
 
     First, we create a |CalibrationInterface| object.  Initially, it needs to know the
@@ -1247,11 +1245,11 @@ attribute nor a rule object named `FC`.
     |CalibrationInterface.apply_values|.  To explain how it works, we first show the
     values of the relevant parameters of some randomly selected model instances:
 
-    >>> stream = hp.elements.stream_lahn_marb_lahn_leun.model
+    >>> stream = hp.elements.stream_lahn_1_lahn_2.model
     >>> stream.parameters.control
     nmbsegments(lag=0.583)
     coefficients(damp=0.0)
-    >>> land = hp.elements.land_lahn_marb.model
+    >>> land = hp.elements.land_lahn_1.model
     >>> land.parameters.control.fc
     fc(206.0)
     >>> land.parameters.control.percmax
@@ -1276,7 +1274,7 @@ attribute nor a rule object named `FC`.
     anymore:
 
     >>> round_(ci.result)
-    1.639374
+    1.603574
 
     Use method |CalibrationInterface.reset_parameters| to restore the initial states of
     all affected parameters:
@@ -1285,7 +1283,7 @@ attribute nor a rule object named `FC`.
     >>> stream.parameters.control
     nmbsegments(lag=0.583)
     coefficients(damp=0.0)
-    >>> land = hp.elements.land_lahn_marb.model
+    >>> land = hp.elements.land_lahn_1.model
     >>> land.parameters.control.fc
     fc(206.0)
     >>> land.parameters.control.percmax
@@ -1319,7 +1317,7 @@ attribute nor a rule object named `FC`.
     |CalibrationInterface.apply_values|:
 
     >>> round_(ci.perform_calibrationstep([100.0, 5.0, 0.3]))
-    1.639374
+    1.603574
 
     >>> stream.parameters.control
     nmbsegments(lag=0.583)
@@ -1351,7 +1349,7 @@ attribute nor a rule object named `FC`.
     <BLANKLINE>
     NSE	fc	percmax	damp
     parameterstep	None	1d	None
-    1.639374	100.0	5.0	0.3
+    1.603574	100.0	5.0	0.3
     <BLANKLINE>
 
     To prevent (automatic) calibration runs from crashing due to IO problems, method
@@ -1373,8 +1371,8 @@ following problem occured: [Errno 2] No such file or directory: 'dirname1/filena
     ...     ci.update_logfile()
     ...     with open("dirname1/filename.log") as file_:
     ...         print(file_.read())
-    1.639374	100.0	5.0	0.3
-    1.639374	100.0	5.0	0.3
+    1.603574	100.0	5.0	0.3
+    1.603574	100.0	5.0	0.3
     <BLANKLINE>
 
     Call method |CalibrationInterface.finalise_logfile| to ensure the
@@ -1411,7 +1409,7 @@ following problem occured: [Errno 2] No such file or directory: 'dirname2/filena
     ...     ci.finalise_logfile()
     ...     with open("dirname2/filename.log") as file_:
     ...         print(file_.read())
-    1.639374	100.0	5.0	0.3
+    1.603574	100.0	5.0	0.3
     <BLANKLINE>
 
     >>> ci._logfilepath = "example_calibration.log"
@@ -1451,10 +1449,10 @@ following problem occured: [Errno 2] No such file or directory: 'dirname2/filena
     <BLANKLINE>
     NSE	fc	percmax	damp
     parameterstep	None	1d	None
-    1.639374	100.0	5.0	0.3
-    -0.722094	50.0	1.0	0.0
-    2.347895	200.0	10.0	0.5
-    1.639374	100.0	5.0	0.3
+    1.603574	100.0	5.0	0.3
+    -0.709987	50.0	1.0	0.0
+    2.312553	200.0	10.0	0.5
+    1.603574	100.0	5.0	0.3
     <BLANKLINE>
 
     Class |CalibrationInterface| also provides method
@@ -1471,9 +1469,9 @@ following problem occured: [Errno 2] No such file or directory: 'dirname2/filena
     >>> ci.damp.value
     0.5
     >>> round_(ci.result)
-    2.347895
+    2.312553
     >>> round_(ci.apply_values())
-    2.347895
+    2.312553
 
     On the contrary, if we set argument `maximisation` to |False|, method
     |CalibrationInterface.read_logfile| returns the worst result in our example:
@@ -1487,9 +1485,9 @@ following problem occured: [Errno 2] No such file or directory: 'dirname2/filena
     >>> ci.damp.value
     0.0
     >>> round_(ci.result)
-    -0.722094
+    -0.709987
     >>> round_(ci.apply_values())
-    -0.722094
+    -0.709987
 
     To prevent errors due to different parameter step-sizes, method
     |CalibrationInterface.read_logfile| raises the following error whenever it detects
@@ -1570,7 +1568,7 @@ does not agree with the one documentated in log file `example_calibration.log` (
     def add_rules(self, *rules: TypeRule1) -> None:
         """Add some |Rule| objects to the actual |CalibrationInterface| object.
 
-        >>> from hydpy.core.testtools import prepare_full_example_2
+        >>> from hydpy.examples import prepare_full_example_2
         >>> hp, pub, TestIO = prepare_full_example_2()
         >>> from hydpy import CalibrationInterface
         >>> ci = CalibrationInterface(hp=hp, targetfunction=lambda: None)
@@ -1618,7 +1616,7 @@ does not agree with the one documentated in log file `example_calibration.log` (
         subclass to convince your IDE (and yourself) that the returned rule follows
         this more specific type:
 
-        >>> from hydpy.core.testtools import prepare_full_example_2
+        >>> from hydpy.examples import prepare_full_example_2
         >>> hp, pub, TestIO = prepare_full_example_2()
         >>> from hydpy import Add, CalibrationInterface, make_rules, nse, Replace
         >>> ci = CalibrationInterface(
@@ -1669,7 +1667,7 @@ named `fc` of type `Add`.
     def remove_rules(self, *rules: Union[str, TypeRule1]) -> None:
         """Remove some |Rule| objects from the actual |CalibrationInterface| object.
 
-        >>> from hydpy.core.testtools import prepare_full_example_2
+        >>> from hydpy.examples import prepare_full_example_2
         >>> hp, pub, TestIO = prepare_full_example_2()
         >>> from hydpy import CalibrationInterface
         >>> ci = CalibrationInterface(hp=hp, targetfunction=lambda: None)
@@ -2037,7 +2035,7 @@ object named `fc`.
         instances with those of application model |arma_rimorido|, which allows
         discussing some special cases concerning the handling of |RuleIUH|:
 
-        >>> from hydpy.core.testtools import prepare_full_example_2
+        >>> from hydpy.examples import prepare_full_example_2
         >>> hp, pub, TestIO = prepare_full_example_2()
         >>> from hydpy import prepare_model
         >>> for element in hp.elements.river:
@@ -2247,7 +2245,7 @@ parameterstep="1d"))
 
     def __dir__(self) -> list[str]:
         """
-        >>> from hydpy.core.testtools import prepare_full_example_2
+        >>> from hydpy.examples import prepare_full_example_2
         >>> hp, pub, TestIO = prepare_full_example_2()
         >>> from hydpy import CalibrationInterface, make_rules, Replace
         >>> ci = CalibrationInterface[Replace](hp=hp, targetfunction=lambda: None)
@@ -3067,7 +3065,7 @@ def make_rules(
     Please see the main documentation on class |CalibrationInterface| first, from
     which we borrow the general setup:
 
-    >>> from hydpy.core.testtools import prepare_full_example_2
+    >>> from hydpy.examples import prepare_full_example_2
     >>> hp, pub, TestIO = prepare_full_example_2()
     >>> from hydpy import CalibrationInterface, make_rules, nse
     >>> ci = CalibrationInterface(