NOTE: CMAKE-BASED BUILDS see #2390 to get the correct library version. For now, you will need to either remove a stray } at line 39 in CMakeLists.txt, or you will need to use the configure script instead of cmake. Our sincere apologies!

Release Notes

This file contains a high-level description of this package's evolution. Releases are in reverse chronological order (most recent first). Note that, as of netcdf 4.2, the netcdf-c++ and netcdf-fortran libraries have been separated into their own libraries.

4.9.0 - June 10, 2022

• [Enhancement] Improve filter installation process to avoid use of an extra shell script. See Github #2348.
• [Bug Fix] Get "make distcheck" to work See Github #/2343.
• [Enhancement] Allow the read/write of JSON-valued Zarr attributes to allow
  for domain specific info such as used by GDAL/Zarr. See Github #2278.
• [Enhancement] Turn on the XArray convention for NCZarr files by default. WARNING, this means that the mode should explicitly specify nczarr" or "zarr" even if "xarray" or "noxarray" is specified. See Github #2257.
• [Enhancement] Update the documentation to match the current filter capabilities See Github #2249.
• [Enhancement] Support installation of pre-built standard filters into user-specified location. See Github #2318.
• [Enhancement] Improve filter support. More specifically (1) add nc_inq_filter_avail to check if a filter is available, (2) add the notion of standard filters, (3) cleanup szip support to fix interaction with NCZarr. See Github #2245.
• [Enhancement] Switch to tinyxml2 as the default xml parser implementation. See Github #2170.
• [Bug Fix] Require that the type of the variable in nc_def_var_filter is not variable length. See Github #/2231.
• [File Change] Apply HDF5 v1.8 format compatibility when writing to previous files, as well as when creating new files. The superblock version remains at 2 for newly created files. Full backward read/write compatibility for netCDF-4 is maintained in all cases. See Github #2176.
• [Enhancement] Add ability to set dataset alignment for netcdf-4/HDF5 files. See Github #2206.
• [Bug Fix] Improve UTF8 support on windows so that it can use utf8 natively. See Github #2222.
• [Enhancement] Add complete bitgroom support to NCZarr. See Github #2197.
• [Bug Fix] Clean up the handling of deeply nested VLEN types. Marks nc_free_vlen() and nc_free_string as deprecated in favor of ncaux_reclaim_data(). See Github #2179.
• [Bug Fix] Make sure that netcdf.h accurately defines the flags in the open/create mode flags. See Github #2183.
• [Enhancement] Improve support for msys2+mingw platform. See Github #2171.
• [Bug Fix] Clean up the various inter-test dependencies in ncdump for CMake. See Github #2168.
• [Bug Fix] Fix use of non-aws appliances. See Github #2152.
• [Enhancement] Added options to suppress the new behavior from Github #2135. The options for cmake and configure are, respectively -DENABLE_LIBXML2 and --(enable/disable)-libxml2. Both of these options defaul to 'on/enabled'. When disabled, the bundled ezxml XML interpreter is used regardless of whether libxml2 is present on the system.
• [Enhancement] Support optional use of libxml2, otherwise default to ezxml. See Github #2135 -- H/T to Egbert Eich.
• [Bug Fix] Fix several os related errors. See Github #2138.
• [Enhancement] Support byte-range reading of netcdf-3 files stored in private buckets in S3. See Github #2134
• [Enhancement] Support Amazon S3 access for NCZarr. Also support use of the existing Amazon SDK credentials system. See Github #2114
• [Bug Fix] Fix string allocation error in H5FDhttp.c. See Github #2127.
• [Bug Fix] Apply patches for ezxml and for selected oss-fuzz detected errors. See Github #2125.
• [Bug Fix] Ensure that internal Fortran APIs are always defined. See Github #2098.
• [Enhancement] Support filters for NCZarr. See Github #2101
• [Bug Fix] Make PR 2075 long file name be idempotent. See Github #2094.

What's Changed

• added 1.12.1 to hdf5 versions built by GitHub actions by @edwardhartnett in #2082
• cmake: extract the HDF5 version when finding HDF5 manually by @mathstuf in #2076
• v4.8.1 Wellspring changes to merge back upstream by @WardF in #2075
• Update Doxygen documentation by @WardF in #2092
• Make Issue #2077 work when build is repeated. by @DennisHeimbigner in #2094
• 2091 + Github Action to test by @WardF in #2093
• Adding missing file ncdap_test/manyurls.h by @DennisHeimbigner in #2091
• added info about logging to build summary, fixed info about byterange in build summary by @edwardhartnett in #2087
• Revamping the HDF5_VERSION logic. by @WardF in #2095
• Add filter support to NCZarr by @DennisHeimbigner in #2101
• Make the fortran cache API always be defined. by @DennisHeimbigner in #2098
• Remove netcdf-c/debug directory as no longer needed. by @DennisHeimbigner in #2099
• Make sure HDF5_C_LIBRARY and HDF5_HL_LIBRARY set by @gsjaardema in #2116
• Adding nc_def_var_quantize()/nc_inq_var_quantize() - second attempt by @edwardhartnett in #2088
• Fix handling of enum constants nested in compound types. by @DennisHeimbigner in #2109
• Fix a stack-read-overflow in ncindexlookup() by @rouault in #2113
• Patch errors by @DennisHeimbigner in #2125
• Attribute creation order on/off by @gsjaardema in #2056
• Avoid infinite loop for finding large prime values by @gsjaardema in #2126
• Fix bug in the default HDF5 byte-range reader by @DennisHeimbigner in #2127
• Remove duplicate line by @gsjaardema in #2131
• Significantly Improve Amazon S3 Cloud Storage Support by @DennisHeimbigner in #2114
• Fix additional S3 support issues by @DennisHeimbigner in #2134
• Typo in previous PR by @DennisHeimbigner in #2137
• Fix a number of OS specific bugs by @DennisHeimbigner in #2138
• libxml2 capability by @WardF in #2139
• Allow optional use of libxml2 by @DennisHeimbigner in #2135
• Refactor Z library detection by @gsjaardema in #2121
• Temporarily disable dap remote tests by @DennisHeimbigner in #2163
• Disable by default dap-remote-tests for CMake by @DennisHeimbigner in #2164
• Restore default enable for enable-dap-remote-testsc by @DennisHeimbigner in #2167
• Cleanup the CMake inter-test dependencies by @DennisHeimbigner in #2168
• tst_misc.sh: Fix hang in make check by @Dave-Allured in #2172
• Support MSYS2/Mingw platform by @DennisHeimbigner in #2171
• Make sure mode flags are properly defined in netcdf.h by @DennisHeimbigner in #2183
• Avoid redefinition of strcasecmp under mingw-w64 by @mjwoods in #2106
• Fix various problem around VLEN's by @DennisHeimbigner in #2179
• Granular BitGroom feature for netcdf-c by @czender in #2130
• Fix a few memory leaks and erroneous logic in nczarr_test/testfilter_misc by @hmaarrfk in #2180
• Now setting deflate_level of 0 is interpreted to mean no deflate. by @edwardhartnett in #2156
• adding quantize test by @edwardhartnett in #2154
• Docs migration by @oxelson in #2145
• Add OSX-based Github Actions by @WardF in #2192
• Dave allured format compat on reopen by @WardF in #2193
• HDF5 format compatibility when re-opening files by @Dave-Allured in #2176
• Collapse and update the HDF5 versions being tested on Github Actions. by @WardF in #2194
• fixed benchmark program run by @edwardhartnett in #2150
• Add MSYS2/MinGW64 to Github Actions by @WardF in #2199
• Merge PR #2118 by @WardF in #2200
• Fix diskless files in mingw-w64 by @mjwoods in #2118
• Resolvee conflict in PR 2152 by @WardF in #2201
• Fix use of S3 with a non-AWS appliances by @DennisHeimbigner in #2152
• Merge #1636 by @WardF in #2202
• NUG appendix files and CDL doc file moved to netcdf/NUG. Remove here. by @ethanrd in #1636
• Correct a memory leak as reported in #2203 by @WardF in #2204
• Add complete bitgroom support to NCZarr by @DennisHeimbigner in #2197
• Correct the accidental removal of NOUNDEFINED in liblib/Makefile.am by @WardF in #2205
• CI: Update HDF5 testing 1.8.21 --> 1.8.22 by @Dave-Allured in #2208
• Address issue with make dist generated tarballs, subsequent cmake builds by @WardF in #2210
• hdf5set_format_compatibility.c: Update new function documentation. by @Dave-Allured in #2209
• CMake: CMP0075 requires CMake >= 3.12. by @scivision in #2218
• Better handling of logging for parallel I/O builds by @edwardhartnett in #2216
• Release notes for #2176 format compatibility by @Dave-Allured in #2211
• Explicitly disallow variable length type compression by @DennisHeimbigner in #2231
• Conflict resolution for #2206 by @WardF in #2238
• Add support for setting HDF5 alignment property when creating a file by @DennisHeimbigner in #2206
• Fixed Clang -Wstrict-prototypes warnings by @seanm in #2239
• Remove stale badges, add badge for Repology by @WardF in #2243
• Various fixes by @mathstuf in #2039
• Fix Compiler Strict Aliasing Rule Violations by @e4t in #2050
• Don't assert if trying to open truncated file from memory. by @d70-t in #2089
• Rebase of #2103 by @WardF in #2246
• Rebase of #2104 by @WardF in #2247
• Use canonical path to derive name of dataset on Windows by @mjwoods in #2104
• cmake: list zip libs before szip by @xantares in #2123
• Change order in which auth.html is generated and copied. by @WardF in #2250
• Static page/documentation reorganization. by @WardF in #2256
• Enhance/Fix filter support by @DennisHeimbigner in #2245
• Fix parallel build issue, add Parallel Tests Github Actions by @WardF in #2264
• fix a compile error by @wkliao in #2261
• use AC_MSG_WARN/AC_MSG_NOTICE instead of echo by @wkliao in #2262
• Correct conflict in #2170 by @WardF in #2266
• Replace ezxml with tinyxml2 by @DennisHeimbigner in #2170
• Fix typo "Nan" -> "NaN" by @DennisHeimbigner in #2267
• use NC_EDIMSCALE for errors related to dimscale by @wkliao in #2260
• Resolve conflict in generated file by @WardF in #2269
• Add BitRound quantization by @czender in #2232
• avoid type redefine of MPI_Comm and MPI_Info by @wkliao in #2270
• Conflict resolution by @WardF in #2277
• Improve UTF8 Support On Windows by @DennisHeimbigner in #2222
• vpath build: use top_srcdir by @wkliao in #2263
• turning on parallel I/O tests in CI by @edwardhartnett in #2273
• Clean up some ncdap tests. by @DennisHeimbigner in #2253
• Adds pnetcdf to the parallel I/O testing on GitHub. by @edwardhartnett in #2280
• Fix incorrect PR link by @aaron-kaplan in #2240
• added ZSTD to netcdf_meta.h and libnetcdf.settings by @edwardhartnett in #2287
• Use Windows paths in tests of mingw-w64 executables by @mjwoods in #2105
• fixing some of the problems with nc_test when --enable-pnetcdf is used by @edwardhartnett in #2284
• fixed missing NC_HAS_QUANTIZE by @edwardhartnett in #2286
• turning off tests that depend on ncpathcvt when --disable-utilities is used by @edwardhartnett in #2282
• 2161 re-run tests by @WardF in #2295
• Make dimscale attachment to variables optional by @gsjaardema in #2161
• ensuring that MPI_File_close() is only called on open MPI file handle by @edwardhartnett in #2292
• Remove on-push trigger for OSX-based workflows. by @WardF in #2297
• Update URL for windows downloads. by @WardF in #2298
• fixed parallel functions for netcdf-fortran build by @edwardhartnett in #2300
• fix for inq_dimlen() bug with unlimited dimensions on parallel I/O builds by @edwardhartnett in #2310
• Fix dll exports for ncxml by @mjwoods in #2289
• fixed all code warnings by @edwardhartnett in #2307
• added BENCHMARKS to the build summary by @edwardhartnett in #2309
• allow to test tst_cdf5format when PnetCDF is enabled by @wkliao in #2312
• declared a variable outside for loop by @edwardhartnett in #2311
• Two fixes for the price of one! by @DennisHeimbigner in #2316
• We are incorrectly running tst_parallel_zlib on 1 processor - it should only ever run on 4 by @edwardhartnett in #2323
• #2323 plus mpi_count error message by @WardF in #2324
• Fix configure check for the -fno-strict-aliasing flag by @skosukhin in #2293
• Support installation of standard pre-built filters into user-specified location by @DennisHeimbigner in #2318
• Update selected documentation by @DennisHeimbigner in #2249
• remove all-error-codes.md by @edwardhartnett in #2336
• Correct links for gliderscope and netcdfninja in software.html by @WardF in #2345
• Turn on the xarray convention for NCZarr format by @DennisHeimbigner in #2257
• Allow the read/write of JSON-valued Zarr attributes. by @DennisHeimbigner in #2278
• use isnan instead of _fpclass on non-MSVC compilers by @Alexander-Barth in #2305
• added some entries to nc-config by @edwardhartnett in #2321
• fixed missing szip constants in netcdf.h by @edwardhartnett in #2335
• fix memory leak in genc_netcdf by @catenacyber in #2339
• Removed precision fiddling on OSX by @WardF in #2352
• #2343 with updated Github Actions by @WardF in #2356
• Fix distcheck problems by @DennisHeimbigner in #2343
• added tst_parallel6 to CMake parallel build by @edwardhartnett in #2327
• Fix libraries for CURL and HDF5 by @paulharris in #2360
• Include getopt.h if HAVE_GETOPT_H is defined by @Alexander-Barth in #2304
• #2348 by @WardF in #2370
• Improve filter installation process to avoid use of an extra shell script by @DennisHeimbigner in #2348
• adding quantize documentation by @edwardhartnett in #2362
• fixed some doxygen warnings by @edwardhartnett in #2363
• fixed more doxygen warnings by @edwardhartnett in #2364
• fixed documentation warnings in filters.md by @edwardhartnett in #2373
• Fix syntax error by @gsjaardema in #2384
• Specify correct plugin suffix by @gsjaardema in #2386
• Add doc on errors introduced by lossy compression by @rkouznetsov in #2375
• fixing issues with dimlens of unlitmited dims in complex situations by @edwardhartnett in #2368
• Initialize variable by @gsjaardema in #2382
• Initialize potentially uninitialized variable by @gsjaardema in #2383

New Contributors

• @mjwoods made their first contribution in #2106
• @czender made their first contribution in #2130
• @hmaarrfk made their first contribution in #2180
• @ethanrd made their first contribution in #1636
• @scivision made their first contribution in #2218
• @seanm made their first contribution in #2239
• @aaron-kaplan made their first contribution in #2240
• @skosukhin made their first contribution in #2293
• @Alexander-Barth made their first contribution in #2305
• @paulharris made their first contribution in #2360

Full Changelog: v4.8.1...v4.9.0