Shiftxy: docu added.

ChangeLog

 2017-02-14  Uwe Schulzweida
 
-	* using CDI library version 1.8.0
+	* Using CDI library version 1.8.0
 	* Version 1.8.0 release
 
 2017-01-28  Uwe Schulzweida

Makefile.in

@@ -379,7 +379,7 @@ top_srcdir = @top_srcdir@
 # Process this file with automake to produce Makefile.in
 SUBDIRS = libcdi src contrib test/data test
 #
-EXTRA_DIST = config/default OPERATORS doc/cdo.pdf doc/cdo_eca.pdf doc/cdo_magics.pdf doc/cdo_cmor.pdf doc/cdo_refcard.pdf cdo.spec README
+EXTRA_DIST = config/default OPERATORS doc/cdo.pdf doc/cdo_eca.pdf doc/cdo_magics.pdf doc/cdo_refcard.pdf cdo.spec README
 #
 ACLOCAL_AMFLAGS = -I m4
 #

NEWS

@@ -7,11 +7,15 @@ Version 1.8.0 (26 October 2016):
      * NetCDF: Improved support for horizontal and vertical grids 
      * Changed default of option -f nc to netCDF2
      * masklonlatbox: added support for unstructured grids
+     * setpartabn: added support for user defined attributes
    New operators:
      * timcumsum: Cumulative sum over time.
      * cmorlite: Apply variable_entry of cmor tables
+     * shiftx/shifty: Shift fields on rectangular grid in x/y direction
    Changed operators:
+     * Tim<STAT> (e.g. monmean): 
    Fixed bugs:
+     * Cond: bug fix for ntsteps1 == 1 && ntsteps2 != 1
      * ml2pl: interpolation failed for data on hybrid half levels [Bug #7225]
 
 Version 1.7.2 (28 June 2016):

OPERATORS

@@ -157,6 +157,8 @@ Operator catalog:
    Setgatt       setgatts        Set global attributes
    Invert        invertlat       Invert latitudes
    Invertlev     invertlev       Invert levels
+   Shiftxy       shiftx          Shift x
+   Shiftxy       shifty          Shift y
    Maskregion    maskregion      Mask regions
    Maskbox       masklonlatbox   Mask a longitude/latitude box
    Maskbox       maskindexbox    Mask an index box

doc/tex/Modules

@@ -33,6 +33,7 @@ Setzaxis      Modification
 Setgatt       Modification
 Invert        Modification
 Invertlev     Modification
+Shiftxy       Modification
 Maskregion    Modification
 Maskbox       Modification
 Setbox        Modification

doc/tex/mod/Shiftxy

+@BeginModule
+@NewPage
+@Name      = Shiftxy
+@Title     = Shift field
+@Section   = Modification
+@Class     = Modification
+@Arguments = infile outfile
+@Operators = shiftx shifty
+
+@BeginDescription
+This module contains operators to shift all fields in x or y direction.
+All fields need to have the same horizontal rectilinear grid.
+@EndDescription
+@EndModule
+
+
+@BeginOperator_shiftx
+@Title     = Shift x
+@Parameter = <nshift> <cyclic> <coord>
+
+@BeginDescription
+Shifts all fields in x direction.
+@EndDescription
+@EndOperator
+
+
+@BeginOperator_shifty
+@Title     = Shift y
+@Parameter = <nshift> <cyclic> <coord>
+
+@BeginDescription
+Shifts all fields in y direction.
+@EndDescription
+@EndOperator
+
+
+@BeginParameter nshift
+@Item = nshift
+INTEGER  Number of grid cells to shift (default: 1)
+@Item = cyclic
+STRING   If set, cells are filled up cyclic (default: missing value)
+@Item = coord
+STRING   If set, coordinates are also shifted
+@EndParameter
+
+
+@BeginExample
+To shift all input fields in the x direction by +1 cells and fill the new cells with missing value, use:
+@BeginVerbatim
+   cdo shiftx infile outfile
+@EndVerbatim
+To shift all input fields in the x direction by +1 cells and fill the new cells cyclic, use:
+@BeginVerbatim
+   cdo shiftx,1,cyclic infile outfile
+@EndVerbatim
+@EndExample

src/modules.c

@@ -706,7 +706,7 @@ static modules_t Modules[] =
   { Setrcaname,     NULL,              SetrcanameOperators,    1,   CDI_REAL,  1,  1 },
   { Settime,        SettimeHelp,       SettimeOperators,       1,   CDI_BOTH,  1,  1 },
   { Setzaxis,       SetzaxisHelp,      SetzaxisOperators,      1,   CDI_BOTH,  1,  1 },
-  { Shiftxy,        NULL,              ShiftxyOperators,       1,   CDI_REAL,  1,  1 },
+  { Shiftxy,        ShiftxyHelp,       ShiftxyOperators,       1,   CDI_REAL,  1,  1 },
   { Showinfo,       ShowinfoHelp,      ShowinfoOperators,      1,   CDI_BOTH,  1,  0 },
   { Sinfo,          SinfoHelp,         SinfoOperators,         1,   CDI_BOTH, -1,  0 },
   { Smooth,         SmoothHelp,        SmoothOperators,        1,   CDI_REAL,  1,  1 },

src/operator_help.h

@@ -1165,6 +1165,30 @@ static const char *InvertlevHelp[] = {
     NULL
 };
 
+static const char *ShiftxyHelp[] = {
+    "NAME",
+    "    shiftx, shifty - Shift field",
+    "",
+    "SYNOPSIS",
+    "    <operator>,<nshift>,<cyclic>,<coord>  infile outfile",
+    "",
+    "DESCRIPTION",
+    "    This module contains operators to shift all fields in x or y direction.",
+    "    All fields need to have the same horizontal rectilinear grid.",
+    "",
+    "OPERATORS",
+    "    shiftx  Shift x",
+    "            Shifts all fields in x direction.",
+    "    shifty  Shift y",
+    "            Shifts all fields in y direction.",
+    "",
+    "PARAMETER",
+    "    nshift  INTEGER  Number of grid cells to shift (default: 1)",
+    "    cyclic  STRING   If set, cells are filled up cyclic (default: missing value)",
+    "    coord   STRING   If set, coordinates are also shifted",
+    NULL
+};
+
 static const char *MaskregionHelp[] = {
     "NAME",
     "    maskregion - Mask regions",