Skip navigation links
(CGNS Documentation Home Page) (Steering Committee Charter) (Overview and Entry-Level Document) (A User's Guide to CGNS) (Mid-Level Library) (Standard Interface Data Structures) (SIDS File Mapping Manual) (CGIO User's Guide) (Parallel CGNS User's Guide) (ADF Implementation) (HDF5 Implementation) (Python Implementation) (CGNS Tools and Utilities)

(What's New?) (Get help at CGNStalk external link) (CGNStalk Archive external link) (Site Maps)


CGNS logo   

CFD General Notation System

CGNS Version 4.3

CGNS Project Group external link

The specific purpose of the CFD General Notation System (CGNS) project is to provide a standard for recording and recovering computer data associated with the numerical solution of the equations of fluid dynamics. The intent is to facilitate the exchange of Computational Fluid Dynamics (CFD) data between sites, between applications codes, and across computing platforms, and to stabilize the archiving of CFD data.

The CGNS project originated in 1994 as a joint effort between Boeing and NASA, and has since grown to include many other contributing organizations worldwide. In 1999, control of CGNS was completely transferred to a public forum known as the CGNS Steering Committee. This Steering Committee is made up of international representatives from government and private industry.

The CGNS system consists of two parts: (1) a standard format for recording the data, and (2) software that reads, writes, and modifies data in that format. The format is a conceptual entity established by the documentation; the software is a physical product supplied to enable developers to access and produce data recorded in that format. All CGNS software is completely free and open to anyone.

In addition to the CGNS documentation, several conference papers and slide presentations are available, as well as minutes from the CGNS meetings and telecons.

NOTE: Due to its dynamic nature, starting in 2013 most of the primary documentation (other than the SIDS document) will only be available as HTML pages, and no longer also in PDF form. We apologize for any inconvenience this may cause.  

Get Help

A CGNStalk mailing list was available for discussion of the CGNS standard and software up to May 2021. The mailing list has since been replaced by a forum discussion GitHub. To post, one needs a GitHub account. Notifications of new posts are controlled by setting the proper watch notifications for the CGNS/CGNS repository.

CGNS Watch Discussions  

Documentation

The various CGNS documents are listed below, and are consistent with the current CGNS version. The home or title page for each of the documents shows the document version number, and the specific CGNS version that the document applies to. Documentation is also available for

 

Primary Documentation

Standard Interface Data Structures (SIDS)
Precisely defines the "intellectual content" of CFD-related data, including the organizational structure supporting the data and the conventions adopted to standardize the data exchange process. The SIDS, together with the information in the SIDS File Mapping Manual, defines the content and organization of a CGNS database.

Note that most documentation is now on-line only (html). However, an older print pdf version of the SIDS from version 3.3 rev 2 is still available. This print document does not cover changes starting with CPEX 0040, nor any errors or changes made after September 2015.

The current SIDS document represents a revision of the now outdated AIAA Recommended Practice R-101A-2005.

Mid-Level Library
Describes a set of routines making up an Application Programming Interface (API) for storing and retrieving data in a CGNS database. Their purpose is to ease the implementation of CGNS by providing CGNS-compliant I/O without the need for detailed low-level programming using the ADF Core routines. These "mid-level routines" are designed to be inserted directly into applications codes, such as flow solvers and grid generators.

A User's Guide to CGNS
A concise introduction to many of the most commonly-used features of CGNS, with coding examples using the Mid-Level Library to write and read simple files containing CGNS databases. The User's Guide is intended as a tutorial: light in content, but heavy in examples, advice, and guidelines. Version 1.0 of the User's Guide was also published as NASA/TM-2001-211236, October 2001.

Note that most documentation (including the User's Guide) is now on-line only (html). However, a pdf version of User's Guide v3.1.3 is included for convenience (may be outdated).

Parallel CGNS User's Guide
Describes the use of the parallel I/O within the CGNS library, and associated routines.
 

Other Documentation

Steering Committee Charter
The charter for the CGNS Steering Committee, the public forum responsible for the development, evolution, support, and promotion of the CGNS (CFD General Notation System) standard external link.

Overview and Entry-Level Document
An introductory document providing an overall view of the purpose and components of CGNS. The Overview is intended as an entry point into CGNS.

SIDS File Mapping Manual
Specifies the exact manner in which, under CGNS conventions, the CFD data structures (the SIDS) are to be stored in, i.e., mapped onto, the file structure provided by a database manager (ADF, HDF, or Python). The File Mapping Manual, together with the information in the Standard Interface Data Structures (SIDS), defines the content and organization of a CGNS database.

CGIO User's Guide
The CGIO routines provide low-level access to the underlying database manager (ADF or HDF5), that may be used to store and retrieve data. It is patterned along the lines of the original ADF core routines, but works for both ADF and HDF5 transparently to the user. This document describes in detail the CGIO core routines used to store and retrieve the data from the database manager.

ADF Implementation
ADF is the original underlying database manager for CGNS. This document defines the structure of an ADF file, and describes in detail the ADF Core, a library of low-level routines used to store and retrieve data in an ADF file. Note that these routines are still supported, but have been superseded by the CGIO interface routines.

HDF5 Implementation
HDF5 is now the default database manager for CGNS (when built with HDF5 support). This document describes the interface between the SIDS File Mapping and the HDF5 database manager.

Python Implementation
This document describes the interface between the SIDS File Mapping and Python as a database manager.

CGNS Tools and Utilities
A variety of tools and utilities for viewing, editing, and manipulating CGNS and ADF files, including the CGNSview, CGNSplot, and Utilities programs in the CGNStools package. Links are also provided to documentation for alternate bindings to the ADF Core and Mid-Level Library routines.

 

Conference Papers

"The CGNS System," D. Poirier, S. R. Allmaras, D. R. McCarthy, M. F. Smith, F. Y. Enomoto (AIAA Paper 98-3007). [Available from AIAA external link]

"Advances in the CGNS Database Standard for Aerodynamics and CFD," D. M. A. Poirier, R. H. Bush, R. R. Cosner, C. L. Rumsey, D. R. McCarthy (AIAA Paper 2000-0681). [HTML, PDF]

"CFD General Notation System (CGNS): Status and Future Directions," S. M. Legensky, D. E. Edwards, R. H. Bush, D. M. A. Poirier, C. L. Rumsey, R. R. Cosner, C. E. Towne (AIAA Paper 2002-0752). [HTML, PDF; copyright Intelligent Light, made available here by permission]

"Parallel I/O for the CGNS system," Th. Hauser (AIAA Paper 2004-1088). [Available from AIAA external link]

"Impact of CGNS on CFD Workflow," M. Poinot, C. L. Rumsey, M. Mani (AIAA Paper 2004-2142). [Available from AIAA external link]

"CGNS-Based Data Model for Turbine Blade Optimization," H. Iepan, F. Guibault, M.-G. Vallet, Magnan, R. (AIAA Paper 2005-0334). [Available from AIAA external link]

"Checking CFD interfaces in a multi-disciplinary workflow with an XML/CGNS compiler," M. Poinot, E. Montreuil, E. Henaux (AIAA Paper 2005-1155). [Available from AIAA external link]

"Benchmarking Parallel I/O Performance for Computational Fluid Dynamics Applications," P. D. Pakalapati, T. Hauser (AIAA Paper 2005-1381). [HTML, PDF; copyright Thomas Hauser, made available here by permission]

"Application of CGNS software components for helicopter blade fluid-structure strong coupling," M. Poinot, M. Costes, B. Cantaloube (ERF Paper 31-107).

"Benchmarking the CGNS I/O Performance," Thomas Hauser (AIAA Paper 2008-0479). [HTML, PDF; copyright Thomas Hauser, made available here by permission]

"An Efficient and Flexible Parallel I/O implementation for the CFD General Notation System," Kyle Horne, Nate Benson, Center for High Performance Computing, Utah State University, Thomas Hauser, Academic & Research Computing, Northwestern University [PDF; copyright Thomas Hauser, made available here by permission]

"Recent Updates to the CFD General Notation System (CGNS)," C. Rumsey, B. Wedan, T. Hauser, M. Poinot (AIAA Paper 2012-1264). [PDF]

"CGNS Test Suites for CFD Software Components," M. Poinot (AIAA Paper 2016-1924). [Available from AIAA external link]

"Seven Keys for Practical Understanding and Use of CGNS," M. Poinot and C. Rumsey (AIAA Paper 2018-1503). [Available from AIAA external link]

 

Slides

"CGNS Summary," Douglas McCarthy, Boeing Commercial Airplane Group, Open Meeting, Hampton, VA, May 20-21, 1999. [HTML, PDF]

"The CGNS System," Diane Poirier, ICEM CFD Engineering, 29th AIAA Fluid Dynamics Conference, Albuquerque, New Mexico, June 15-18, 1998. [See AIAA Paper 98-3007, above]

"The CGNS System," Armin Wulf, ICEM CFD Engineering, 37th Aerospace Sciences Meeting & Exhibit, Reno, Nevada, January 13, 1999. [HTML, PDF]

"Advances in the CGNS Database Standard for Aerodynamics and CFD," Diane Poirier, ICEM CFD Engineering, 38th Aerospace Sciences Meeting & Exhibit, Reno, Nevada, January 10-13, 2000. [HTML, PDF]

"CGNS CFD Data Standard," John Steinbrenner, Pointwise, Inc., Panel on Standards for Geometry Modeling and Grid Generation, 8th International Conference on Numerical Grid Generation in Computational Field Simulations, International Society of Grid Generation, Honolulu, Hawaii, June 2-6, 2002. [HTML, PDF]

"CFD General Notation System," Bruce Wedan, ANSYS/ICEM CFD, Presentation at NASA Ames, Jan, 2005. [HTML, PowerPoint (345K, 46 pages)]

"CGNS Tutorial Session," 36th AIAA Fluid Dynamics Conference, San Francisco, California, June 5-8, 2006.

"CGNS Tutorial Session," 48th AIAA Aerospace Sciences Meeting, Orlando, Florida, January 4-7, 2010.

"Recent Updates to the CFD General Notation System (CGNS)," C. Rumsey, B. Wedan, T. Hauser, M. Poinot, 50th AIAA Aerospace Sciences Meeting, Nashville, TN, January 9-12, 2012. (See AIAA Paper 2012-1264, above.) [PDF]

"Seven Keys for Practical Understanding and Use of CGNS," M. Poinot and C. Rumsey, 2018 AIAA SciTech Forum, Kissimmee, FL, January 8-12, 2018. (See AIAA Paper 2018-1503.) [PDF]

 

Minutes

Minutes are available for the following CGNS Steering Committee meetings and telecons.

 
2024
   16 Jan  Telecon  (PDF)    
 
2023
   10 Jan  Telecon  (PDF)     4 Apr  Telecon  (PDF)     11 Jul  Telecon  (PDF)    
   3 Oct  Telecon  (PDF)    
 
2022
   29 Mar  Telecon  (PDF)     19 Jul  Telecon  (PDF)     11 Oct  Telecon  (PDF)    
 
2021
   2 Mar  Telecon  (PDF)     15 June  Telecon  (PDF)     7 Sep  Telecon  (PDF)    
   12 Dec  Telecon  (PDF)    
 
2020
   28 Jan  Telecon  (PDF)     28 Apr  Telecon  (PDF)     4 Aug  Telecon  (PDF)    
   8 Dec  Telecon  (PDF)    
 
2019
   12 Nov  Telecon  (PDF)     03 Sep  Telecon  (PDF)     25 June  Telecon  (PDF)    
   21 May  Telecon  (PDF)     26 Mar  Telecon  (PDF)     22 Jan  Telecon  (PDF)    
 
2018
   06 Nov  Telecon  (PDF)     18 Sep  Telecon  (PDF)    
   05 Jun  Telecon  (PDF)     27 Mar  Telecon  (PDF)     30 Jan  Telecon  (PDF)    
 
2017
   24 Oct  Telecon  (PDF)     12 Sep  Telecon  (PDF)    
   25 Jul  Telecon  (PDF)     5 May  Telecon  (PDF)     31 Jan  Telecon  (PDF)    
 
2016
   29 Nov  Telecon  (PDF)     23 Sep  Telecon  (PDF)    
   05 Jul  Telecon  (PDF)     05 Apr  Telecon  (PDF)     01 Mar  Telecon  (PDF)    
 
2015
   08 Dec  Telecon  (PDF)     20 Oct  Telecon  (PDF)     08 Sep  Telecon  (PDF)    
   19 May  Telecon  (PDF)     03 Mar  Telecon  (PDF)    
 
2014
   02 Dec  Telecon  (PDF)     02 Oct  Telecon  (PDF)     03 Sep  Telecon  (PDF)    
   18 Feb  Telecon  (PDF)     28 Jan  Telecon  (PDF)    
 
2013
   17 Dec  Telecon  (PDF)     18 Sep  Telecon  (PDF)     16 Jul  Telecon  (PDF)    
   30 Apr  Telecon  (PDF)     12 Mar  Telecon  (PDF)     5 Feb  Telecon  (PDF)    
 
2012
   10 Dec  Telecon  (PDF)     23 Oct  Telecon  (PDF)     25 Sep  Telecon  (PDF)    
   24 Apr  Telecon  (PDF)     13 Mar  Telecon  (PDF)     24 Jan  Telecon  (PDF)    
 
2011
   06 Dec  Telecon  (PDF)     30 Aug  Telecon  (PDF)     07 Jun  Telecon  (PDF)    
   19 Apr  Telecon  (PDF)     02 Mar  Telecon  (PDF)     02 Feb  Telecon  (PDF)    
 
2010
   01 Dec  Telecon  (PDF)     20 Oct  Telecon  (PDF)     08 Sep  Telecon  (PDF)    
   10 Jun  Telecon  (HTML, PDF)     29 Apr  Telecon  (HTML, PDF)     18 Mar  Telecon  (HTML, PDF)    
   28 Jan  Telecon  (HTML, PDF)    
 
2009
   01 Dec  Telecon  (HTML, PDF)     02 Sep  Telecon  (HTML, PDF)     07 Jul  Telecon  (HTML, PDF)    
   20 May  Telecon  (HTML, PDF)     1 Apr   Telecon  (HTML, PDF)     7 Jan   Meeting  (HTML, PDF)
 
2008
   5 Nov   Telecon  (HTML, PDF)     10 Sep   Telecon  (HTML, PDF)     2 Jul   Telecon  (HTML, PDF)
   7 May  Telecon  (HTML, PDF)     6 Jan  Meeting  (HTML, PDF)
 
2007
   28 Nov  Telecon  (HTML, PDF)     12 Sep  Telecon  (HTML, PDF)     22 May  Telecon  (HTML, PDF)
   21 Mar  Telecon  (HTML, PDF)     10 Jan  Meeting  (HTML, PDF)
 
2006
   4 Oct  Telecon  (HTML, PDF)     2 Aug  Telecon  (HTML, PDF)     10 May  Telecon  (HTML, PDF)
   22 Mar  Telecon  (HTML, PDF)     11 Jan  Meeting  (HTML, PDF)
 
2005
   4 Oct  Telecon  (HTML, PDF)     2 Aug  Telecon  (HTML, PDF)     25 May  Telecon  (HTML, PDF)
   16 Mar  Telecon  (HTML, PDF)     12 Jan  Meeting  (HTML, PDF)
 
2004
   17 Nov  Telecon  (HTML, PDF)     28 Sep  Telecon  (HTML, PDF)     30 Jun  Meeting  (HTML, PDF)
   25 Mar  Telecon  (HTML, PDF)     7 Jan  Meeting  (HTML, PDF)
 
2003
   20 Nov  Telecon  (HTML, PDF)     18 Sep  Telecon  (HTML, PDF)     24 Jun  Meeting  (HTML, PDF)
   29 May  Telecon  (HTML, PDF)     20 Mar  Telecon  (HTML, PDF)     15 Jan  Meeting  (HTML, PDF)
 
2002
   4 Dec  Telecon  (HTML, PDF)     18 Sep  Telecon  (HTML, PDF)     24 Jun  Meeting  (HTML, PDF)
   15 May  Telecon  (HTML, PDF)     13 Mar  Telecon  (HTML, PDF)     14 Jan  Meeting  (HTML, PDF)
 
2001
   6 Nov  Telecon  (HTML, PDF)     6 Sep  Telecon  (HTML, PDF)     12 Jun  Meeting  (HTML, PDF)
   17 May  Telecon  (HTML, PDF)     15 Mar  Telecon  (HTML, PDF)     9 Jan  Meeting  (HTML, PDF)
 
2000
   7 Dec  Telecon  (HTML, PDF)     25 Oct  Telecon  (HTML, PDF)     24 Aug  Telecon  (HTML, PDF)
   21 Jun  Meeting  (HTML, PDF)     11 May  Telecon  (HTML, PDF)     16 Mar  Telecon  (HTML, PDF)
   10 Jan  Meeting  (HTML, PDF)
 
1999
   9 Dec  Telecon  (HTML, PDF)     14 Oct  Meeting  (HTML, PDF)

 

CGNSTalk Archives

The following gzipped text files are archives of CGNSTalk emails from the past years. Sometimes, these emails can be useful to search for answers to CGNS-related questions that have been posted in the past.

Archives are available from 2008 forward from: https://lists.nasa.gov/mailman/private/cgnstalk/ (you may need to sign up to be a member of CGNSTalk in order to view). For convenience, they are also given below, along with older archives extending back to 2000.

2000-2020
   Archives  (Gzipped Text File)