Skip to content

v5.3.2

Compare
Choose a tag to compare
@lesserwhirls lesserwhirls released this 30 Apr 00:02

netCDF-Java

Version 5.3.2

The NetCDF-Java/Common Data Model (CDM) library version 5.3.2 release was announced on April 29th, 2020. Version 5.3.2 adds the capability for netCDF-Java to read CDM datasets stored in any AWS S3 API compatible object store using HTTP Byte-Range requests, which removes the need to download an entire object blob before reading (GRIB support will be part of the next release). For information on how to reference objects for consumption by the netCDF-Java API, please see https://docs.unidata.ucar.edu/netcdf-java/5.3/userguide/dataset_urls.html#object-stores. Note that you will need to include the cdm-s3 artifact in your build, and utilize the new NetcdfFiles.open* or NetcdfDatasets.open* or NetcdfDatasets.acquire* methods. Due to the potential increase in size, ucar.edu:cdm-s3 is not part of netCDFAll.jar at this time.

Notices

Special notes about netCDF-Java

As you migrate to this and future 5.x releases, you will encounter several deprecation warnings. We are in the process of solidifying the public API, and as such some of these warnings will come without a clear alternative. Over the next week, we will be documenting the current status of the future public API on the netCDF-Java Wiki, and are currently seeking actively developed projects that use the NetCDF-Java library who are interested in providing feedback. For more information, please visit the Developers@Unidata blog post NetCDF-Java - Looking Ahead.

The v5.3.2 release is the current stable version of netCDF-Java. The minimum version required to use netCDF-Java is Java 8. We build and test against both OracleJDK and OpenJDK 8. Initial testing using our artifacts running against OpenJDK 11 are promising, and so far we have not had any reports of issues. We are working towards building with OpenJDK 11 (targeting v5.5), although we will continue to limit netCDF-Java to Java 8 features until netCDF-Java version 6 (which will move to Java 11 features).

Downloads

How to use netCDF-Java Maven Artifacts

Standalone Jars Description
netCDFAll.jar The netCDF library implements the full CDM model, including all other jar dependencies except for a logging implementation and cdm-s3. [md5] [sha1]
toolsUI.jar The toolsUI.jar contains everything to run the ToolsUI application. [md5] [sha1]

Documentation

Changes

Please visit https://docs.unidata.ucar.edu/netcdf-java/5.3/userguide/upgrade_to_50.html.

For a full list of changes between netCDF-Java v5.2.0 and v5.3.2, please visit v5.2.0...v5.3.2

Real-world use by the user community is integral to the process of creating and refining these libraries. Please direct all potential security issues directly to Unidata using the address security@unidata.ucar.edu. Please send all other potential issues to the development team via the the user community mailing lists (netcdf-java@unidata.ucar.edu), through the Unidata support system (support-netcdf-java@unidata.ucar.edu), or on the netCDF-Java GitHub issue tracker.