1NCECAT(1)                   General Commands Manual                  NCECAT(1)
2
3
4

NAME

6       ncecat - netCDF Ensemble Concatenator
7

SYNTAX

9       ncecat  [-3]  [-4]  [-5]  [-6]  [-7] [-A] [--bfr sz_byt][-C][-c] [--cmp
10       cmp_sng]  [--cnk_byt  sz_byt][--cnk_csh  sz_byt][--cnk_dmn   nm,sz_lmn]
11       [--cnk_map   map]   [--cnk_min   sz_byt]   [--cnk_plc  plc]  [--cnk_scl
12       sz_lmn][-D dbg_lvl] [-d dim,[ min][,[ max]]]  [-F]  [--fl_fmt=fmt]  [-G
13       gpe_dsc]  [-g  grp[,...]]  [--gag] [--glb att_name= att_val]] [-H] [-h]
14       [--hdr_pad sz_byt][--hpss_try] [-L  dfl_lvl]  [-l  path]  [-M]  [--mrd]
15       [--msa]  [-n loop] [--no_cll_msr] [--no_frm_trm] [--no_tmp_fl] [-O] [-p
16       path] [--ppc  var1[,  var2[,...]]=  prc]]  [-R]  [-r]  [--ram_all]  [-t
17       thr_nbr]  [-u ulm_nm] [--uio] [--unn] [-v var[,...]]  [-X box] [-x] in‐
18       put-files output-file
19

DESCRIPTION

21       ncecat concatenates an arbitrary number of input files  into  a  single
22       output  file.   Input files are glued together by creating a record di‐
23       mension in the output file.  Input files must be the same  size.   Each
24       input  file  is  stored  consecutively as a single record in the output
25       file.  Each variable (except coordinate variables) in each  input  file
26       becomes one record in the same variable in the output file.  Coordinate
27       variables are not concatenated, they are instead simply copied from the
28       first input file to the output-file.  Thus, the size of the output file
29       is the sum of the sizes of the input files.
30
31       Consider five realizations, 85a.nc, 85b.nc,...  85e.nc of 1985  predic‐
32       tions  from the same climate model.  Then ncecat 85?.nc 85_ens.nc glues
33       the individual realizations together into the single  file,  85_ens.nc.
34       If  an  input variable was dimensioned [ lat, lon], it will have dimen‐
35       sions [ record, lat, lon] in the output file.  A restriction of  ncecat
36       is that the hyperslabs of the processed variables must be the same from
37       file to file.  Normally this means all the input  files  are  the  same
38       size, and contain data on different realizations of the same variables.
39

EXAMPLES

41       Consider  a  model  experiment which generated five realizations of one
42       year of data, say 1985.  You can imagine that the experimenter slightly
43       perturbs  the  initial conditions of the problem before generating each
44       new solution.  Assume each file contains all twelve months (a  seasonal
45       cycle)  of data and we want to produce a single file containing all the
46       seasonal cycles.  Here the numeric filename suffix denotes the  experi‐
47       ment number (not the month):
48              ncecat 85_01.nc 85_02.nc 85_03.nc 85_04.nc 85_05.nc 85.nc
49              ncecat 85_0[1-5].nc 85.nc
50              ncecat -n 5,2,1 85_01.nc 85.nc
51       These  three  commands  produce  identical  answers.   The output file,
52       85.nc, is five times the size as a single input-file.  It  contains  60
53       months of data (which might or might not be stored in the record dimen‐
54       sion, depending on the input files).
55
56

AUTHOR

58       NCO manual pages written by Charlie Zender and originally formatted  by
59       Brian Mays.
60
61

REPORTING BUGS

63       Report bugs to <http://sf.net/bugs/?group_id=3331>.
64
65
67       Copyright © 1995-present Charlie Zender
68       This is free software; see the source for copying conditions.  There is
69       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
70       PURPOSE.
71
72

SEE ALSO

74       The full documentation for NCO is maintained as a Texinfo manual called
75       the NCO Users Guide.  Because NCO is mathematical in nature, the  docu‐
76       mentation  includes  TeX-intensive  portions not viewable on character-
77       based displays.  Hence the only complete and authoritative versions  of
78       the NCO Users Guide are the PDF (recommended), DVI, and Postscript ver‐
79       sions at <http://nco.sf.net/nco.pdf>, <http://nco.sf.net/nco.dvi>,  and
80       <http://nco.sf.net/nco.ps>,  respectively.   HTML  and XML versions are
81       available         at          <http://nco.sf.net/nco.html>          and
82       <http://nco.sf.net/nco.xml>, respectively.
83
84       If  the  info and NCO programs are properly installed at your site, the
85       command
86
87              info nco
88
89       should give you access to the complete manual, except for  the  TeX-in‐
90       tensive portions.
91
92       ncap2(1),   ncatted(1),   ncbo(1),   ncclimo(1),   nces(1),  ncecat(1),
93       ncflint(1), ncz2psx(1), ncks(1), nco(1), ncpdq(1), ncra(1),  ncrcat(1),
94       ncremap(1), ncrename(1), ncwa(1)
95
96

HOMEPAGE

98       The NCO homepage at <http://nco.sf.net> contains more information.
99
100
101
102                                                                     NCECAT(1)
Impressum