|
| 1 | +[PnetCDF](https://parallel-netcdf.github.io) Version 1.12.3 Release Notes (January 21, 2021) |
| 2 | +------------------------------------------------------------------------------ |
| 3 | + |
| 4 | +* New optimization |
| 5 | + + Improve the performance when nonblocking requests contain more than one |
| 6 | + record. |
| 7 | + See [a00f5d2](https://github.com/Parallel-NetCDF/PnetCDF/commit/a00f5d2). |
| 8 | + |
| 9 | +* Update configure options |
| 10 | + + Retire configure options `--enable-netcdf4` and `--enable-adios`, as there |
| 11 | + are already options `--with-netcdf4` and `--with-adios`. According to the |
| 12 | + autoconf manual, `--enable-feature` is for internal packages and |
| 13 | + `--with-feature` is for external. Adding `--with-feature` is equivalent to |
| 14 | + enabling the feature. |
| 15 | + |
| 16 | +* Updated utility program |
| 17 | + + Replace the definition of "difference ratio" used in utility programs |
| 18 | + `cdfdiff` and `ncmpidiff` with formula |
| 19 | + ``` |
| 20 | + |x - y| / max(|x|, |y|) |
| 21 | + ``` |
| 22 | + where |x| means the absolute value of x. |
| 23 | + See [issue #78](https://github.com/Parallel-NetCDF/PnetCDF/issues/78) and |
| 24 | + [9b165ceb](https://github.com/Parallel-NetCDF/PnetCDF/commit/9b165ceb). |
| 25 | + + Utility programs `cdfdiff` and `ncmpidiff` now report only the first |
| 26 | + variable element that are different or fail to meet the tolerances. Their |
| 27 | + values and differences are now printed on the standard output. |
| 28 | + See [75d20e6](https://github.com/Parallel-NetCDF/PnetCDF/commit/75d20e6) |
| 29 | + and [58d2d17](https://github.com/Parallel-NetCDF/PnetCDF/commit/58d2d17). |
| 30 | + + Use the same user-provided tolerant difference and tolerant difference |
| 31 | + ratio (through command-line option '-t') to check all variables. |
| 32 | + See [issue #78](https://github.com/Parallel-NetCDF/PnetCDF/issues/78) and |
| 33 | + [75d20e6](https://github.com/Parallel-NetCDF/PnetCDF/commit/75d20e6). |
| 34 | +
|
| 35 | +* Other updates: |
| 36 | + + IBM XLF compiler on Summit at OLCF requires compile flag "-qfixed" when |
| 37 | + compiling Fortran programs written in fixed form. Thus, the fixed form flag |
| 38 | + detected at configure time has been added to `AM_FFLAGS` when compiling |
| 39 | + fixed form programs. Similarly, the free form flag has been added to |
| 40 | + `AM_FCFLAGS` when compiling free form programs. This issue affects only the |
| 41 | + test and example Fortran programs. The PnetCDF library is intact. |
| 42 | + See [PR #73](https://github.com/Parallel-NetCDF/PnetCDF/pull/73) |
| 43 | + + Add all PnetCDF I/O hints to the inquired MPI info object returned by API |
| 44 | + `ncmpi_inq_file_info()`. |
| 45 | + See [f0e65cf](https://github.com/Parallel-NetCDF/PnetCDF/commit/f0e65cf). |
| 46 | +
|
| 47 | +* Bug fixes |
| 48 | + + Fix a bug in utility program `ncvalidator` for the case when there is no |
| 49 | + record written, but both fixed-size and record variables are defined. |
| 50 | + See [b34bfcd](https://github.com/Parallel-NetCDF/PnetCDF/commit/b34bfcd). |
| 51 | + + Fix configure bug of setting environment variable `SEQ_CC` to the |
| 52 | + sequential `CC` extracted from `MPICC`. Also add configure help message for |
| 53 | + environment variable `SEQ_CC`. Thanks to Carl Ponder for reporting. |
| 54 | + See [4978f6d](https://github.com/Parallel-NetCDF/PnetCDF/commit/4978f6d). |
| 55 | + + Fix a bug when C function `truncate` is not available. Argument `fh` of |
| 56 | + `MPI_File_close` is a pointer. |
| 57 | + See [3e331a6](https://github.com/Parallel-NetCDF/PnetCDF/commit/3e331a6). |
| 58 | + + When using an MPI compiler whose Fortran feature was disabled, the MPI |
| 59 | + Fortran constants and datatypes may not be defined in the header file |
| 60 | + `mpi.h`. This is the case for Open MPI (tested with 4.0.2). PnetCDF used |
| 61 | + some Fortran datatypes without checking whether they are defined, which can |
| 62 | + fail when running 'make'. A fix has been added to check whether the Fortran |
| 63 | + feature is disabled and wraps around the Fortran datatypes with C directive |
| 64 | + 'ifdef ENABLE_FORTRAN'. Thanks Bert Wesarg for reporting this bug. |
| 65 | + See [issue #68](https://github.com/Parallel-NetCDF/PnetCDF/issues/68) and |
| 66 | + [PR #69](https://github.com/Parallel-NetCDF/PnetCDF/pull/69). |
| 67 | +
|
| 68 | +* Issues with NetCDF library |
| 69 | + + Test program [test/nc4/tst_rec_vars.c](test/nc4/tst_rec_vars.c) fails to |
| 70 | + run when using NetCDF 4.8.0 and 4.8.1. Thanks Bruno Pagani for reporting. |
| 71 | + See [issue #72](https://github.com/Parallel-NetCDF/PnetCDF/issues/72). |
| 72 | +
|
| 73 | +* Clarifications |
| 74 | + + Nonblocking APIs have yet to support subfiling feature. |
| 75 | +
|
0 commit comments