Skip to content

Commit b96ca79

Browse files
committed
update version number to 1.14.0
* Move contents of sneak_peek.md to RELEASE_NOTES
1 parent c4758b0 commit b96ca79

File tree

3 files changed

+98
-54
lines changed

3 files changed

+98
-54
lines changed

RELEASE_NOTES

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

configure.ac

Lines changed: 2 additions & 2 deletions
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

Lines changed: 10 additions & 52 deletions
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)