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


CGNS logo   

CFD General Notation System
Document Change History

This document summarizes the change history for the CGNS documentation. Each entry includes the document version number, the date of the change, and a (very) brief description of the change. For the Mid-Level Library, Standard Interface Data Structures, and SIDS-to-ADF File Mapping Manual, the CGNS release number that the document corresponds to is also shown. A bit more detail about the changes may be available in the What's New list for the CGNS documentation.

Overview and Entry-Level Document

    Document
Version
   Date   Change
 
1.0 15 May 1998 Original version
2.0 7 May 2002 Updated and reorganized
2.0.1 20 May 2002 Corrected location of APPT in the tables in the CGNS-Compatible Applications section
2.0.2 30 Jul 2002 Updated the History and Current Status section to reflect the release of Version 2.1 of the CGNS software on May 24, 2002.
2.0.3 10 Dec 2002 Added an entry for the CGNS Tools in the list of CGNS Utilities.
2.0.4 23 Jan 2003 Updated the History and Current Status section to reflect the publication of the AIAA Recommended Practice for the storage of CFD data.
2.0.5 13 May 2003 Updated to reflect the release of Version 2.2 of the CGNS software on May 3, 2003.
2.0.6 9 Jun 2003 Changed terminology of "Software Release" to "CGNS Version".
2.0.7 28 Oct 2003 Updated links in the Applications Software section.
2.0.8 26 Mar 2004 Updated to reflect the release of CGNS Version 2.3 on Jan 22, 2004.
2.0.9 27 May 2005 Updated some links and contact points listed in the Applications Software section.
2.0.10 2 Sep 2005 Updated to reflect the release of CGNS Version 2.4 in Aug, 2005.
2.0.11 7 Sep 2005 Added note crediting developers of HDF5 support in CGNS Version 2.4.
2.0.12 17 Oct 2005 Updated Elements and Documentation section to reflect the option of using HDF instead of ADF.
2.0.13 10 Apr 2006 Updated some links and contact points listed in the Applications Software section.
2.0.14 13 Apr 2006 Updated the status of the inclusion of CGNS as part of an ISO standard.
2.0.15 25 Sep 2006 Updated some links and contact points listed in the Applications Software section.
2.0.16 14 Sep 2007 Updated to reflect the release of CGNS Version 2.5 in Sep, 2007.
2.0.17 30 Jan 2008 Changed a contact email address.
2.0.18 12 Mar 2008 Removed references to the utility ADF_Edit, in favor of ADFviewer.
2.0.19 23 Oct 2008 Updated a contact link in the Applications Software section.
2.0.20 26 May 2009 Changed the contact person in the Applications Software section for notification about new CGNS applications.

A User's Guide to CGNS

    Document
Version
   CGNS
Version
   Date   Change
 
1.0 2.0, Beta 1 Nov 2000 Original version
1.1 2.0, Rev 1 23 Aug 2001 Addition of sections on time-dependent capability and PLOT3D guidelines
1.1.1 2.1, Beta 1 14 Feb 2002 Paragraph change due to addition of links to API
1.1.2 2.2, Beta 1 12 Sep 2002 Added an FAQ about writing data sets associated with boundary conditions.
1.1.3 2.2, Beta 1 17 Sep 2002 Small clarification added to last answer in FAQ section.
1.1.4 2.2 9 Jun 2003 Changed sentence defining CGNSLibraryVersion_t.
1.1.5 2.3 6 Feb 2004 Modified the "Getting Started" section to reflect the addition of ElementRange and ElementList in the BC_t structure in CGNS Version 2.3.
1.1.6 2.4 1 Sep 2005 Added a note in the Introduction about the option of using HDF instead of ADF.
1.1.7 2.4 7 Dec 2005 Modified to refer users to the CGNS site at SourceForge external link to download the source code examples.
1.1.8 2.4.4 19 May 2006 Wording changes due to the new capability for rind data with unstructured grids.
1.1.9 2.5 14 Sep 2007 Change in version numbers only, to reflect the release of CGNS Version 2.5 in Sep, 2007.
1.1.10 2.5 14 Sep 2007 Noted its original publication as NASA/TM-2001-211236.
1.1.11 2.5 7 Mar 2008 Modified the section on writing boundary conditions for an unstructured grid to illustrate the recommended procedure using ElementList, and removed references to the utility ADF_Edit, in favor of ADFviewer.
1.1.12 2.5 14 May 2008 Made a minor change in the Getting Started section involving the use of PointList or PointRange with GridLocation set to FaceCenter.
1.1.13 3.1 01 Feb 2011 Changed references of ADFviewer to CGNSview. Updated code snippet examples to reflect changes in new UserGuideCodeV3.1, including changes of MODE_READ to CG_MODE_READ (for example) in cg_open calls. Added mention of cg_error_handler.
3.1.1 3.1 02 Mar 2011 Change in version numbers only, to reflect the release of CGNS Version 3.1 in Mar, 2011.

