revice documentation of random_search module

mu_map/recon/filter.py

+"""
+Implementation of post-filters for STIR reconstruction.
+"""
 from mu_map.file.interfile import Interfile, InterfileKeys
 
 """
@@ -19,17 +22,20 @@ end separable gaussian filter parameters :=
 
 class GaussianFilter:
     """
-    Class handling a Gaussian post-filter in a reconstruction.
+    A Gaussian post-filter for reconstruction.
     """
 
     def __init__(self, projection: Interfile, width_scale: int = 1.0):
         """
         Initialize a Gaussian post-filter for the reconstruction of a projection.
 
-        :param projection: the projection for which the filter is created
-        :param width_scale: the width of the filter in each dimension is this scale
-               times the spacing defined in the projection
-        :returns: an object which can add this filter to reconstruction parameters
+        Parameters
+        ----------
+        projection: Interfile
+            the projection for which the filter is created
+        width_scale: int, optional
+            the width of the filter in each dimension which is this scale
+            times the spacing defined in the projection
         """
         header, _ = projection
 
@@ -50,8 +56,14 @@ class GaussianFilter:
         """
         Inter this filter into a string of OSEM parameters for STIR.
 
-        :param osem_params: the params in which this filter is inserted
-        :return: the params with inserted filter
+        Parameters
+        ----------
+        osem_params: str
+            the params in which this filter is inserted
+
+        Returns
+        str
+            the params with inserted filter
         """
         lines = self.params.strip().split("\n")
         lines = list(map(lambda line: "  " + line, lines))