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 Steering Committee

Meeting Minutes

6 January 2008
7:30 PM Pacific Time
AIAA Aerospace Sciences Meeting, Reno, NV

  1. The meeting was called to order at 7:35 PM. There were 9 attendees (one by telecon), listed below.

  2. The minutes of the 28 November 2007 meeting were approved as posted on the web site.

  3. Steering Committee membership changes, updates, and issues

    1. Thomas Hauser was voted in as the new chair of the CGNS steering committee. This is a 2-year term, through January 2010. Congratulations, Thomas!
    2. We are still looking for a CGNS Steering committee member willing to assume the role of Vice Chair (2-year position).

  4. Status of previous action items

    1. Hauser and Wedan will put V3.0 with parallel HDF-5 capability as an alpha release on SourceForge when ready.
      1. Wedan has put an alpha release of V3.0 on SourceForge (CVS access only). This version has the new PYRA fixes (see Open Items, item (d)), allows the user to choose between ADF, HDF-5, and XML on the fly, and supports NGON_n plus NFACE_n (see item (b) below). The parallel HDF-5 capability is not in it yet. Hauser will add HDF-5 parallel capability to V3.0 on SourceForge CVS and will let users know when it is available.
    2. Allmaras will send Rumsey, Feldman, and Pereira revised face-based proposal for evaluation, comparison with original proposal, and posting on website.
      1. Not done. However, Wedan has implemented the proposal from 1/07 into V3.0 on SourceForge (CVS access only). This is described below. Users are encouraged to look at this method and see if it suits their needs. Rumsey to send Wedan any existing documentation on NGON_n + NFACE_n for modification/addition, then posting.
    3. Rumsey will coordinate bringing the Regions proposal to completion.
      1. Not done yet. This item has been transferred to Allmaras. Allmaras to finalize Regions proposal modification, including proposed additions to FlowSolution, DiscreteData, BC, and BCDataSet and send to Rumsey for posting on website.
      2. There was also discussion regarding potential Boeing involvement in helping the development effort in this regard. Paul, Bussoletti, and Allmaras to look into finding development resources (particularly for MLL implementation) at Boeing.
    4. Rumsey will develop a proposal to handle sprays of unconnected points.
      1. Not done; Rumsey decided he was not enough of an expert on this subject to do it justice. Duque and Hauser to assume lead on new discussion/proposal for handling sprays of unconnected points.
    5. Hann and Hauser will evaluate the capability for writing HDF-5, ADF, or XML in proposed V3.0.
      1. Done for HDF-5 and ADF. Others may also now evaluate by getting V3.0 alpha from Sourceforge (CVS version). Use of XML is available in V3.0 alpha, but there may be issues related to consistency of the XML grammar. Hauser to have further discussions with Poinot on usage of XML and possible need for changes.
    6. Wedan will look into Weinkauf (9/12/07 CGNSTalk) issues regarding automatically closing linked files, problem with unsuccessful opening leaving data structures undefined, issues with MAXIMUM_FILES, and use of relative paths.
      1. Done. These limitations have been fixed. They are currently in the CVS version of V2.5, and will be in the official V2.5.3 when it is released.
    7. Hauser will maintain contact with users interested in parallel HDF-5 capability, and let them know when parallel V3.0alpha version is ready to be tested.
      1. Not done yet. Action item cancelled (absorbed into another action item).
    8. Hauser and Rumsey will contact people in Europe regarding possibility of holding a European CGNS User's Meeting sometime in the future.
      1. Ongoing. Hauser, Rumsey, and Poinot to continue to explore possible CGNS meeting in Europe.
    9. Rumsey will carry several unresolved CGNSTalk issues over to the next meeting: Bussoletti 9/25/07 CGNSTalk), Guzik (10/02/07 CGNSTalk), Miller (10/19/07 CGNSTalk).
      1. Done.

  5. Open items (see number 15 below)

    1. Purpose of open items is to not lose track of long-term issues that come up.
    2. Two new open items added (see Software item (c)).

  6. CGNS short course for AIAA

    1. Originally scheduled for Jan 5-6, 2008 in Reno, NV (just prior to Aerospace Sciences Meeting), but had to be cancelled due to insufficient number of advance registrants. AIAA would like to try again for their Summer 2009 conference.

  7. ISO/STEP

    1. Nothing new to report.

  8. Documentation

    1. Nothing new to report.

  9. Software

    1. Issue of the API forcing a copy of the entire CGNS file temporarily (Bussoletti 9/25/07 CGNSTalk) was discussed. This is an ADFViewer issue (the MLL does a compress when closing, so it is not an issue there). Wedan will add a button to ADFViewer to allow user to compress file after deleting nodes.
    2. Issue from Guzik (10/02/07 CGNSTalk) on the use of cg_configure to avoid the copy. Currently cg_config_compress by default is −1 (only compress if nodes deleted), but it can also be set to 1 (always rewrite) or 0 (never rewrite). Rumsey to check with Towne if documentation is in place for cg_config_compress. Guzik also brought up issues on it being not necessary to delete and rewrite entire node when dimensions are the same, and specific issue regarding dereferencing void. Wedan to investigate issue of MLL deleting the entire node even though its new dimensions are the same. Also, Wedan to investigate type casting of int to void pointer then dereferencing (cg_configure).
    3. Issue of wanting to write info one element at a time to save memory via cg_section_write_f, and issue of possible need for "long" instead of "int" (Miller 10/19/07 CGNSTalk). Issue of writing one element at a time (perhaps using something like cg_section_partialwrite) is somewhat difficult and cannot be addressed in the near-term. This item has been added as an "Open Item." Issue of ints & longs is complicated; many aspects are machine dependent. We may need to define our own datatype to allow for greater than 2 Gig signed limit. This item has also been added as an "Open Item."
    4. Need to change Celcius to Celsius (cgnsKeywords.h, cgnslib.c, cgnslib.h, cgnslib_f.h) (Lecointe 12/5/07 CGNSTalk). Fixed in CVS version 2.5. Will be in V2.5.3 official version when it is released. In V2.5, it will accept either spelling; but in V3.0, it will only accept the correct spelling (Celsius).

  10. HDF-5

    1. Some discussion of HDF-5 linking features (see minutes from November 2007). Poinot to send necessary coding changes for HDF-5 linking to Hauser for implementation into V3.0 alpha version.

  11. Extensions

    1. Covered under Status of Previous Action Items.

  12. Other issues

    1. Rumsey reported on "Accomplishments" and "Concerns" for 2007.
      1. Accomplishments:
        1. Maintenance & Support
          1. 1 new steering committee member added (total=23)
          2. Website moved from ICEM to SourceForge hosting
        2. Evolution
          1. September 2007: official release of Version 2.5 (off beta status)
          2. Fixed HDF5 external links feature (with CGNS mods to be implemented and with a soon-to-be released version of HDF-5)
        3. Acceptance
          1. Latest SIDS finally came out in 2007 in AIAA's Recommended Practice document update: AIAA R-101A-2005
          2. As of Oct 2007, the CGNSTalk mailing list had 223 participants from 20 different countries and 77 different organizations
          3. Over 21,000 CGNS downloads from SourceForge since 2003 (average of 496 per month over the last year)
        4. Answering questions & Exchanging ideas
          1. CGNSTalk has regular postings (137 postings in 2007)
          2. CGNS short course is nearly developed (Alabi, Hauser, Poinot, Wedan, Rumsey) - even though it was cancelled for Jan 2008
      2. Concerns:
        1. Maintenance & Support
          1. We still only have 1 official developer (in his spare time)
        2. Evolution
          1. All recent proposals for extension have been stalled during 2007, either in development or in implementation
          2. Move toward implementation of V3.0 (with parallel HDF-5) has been very slow
        3. Acceptance
          1. CGNS short course for Jan 2008 (through AIAA) had to be cancelled due to lack of minimum required registrants
        4. Answering questions & Exchanging ideas
          1. CGNSTalk postings mostly only answered by a few people; questions sometimes remain unanswered / unresolved for a long time
    2. Rumsey to look into adding back (optional) registration to website when people download CGNS.
    3. Rumsey to respond to some of the CGNSTalk issues that are now closed.
    4. Hauser to look into methods on SourceForge for getting Poinot developer access: switch from CVS to SVN? or use SSL?
    5. Rumsey to notify people about V3.0 alpha.
    6. Wedan to release 2.5.3.
    7. Hauser to speak to Koziol at HDF5 Group about issues related to developers and funding; and also to ask about when their link-fix release will become official.
    8. Wedan to investigate problem with NFS-mounted soft links when re-write file.
    9. Rumsey and Hauser to work out issues on domain name with ANSYS-ICEM.

  13. Meeting was adjourned at 9:15 PM. Next Telecon will be called by Hauser.

  14. Summary of action items:

    1. Hauser will add HDF-5 parallel capability to V3.0 on SourceForge CVS and will let users know when it is available.
    2. Rumsey to send Wedan any existing documentation on NGON_n + NFACE_n for modification/addition, then post.
    3. Allmaras to finalize Regions proposal modification, including proposed additions to FlowSolution, DiscreteData, BC, and BCDataSet and send to Rumsey for posting on website.
    4. Paul, Bussoletti, and Allmaras to look into finding development (particularly for MLL implementation) resources at Boeing.
    5. Duque and Hauser to assume lead on new discussion/proposal for handling sprays of unconnected points.
    6. Hauser to have further discussions with Poinot on usage of XML and possible need for changes.
    7. Hauser, Rumsey, and Poinot to continue to explore possible CGNS meeting in Europe.
    8. Wedan will add a button to ADFViewer to allow user to compress file after deleting nodes.
    9. Rumsey to check with Towne if documentation is in place for cg_config_compress.
    10. Poinot to send necessary coding changes for HDF-5 linking to Hauser for implementation into V3.0 alpha version.
    11. Rumsey to look into adding back (optional) registration to website when people download CGNS.
    12. Rumsey to respond to some of the CGNSTalk issues that are now closed.
    13. Hauser to look into methods on SourceForge for getting Poinot developer access: switch from CVS to SVN? or use SSL?
    14. Rumsey to notify people about V3.0 alpha.
    15. Wedan to release 2.5.3.
    16. Hauser to speak to Koziol at HDF5 Group about issues related to developers and funding; and also to ask about when their link-fix release will become official.
    17. Wedan to investigate problem with NFS-mounted soft links when re-write file.
    18. Wedan to investigate issue of MLL deleting the entire node even though its new dimensions are the same.
    19. Wedan to investigate type casting of int to void pointer then dereferencing (cg_configure).
    20. Rumsey and Hauser to work out issues on domain name with ANSYS-ICEM.

  15. Summary of open items from prior meetings (these are different from action items, in that they are open or unresolved issues that we want to keep track of, but there are no specific actions required of anyone at this point in time):

    1. Keep track of/resolve HDF-5 "to-do" list.
    2. Keep track of progress with ISO/STEP.
    3. Need for official certification process (test for compliance)
    4. Need to make Karman's changes to PYRA elements: change PYRA_14 to PYRA_13, without the centroid, and add PYRA_14 with the base mid-face defined (in software and in SIDS). Need to wait until V3.0 for this due to compatibility issues.
    5. Need to upgrade/update User's Guide as appropriate (such as additional specific examples)
    6. Need to resolve slow behavior and larger file sizes that can occur in CGNS files when there are many (thousands) of nodes.
    7. Develop method to write info one element at a time to save memory via something like cg_section_partialwrite (Miller 10/19/07 CGNSTalk)
    8. Address issue of possible need for "long" instead of "int" to avoid signed 2 Gig limit (Miller 10/19/07 CGNSTalk).

Attendees

   Steve Allmaras    Boeing Commercial
Earl Duque Intelligent Light
Thomas Hauser Utah State
Scott Imlay Tecplot
Steve Karman U Tennessee Chattanooga
Ben Paul Boeing Commercial
Simon Pereira ANSYS / ICEM CFD
Chris Rumsey NASA Langley
Bruce Wedan no affiliation

New NGON_n + NFACE_n Capability

The following is a brief description of the proposed extension for storing arbitrary polyhedral cells. This is implemented in the alpha release of V3.0 (currently available on SourceForge under CVS only).

In it, we redefine NGON_n to be similar to MIXED, but with the element type replaced by the number of nodes for the face. We then eliminate all of the element types NGON_n+1, NGON_n+2, etc. For face-based storage, this requires exactly the same amount of data for the element definitions, since we replace

   type = MIXED;
   Element = NGON_n+nnodes,node1,node2,...
with
   Type = NGON_n
   Element = nnodes,node1,node2,...

With this change, we are free to add new element types. To handle volume cells in a face-based system, we define an element type NFACE_n, which indicates the element set is defined by number of faces, and the face elements.

   Type = NFACE_n
   Element = nfaces,face1,face2,...

This formulation also has the advantage of readily identifying a face-based system, since you only need to check the element set type - if it is NGON_n or NFACE_n, you know it is face-based. We are also able to add new element types in the future as the need arises without breaking any code. Finally, this also involves only changes to the SIDS, not the MLL.

As an example, consider a grid with a single hexahedral cell (one 6-sided cube with eight vertices) in it. To describe this in a face-based manner, the new method would use:

   Name = user-specified1 (Elements_t)
      ElementType = NGON_n
      ElementRange (IndexRange_t) = ElemNo1, ElemNo6
      ElementConnectivity (DataArray_t) = 
         4, face1node1, face1node2, face1node3, face1node4
         4, face2node1, face2node2, face2node3, face2node4
         4, face3node1, face3node2, face3node3, face3node4
         4, face4node1, face4node2, face4node3, face4node4
         4, face5node1, face5node2, face5node3, face5node4
         4, face6node1, face6node2, face6node3, face6node4
   Name = user-specified2 (Elements_t)
   ElementType = NFACE_n
      ElementRange (IndexRange_t) = 1,1
      ElementConnectivity (DataArray_t) = 
         6, ElemNo1, ElemNo2, ElemNo3, ElemNo4, ElemNo5, ElemNo6