Porting the converting decorators from v2

tobac/utils.py

@@ -977,6 +977,18 @@ def xarray_to_iris(func):
     -------
     wrapper : function
         Function including decorator.
+
+    Examples
+    --------
+    >>> segmentation_xarray = xarray_to_iris(segmentation)
+
+    This line creates a new function that can process xarray fields and 
+    also outputs fields in xarray format, but otherwise works just like 
+    the original function:
+
+    >>> mask_xarray, features = segmentation_xarray(
+        data_xarray, dxy, threshold
+        )
     """
 
     import iris
@@ -1130,8 +1142,21 @@ def xarray_to_irispandas(func):
     -------
     wrapper : function
         Function including decorator.
-    """
 
+    Examples
+    --------
+    >>> linking_trackpy_xarray = xarray_to_irispandas(
+        linking_trackpy
+        )
+
+    This line creates a new function that can process xarray inputs and 
+    also outputs in xarray formats, but otherwise works just like the 
+    original function:
+
+    >>> track_xarray = linking_trackpy_xarray(
+        features_xarray, field_xarray, dt, dx
+        )
+    """
     import iris
     import xarray
     import pandas as pd