Add tutorial on impact function calibration

Author: peanutfun

doc/climada/climada.util.calibrate.rst

@@ -0,0 +1,32 @@
+==================================
+Impact Function Calibration Module
+==================================
+
+Base Classes
+------------
+
+Generic classes for defining the data structures of this module.
+
+.. automodule:: climada.util.calibrate.base
+   :members:
+   :private-members:
+
+Bayesian Optimizer
+------------------
+
+Calibration based on Bayesian optimization.
+
+.. automodule:: climada.util.calibrate.bayesian_optimizer
+   :members:
+   :show-inheritance:
+   :inherited-members:  abc.ABC
+
+Scipy Optimizer
+---------------
+
+Calibration based on the ``scipy.optimize`` module.
+
+.. automodule:: climada.util.calibrate.scipy_optimizer
+   :members:
+   :show-inheritance:
+   :inherited-members:  abc.ABC

doc/climada/climada.util.rst

@@ -12,9 +12,10 @@ climada\.util\.api\_client module
 climada\.util\.calibrate module
 -------------------------------
 
-.. automodule:: climada.util.calibrate.impact_func
-    :members:
-    :show-inheritance:
+.. toctree::
+   :maxdepth: 1
+
+   climada.util.calibrate
 
 climada\.util\.checker module
 -----------------------------

doc/index.rst

@@ -83,6 +83,7 @@ Jump right in:
    Impact <tutorial/impact>
    Uncertainty Quantification <tutorial/unsequa>
    tutorial/climada_engine_Forecast
+   tutorial/climada_util_calibrate
    Google Earth Engine <tutorial/climada_util_earth_engine>
    tutorial/climada_util_api_client