README 3.12 KB
Newer Older
Uwe Schulzweida's avatar
Uwe Schulzweida committed
1 2 3 4

CDO - Climate Data Operators
----------------------------

5 6 7
     This package contains the source code for CDO. This program was developed at the 
     Max-Planck-Institute for Meteorology.
     CDO is a collection of Operators to manipulate and analyse Climate model Data.
Uwe Schulzweida's avatar
Uwe Schulzweida committed
8
     Supported data formats are GRIB, netCDF, SERVICE, EXTRA and IEG.
Uwe Schulzweida's avatar
Uwe Schulzweida committed
9 10 11 12

     CDO is licensed under the GNU General Public License, version 2.
     Read the file COPYING in the source distribution for details.

13 14 15 16 17 18 19 20 21 22 23 24
     MPI-M makes no representations or warranties of any kind concerning the Software and any results
     (including but not limited to any data) generated by use of the Software (hereinafter "Results"),
     express or implied, and the absence of any legal or actual defects, whether discoverable or not.
     The use of the Software and the Results is at your own risk.

     Specifically, and not to limit the foregoing, MPI-M makes no representations or warranties 
       (i) regarding the fitness for a particular purpose of the Software and the Results,
      (ii) that the use of the Software and the Results will not infringe any patents or other 
           intellectual property rights of any third party, and 
     (iii) that the use of the Software and the Results will not cause any damages of any kind 
           to you or to any third party.

Uwe Schulzweida's avatar
Uwe Schulzweida committed
25 26
Operators:

Uwe Schulzweida's avatar
Uwe Schulzweida committed
27
     There are more than 600 operators available. Read OPERATORS for a short overview of all operators.
Uwe Schulzweida's avatar
Uwe Schulzweida committed
28 29 30

Documentation:

Uwe Schulzweida's avatar
Uwe Schulzweida committed
31
     A detailed description of all operators can be found in: ./doc/cdo.pdf
Uwe Schulzweida's avatar
Uwe Schulzweida committed
32 33 34 35 36 37 38 39

     Online reference manuals:   cdo -h <operator>

Building and installing it:

     1. Run ./configure, with some options if you wish. The standard
        options are documented in the INSTALL file. The configuration
        script has some more options; type 'configure -h' to see them.
Uwe Schulzweida's avatar
Uwe Schulzweida committed
40

Uwe Schulzweida's avatar
Uwe Schulzweida committed
41
        The most interesting ones are the usual
Uwe Schulzweida's avatar
Uwe Schulzweida committed
42 43
          --prefix=<installation directory> and
          --with-netcdf=<directory> to enable netCDF support.
Uwe Schulzweida's avatar
Uwe Schulzweida committed
44

Uwe Schulzweida's avatar
Uwe Schulzweida committed
45 46 47
        The netCDF-4 configuration depends on the netCDF-4 and HDF5 installation!
	You have to define the location of the HDF5 installation if netCDF-4 was 
        build with HDF5 support:
Uwe Schulzweida's avatar
Uwe Schulzweida committed
48
 
Uwe Schulzweida's avatar
Uwe Schulzweida committed
49
          --with-netcdf=<netCDF-4 root directory> --with-hdf5=<HDF5 root directory> 
Uwe Schulzweida's avatar
Uwe Schulzweida committed
50

51 52 53 54
        You have to specify also the location of the SZLIB if HDF5 was build
        with SZLIB support. If only the linking is required, you can directly
        set the linking path with --with-szlib-lib=<dir>, --with-zlib-lib=<dir>
        and --with-hdf5-lib=<dir>
Uwe Schulzweida's avatar
Uwe Schulzweida committed
55 56 57

        To process szip compressed GRIB files you have to enable SZLIB support with:
          --with-szlib=<directory>
Uwe Schulzweida's avatar
Uwe Schulzweida committed
58 59 60 61 62 63 64 65 66 67

     2. Do "make" to compile the program.

     3. (Optional) Do "make install", possibly as root if the destination
        permissions require that. This installs CDO in the directory
        specified during configuration. The default prefix is /usr/local.

Porting:

     This package was designed for maximum portability. It is written entirely
Uwe Schulzweida's avatar
Uwe Schulzweida committed
68
     in ISO C++11 and ANSI C99, and will compile on most UNIX platforms.
Uwe Schulzweida's avatar
Uwe Schulzweida committed
69 70 71
     
Contact:

Uwe Schulzweida's avatar
Uwe Schulzweida committed
72
     Send questions, comments and bug reports to <https://mpimet.mpg.de/cdo>