CDO

Changed from old pycdf to more recent scipy.io.netcdf for returning numpy arrays (suggested by Alastair McKinstry).

See cdo.{rb,py}

Both versions now work with the win32 version of CDO and interfaces have converged a bit more.

See cdo.{rb,py} for installation instructions.

Updated libraries:

• netcdf-4.2
• hdf5-1.8.8
• grib_api-1.9.16
• proj4-4.8.0

The default unix installation now includes grib_api.

• setgridtype: added parameter lonlat to convert curvilinear to regular lon/lat grids
• remapcon: added env REMAP_AREA_MIN, to set the minimum area fraction

• timcovar: covariance over time
• fldcovar: covariance in grid space

• splitsel: added support for constant fields [Bug #1701]
• combination of selection commands (e.g. selmon -selyear) do not terminate, if no result found [Bug #1640]

The scripting language bindings for Ruby have been enlarged to Python! Please have a look at cdo.{rb,py} for installation instructions and some examples.

For reading all unit tests, please register yourself and have a look at source:trunk/cdo/contrib/python/test/test_cdo.py for Python and source:trunk/cdo/contrib/ruby/test/test_cdo.rb for Ruby.

This is the first release of cdo.rb, a Ruby module to call CDO.

Installation¶

cdo.rb is released as a ruby gem, Ruby's own package format. Install cdo.rb with

gem install cdo

Documentation¶

Please have a look at the automatic documentation from rubygem: http://rubydoc.info/gems/cdo/frames

Examples¶

CDO's operators are implemented as module methods:

Cdo.info(:in => "input.nc")

Input and output stream arguments are handled special with hash keys :in and :out. Same is true for the other options of CDO like "-f" or "-P":

Cdo.topo(:out => "topography.grb")
Cdo.copy(:in => "topography.grb",:out => "topography.nc4",:options => "-f nc4")

Operator options can be set as standard method arguments:

Cdo.stdatm(0,10,20,50,100,200,500,1000,:out => "standard_atm.nc",:options => "-f nc")

More example can be found in the unit tests: source:trunk/cdo/contrib/ruby/test/test_cdo.rb.

• Variable input parameter for ECA operators: eca_cdd, eca_cwd, eca_rr1, eca_sdii

• deflate compression with netCDF4 doesn't work (option: -z zip)
• sellonlatbox: correct lon bounds if necessary
• ifthen, ifthenelse: uses only the first time step of the first input file
• module Monarith (monadd, monsub, monmul, mondiv): wrong result for 3D variables

• replace: added support to replace single levels

• remapeta: Changed minimum pressure level for condensation from 1000Pa to 0Pa.
  Use the environment variable REMAPETA_PTOP to set the minimum pressure level for condensation.
  Above this level the humidity is set to the constant 1.E-6.

• invertlat: bug fix for CURVILINEAR grids
• ymon<stat>: preserve time axis attributes (type and calendar)
• import_binary: added support for OPTION ZREV
• expr/exprf: wrong result for expression 'constant-field' and 'constant/field' (e.g. 1-field)
  This bug was introduced in CDO version 1.5.1.
• eof, eoftime, eofspatial, eof3d - Empirical Orthogonal Functions:
  There was a bug in the calculation of the Frobenius norm, which has only been triggered in some cases
  when using a low precision. The normalization has been changed thus that the eigenvectors are not weighted
  and their absolute is 1. The default settings for convergence have been changed to be more conservative:
  CDO_SVD_MODE=jacobi
  MAX_JACOBI_ITER=12
  FNORM_PRECISION=1.e-12

• Added support for netCDF4 classic format; option -f nc4c
• import_binary: Added support for 1 and 2 byte integer

• intlevel3d: vertical interpolation to/from 3d vertical coordinates
• ensrkhistspace: Ranked Histogram averaged over time
• ensrkhisttime: Ranked Histogram averaged over space
• ensroc: Ensemble Receiver Operating characteristics
• enscrps: Ensemble CRPS and decomposition
• ensbrs: Ensemble Brier score

• Exprf: wrong result for missing values != (double) -9.e33
• detrend: added support for time bounds
• Filter: added support for time bounds
• eofspatial: integer overflow; wrong result for grid size > 46340
• eca_*: use the input calendar for the output streams

• netcdf-4.1.2
• hdf5-1.8.7
• grib_api-1.9.9

• Compile grib_api + jasper with PIC support when using make libs4cdo.

Download it here