Mid-Level Library

    Document
Version
   CGNS
Version
   Date   Change
 
1.0 1.0 Original (undated) HTML version
2.0 2.0, Beta 2 17 Apr 2001 Re-organization and creation of PDF version
2.0.1 2.0, Beta 2 10 Jul 2001 Slanted font for output
2.0.2 2.0, Rev 2 26 Sep 2001 Error fix in description of the donor_datatype argument for Generalized Connectivity functions
2.1 2.0, Rev 3 2 Nov 2001 Changes related to FamilySpecified boundary condition type, cardinality of FamilyBC_t
2.2 2.1, Beta 1 14 Feb 2002 Changes to add user-defined data, chemistry, links
2.2.1 2.1 12 Aug 2002 In the PDF version of the manual, corrected error in the input/output labeling for fn in the cg_open, cg_version, and cg_close routines.
2.2.2 2.1 6 Sep 2002 In the PDF version of the manual, corrected a typo in the definition of "A" in Section 8.1.
2.2.3 2.1, Rev 1 25 Sep 2002 Corrected minor error in syntax of C call for cg_geo_read.
2.2.4 2.1, Rev 1 27 Mar 2003 Modified the description of cg_goto.
2.3 2.2, Beta 1 20 Sep 2002 Updated for consistency with Release 2.2, Beta 1, of the CGNS software.
2.3.1 2.2, Beta 1 25 Sep 2002 Corrected errors in descriptions of cg_geo_read, cg_delete_node, and routines used to read and write rotating coordinates.
2.3.2 2.2, Beta 1 26 Sep 2002 Added some new typedefs in the General Remarks/Typedefs section.
2.3.3 2.2, Beta 2 27 Mar 2003 Modified the description of cg_goto.
2.3.4 2.2 27 Mar 2003 Modified the section on Acquiring the Software and Documentation to reflect the current use of SourceForge for distribution.
2.3.5 2.2 9 Jun 2003 Changed terminology of "Software Release" to "CGNS Version", and added a paragraph explaining the default for a missing CGNSLibraryVersion_t node.
2.3.6 2.2 12 Sep 2003 Corrected a couple of typos in the Grid Connectivity section.
2.3.7 2.3 5 Feb 2004 Modified the description of the routines related to the Boundary Condition Type and Location to reflect the addition of ElementRange and ElementList in the BC_t structure.
2.3.8 2.3 18 May 2004 Fixed a minor error in the definition of Ordinal.
2.3.9 2.3 24 Jan 2005 Corrected an error in the description of the data conversion routines cg_conversion_write and cg_conversion_read.
2.3.10 2.3 23 Aug 2005 Added a paragraph to the description of the function cg_bcdata_write about writing the boundary condition data itself.
2.4 2.4 20 Jun 2005 Updated for consistency with CGNS Version 2.4.
2.4.1 2.4 1 Sep 2005 Minor modifications in the Introduction, General Remarks, Opening and Closing a CGNS File, and Navigating a CGNS File sections, due to the option of using HDF instead of ADF.
2.4.2 2.4 2 Nov 2005 In the description of the Generalized Connectivity routines, clarified the definitions of ndata_donor and donor_data.
2.4.3 2.4 17 Nov 2005 Corrected a couple of typos in the Solution Data section.
2.4.4 2.4 3 Feb 2006 Corrected a typo in the Physical Data/Data Arrays section.
2.4.5 2.4 1 Mar 2006 Corrected a typo where FlowSolutionPointers had been written as FlowSolutionsPointers).
2.4.6 2.4.4 28 July 2006 Changes in the Rind Layers section due to the new capability for rind data with unstructured grids. Also added the functions cg_free and cg_conn_write_short.
2.4.7 2.4.4 5 Sep 2006 Changes in the Zone Information section to clarify the definition of size for unstructured grids.
2.4.8 2.4.4 16 Oct 2006 Corrected an error in the argument list for cg_conn_write_short.
2.4.9 2.4.4 30 Jan 2007 Corrected a minor error, changing the error status names ALL_OK, ERROR, NODE_NOT_FOUND, and INCORRECT_PATH to CG_OK, CG_ERROR, CG_NODE_NOT_FOUND, and CG_INCORRECT_PATH, respectively.
2.5 2.5 17 Jan 2007 New functions to check file validity and configure some internal CGNS library options. Additional functions providing alternate ways to access a node. Changes in the use of functions for partial writes of coordinate element, and solution data. Corrected typo in the data type of the argument data in the function cg_free.
3.0.1 3.0 Beta 17 Jun 2008 In the Typedefs section, added PYRA_13 and NFACE_n to the list of supported key words for ElementType_t.
3.0.2 3.0 Beta 12 May 2009 In the Zone Information description in the "Structural Nodes" section, added a sentence emphasizing that zones must be named alphanumerically to ensure proper retrieval.
3.0.3 3.0 Beta 21 May 2009 In the Accessing a Node description in the "Navigating a CGNS File" section, corrected an error in the syntax for the cg_gopath_f Fortran routine.
3.1.1 3.1 01 Feb 2011 Added new table of Typedef Name Access Functions under General Remarks. Added description of cg_elements_partial_write. Added descriptions of cg_save_as, cg_set_file_type, cg_get_file_type, cg_error_handler, cg_set_compress, cg_get_compress, cg_set_path, and cg_add_path.
3.1.2 3.1 04 Feb 2011 Changed Null to CG_Null and UserDefined to CG_UserDefined, and added comment under General Remarks about their usage.
3.1.3 3.1 23 Feb 2011 Changed references from "int" to "cgsize_t" as appropriate. Added new sections on 64-bit C and Fortran Portability and Issues. Added references to xxxxNull and xxxxUserDefined under Typedefs.
3.1.4 3.1 25 Feb 2011 Moved PYRA_13 in list to come after MIXED in Typedefs. Moved Acquiring the Software and Documentation and Organization of This Manual sections to come first. Minor correction of ParentData in cg_parent_data_write and cg_parent_data_partial_write to no longer be slanted typeface (because it is input type) in Element Connectivity section.
3.1.5 3.1 01 Mar 2011 Added information in File Operations about file_type = CG_FILE_ADF2, which can be used to write a Version 2.5 file from Version 3 when compiled in 32-bit.
3.1.6 3.1 23 Mar 2011 Added cg_boco_gridlocation_read and write functions to Mid-Level Library.

Standard Interface Data Structures

    Document
Version
   CGNS
Version
   Date   Change
 
1.0 1.0 11 Aug 1999 Original (un-numbered) version, labeled as a draft
2.0 1.2 8 Sep 2000 Changes and additions for unstructured zones and geometry-to-mesh association
2.1 2.0, Beta 2 14 Dec 2000 Changes to add time-dependent structures
2.1.1 2.0, Beta 2 22 Feb 2001 Error fixes in description of ArbitraryGridMotion_t
2.1.2 2.0, Beta 2 7 Mar 2001 Clarifications of normal direction for 2-D unstructured grid elements, and for data-name identifiers of components of vector quantities
2.1.3 2.0, Beta 2 14 Mar 2001 Clarifications in descriptions of BaseIterativeData_t and ZoneIterativeData_t structures
2.1.4 2.0, Beta 2 27 Jun 2001 Error fix in Flow Solution example
2.1.5 2.0, Rev 2 26 Sep 2001 Error fix for units of ideal gas constant
2.1.6 2.0, Rev 3 2 Nov 2001 Changes related to FamilySpecified boundary condition type, cardinality of GeometryReference_t
2.1.7 2.0, Rev 4 23 May 2002 Corrected a minor error in the OversetHoles_t structure definition.
2.2 2.1, Beta 1 14 Feb 2002 Changes to add chemistry, user-defined data
2.2.1 2.1, Beta 2 25 Mar 2002 Clarification in Data-Name Identifiers section about where to store forces and moments data
2.2.2 2.1, Beta 3 23 May 2002 Corrected a minor error in the OversetHoles_t structure definition.
2.2.3 2.1 20 Aug 2002 Corrected a minor error in the GeometryReference_t structure definition.
2.2.4 2.1 23 Aug 2002 Fixed a typo in the equations for the lift and drag coefficients in the Conventions for Data-Name Identifiers section.
2.2.5 2.1 25 Sep 2002 In the HTML version, fixed typo in definition of OversetHoles_t data structure.
2.2.6 2.1 22 Jan 2003 Added a paragraph noting that the CGNS SIDS document represents a draft revision of the AIAA Recommended Practice, and made the PDF version of the Recommended Practice available.
2.2.7 2.1 23 Jan 2003 Corrected use of ParentData in the examples of the Elements_t data structure
2.2.8 2.1 20 Mar 2003 Added to the discussion of the ZoneBC_t and BC_t data structures, to clarify some information about BC patches.
2.3 2.2, Beta 1 20 Sep 2002 Updated for consistency with Release 2.2, Beta 1, of the CGNS software.
2.3.1 2.2, Beta 1 25 Sep 2002 In the HTML version, fixed typo in definition of OversetHoles_t data structure.
2.3.2 2.2, Beta 2 22 Jan 2003 Added a paragraph noting that the CGNS SIDS document represents a draft revision of the AIAA Recommended Practice, and made the PDF version of the Recommended Practice available.
2.3.3 2.2, Beta 2 23 Jan 2003 Corrected use of ParentData in the examples of the Elements_t data structure.
2.3.4 2.2, Beta 2 20 Mar 2003 Added to the discussion of the ZoneBC_t and BC_t data structures, to clarify some information about BC patches.
2.3.5 2.2 9 Jun 2003 Changed terminology of "Software Release" to "CGNS Version", and added the section CGNS Version defining it. Also modified the Notes for the GridConnectivity_t node to clarify the allowed GridLocation values.
2.3.6 2.3 5 Feb 2004 Changed the description of the BC_t data structure to reflect the addition of ElementRange and ElementList.
2.3.7 2.3 6 Oct 2004 Added SoundIntensityDB and SoundIntensity to the list of recommended flow solution data-name identifiers.
2.3.8 2.3 20 Oct 2004 Corrected an error in the list of oriented edges for face F4 for pyramid elements, in the Unstructured Grid Element Numbering Conventions section.
2.3.9 2.3 19 Nov 2004 Corrected a spelling typo in the "Deforming Grid Motion" example in the Time-Dependent Flow section.
2.3.10 2.3 24 Jan 2005 Corrected an error in the Elements_t data structure examples.
2.4 2.4 20 Jun 2005 Updated for consistency with CGNS Version 2.4.
2.4.1 2.4 1 Sep 2005 Minor modifications in the Introduction, Conventions, Hierarchical Structures, Multizone Interface Connectivity, and Boundary Conditions sections, due to the option of using HDF instead of ADF.
2.4.2 2.4 18 Oct 2005 Added a couple of sentences in the Multizone Interface Connectivity and Boundary Conditions sections to clarify that a given zone boundary segment is intended to be defined as either a boundary condition segment or a multizone connectivity segment, but not both.
2.4.3 2.4 19 Oct 2005 Modified the description of the use of GridLocation under GridConnectivity_t to clarify its allowed values for different types of interfaces.
2.4.4 2.4 16 Nov 2005 Corrected a minor cross-referencing error in the PDF version of the document.
2.4.5 2.4 15 Dec 2005 Added a paragraph at the start of the Introduction, clarified the description of the RotatingCoordinates_t data structure, and made a few other changes in various places to correct typos and add clarification.
2.4.6 2.4 10 Jan 2006 Corrected a typo in the PDF version of the document involving an escaped underscore.
2.4.7 2.4 1 Mar 2006 Corrected a couple of typos where FlowSolutionPointers had been written as FlowSolutionsPointers).
2.4.8 2.4.4 28 July 2006 Changes to the descriptions and/or components of the following structures due to the new capability for rind data with unstructured grids: Rind_t, GridCoordinates_t, Elements_t, FlowSolution_t, ArbitraryGridMotion_t, DiscreteData_t. Modified the description of the GridConnectivity_t structure due to zone connectivity donor information being optional for generalized multizone interfaces. Added a sentence to the description of the Elements_t structure to clarify the use of the global numbering system.
2.4.9 2.4.4 5 Sep 2006 Modified the description of VertexSize for the Zone_t structure to clarify its definition for unstructured grids. Also modified the description of GridLocation under GridConnectivity_t to allow indices in the receiver zone to be specified at face centers for abutting interfaces.
2.4.10 2.4.4 7 Jan 2007 Corrected an error in the description of the unstructured grid element numbering conventions for pyramid elements.
2.4.11 2.4.4 5 July 2007 Rearranged discussion of the AIAA Recommended Practice version of the SIDS, noting that it's out of date.
2.4.12 2.4.4 11 July 2007 Updated to include information on the newly-released AIAA Recommended Practice R-101A-2005, and made the PDF version of the Recommended Practice available.
2.5 2.5 14 Sep 2007 Change in version numbers to reflect the release of CGNS Version 2.5 in Sep, 2007. Modified the description of the GridConnectivity_t structure to clarify the use of CellListDonor and InterpolantsDonor, and added some examples.
2.5.1 2.5 7 Nov 2007 Modified the description of the TurbulenceModel_t structure to add more detail about the various TurbulenceModelType names.
3.0.1 3.0 Beta 14 May 2008 Added a PYRA_13 element in the description of the unstructured grid element numbering conventions for pyramid elements.
3.0.2 3.0 Beta 19 Jun 2008 Modified the description of the Elements_t structure to incorporate the new definition of the NGON_n element type, and add the NFACE_n element type. Also added examples illustrating their use.
3.0.3 3.0 Beta 11 Sep 2008 In the description of the Elements_t structure, modified the description of how NGON_n and NFACE_n are used to define general polyhedral elements, along with the corresponding example.
3.1.1 3.1 04 Feb 2011 Changed Null to xxxxNull and UserDefined to xxxxUserDefined, as appropriate. Also made sure that the xxxxNull is listed first, and the xxxxUserDefined is listed second.
3.1.2 3.1 23 Feb 2011 Changed description of BCType_t slightly, to clarify the simple and compound types. Added section Model Type Structure Definition. Corrected ModelTypeNull and ModelTypeUserDefined listings (where enumerated values are a subset of the ModelType_t enumeration).

SIDS-to-ADF File Mapping Manual

    Document
Version
   CGNS
Version
   Date   Change
 
1.2.7 1.2 14 Jul 2000 PDF version from CGNS Team
2.0 2.0, Beta 2 22 Feb 2001 Updates for consistency with SIDS
2.0.1 2.0, Rev 1 21 Aug 2001 Error fixes for InwardNormalIndex and GeometryEntity_t
2.0.2 2.0, Rev 2 10 Oct 2001 Error fix for cardinality of FamilyName_t
2.0.3 2.0, Rev 3 2 Nov 2001 Error fixes and clarifications involving families
2.1 2.1, Beta 1 14 Feb 2002 Changes to add user-defined data, chemistry
2.2 2.2, Beta 1 20 Sep 2002 Updated for consistency with Release 2.2, Beta 1, of the CGNS software.
2.2.1 2.2 9 Jun 2003 Changed terminology of "Software Release" to "CGNS Version", and expanded the description of the CGNSLibraryVersion_t node.
2.3 2.3 5 Feb 2004 Modified the BC_t figure to reflect the addition of ElementRange and ElementList.
2.3.1 2.3 2 Jun 2004 Removed some wording inadvertantly left in when the documentation was updated with the release of CGNS Version 2.3.
2.4 2.4 20 Jun 2005 Updated for consistency with CGNS Version 2.4.
2.4.1 2.4 1 Sep 2005 Minor modifications in the Brief Description of CGNS, CGNS Documentation, and Summary Description of ADF sections, due to the option of using HDF instead of ADF.
2.4.2 2.4.4 28 July 2006 Changes to the descriptions of the Rind_t, GridCoordinates_t, and FlowSolution_t nodes, and to the figures for the GridCoordinates_t, Elements_t, and FlowSolution_t nodes due to the new capability for rind data with unstructured grids. In the GridConnectivity node figure, changed the Cardinality of CellListDonor/PointListDonor from "1" to "0,1".
2.5 2.5 14 Sep 2007 Change in version numbers only, to reflect the release of CGNS Version 2.5 in Sep, 2007.
3.1.1 3.1 02 Mar 2011 Change in version numbers only, to reflect the release of CGNS Version 3.1 in Mar, 2011.

SIDS-to-HDF File Mapping Manual

    Document
Version
   CGNS
Version
   Date   Change
 
1.0 2.4 2 Sep 2005 Original version
1.0.1 2.4.4 28 July 2006 Changes to the descriptions of the Rind_t, GridCoordinates_t, and FlowSolution_t nodes, and to the figures for the GridCoordinates_t, Elements_t, and FlowSolution_t nodes due to the new capability for rind data with unstructured grids. In the GridConnectivity node figure, changed the Cardinality of CellListDonor/PointListDonor from "1" to "0,1".
1.1 2.5 14 Sep 2007 Change in version numbers only, to reflect the release of CGNS Version 2.5 in Sep, 2007.
3.1.1 3.1 02 Mar 2011 Change in version numbers only, to reflect the release of CGNS Version 3.1 in Mar, 2011.

SIDS-to-Python File Mapping Manual

    Document
Version
   CGNS
Version
   Date   Change
 
3.1.1 3.1 03 Mar 2011 Original version

Advanced Data Format (ADF) User's Guide

    Document
Version
   Date   Change
 
1.0 7 May 1998 Original version
1.1 15 Mar 2002 Addition of ADF_Read_Block_Data and ADF_Write_Block_Data
1.1.1 13 May 2003 Modified the section on Acquiring the Software and Documentation to reflect the current use of SourceForge for distribution.

