NC3TONC4(1)

✨ NC3TONC4 — the manual page, bestie edition ✨

okay so you found yourself in section 1 of the general commands manual, staring at nc3tonc4, and you're like "what is this". don't worry, I got you 💖

🌸 NAME 🌸

nc3tonc4 — a program to convert netCDF 3 files to netCDF 4 format files 🦋

🌈 SYNOPSIS 🌈

nc3tonc4 [-h] [-o] [--vars=var1,var2,..]  [--zlib=(0|1)]
[--complevel=(1-9)] [--shuffle=(0|1)] [--fletcher32=(0|1)]
[--unpackshort=(0|1)] [--quantize=var1=n1,var2=n2,..]  netcdf3filename
netcdf4filename

💫 DESCRIPTION 💫

This manual page documents briefly the nc3tonc4 command.

nc3tonc4 is a program that converts a netCDF 3 file into netCDF 4 format. and babes, it does not stop there 😌 optionally it will unpack variables that are packed as short integers (with scale_factor and add_offset) into floats, and it will add zlib compression — with the HDF5 shuffle filter and fletcher32 checksum, the whole glow-up routine ✨

your data may also be quantized (that means truncated) to a precision you specify, which makes the compression improve. it's giving ✨ skinny legend data ✨.

💅 OPTIONS 💅

These programs follow the usual GNU command line syntax, with long options starting with two dashes (-). A summary of options is included below. slay, let's go one by one 🎀

• -h — Shows a summary of the available options. the "hello what do you do" flag 🫶
• -o — Overwrite destination file. the default is to raise an error if the output file already exists, so if you want it gone-gone, you say so.
• --vars — A comma separated list of variable names to copy. the default is to copy all variables. like, all of them. no one left behind 💜
• --classic=(0|1) — Use NETCDF4_CLASSIC format instead of NETCDF4. default = 1.
• --zlib=(0|1) — Activate (or disable) zlib compression. the default is to activate it, obviously, she's compressed and thriving.
• --complevel=(1-9) — Set the zlib compression level. 6 is default.
• --shuffle=(0|1) — Activate (or disable) the shuffle filter. it is active by default.
• --fletcher32=(0|1) — Activate (or disable) the fletcher32 checksum. it is not active by default, so flip it on if you want that.
• --unpackshort=(0|1) — Unpack short integer variables to float variables using scale_factor and add_offset netCDF variable attributes. it is active by default.
• --quantize=(comma separated list of variable name=integer pairs) — Truncate the data in the specified variables to a given decimal precision. for example, 'speed=2, height=-2, temp=0' will cause the variable 'speed' to be truncated to a precision of 0.01, 'height' to a precision of 100 and 'temp' to 1. this can significantly improve compression. the default is not to quantize any of the variables. no cap, this one's the compression cheat code 👑
• --quiet=(0|1) — If set to 1, don't print any diagnostic information. silent mode, mysterious era 🙈
• --chunk=(integer) — The number of records along unlimited dimension to write at once. the default is 10. it is ignored if there is no unlimited dimension. if chunk=0, it means write all the data at once.
• --istart=(integer) — The number of the record to start at along unlimited dimension. the default is 0. this option is ignored if there is no unlimited dimension.
• --istop=(integer) — The number of the record to stop at along unlimited dimension. the default is 1. this option is ignored if there is no unlimited dimension.

heads up bestie: --classic and --quiet are in the options list but they are not in the synopsis line above, so don't come for me, that's just how the page is 💀

🦋 SEE ALSO 🦋

ncinfo(1), nc4tonc3(1).

🎀 AUTHOR 🎀

This manual page was written by Ross Gammon <rossgammon@mail.dk> based on the options displayed by nc3tonc4 -h.

and that's the whole page, bestie 🫶 this one's dated 22 Mar 2015, straight out of the General Commands Manual, and it's NC3TONC4(1) all the way through. go convert something gorgeous 💖✨🌸