From 94da99eacf95bd049411a1945925b4572fb59533 Mon Sep 17 00:00:00 2001
From: Martin Reinecke <martin@mpa-garching.mpg.de>
Date: Mon, 12 Feb 2018 12:25:44 +0100
Subject: [PATCH] more documentation

---
 nifty4/operators/fft_smoothing_operator.py | 24 ++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/nifty4/operators/fft_smoothing_operator.py b/nifty4/operators/fft_smoothing_operator.py
index d3c3ee8a9..239b6e1da 100644
--- a/nifty4/operators/fft_smoothing_operator.py
+++ b/nifty4/operators/fft_smoothing_operator.py
@@ -24,6 +24,30 @@ from ..domain_tuple import DomainTuple
 
 
 def FFTSmoothingOperator(domain, sigma, space=None):
+    """ This function returns an operator that carries out a smoothing with
+    a Gaussian kernel of width `sigma` on the part of `domain` given by
+    `space`.
+
+    Parameters
+    ----------
+    domain : Domain, tuple of Domains, or DomainTuple
+       The total domain of the operator's input and output fields
+
+    sigma : float>=0
+       The sigma of the Gaussian used for smoothing. It has the same units as
+       the RGSpace the operator is working on.
+       If `sigma==0`, an identity operator will be returned.
+
+    space: integer, *optional*
+       The index of the sub-domain on which the smoothing is performed.
+       Can be omitted if `domain` only has one sub-domain.
+
+    Notes
+    -----
+       The sub-domain on which the smoothing is carried out *must* be a
+       non-harmonic `RGSpace`.
+    """
+
     sigma = float(sigma)
     if sigma < 0.:
         raise ValueError("sigma must be nonnegative")
-- 
GitLab