Skip to content
GitLab
Projects
Groups
Snippets
/
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
mpim-sw
cdo
Commits
2e984578
Commit
2e984578
authored
Nov 18, 2015
by
Uwe Schulzweida
Browse files
Docu update
parent
a7aa6b02
Changes
36
Hide whitespace changes
Inline
Side-by-side
doc/cdo_refcard.pdf
View file @
2e984578
No preview for this file type
doc/tex/appendix.tex
View file @
2e984578
...
...
@@ -84,9 +84,9 @@ The following table describes the environment variables that affect {\CDO}.
CDO
\_
FILE
\_
SUFFIX
&
None
&
Default file suffix. This suffix will be added to the output file
\\
&
&
name instead of the filename extension derived from the file
\\
&
&
format. NULL will disable the adding of a file suffix.
\\
\hline
CDO
\_
HISTORY
\_
INFO
&
1
&
Append
n
etCDF global attribute histroy
\\
\hline
CDO
\_
HISTORY
\_
INFO
&
1
&
Append
N
etCDF global attribute histroy
\\
\hline
CDO
\_
PCTL
\_
NBINS
&
101
&
Number of histogram bins.
\\
\hline
CDO
\_
RESET
\_
HISTORY
&
0
&
Set to 1 to reset the
n
etCDF
{
\it
history
}
global attribute.
\\
\hline
CDO
\_
RESET
\_
HISTORY
&
0
&
Set to 1 to reset the
N
etCDF
{
\it
history
}
global attribute.
\\
\hline
CDO
\_
REMAP
\_
NORM
&
fracarea
&
Choose the normalization for the conservative interpolation
\\
CDO
\_
GRIDSEARCH
\_
RADIUS
&
180
&
Grid search radius in degree. Used by the operators
\\
&
&
setmisstonn,
...
...
@@ -94,7 +94,7 @@ CDO\_GRIDSEARCH\_RADIUS & 180 & Grid search radius in degree. Used
CDO
\_
TIMESTAT
\_
DATE
&
None
&
Set the date information of a time statistic operator to
\\
&
&
the "first", "middle" or "last" contributing timestep.
\\
\hline
CDO
\_
USE
\_
FFTW
&
1
&
Set to 0 to switch off usage of FFTW. Used in the Filter module.
\\
\hline
CDO
\_
VERSION
\_
INFO
&
1
&
Set to 0 to disable
n
etCDF global attribute CDO
\\
\hline
CDO
\_
VERSION
\_
INFO
&
1
&
Set to 0 to disable
N
etCDF global attribute CDO
\\
\hline
\end{tabular}
...
...
doc/tex/bib.tex
View file @
2e984578
...
...
@@ -67,7 +67,7 @@
{
Max Planck Institute for Meteorologie
}
\bibitem
[
n
etCDF]
{
n
etCDF
}
\ \\
\bibitem
[
N
etCDF]
{
N
etCDF
}
\ \\
\href
{
https://www.unidata.ucar.edu/software/netcdf
}{
NetCDF Software Package
}
,
from the
\href
{
https://www.unidata.ucar.edu
}{
UNIDATA
}
...
...
doc/tex/cdo.tex
View file @
2e984578
...
...
@@ -183,7 +183,7 @@
\end{picture}
\begin{flushright}
\large\bf
{
Climate Data Operators
\\
Version 1.7.
0
\\
October
201
5
}
\large\bf
{
Climate Data Operators
\\
Version 1.7.
1
\\
February
201
6
}
\end{flushright}
\vfill
...
...
doc/tex/cdo_int.tex
View file @
2e984578
...
...
@@ -8,21 +8,21 @@ and subsampling tools, and spatial interpolation.
%There are a lot of operators for doing standard processing like simple statistic,
%arithmetic, selection and interpolation on datasets from climate and forecast models.
%The operators are primarily designed to aid manipulation and analysis of gridded scientific data
{
\CDO
}
was developed to have the same set of processing functions for GRIB
\cite
{
GRIB
}
and
n
etCDF
\cite
{
n
etCDF
}
{
\CDO
}
was developed to have the same set of processing functions for GRIB
\cite
{
GRIB
}
and
N
etCDF
\cite
{
N
etCDF
}
datasets in one package.
The Climate Data Interface
\cite
{
CDI
}
is used for the fast and file format
independent access to GRIB and
n
etCDF datasets.
independent access to GRIB and
N
etCDF datasets.
The local
\href
{
http://www.mpimet.mpg.de/
}{
MPI-MET
}
data formats SERVICE, EXTRA and
IEG are also supported.
There are some limitations for GRIB and
n
etCDF datasets.
A GRIB dataset has to be consistent, similar to
n
etCDF.
There are some limitations for GRIB and
N
etCDF datasets.
A GRIB dataset has to be consistent, similar to
N
etCDF.
That means all time steps need to have the same variables, and
within a time step each variable may occur only once.
NetCDF datasets are only supported for the classic data model and arrays up to 4 dimensions.
These dimensions should only be used by the horizontal and vertical grid and the time.
The
n
etCDF attributes should follow the
The
N
etCDF attributes should follow the
\href
{
http://ftp.unidata.ucar.edu/software/netcdf/docs/conventions.html
}
{
GDT, COARDS or CF Conventions
}
.
...
...
doc/tex/cdoprog.tex
View file @
2e984578
...
...
@@ -14,7 +14,7 @@
\put
(0,0.0)
{
\line
(1,0)
{
3.95
}}
\end{picture}
\begin{flushright}
{
\small
{
Climate Data Operators
\\
Version 1.7.
0
\\
October
201
5
}}
{
\small
{
Climate Data Operators
\\
Version 1.7.
1
\\
February
201
6
}}
\end{flushright}
\vspace*
{
0mm
}
...
...
@@ -59,6 +59,6 @@
\makebox
[0.85in][l]
{{
\bf
{
-v
}}
}
&
\makebox
[2.76in][l]
{
Print extra details for some operators
}
\\
%\hline
\makebox
[0.85in][l]
{{
\bf
{
-z
}}
szip
}
&
\makebox
[2.76in][l]
{
SZIP compression of GRIB1 records
}
\\
\hline
% \makebox[0.85in][l]{{\bf{\ \ }} jpeg } & \makebox[2.76in][l]{JPEG compression of GRIB2 records} \\ %\hline
% \makebox[0.85in][l]{{\bf{\ \ }} zip } & \makebox[2.76in][l]{Deflate compression of
n
etCDF4 variables} \\ %\hline
% \makebox[0.85in][l]{{\bf{\ \ }} zip } & \makebox[2.76in][l]{Deflate compression of
N
etCDF4 variables} \\ %\hline
\end{tabular*}
doc/tex/grid.tex
View file @
2e984578
...
...
@@ -21,7 +21,7 @@ If the cell area is not available then it will be computed from the geographical
This is only possible if the geographical coordinates of the grid cell corners are available or derivable.
Otherwise
{
\CDO
}
gives a warning message and uses constant area weights for all grid cells.
The cell area is read automatically from a
n
etCDF input file if a variable has the
The cell area is read automatically from a
N
etCDF input file if a variable has the
corresponding ``cell
\_
measures'' attribute, e.g.:
\begin{lstlisting}
[frame=single, backgroundcolor=
\color
{
pcolor1
}
, basicstyle=
\small
]
...
...
@@ -92,13 +92,13 @@ If there are more then one grid in the datafile the grid description of the firs
SCRIP (Spherical Coordinate Remapping and Interpolation Package) uses
a common grid description for curvilinear and unstructured grids.
For more information about the convention see
\cite
{
SCRIP
}
.
This grid description is stored in
n
etCDF. Therefor it is only
available if
{
\CDO
}
was compiled with
n
etCDF support!
This grid description is stored in
N
etCDF. Therefor it is only
available if
{
\CDO
}
was compiled with
N
etCDF support!
\vspace
{
2mm
}
%\begin{minipage}[t]{\textwidth}
SCRIP grid description example of a curvilinear MPIOM
\cite
{
MPIOM
}
GROB3 grid (only the
n
etCDF header):
SCRIP grid description example of a curvilinear MPIOM
\cite
{
MPIOM
}
GROB3 grid (only the
N
etCDF header):
\begin{lstlisting}
[frame=single, backgroundcolor=
\color
{
pcolor1
}
, basicstyle=
\footnotesize
]
netcdf grob3s
{
dimensions:
...
...
doc/tex/install.tex
View file @
2e984578
...
...
@@ -16,10 +16,10 @@ To take full advantage of {\CDO} features the following additional
libraries should be installed:
\begin{itemize}
\item
Unidata
\href
{
http://www.unidata.ucar.edu/packages/netcdf
}{
n
etCDF
}
library
\item
Unidata
\href
{
http://www.unidata.ucar.edu/packages/netcdf
}{
N
etCDF
}
library
(
{
\tt
http://www.unidata.ucar.edu/packages/netcdf
}
)
version 3 or higher.
\\
This is needed to process
n
etCDF
\cite
{
n
etCDF
}
files with
{
\CDO
}
.
This is needed to process
N
etCDF
\cite
{
N
etCDF
}
files with
{
\CDO
}
.
\item
The ECMWF
\href
{
http://www.ecmwf.int/products/data/software/grib
_
api.html
}{
GRIB
\_
API
}
(
{
\tt
http://www.ecmwf.int/products/data/software/grib
\_
api.html
}
)
version 1.12 or higher.
...
...
@@ -71,10 +71,10 @@ Compilation is done by performing the following steps:
\end
{
verbatim
}
\begin
{
itemize
}
\item
Optionaly with
n
etCDF
\cite
{
n
etCDF
}
support:
\item
Optionaly with
N
etCDF
\cite
{
N
etCDF
}
support:
\begin
{
verbatim
}
.
/
configure
--
with
-
netcdf
=
<
n
etCDF root directory>
.
/
configure
--
with
-
netcdf
=
<
N
etCDF root directory>
\end
{
verbatim
}
\item
and with GRIB
\_
API:
...
...
doc/tex/missval.tex
View file @
2e984578
...
...
@@ -3,7 +3,7 @@
Most operators can handle missing values.
The default missing value for GRIB, SERVICE, EXTRA and IEG files is
$
-
9
.e
^{
33
}$
.
The
{
\CDO
}
option '-m
$
<
$
missval
$
>
$
' overwrites the default missing value.
In
n
etCDF files the variable attribute '
\_
FillValue' is used as a missing value.
In
N
etCDF files the variable attribute '
\_
FillValue' is used as a missing value.
The operator '
\htmlref
{
setmissval
}{
setmissval
}
' can be used to set a new missing value.
The
{
\CDO
}
use of the missing value is shown in the following tables,
...
...
doc/tex/mod/Copy
View file @
2e984578
...
...
@@ -34,7 +34,7 @@ of @file{ofile}. If @file{ofile} does not exist it will be created.
@BeginExample
To change the format of a dataset to
n
etCDF use:
To change the format of a dataset to
N
etCDF use:
@BeginVerbatim
cdo -f nc copy ifile ofile.nc
@EndVerbatim
...
...
doc/tex/mod/Gradsdes
View file @
2e984578
...
...
@@ -13,7 +13,7 @@
@Parameter = [mapversion]
@BeginDescription
Creates a @ref{GrADS} data descriptor file. Supported file formats are GRIB1,
n
etCDF, SERVICE,
Creates a @ref{GrADS} data descriptor file. Supported file formats are GRIB1,
N
etCDF, SERVICE,
EXTRA and IEG. For GRIB1 files the GrADS map file is also generated. For SERVICE and EXTRA
files the grid have to be specified with the CDO option '-g <grid>'. This module takes @file{ifile}
in order to create filenames for the descriptor (@file{ifile.ctl}) and the map (@file{ifile.gmp}) file.
...
...
doc/tex/mod/Importamsr
View file @
2e984578
...
...
@@ -28,7 +28,7 @@ More information to the data is available on the AMSR homepage http://www.remss.
@BeginExample
To convert monthly binary AMSR files to
n
etCDF use:
To convert monthly binary AMSR files to
N
etCDF use:
@BeginVerbatim
cdo -f nc amsre_yyyymmv5 amsre_yyyymmv5.nc
@EndVerbatim
...
...
doc/tex/mod/Importbinary
View file @
2e984578
...
...
@@ -41,7 +41,7 @@ Only 32-bit IEEE floats are supported for standard binary files!
@BeginExample
To convert a binary data file to
n
etCDF use:
To convert a binary data file to
N
etCDF use:
@BeginVerbatim
cdo -f nc import_binary ifile.ctl ofile.nc
@EndVerbatim
...
...
doc/tex/mod/Importcmsaf
View file @
2e984578
...
...
@@ -94,7 +94,7 @@ functionality.
@BeginExample
@C To convert a CM-SAF HDF5 file to
n
etCDF use:
@C To convert a CM-SAF HDF5 file to
N
etCDF use:
@C @BeginVerbatim
@C cdo -f nc import_cmsaf ifile.h5 ofile.nc
@C @EndVerbatim
...
...
@@ -102,7 +102,7 @@ A typical sequence of commands with this operator could look like this:
@BeginVerbatim
cdo -f nc remapbil,r360x180 -import_cmsaf cmsaf_product.hdf output.nc
@EndVerbatim
(bilinear remapping to a predefined global grid with 1 deg resolution and conversion to
n
et
cdf
). \\
(bilinear remapping to a predefined global grid with 1 deg resolution and conversion to
N
et
CDF
). \\
If you work with CM-SAF data on original satellite project, an additional file
with information on geolocation is required, to perform such spatial operations:
...
...
doc/tex/mod/Intyear
View file @
2e984578
...
...
@@ -44,7 +44,7 @@ To interpolate the years between 1985 and 1990 month by month use:
@BeginVerbatim
cdo intyear,1986,1987,1988,1989 ifile1 ifile2 year
@EndVerbatim
Example result of '{\tt dir year*}' for
n
etCDF datasets:
Example result of '{\tt dir year*}' for
N
etCDF datasets:
@BeginListing
year1986.nc year1987.nc year1988.nc year1989.nc
@EndListing
...
...
doc/tex/mod/Remap
View file @
2e984578
...
...
@@ -20,8 +20,8 @@ In this case the interpolation process can be split into two parts.
Firstly the generation of the interpolation weights, which is the most time-consuming part.
These interpolation weights can be reused for every remapping process with the operator @mod{remap}.
This operator remaps all input fields to a new horizontal grid. The remap type and
the interpolation weights of one input grid are read from a
n
etCDF file. More weights
are computed if the input fields are on different grids. The
n
etCDF file with the
the interpolation weights of one input grid are read from a
N
etCDF file. More weights
are computed if the input fields are on different grids. The
N
etCDF file with the
weights should follow the @ref{SCRIP} convention. Normally these weights come from a previous
call to one of the genXXX operators (e.g. @mod{genbil}) or were created by the original SCRIP package.
@EndDescription
...
...
@@ -32,7 +32,7 @@ call to one of the genXXX operators (e.g. @mod{genbil}) or were created by the o
@Item = grid
STRING Target grid description file or name
@Item = weights
STRING Interpolation weights (SCRIP
n
etCDF file)
STRING Interpolation weights (SCRIP
N
etCDF file)
@EndParameter
...
...
doc/tex/mod/Remapbic
View file @
2e984578
...
...
@@ -47,7 +47,7 @@ Performs a bicubic interpolation on all input fields.
@BeginDescription
Generates bicubic interpolation weights for the first input field and writes the
result to a file. The format of this file is
n
etCDF following the SCRIP convention.
result to a file. The format of this file is
N
etCDF following the SCRIP convention.
Use the operator @mod{remap} to apply this remapping weights to a data file with the same source grid.
@EndDescription
@EndOperator
...
...
doc/tex/mod/Remapbil
View file @
2e984578
...
...
@@ -47,7 +47,7 @@ Performs a bilinear interpolation on all input fields.
@BeginDescription
Generates bilinear interpolation weights for the first input field and writes the
result to a file. The format of this file is
n
etCDF following the SCRIP convention.
result to a file. The format of this file is
N
etCDF following the SCRIP convention.
Use the operator @mod{remap} to apply this remapping weights to a data file with the same source grid.
@EndDescription
@EndOperator
...
...
doc/tex/mod/Remapcon
View file @
2e984578
...
...
@@ -48,7 +48,7 @@ Performs a first order conservative remapping on all input fields.
@BeginDescription
Generates first order conservative remapping weights for the first input field and
writes the result to a file. The format of this file is
n
etCDF following the SCRIP convention.
writes the result to a file. The format of this file is
N
etCDF following the SCRIP convention.
Use the operator @mod{remap} to apply this remapping weights to a data file with the same source grid.
@EndDescription
@EndOperator
...
...
doc/tex/mod/Remapcon2
View file @
2e984578
...
...
@@ -48,7 +48,7 @@ Performs a second order conservative remapping on all input fields.
@BeginDescription
Generates second order conservative remapping weights for the first input field and
writes the result to a file. The format of this file is
n
etCDF following the SCRIP convention.
writes the result to a file. The format of this file is
N
etCDF following the SCRIP convention.
Use the operator @mod{remap} to apply this remapping weights to a data file with the same source grid.
@EndDescription
@EndOperator
...
...
Prev
1
2
Next
Write
Preview
Supports
Markdown
0%
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment