NCPDQ(1)

🎀 NCPDQ(1) — NAME 🎀

ok so like, hi bestie, welcome to NCPDQ(1) — the General Commands Manual page for section 1 💅 and the program is:

ncpdq — netCDF Permute Dimensions Quickly, Pack Data Quietly...

yep that's the whole name, ellipsis and all, she's dramatic, we love her 🫶

---

✨ SYNTAX ✨

ncpdq [-3] [-4] [-5] [-6] [-7] [-A] [-a dim[,...]]  [--bfr sz_byt][-C][-c] [--cmp cmp_sng] [--cnk_byt sz_byt][--cnk_csh sz_byt][--cnk_dmn nm,sz_lmn] [--cnk_map map] [--cnk_min sz_byt] [--cnk_plc plc] [--cnk_scl sz_lmn][-D dbg_lvl] [-d dim,[ min][,[ max]]] [-F] [--fl_fmt=fmt] [-G gpe_dsc] [-g grp[,...]]  [--gaa att_name= att_val]] [--gad att1[,...]]  [-H] [-h] [--hdf] [--hdr_pad sz_byt][--hpss_try] [-L dfl_lvl] [-l path] [-M pck_map] [--mrd] [--msa] [--no_cll_msr] [--no_frm_trm] [--no_tmp_fl] [-O] [-o output-file] [-P pck_plc] [-p path] [--qnt var1[, var2[,...]]= prc]] [--qnt_alg alg_nm] [-R] [-r] [--ram_all] [-t thr_nbr] [-U] [--uio] [--unn] [-v var[,...]] [-X box] [-x] input-file [ output-file ]

---

🦋 DESCRIPTION 🦋

so the tea ☕: ncpdq packs or re-shapes variables in input-file and stores them in output-file. That's the whole job, no cap.

Which variables get packed/unpacked is determined by the packing policy encoded in the pck_plc argument to the -P switch. The valid pck_plc options are:

• all_new
• all_xst
• xst_new
• upk

And the numeric type a variable gets packed — or re-packed — to is determined by the packing map encoded in the pck_map argument to the -M switch. The valid pck_map options are:

• flt_byt
• flt_sht
• hgh_byt
• hgh_sht
• nxt_lsr

---

🌈 the re-shaping part (this is the iconic bit) 🌈

ncpdq re-shapes variables in input-file by re-ordering and/or reversing dimensions specified in the dimension list. The dimension list is a comma separated list of dimension names, optionally prefixed by negative signs, that follow the -a switch.

• To re-order variables by a subset of their dimensions, specify these dimensions in a comma-separated list following -a, e.g., -a lon,lat.
• To reverse a dimension, prefix its name with a negative sign in the dimension list, e.g., -a -lat.
• Re-ordering and reversal may be performed simultaneously, e.g., -a lon,-lat,time,-lev.

---

👑 permutation rules, periodt 👑

Users may specify any permutation of dimensions, including permutations which change the record dimension identity. The record dimension is re-ordered like any other dimension. The record dimension is always the most slowly varying dimension in a record variable.

⚠️ The specified re-ordering will fail if it requires creating more than one record dimension amongst all the output variables. so like, don't do that 💀

---

💜 AUTHOR 💜

NCO manual pages written by Charlie Zender</purl> and originally formatted by Brian Mays. legends 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. like literally none, zero, nada 😭

---

🌸 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. 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> ← recommended, bestie 💖
• <http://nco.sf.net/nco.dvi>
• <http://nco.sf.net/nco.ps>

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 ✨

also go read these, the whole squad:

• 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)

---

🌈 HOMEPAGE 🌈

The NCO homepage at <http://nco.sf.net> contains more information. go touch grass... i mean, go touch docs 🌱

---

and that's the page bestie!! 💖 this was NCPDQ(1) from the General Commands Manual, no version number and no date in sight because that's just how she is 💅 slay, ate, periodt 🎀✨🦋