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

ncpdq [-A] [-a dim[,...]] [-C] [-c] [-D dbg] [-d dim,[ min][,[ max]]] [-F] [-h] [-l path] [-M pck_map] [-O] [-o output-file] [-P pck_plc] [-p path] [-R] [-r] [-t thr_nbr] [-v var[,...]] [-x] input-file [ output-file ]

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.

NCO manual pages written by Charlie Zender and Brian Mays.

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

Copyright © 1995-2004 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.

The full documentation for NCO is maintained as a Texinfo manual called the NCO User's 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 User's Guide are the PDF (recommended), DVI, and Postscript versions at <http://nco.sf.net/nco.pdf>, <http://nco.sf.net/nco.dvi>, and <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.

The NCO homepage at <http://nco.sf.net> contains more information.