--- name: "ncpdq" section: "1" platform: "linux" package: "nco" version: "5.3.3-1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/ncpdq" --- # ncpdq(1) netCDF Permute Dimensions Quickly, Pack Data Quietly... ## NAME ncpdq - netCDF Permute Dimensions Quickly, Pack Data Quietly... ## 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*\[,...\]\] \[--glb *att\_name=* *att\_val*\]\] \[-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 **ncpdq** packs or re-shapes variables in *input-file* and stores them in *output-file.* Which variables to pack/unpack are determined by the packing policy encoded in the *pck\_plc* argument to the **-P** switch. Valid *pck\_plc* options are *all\_new,* *all\_xst,* *xst\_new,* and *upk.* The numeric type of variable to pack or re-pack a variable to is determined by the packing map encoded in the *pck\_map* argument to the **-M** switch. Valid *pck\_map* options are *flt\_byt,* *flt\_sht,* *hgh\_byt,* *hgh\_sht,* and *nxt\_lsr.* **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**. 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. ## AUTHOR **NCO** manual pages written by Charlie Zender and originally formatted by Brian Mays. ## REPORTING BUGS Report bugs to \. ## 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. ## 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 \, \, and \, respectively. HTML and XML versions are available at \ and \, 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. [**ncap2**(1)](/ncap2/1.md), [**ncatted**(1)](/ncatted/1.md), [**ncbo**(1)](/ncbo/1.md), [**ncclimo**(1)](/ncclimo/1.md), [**nces**(1)](/nces/1.md), [**ncecat**(1)](/ncecat/1.md), [**ncflint**(1)](/ncflint/1.md), [**ncz2psx**(1)](/ncz2psx/1.md), [**ncks**(1)](/ncks/1.md), [**nco**(1)](/nco/1.md), [**ncpdq**(1)](/ncpdq/1.md), [**ncra**(1)](/ncra/1.md), [**ncrcat**(1)](/ncrcat/1.md), [**ncremap**(1)](/ncremap/1.md), [**ncrename**(1)](/ncrename/1.md), [**ncwa**(1)](/ncwa/1.md) ## HOMEPAGE The **NCO** homepage at \ contains more information.