From 48dd70ef101e4bdf956b79ad9873d5fc0c55cec7 Mon Sep 17 00:00:00 2001
From: ned <daniele.nerini@meteoswiss.ch>
Date: Tue, 25 Jun 2019 11:33:26 +0200
Subject: [PATCH] Specify units of output motion field

---
 pysteps/motion/darts.py       | 3 ++-
 pysteps/motion/lucaskanade.py | 3 ++-
 pysteps/motion/vet.py         | 3 ++-
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/pysteps/motion/darts.py b/pysteps/motion/darts.py
index 027ecfabe..085cef25c 100644
--- a/pysteps/motion/darts.py
+++ b/pysteps/motion/darts.py
@@ -64,7 +64,8 @@ def DARTS(R, **kwargs):
     -------
     out : ndarray
         Three-dimensional array (2,m,n) containing the dense x- and y-components
-        of the motion field.
+        of the motion field in units of pixels / timestep as given by the input
+        array R.
 
     """
 
diff --git a/pysteps/motion/lucaskanade.py b/pysteps/motion/lucaskanade.py
index 320140e1c..a2fb73635 100644
--- a/pysteps/motion/lucaskanade.py
+++ b/pysteps/motion/lucaskanade.py
@@ -172,7 +172,8 @@ def dense_lucaskanade(R, **kwargs):
     -------
     out : ndarray_
         If dense=True (the default), it returns the three-dimensional array (2,m,n)
-        containing the dense x- and y-components of the motion field.
+        containing the dense x- and y-components of the motion field in units of
+        pixels / timestep as given by the input array R.
         If dense=False, it returns a tuple containing the one-dimensional arrays
         x, y, u, v, where x, y define the vector locations, u, v define the x
         and y direction components of the vectors.
diff --git a/pysteps/motion/vet.py b/pysteps/motion/vet.py
index d5b1514a1..256367528 100644
--- a/pysteps/motion/vet.py
+++ b/pysteps/motion/vet.py
@@ -431,7 +431,8 @@ def vet(input_images,
         Displacement Field (2D array representing the transformation) that
         warps the template image into the input image.
         The dimensions are (2,ni,nj), where the first
-        dimension indicates the displacement along x (0) or y (1).
+        dimension indicates the displacement along x (0) or y (1) in units of
+        pixels / timestep as given by the input_images array.
 
     intermediate_steps : list of ndarray_
         List with the first guesses obtained during the scaling procedure.