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

NAME

6       ncap - netCDF Arithmetic Processor
7

SYNTAX

9       ncap [-3] [-4] [-6] [-A] [-C] [-c] [-D dbg] [-F] [-f] [-h] [-L dfl_lvl]
10       [-l path] [-O] [-o output-file] [-p path] [-R] [-r] [-S script-file][-s
11       script][-v var[, ... ]] input-file [ output-file ]
12

DESCRIPTION

14       ncap  arithmetically  processes  a netCDF file.  However, in about 2008
15       ncap was deprecated in favor of ncap2 which far surpasses its  capbili‐
16       ties.  ncap will eventually be completely removed from NCO.  It is cur‐
17       rently retained only because it provides an easier-to-build  arithmetic
18       operator than ncap2.
19
20       The processing instructions are contained either in the NCO script file
21       fl.nco or in a sequence of command line arguments.  The options -s  (or
22       long options --spt or --script) are used for in-line scripts and -S (or
23       long options --fl_spt or --script-file) are used to provide  the  file‐
24       name  where (usually multiple) scripting commands are pre-stored.  ncap
25       was written to perform arbitrary albebraic transformations of data  and
26       archive  the results as easily as possible.  Missing values are treated
27       correctly.  The results  of  the  algebraic  manipulations  are  called
28       derived fields.
29
30       Unlike the other operators, ncap does not accept a list of variables to
31       be operated on as an argument to -v.  Rather, the -v  switch  takes  no
32       arguments and indicates that ncap should output only user-defined vari‐
33       ables.  ncap does not accept or understand the -x switch.
34

EXAMPLES

36       Compute the square of variable T
37              ncap -s "T2=T*T" in.nc out.nc
38
39

AUTHOR

41       NCO manual pages written by Charlie Zender and Brian Mays.
42
43

REPORTING BUGS

45       Report bugs to <http://sf.net/bugs/?group_id=3331>.
46
47

49       Copyright © 1995-2010 Charlie Zender
50       This is free software; see the source for copying conditions.  There is
51       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
52       PURPOSE.
53
54

SEE ALSO

56       The full documentation for NCO is maintained as a Texinfo manual called
57       the NCO User's Guide.  Because NCO is mathematical in nature, the docu‐
58       mentation includes TeX-intensive portions not  viewable  on  character-
59       based  displays.  Hence the only complete and authoritative versions of
60       the NCO User's Guide are the PDF  (recommended),  DVI,  and  Postscript
61       versions  at  <http://nco.sf.net/nco.pdf>, <http://nco.sf.net/nco.dvi>,
62       and <http://nco.sf.net/nco.ps>, respectively.  HTML  and  XML  versions
63       are       available       at      <http://nco.sf.net/nco.html>      and
64       <http://nco.sf.net/nco.xml>, respectively.
65
66       If the info and NCO programs are properly installed at your  site,  the
67       command
68
69              info nco
70
71       should  give  you  access  to  the complete manual, except for the TeX-
72       intensive portions.
73
74

HOMEPAGE

76       The NCO homepage at <http://nco.sf.net> contains more information.
77
78
79
80                                                                       NCAP(1)
Impressum