Skip to content

Commit 29e55b9

Browse files
committed
update version number to 1.14.0
* Move contents of sneak_peek.md to RELEASE_NOTES
1 parent ecafde8 commit 29e55b9

File tree

3 files changed

+97
-54
lines changed

3 files changed

+97
-54
lines changed

RELEASE_NOTES

+85
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,91 @@ PnetCDF Release Notes
66
Version _PNETCDF_VERSION_ (_PNETCDF_RELEASE_DATE_)
77
-------------------------------------
88

9+
* New features
10+
+ Intra-node aggregation for write requests -- When the number of MPI
11+
processes allocated to a compute node is large, this feature can
12+
effectively reduce the communication congestion caused by an overwhelming
13+
large number of asynchronous messages posted during the collective write
14+
of MPI-IO. This new feature can be enabled by setting the PnetCDF I/O hint
15+
'nc_num_aggrs_per_node' to the desired number of aggregators per compute
16+
node. The non-aggregators send their requests to the assigned aggregators,
17+
and then the aggregators make aggregated requests to the file.
18+
[PR #156](https://github.com/Parallel-NetCDF/PnetCDF/pull/156).
19+
+ Support MPI derived data types that are constructed from the large-count
20+
derived datatype constructors introduced in MPI 4.0.
21+
[PR #145](https://github.com/Parallel-NetCDF/PnetCDF/pull/145).
22+
23+
* New optimization
24+
+ When running sequentially (i.e. number of processes is 1), PnetCDF calls
25+
the MPI independent I/O functions and avoids calls to MPI_Barrier,
26+
MPI_Bcast, and MPI_Allreduce.
27+
[PR #149](https://github.com/Parallel-NetCDF/PnetCDF/pull/149).
28+
29+
* Configure options changed
30+
+ The default has been changed to build both shared and static libraries.
31+
[PR #143](https://github.com/Parallel-NetCDF/PnetCDF/pull/143).
32+
33+
* Configure updates:
34+
+ Fix `pnetcdf-config` of reflecting the installation path when installation
35+
is done by running command `make install DESTDIR=/alternate/directory`
36+
which prepends '/alternate/directory' before all installation names.
37+
[PR #154](https://github.com/Parallel-NetCDF/PnetCDF/pull/154).
38+
39+
* New constants
40+
+ A new C macro `NC_FillValue` replaces `_FillValue` and thus `_FillValue` is
41+
now deprecated This conforms with NetCDF4's change in its version 4.9.3
42+
release. [PR #153](https://github.com/Parallel-NetCDF/PnetCDF/pull/153).
43+
44+
* New PnetCDF hints
45+
+ 'nc_num_aggrs_per_node' -- To enable the intra-node aggregation, this I/O
46+
hint can set to a positive integral value, which indicates the desired
47+
number of processes per compute node to be selected as the aggregators.
48+
Setting it to 0 disables the aggregation, which is also the default mode.
49+
[PR #156](https://github.com/Parallel-NetCDF/PnetCDF/pull/156).
50+
51+
* Build recipes
52+
+ When using OpenMPI on Mac OSX, a link error may appear. The work around is
53+
to add `LDFLAGS=-ld_classic` into the configure command line. Thanks to
54+
Rui Chen for reporting and provide the solution.
55+
[Issue #139](https://github.com/Parallel-NetCDF/PnetCDF/issues/139).
56+
57+
* Updated utility programs
58+
+ none
59+
60+
* Other updates:
61+
+ More document for comparing PnetCDF and NetCDF4 has been added to file
62+
doc/netcdf4_vs_pnetcdf.md
63+
[PR #152](https://github.com/Parallel-NetCDF/PnetCDF/pull/152) and
64+
[PR #140](https://github.com/Parallel-NetCDF/PnetCDF/pull/140).
65+
66+
* New example programs
67+
+ C/flexible_bottom.c and C/vard_bottom.c - These two examples construct MPI
68+
derived data types using absolute memory addresses first and use MPI_BOTTOM
69+
when calling the PnetCDF flexible APIs.
70+
71+
* New programs for I/O benchmarks
72+
+ C/pnetcdf_put_vara.c --
73+
* This program writes a series of 3D variables with 2D block-block
74+
partitioning pattern. Each variable is a record variable.
75+
[PR #150](https://github.com/Parallel-NetCDF/PnetCDF/pull/150).
76+
+ C/netcdf_put_vara.c --
77+
* This sequential NetCDF-C program writes a series of 3D variables. Each
78+
variable is a record variable.
79+
* This program and `C/pnetcdf_put_vara.c` can be used to compare the
80+
performance of NetCDF and PnetCDF when running sequentially, i.e. one
81+
process.
82+
[PR #150](https://github.com/Parallel-NetCDF/PnetCDF/pull/150).
83+
84+
* New test program
85+
+ test/testcases/flexible_large_count.c - tests flexible APIs that use MPI
86+
derived datatypes created by MPI large-count datatype constructors.
87+
[PR #145](https://github.com/Parallel-NetCDF/PnetCDF/pull/145).
88+
89+
90+
-------------------------------------
91+
Version 1.13.0 (March 29, 2024)
92+
-------------------------------------
93+
994
* New features
1095
+ A single read/write request made by an MPI process is now allowed to be of
1196
size larger than 2 GiB. Such large requests will be passed to the MP-IO

configure.ac

+2-2
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ dnl AC_REVISION([$Revision$])dnl
1515
dnl autoconf v2.70 and later is required. See https://github.com/Parallel-NetCDF/PnetCDF/issues/94
1616
dnl autoconf v2.70 was released in 2021-01-28
1717
AC_PREREQ([2.70])
18-
AC_INIT([PnetCDF],[1.13.0],[[email protected]],[pnetcdf],[https://parallel-netcdf.github.io])
18+
AC_INIT([PnetCDF],[1.14.0],[[email protected]],[pnetcdf],[https://parallel-netcdf.github.io])
1919

2020
dnl config.h.in will be created by autoreconf (autoheader)
2121
dnl call it right after AC_INIT, as suggested by autoconf
@@ -2641,7 +2641,7 @@ dnl Update the version information only immediately before a public release.
26412641
dnl PnetCDF starts with 1:0:0 (shared library is first supported in 1.9.0)
26422642
dnl because some package distributors, such as Debian, may have already built
26432643
dnl PnetCDF with shared libraries.
2644-
ABIVERSION="5:0:0"
2644+
ABIVERSION="6:0:0"
26452645
AC_SUBST(ABIVERSION)
26462646
if test "$enable_versioning" = "yes" ; then
26472647
ABIVERSIONFLAGS="-version-info \$(ABIVERSION)"

sneak_peek.md

+10-52
Original file line numberDiff line numberDiff line change
@@ -3,43 +3,22 @@ This is essentially a placeholder for the next release note ...
33
------------------------------------------------------------------------------
44

55
* New features
6-
+ Intra-node aggregation for write requests -- When the number of MPI
7-
processes allocated to a compute node is large, this feature selects a
8-
subset of processes per node to be an I/O aggregator. The non-aggregators
9-
send their requests to the assigned aggregators, and then the aggregators
10-
make aggregated requests to the file. This feature can effectively reduce
11-
communication congestion due to too many pending asynchronous messages
12-
produced in the collective write inside of MPI-IO. This new feature can be
13-
enabled by setting the PnetCDF I/O hint 'nc_num_aggrs_per_node' to the
14-
desired number of aggregators per compute node.
15-
See [PR #156](https://github.com/Parallel-NetCDF/PnetCDF/pull/156).
16-
+ Support MPI derived data types that are constructed from the large-count
17-
derived datatype constructors introduced in MPI 4.0.
18-
See [PR #145](https://github.com/Parallel-NetCDF/PnetCDF/pull/145).
6+
+ none
197

208
* New optimization
21-
+ When running sequentially (i.e. number of processes is 1), PnetCDF calls
22-
the MPI independent I/O functions and avoids calls to MPI_Barrier,
23-
MPI_Bcast, and MPI_Allreduce.
24-
See [PR #149](https://github.com/Parallel-NetCDF/PnetCDF/pull/149).
9+
+ none
2510

2611
* New Limitations
2712
+ none
2813

2914
* Configure options
30-
+ The default has been changed to build both shared and static libraries.
31-
See [PR #143](https://github.com/Parallel-NetCDF/PnetCDF/pull/143).
15+
+ none
3216

3317
* Configure updates:
34-
+ Fix `pnetcdf-config` of reflecting the installation path when installation
35-
is done by running command `make install DESTDIR=/alternate/directory`
36-
which prepends '/alternate/directory' before all installation names.
37-
See [PR #154](https://github.com/Parallel-NetCDF/PnetCDF/pull/154).
18+
+ none
3819

3920
* New constants
40-
+ A new C macro `NC_FillValue` replaces `_FillValue` and thus `_FillValue` is
41-
now deprecated This conforms with NetCDF4's change in its version 4.9.3
42-
release. See [PR #153](https://github.com/Parallel-NetCDF/PnetCDF/pull/153).
21+
+ none
4322

4423
* New APIs
4524
+ none
@@ -60,11 +39,7 @@ This is essentially a placeholder for the next release note ...
6039
+ none
6140

6241
* New PnetCDF hints
63-
+ 'nc_num_aggrs_per_node' -- To enable the intra-node aggregation, this I/O
64-
hint can set to a positive integral value, which indicates the desired
65-
number of processes per compute node to be selected as the aggregators.
66-
Setting it to 0 disables the aggregation, which is also the default mode.
67-
See [PR #156](https://github.com/Parallel-NetCDF/PnetCDF/pull/156).
42+
+ none
6843

6944
* New run-time environment variables
7045
+ none
@@ -76,36 +51,19 @@ This is essentially a placeholder for the next release note ...
7651
+ none
7752

7853
* Other updates:
79-
+ More document for comparing PnetCDF and NetCDF4 has been added to file
80-
doc/netcdf4_vs_pnetcdf.md
81-
See [PR #152](https://github.com/Parallel-NetCDF/PnetCDF/pull/152) and
82-
[PR #140](https://github.com/Parallel-NetCDF/PnetCDF/pull/140).
54+
+ none
8355

8456
* Bug fixes
8557
+
8658

8759
* New example programs
88-
+ C/flexible_bottom.c and C/vard_bottom.c - These two examples construct MPI
89-
derived data types using absolute memory addresses first and use MPI_BOTTOM
90-
when calling the PnetCDF flexible APIs.
60+
+ none
9161

9262
* New programs for I/O benchmarks
93-
+ C/pnetcdf_put_vara.c --
94-
* This program writes a series of 3D variables with 2D block-block
95-
partitioning pattern. Each variable is a record variable.
96-
See [PR #150](https://github.com/Parallel-NetCDF/PnetCDF/pull/150).
97-
+ C/netcdf_put_vara.c --
98-
* This sequential NetCDF-C program writes a series of 3D variables. Each
99-
variable is a record variable.
100-
* This program and `C/pnetcdf_put_vara.c` can be used to compare the
101-
performance of NetCDF and PnetCDF when running sequentially, i.e. one
102-
process.
103-
See [PR #150](https://github.com/Parallel-NetCDF/PnetCDF/pull/150).
63+
+ none
10464

10565
* New test program
106-
+ test/testcases/flexible_large_count.c - tests flexible APIs that use MPI
107-
derived datatypes created by MPI large-count datatype constructors.
108-
See [PR #145](https://github.com/Parallel-NetCDF/PnetCDF/pull/145).
66+
+ none
10967

11068
* Issues with NetCDF library
11169
+ none

0 commit comments

Comments
 (0)