some typos and rephrasing

Author: ValentinGebhart

doc/user-guide/climada_measure_config.ipynb

@@ -21,7 +21,7 @@
     "\n",
     "The caveat of defining measure effects as python functions is that it cannot be serialized (written to a file), and also makes reading from a file a challenge.\n",
     "\n",
-    "In order to retain close that gap, the `measure` module now ships `MeasureConfig` objects, which handle the reading, writing and \"declarative\" defining of `Measure` objects.\n",
+    "In order to close that gap, the `measure` module now ships `MeasureConfig` objects, which handle the reading, writing and \"declarative\" defining of `Measure` objects.\n",
     "\n",
     "`Measure` objects can be instantiated from `MeasureConfig` objects using `Measure.from_config(<MeasureConfig object>)`.\n",
     "\n",
@@ -30,7 +30,7 @@
     "| `Measure` | `MeasureConfig` |\n",
     "|-----------|--------------------|\n",
     "| Is used for the actual computation | Is transformed into a `Measure` for actual computation |\n",
-    "| Uses python function to define what change to apply to the `Exposures`, `ImpactFuncSet`, `Hazard` objects | Define the changes (functions) to apply via the former way (scaling/shifting effect, alternate file loading, etc.) |\n",
+    "| Uses python functions to define what change to apply to the `Exposures`, `ImpactFuncSet`, `Hazard` objects | Defines the changes to apply using the (former) declarative way (scaling/shifting effect, alternate file loading, etc.) |\n",
     "| Accepts any possible effect as long as it can be defined as a python function | Is restricted to a set of defined effects |\n",
     "| Cannot be written to a file (unless it was created by a `MeasureConfig`) | Can easily be read from/written to a file (`.xlsx` or `.yaml`) |"
    ]
@@ -163,7 +163,7 @@
     "\n",
     "The `ImpfsetModifierConfig` is used to define how an adaptation measure changes the vulnerability (refer to the [impact functions tutorial](impact-functions-tutorial)).\n",
     "\n",
-    "When \"translated\" to a `Measure` object the `ImpfsetModifierConfig` populates the `impfset_change` attribute with a function that takes an `ImpactFuncSet` and returns a modified one, according to the specifications.\n",
+    "When \"translated\" to a `Measure` object, the `ImpfsetModifierConfig` populates the `impfset_change` attribute with a function that takes an `ImpactFuncSet` and returns a modified one, according to the specifications.\n",
     "\n",
     "```{note}\n",
     "Modifications are always applied to a specific hazard type (`haz_type` parameter).\n",
@@ -218,12 +218,12 @@
     "\n",
     "# 1. Scaling existing Impact Functions\n",
     "# Let's say we want to simulate a 20% reduction in MDD\n",
-    "# and a slight shift in the intensity threshold for Hazard 'TC'.\n",
+    "# and a horziontal translation of the impact function for Hazard 'TC'.\n",
     "impf_mod_scaling = ImpfsetModifierConfig(\n",
     "    haz_type=\"TC\",\n",
     "    impf_ids=[1, 2],  # Apply only to specific function IDs\n",
     "    impf_mdd_mult=0.8,  # Reduce Mean Damage Degree by 20%\n",
-    "    impf_int_add=5.0,  # Shift intensity axis by 5 units (e.g., higher resistance)\n",
+    "    impf_int_add=5.0,  # Shift intensity array by 5 units, i.e. move impact function by 5 units to the right (e.g., higher resistance)\n",
     ")\n",
     "\n",
     "print(\"--- Scaling Config ---\")\n",
@@ -248,7 +248,7 @@
     "\n",
     "The `HazardModifierConfig` is used to define how an adaptation measure changes the hazard (refer to the [hazard tutorial](hazard-tutorial)).\n",
     "\n",
-    "When \"translated\" to a `Measure` object the `HazardModifierConfig` populates the `hazard_change` attribute with a function that takes a `Hazard` (possibly additional arguments, see below) and returns a modified one, according to the specifications.\n",
+    "When \"translated\" to a `Measure` object, the `HazardModifierConfig` populates the `hazard_change` attribute with a function that takes a `Hazard` (possibly additional arguments, see below) and returns a modified one, according to the specifications.\n",
     "\n",
     "```{note}\n",
     "Modifications are always applied to a specific hazard type (`haz_type` parameter).\n",
@@ -359,7 +359,7 @@
     "\n",
     "The `ExposuresModifierConfig` is used to define how an adaptation measure changes the exposure (refer to the [exposure tutorial](exposure-tutorial)).\n",
     "\n",
-    "When \"translated\" to a `Measure` object the `ExposuresModifierConfig` populates the `exposures_change` attribute with a function that takes an `Exposures` and returns a modified one, according to the specifications.\n",
+    "When \"translated\" to a `Measure` object, the `ExposuresModifierConfig` populates the `exposures_change` attribute with a function that takes an `Exposures` and returns a modified one, according to the specifications.\n",
     "\n",
     "`ExposuresModifierConfig` allows you to modify the impact function assigned to different hazard, to set a list of points to 0 value, or to load a different Exposures:\n",
     "\n",
@@ -402,7 +402,9 @@
     "\n",
     "# 1. Changing existing Exposures\n",
     "exp_mod = ExposuresModifierConfig(\n",
-    "    reassign_impf_id={\"TC\": {1: 2}},  # Remaps exposures points with impf_TC == 1 to 2.\n",
+    "    reassign_impf_id={\n",
+    "        \"TC\": {1: 2}\n",
+    "    },  # Reassigns exposures points with impact function id impf_TC == 1 to 2.\n",
     "    set_to_zero=[\n",
     "        0,\n",
     "        25,\n",