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][--cnk_byt
10       sz_byt][--cnk_csh   sz_byt][--cnk_dmn   nm,sz_lmn]   [--cnk_map    map]
11       [--cnk_min  sz_byt]  [--cnk_plc plc] [--cnk_scl sz_lmn][-D dbg_lvl] [-d
12       dim,[ min][,[ max]]] [-F] [--fl_fmt=fmt] [-G  gpe_dsc]  [-g  grp[,...]]
13       [--gag]  [--glb att_name= att_val]] [-h] [--hdr_pad sz_byt][--hpss_try]
14       [-L dfl_lvl] [-l path] [-M] [--mrd] [--msa]  [-n  loop]  [--no_cll_msr]
15       [--no_frm_trm]  [--no_tmp_fl] [-O] [-p path] [--ppc var1[, var2[,...]]=
16       prc]] [-R] [-r]  [--ram_all]  [-t  thr_nbr]  [-u  ulm_nm]  [--unn]  [-v
17       var[,...]]  [-X box] [-x] input-files output-file
18

DESCRIPTION

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

EXAMPLES

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

AUTHOR

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

REPORTING BUGS

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

SEE ALSO

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

HOMEPAGE

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