CGNS Tools and Utilities

    Document
Version
   Date   Change
 
1.0 20 May 2003 Original version.
1.0.1 30 Nov 2006 Corrected error in table at top of Export Utilities section.
1.0.2 12 Mar 2008 Modified the description of ADF_Edit to note that it's been superseded by the more capable ADFviewer.
2.0 01 Feb 2011 Major update of CGNS tools and utilities, including switch from use of ADFviewer to CGNSview.

Steering Committee Charter

    Document
Version
   Date   Change
 
1.0 23 Jan 2002 Original WWW version
1.1 13 Jan 2004 Updated
1.1.1 19 Nov 2004 Additions to Steering Committee members
1.1.2 26 May 2005 Modified the Organization/Bylaws section to allow appointment of a Vice-Chairperson.
1.1.3 31 Aug 2005 Modified the Background section to to note the addition of the HDF5 option, and changed the license covering the allowed distribution and use of the CGNS software.
1.1.4 17 Jan 2006 Updated (and alphabetized) the list of current member organizations.
1.1.5 27 Mar 2006 Updated the list of current member organizations.
1.1.6 13 Apr 2006 Minor name change in the list of Steering Committee Members.
1.1.7 5 Sep 2006 In the Representation section, updated the list of current member organizations, and added a paragraph about the responsibilities of individual Steering Committee members.
1.1.8 11 Oct 2006 Updated the list of current member organizations.
1.1.9 14 Sep 2007 Updated the list of current member organizations.
1.1.10 9 Oct 2007 Modified the list of current member organizations in the CGNS Steering Committee Charter to reflect a company name change.
1.1.11 14 Jan 2009 Updated the list of current member organizations.
1.1.12 20 May 2009 Deleted the list of current member organizations in the Organization/Bylaws section. This is now available at the CGNS web site.