INTRODUCTION

This document describes the difference between CGNS 4.4.0 and
CGNS 4.5.0, and contains information on known problems in
CGNS 4.5.0.

Links to the CGNS current released source code can be found at:
Download
User MLL documentation for the current release can be found at:
MLL Documentation
For more general information, see the CGNS home page:
CGNS.org

CONTENTS

• New Features
• Bug Fixes since CGNS 4.4.0
• Known Problems

New Features

Configuration:

N/A

Library:

• New CPEX0046 Particle extension, the inclusion of particle data in CGNS.
  • For Details, see: https://cgns.org/_downloads/74b6fa06432163b5730964340e3084bc/CPEX0046-v2-rev1.pdf
  • Numerous new MLL APIs, both parallel and serial, were added. See the MLL documentation
    at cgns.org for more details.

• Added Fortran support for cg_configure_f to allow a callback function, such as in the case of CG_CONFIG_ERROR.

Parallel Library:

• Added new PointList Functions: cgp_parent_data_write(_f), cgp_ptlist_write_data(_f) and
  cgp_ptlist_read_data(_f), PR #730, Issue #728.

  • Parallel writing/reading of any PointSet is possible via a cg_goto statement rather than
    just pointsets associated with BC_t nodes.

• Added poly elements read/parent elements read-write APIs:

  • cgp_poly_section_write(_f), cgp_poly_elements_write_data(_f)
  • cgp_poly_elements_read_data_elements, cgp_poly_elements_read_data_offsets(_f),cgp_parentelements_read_data(_f)

Fortran Library:

See section Parallel Library.

Tools:

N/A

Bug Fixes since CGNS 4.4.0 release

Configuration:

• Fixed compilation issues due to missing _POSIX_SOURCE define, Issue #810.

• Add cgns-config.cmake file.

  • Also change hdf5 target names to match those from find_package(HDF5)

• Fix for HDF5 1.14.3 and onward with the NAG compiler.

  • IEEE standard arithmetic enables software to raise exceptions such as overflow,
    division by zero, and other illegal operations without interrupting or halting
    the program flow. The HDF5 C library intentionally performs these exceptions.
    Therefore, the "-ieee=full" nagfor switch is necessary when compiling a program
    to avoid stopping on an exception.

• Improve cmake packaging

  • Set an installed rpath that handles install location differently from "lib"
    for multiple arch support, for instance.

• Update cmake requirement

  • Update cmake requirement to 3.20
  • Fix conversion issue with vs2022 compiler
  • Handle F2C string on ARM64
  • Hidden parameters should be handled through a size_t according to https://gcc.gnu.org/onlinedocs/gcc-8.2.0/gfortran/Argument-passing-conventions.html

• Remove the deprecated build system on Windows (i.e., .bat); CMake is the current focus of development.

• Bumped the Autotools prerequisite to 2.71, and fixed the check to allow for HDF5 version 2.0.0

Library:

• [CGNS-284] Fixed cgi_warning

  • modify return status when the bounding box is not found.
  • No more cgi_warning shown see [CGNS-284]
  • removed outdated documentation

• Do not force Elements_t node to be contiguous

  • Only data arrays are forced to be contiguous in the Elements_t node

• fixed uninitialized warnings

• Fix issue #754 (#756)

  • use C99 types int64_t
  • define cgsize_t as a intxx_t type
  • provide PRIdCGSIZE
  • follow hdf5 changes

• Corrected int types for MPI_Allgather in ptests

  • Fixed cgsize_t type for MPI _Allgather, in tests, depending on how CGNS was built.

• Misc windows fixes

  • Make cmakelist more robust to Multi-configuration generators
  • Improve Win32 ctest support
  • Remove the redefinition of MACRO; the MACRO is already defined in glib.h

• use size_t casting to prevent allocation failure

  • the cast to size_t is done before multiplying with size_of
  • size_of now returns a size_t
  • This prevents capacity reduction in 32-bit mode when cgsize_t is an int.

• Remove access() calls in the CGNS library

  • Remove ACCESS calls due to possible race condition

• Address miscellaneous CodeQL issues and warnings.

Fortran:

• made Fortran Test_Family example output valid for cgnscheck

Tools:

• backport gcc14 fedora patch for tkogl
• [cgnscheck] check multiple grid coordinates nodes & null pointer

Known Problems

************ FORTRAN ************

• A gfortran bug in version 10.2 broke Fortran mapping and caused cg_goto_f
  to segfault. All other versions of gfortran are suitable.
  (ref. CGNS-246, GNU BUG 100149)

• A bug in gfortran (all versions) causes cg_configure_f to fail,
  GNU BUG 99982. Other Fortran compilers are OK.

• Building CGNS with parallel enabled, with Fortran enabled, and as a shared library on Windows
  is not working. Some C parallel tests fail on Windows with the Intel Compiler.

************ FORTRAN END ********

************ CGNSVIEW ************

• cgnsview for OSX is not viewing properly, and cgnsview under Windows
  may fail to compile due to tcl/tk incompatibility.

************ CGNSVIEW END ********

• For details on these and other issues, see https://github.com/CGNS/CGNS/issues
  

Supported Platforms

The following platforms are supported and have been tested for this release.
They are built with autotools unless specified otherwise.

Tested Configuration Features Summary

In the table below
      y   = tested
      n   = not tested in this release
      x   = not working in this release

[1] Parallel

Acknowledgements

• Thank you, Mickael Philit, for contributing to updating the documentation and resolving various issues
  in the CGNS library for this release.
• We appreciate all the CGNS users who reported issues and submitted pull requests.