CGNS  4.3.0
About: The CGNS (CFD General Notation System) provides a standard for recording and recovering computer data associated with the numerical solution of fluid dynamics equations.
  Fossies Dox: CGNS-4.3.0.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  
CGNS Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies CGNS-4.3.0.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
README.md

CGNS

Actions Status Build Status: Windows

Coverity Scan Build Status

About

The CFD General Notation System (CGNS) provides a standard for recording and recovering computer data associated with the numerical solution of fluid dynamics equations.

Bugs/Feature and issue tracking

https://cgnsorg.atlassian.net

Installation

Installation Instructions using cmake

  1. Install HDF5 on your system.

    • HDF5 can use the standard GNU autotools, so ./configure, make, sudo make install should install HDF5 without problems on most systems.

  2. Unpack the tar ball containing the source code into some directory.

  3. Create a new directory in which to build the library.

  4. Use cmake to initialize the build tree.

    user@hostname:build_path$ cmake /path/to/cgns/sources/

  5. Use ccmake to edit the control variables as needed.

    user@hostname:build_path$ ccmake .
    • The path to the HDF5 library should be specified with CMAKE_PREFIX_PATH=$HDF_DIR for linking with a specific HDF5 version.
      • If HDF5 is built with parallel-IO support via MPI, the HDF5_NEEDS_MPI flag must be set to true.
      • If HDF5 is built with zlib and szip support, these need to be flagged with HDF5_NEEDS_ZLIB and HDF5_NEEDS_SZIP as well as the paths for those libraries.
    • Fortran can be enabled by toggling the CGNS_ENABLE_FORTRAN variable.
      • A view of the attempt to autodetect the correct interface between Fortran and C is show, setting the value of FORTRAN_NAMING.
      • For gfortran and pgf90 the value of FORTRAN_NAMING should be LOWERCASE_.
    • The build system must be reconfigured after variable changes by pressing c. Variables who's value has changed are marked with a * in the interface.
    • After configuration, the Makefiles must be generated by pressing g.

  6. Use make to build the library.

    user@hostname:build_path$ make
    • A colorized review of the build process should follow.

  7. Installation of the library is accomplished with the install target of the makefile.

    user@hostname:build_path$ make install
    • You must have permissions to alter the directory where CGNS will be installed.

Installation Instructions using make

  1. Install HDF5 on your system.
    • HDF5 can use the standard GNU autotools, so ./configure, make, sudo make install should install HDF5 without problems on most systems.
  2. Typically the standard ./configure, make, make install will suffice.
  3. Sample scripts for building parallel CGNS can be found in src/SampleScripts.

Usage

License

The distribution and use of the CGNS software is covered by the following license:

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.

  2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.

  3. This notice may not be removed or altered from any source distribution.

This license is borrowed from the zlib/libpng License:

http://www.opensource.org/licenses/zlib-license.php

and supersedes the GNU Lesser General Public License (LGPL) which previously governed the use and distribution of the software.

For details on the policy governing the distribution of the CGNS standard and software see:

http://www.grc.nasa.gov/www/cgns/charter/principles.html

Development

CGNS uses the branching/release model as summarized at:

http://nvie.com/posts/a-successful-git-branching-model/

image