NCAP2(1)

💖 NCAP2 — netCDF Arithmetic Processor, Next Generation 💖

okay bestie, welcome to ncap2(1) from the General Commands Manual 🫶 this is the little powerhouse that does math on your netCDF files and it's giving calculator-but-make-it-serve. let's go ✨

---

🌸 NAME 🌸

ncap2 — netCDF Arithmetic Processor, Next Generation 👑

---

✨ SYNTAX ✨

no cap, here's the whole invocation, verbatim, every bracket exactly where it lives:

ncap2 [-3] [-4] [-5] [-6] [-7] [-A] [--bfr sz_byt][-C][-c][-D dbg_lvl]
[-F] [--fl_fmt=fmt] [-f] [--gaa att_name= att_val]] [--gad att1[,...]]
[-H] [-h] [--hdf] [--hdr_pad sz_byt][--hpss_try] [-l path] [--no_tmp_fl]
[-O] [-o output-file] [-p path] [-R] [-r] [--ram_all] [-S script-
file][-s script][-t thr_nbr][--uio][-v var[,...]]  [ input-file ]
output-file

---

🦋 DESCRIPTION 🦋

so like, ncap2 supersedes ncap and is backwards-compatible with it — and listen, ncap is now deprecated 💀 (rip bestie, we don't use her anymore). Both of these operators arithmetically process netCDF files. The primary ncap2 documentation is currently the sample script <http://nco.sf.net/ncap2.in> — literally go read it, it's the real one. And just so you know, the remainder of this manpage is identical to the ncap manpage. periodt.

The processing instructions are contained either in the NCO script file fl.nco or in a sequence of command line arguments, whichever vibe you're on. The options -s (or the long options --spt or --script) are used for in-line scripts, and -S (or the long options --fl_spt or --script-file) are used to provide the filename where (usually multiple) scripting commands are pre-stored 📂.

ncap2 was written to perform arbitrary algebraic transformations of data and archive the results as easily as possible. Missing values are treated correctly, which is honestly so thoughtful of her 🥹. The results of the algebraic manipulations are called derived fields 🌈.

Unlike the other operators, ncap2 does not accept a list of variables to be operated on as an argument to -v 🚫. Rather, the -v switch takes no arguments and indicates that ncap2 should output only user-defined variables. Also, ncap2 does not accept or understand the -x switch — don't even try it, she will not know her 💅.

---

🔥 EXAMPLES 🔥

Compute the square of variable T:

ncap2 -s "T2=T*T" in.nc out.nc

ate. no crumbs. 🍓

---

🎀 AUTHOR 🎀

NCO manual pages written by Charlie Zender and originally formatted by Brian Mays. iconic behavior fr fr 👑

---

🙈 REPORTING BUGS 🙈

Report bugs to <http://sf.net/bugs/?group_id=3331>. tell them everything bestie, they wanna know 😭

---

💜 COPYRIGHT 💜

Copyright © 1995-present Charlie Zender

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

okay that's the scary-but-important part: no warranty, not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. read it, absorb it, move on 🫶

---

⭐ SEE ALSO ⭐

The full documentation for NCO is maintained as a Texinfo manual called the NCO Users Guide. Because NCO is mathematical in nature, the documentation includes TeX-intensive portions not viewable on character-based displays 😭 (yes, your terminal cannot handle her in full glam). Hence the only complete and authoritative versions of the NCO Users Guide are the PDF (recommended), DVI, and Postscript versions at:

• <http://nco.sf.net/nco.pdf>
• <http://nco.sf.net/nco.dvi>
• <http://nco.sf.net/nco.ps>

respectively 💖

HTML and XML versions are available at <http://nco.sf.net/nco.html> and <http://nco.sf.net/nco.xml>, respectively 🌐

If the info and NCO programs are properly installed at your site, the command

info nco

should give you access to the complete manual, except for the TeX-intensive portions. iykyk 📖

ncap2(1), ncatted(1), ncbo(1), ncclimo(1), nces(1), ncecat(1), ncflint(1), ncz2psx(1), ncks(1), nco(1), ncpdq(1), ncra(1), ncrcat(1), ncremap(1), ncrename(1), ncwa(1) — the whole squad, go follow them all 🧚

---

🌈 HOMEPAGE 🌈

The NCO homepage at <http://nco.sf.net> contains more information. go, run, don't walk 🦋

---

okay that's the whole page bestie!! this is NCAP2(1) straight outta the General Commands Manual — thanks for reading all the way to the bottom, you're the main character now 👑💖✨