WindTrans: added docu.

OPERATORS

@@ -533,6 +533,9 @@ Operator catalog:
    Vargen        topo            Create a field with topography
    Vargen        for             Create a time series
    Vargen        stdatm          Create values for pressure and temperature for hydrostatic atmosphere
+   WindTrans     uvDestag        Destaggering of u/v wind components
+   WindTrans     rotuvNorth      Rotate u/v wind to North pole.
+   WindTrans     projuvLatLon    Cylindrical Equidistant projection
    Rotuv         rotuvb          Backward rotation
    Mastrfu       mastrfu         Mass stream function
    Derivepar     sealevelpressure Sea level pressure

doc/tex/Modules

@@ -129,6 +129,7 @@ Smooth        Miscellaneous
 Replacevalues Miscellaneous
 Timsort       Miscellaneous
 Vargen        Miscellaneous
+WindTrans     Miscellaneous
 Rotuv         Miscellaneous
 Mastrfu       Miscellaneous
 Derivepar     Miscellaneous

doc/tex/mod/WindTrans

+@BeginModule
+@NewPage
+@Name      = WindTrans
+@Title     = Wind Transformation
+@Section   = Miscellaneous
+@Arguments = infile outfile
+@Operators = uvDestag rotuvNorth projuvLatLon
+
+@BeginDescription
+This module contains special operators for datsets with wind components on a rotated lon/lat grid, 
+e.g. data from the regional model HIRLAM or REMO. 
+@EndDescription
+@EndModule
+
+
+@BeginOperator_uvDestag
+@Title     = Destaggering of u/v wind components
+@Parameter = u v [-/+0.5] [-/+0.5]
+
+@BeginDescription
+This is a special operator for destaggering of wind components.
+If the file contains a grid with temperature (name='t' or code=11)
+then grid_temp will be used for destaggered wind.
+@EndDescription
+@EndOperator
+
+
+@BeginOperator_rotuvNorth
+@Title     = Rotate u/v wind to North pole.
+@Parameter = u v
+
+@BeginDescription
+This is an operator for transformation of wind-vectors from grid-relative to north-pole
+relative for the whole file. (FAST implementation with JACOBIANS)
+@EndDescription
+@EndOperator
+
+
+@BeginOperator_projuvLatLon
+@Title     = Cylindrical Equidistant projection
+@Parameter = u v
+
+@BeginDescription
+Thus is an operator for transformation of wind-vectors from the globe-spherical coordinate system
+into a flat Cylindrical Equidistant (lat-lon) projection. (FAST JACOBIAN implementation)
+@EndDescription
+@EndOperator
+
+
+@BeginParameter
+@Item = u,v
+STRING  Pair of u,v wind components (use variable names or code numbers)
+@Item = -/+0.5,-/+0.5
+STRING  Destaggered grid offsets are optional (default -0.5,-0.5)
+@EndParameter
+
+
+@BeginExample
+Typical operator sequence on HIRLAM NWP model output (LAMH_D11 files):
+@BeginVerbatim
+cdo uvDestag,33,34   inputfile inputfile_destag
+cdo rotuvNorth,33,34 inputfile_destag inputfile_rotuvN
+@EndVerbatim
+@EndExample

src/modules.c

@@ -845,7 +845,7 @@ static modules_t Modules[] =
   // HIRLAM_EXTENSIONS
   { Samplegrid,     SamplegridHelp,    SamplegridOperators,    1,   CDI_REAL,  1,  1 },
   { Selmulti,       NULL,              SelmultiOperators,      1,   CDI_REAL,  1,  1 },
-  { WindTrans,      NULL,              WindTransOperators,     1,   CDI_REAL,  1,  1 },
+  { WindTrans,      WindTransHelp,     WindTransOperators,     1,   CDI_REAL,  1,  1 },
 };							       
 							       
 static int NumModules = sizeof(Modules) / sizeof(Modules[0]);

src/operator_help.h

@@ -509,7 +509,7 @@ static const char *SelectHelp[] = {
     "    year              INTEGER Comma separated list of years.",
     "    timestep          INTEGER Comma separated list of timesteps. Negative values selects timesteps from the end (NetCDF only).",
     "    timestep_of_year  INTEGER Comma separated list of timesteps of year.",
-    "    timestepmask      STRING Read timesteps from a mask file.",
+    "    timestepmask      STRING  Read timesteps from a mask file.",
     NULL
 };
 
@@ -4766,6 +4766,37 @@ static const char *VargenHelp[] = {
     NULL
 };
 
+static const char *WindTransHelp[] = {
+    "NAME",
+    "    uvDestag, rotuvNorth, projuvLatLon - Wind Transformation",
+    "",
+    "SYNOPSIS",
+    "    uvDestag,u,v[,-/+0.5[,-/+0.5]]  infile outfile",
+    "    rotuvNorth,u,v  infile outfile",
+    "    projuvLatLon,u,v  infile outfile",
+    "",
+    "DESCRIPTION",
+    "    This module contains special operators for datsets with wind components on a rotated lon/lat grid, ",
+    "    e.g. data from the regional model HIRLAM or REMO. ",
+    "",
+    "OPERATORS",
+    "    uvDestag      Destaggering of u/v wind components",
+    "                  This is a special operator for destaggering of wind components.",
+    "                  If the file contains a grid with temperature (name='t' or code=11)",
+    "                  then grid_temp will be used for destaggered wind.",
+    "    rotuvNorth    Rotate u/v wind to North pole.",
+    "                  This is an operator for transformation of wind-vectors from grid-relative to north-pole",
+    "                  relative for the whole file. (FAST implementation with JACOBIANS)",
+    "    projuvLatLon  Cylindrical Equidistant projection",
+    "                  Thus is an operator for transformation of wind-vectors from the globe-spherical coordinate system",
+    "                  into a flat Cylindrical Equidistant (lat-lon) projection. (FAST JACOBIAN implementation)",
+    "",
+    "PARAMETER",
+    "    u,v            STRING  Pair of u,v wind components (use variable names or code numbers)",
+    "    -/+0.5,-/+0.5  STRING  Destaggered grid offsets are optional (default -0.5,-0.5)",
+    NULL
+};
+
 static const char *RotuvbHelp[] = {
     "NAME",
     "    rotuvb - Rotation",