adapted docstrings of plot_rp_.. funcs

Author: ValentinGebhart

climada/engine/impact.py

@@ -1140,11 +1140,9 @@ def plot_rp_imp(
         **kwargs,
     ):
         """
-        This function is deprecated, use Impact.local_exceedance_impact and
-        util.plot.plot_from_gdf instead.
-
         Compute and plot exceedance impact maps for different return periods.
-        Calls local_exceedance_imp.
+        Calls local_exceedance_impact. For handling large data sets and for further options,
+        see Notes.
 
         Parameters
         ----------
@@ -1163,6 +1161,13 @@ def plot_rp_imp(
         axis : matplotlib.axes.Axes
         imp_stats : np.array
             return_periods.size x num_centroids
+
+        Notes
+        -----
+        For handling large data, and for more flexible options in the exceedance
+        impact computation and in the plotting, we recommend to use
+        gdf, title, labels = impact.local_exceedance_impact() and
+        util.plot.plot_from_gdf(gdf, title, labels) instead.
         """
 
         LOGGER.info(

climada/hazard/plot.py

@@ -44,11 +44,9 @@ def plot_rp_intensity(
         **kwargs,
     ):
         """
-        This function is deprecated,
-        use Impact.local_exceedance_impact and util.plot.plot_from_gdf instead.
-
         Compute and plot hazard exceedance intensity maps for different
-        return periods. Calls local_exceedance_inten.
+        return periods. Calls local_exceedance_intensity. For handling large data sets and for
+        further options, see Notes.
 
         Parameters
         ----------
@@ -63,6 +61,13 @@ def plot_rp_intensity(
         -------
         axis, inten_stats:  matplotlib.axes._subplots.AxesSubplot, np.ndarray
             intenstats is return_periods.size x num_centroids
+
+        Notes
+        -----
+        For handling large data, and for more fleixble options in the exceedance
+        intensity computation and in the plotting, we recommend to use
+        gdf, title, labels = hazard.local_exceedance_intensity() and
+        util.plot.plot_from_gdf(gdf, title, labels) instead.
         """
         LOGGER.info(
             "Some errors in the previous calculation of local exceedance intensities have been corrected,"