Copyright (c) 1998 ICEM CFD Engineering 

CGNS Software Revisions

Version 2.3, Release:  Jan 22 2004

• API:
  • Reimplemented ElementList and ElementRange for boundary conditions.
  • Removed all dependencies on AU1 routines
• ADF:
  • modified ADFI_ASCII_Hex_2_unsigned_int to speed it up.
  • removed buffering of disk block pointer
  • saved last link ID in ADFI_chase_link to speed repeated accesses to link node children.

Version 2.3, Beta:  Sept 28 2003

• API: Rewritten to allow better handling of links and cases containing a large number of zones.
• ADF: added ADF_Children_IDs routine to speed access to node children.

Version 2.2:  May 02 2003 

• Configure:
  • Addition of a configure script to setup SYSTEM type and compiler options
• API:
  • added CGNS_VERSION and CGNS_DOTVERS defines to cgnslib.h and prefixed OK, ERROR, NODE_NOT_FOUND and INCORRECT_PATH with CG_
  • fixed to work under CYGWIN
  • added adfwin_f.h and cgnswin_f.h include files for Windows Fortran.
  • fixed bug in cg_close that was leaving temp files under Windows.
  • removed range checking in cg_boco_write - causes failure when using elements.
  • fixed some inconsistencies between writing and reading a CGNS file.
  • fixed problem with donor pt data size in cg_conn_read.
• ADF:
  • Added Fortran callable C routines to replace the Fortran routines in ADF_fortran.f and ADF_U1_fortran.f. As a result a Fortran compiler is no longer required to compile the library.

Version 2.2 beta 1:  September 23 2002 

• API:  Addition of I/O functions to support the following new features:
  • Delete a node anywhere in the tree
  • Gravity
  • Axisymmetry
  • Rotating Coordinates
  • Wall Function, Periodic and Rotor/Stator
• ADF:
  • Fixed a bug when a link points to a node within the same file (Mark Fisher).
  • Fixed problem of reading data sets over 2GB using ADF_Read_Data and ADF_Write_Data (Mark Fisher).
  • Add "ifdef" in ADF_internals.c and fortran_macros.h for NuTCRACKER Environment on Windows.
  • Fixed a minor bug in the ADF core which caused a Block Offset out of range error (Mark Fisher).
• F77_examples:  Five new test cases to exercise the new API functions:
  • Test_Gravity
  • Test_Axisym
  • Test_RotatingCoordinates
  • Test_BCProperty
  • Test_ConnProperty

Version 2.1 rev 1:  September 23 2002

• API:
  • When reading a newer file (than the API), the error message is "Error: Unable to determine the version number".  This was fixed in this revision.
  • Allow reading file with newer version number, as long as the first digit in the version number is the same.

Version 2.1:  May 24 2002

• API:
  • typecast "strlen" to "int" in comparison statement, in cgi_sort_names.
  • in cgi_write, correct writing of simulation type to save the ADF_id which is required in mode modify
  • cgnslib.c: Add a comma in definition of ModelTypeName
  • Correct indexing error to retrieve memory address pointed to by cg_goto for node types UserDefinedData_t located under the following parents:
    • FlowEquationSet_t/GoverningEquations_t
    • FlowEquationSet_t/xxxModel_t
• ADF: Correct functions ADFI_ID_2_file_block_offset and ADFI_file_block_offset_2_ID to remove the use of "union" to typecast variables.

Version 2.1 Beta 3:  April 30 2002

• API:
  • Correction in the alphanumerical ordering of the zone names.
  • Correct bug where we could jump to the next iteration of a loop and miss initializing the user data count and memory pointer. This was fixed in several places:
    • cgi_read_dataset, cgi_read_discrete, cgi_read_integral, cgi_read_amotion
  • A similar bug, where we could exit with a good status and miss initializing user data, was also fixed in cgi_read_biter and cgi_read_ziter.
  • Change type of cg_get_error from "char" to "char const"
  • Macro "new" and "renew" moved from cgnslib.h to cgns_header.h and renamed CGNS_NEW & CGNS_RENEW.
  • cgns_header.h & cgns_internals.c:  replace "char" with "char const" for functions:
    • cgi_descr_address, cgi_internal_address, cgi_array_address, cgi_model_address, cgi_user_data_address, cgi_new_node, cgi_move_node, cgi_check_strlen, cgi_check_mode, cgi_datatype
  • cgnslib.h & cgnslib.c:   Change variable type from "char *" to "char const *" for all xxxName.  Move the name definition to cgnslib.c
  • Replace data type from "xxx" to "xxx const" for functions:
    • cg_open, cg_base_write, cg_zone_write, cg_family_write, cg_famname_write, cg_fambc_write, cg_geo_write, cg_part_write, cg_grid_write, cg_coord_read, cg_coord_write, cg_section_write, cg_parent_data_write, cg_sol_write, cg_field_write, cg_hole_write, cg_conn_write, cg_1to1_write, cg_boco_write, cg_boco_normal_write, cg_dataset_write, cg_discrete_write, cg_rigid_motion_write, cg_arbitrary_motion_write, cg_biter_write, cg_ziter_write, cg_convergence_write, cg_state_write, cg_diffusion_write, cg_model_write, cg_array_write, cg_user_data_write, cg_integral_write, cg_rind_write, cg_descriptor_write, cg_exponents_write, cg_conversion_write, cg_link_write, cg_get_error
  • Fix backward compatibility problem in mode modify
  • cgnslib.c:   In cg_boco_info, NormalListFlag used to return:
    • 0 -> Normal list not defined
      1 -> Normal list defined
      It now returns:
      0 -> Normal list not defined
      ndata -> Normal list defined
      where ndata is the number of data in the normal list
  • cg_ftoc.c:  Modify functions cg_array_read_as_f, cg_array_read_f and cg_array_write_fon WINNT to use var. arg list, in case character array is passed (therefore adding an extra argument on WINNT)
  • cgnslib_f.h:  Add missing declaration  for FamilySpecified 
• F77_examples:
  • read_cgns_motion.F: add declaration of real*4 version
  • Review all test cases:
  • - Add the following var. arg declaration for WINNT where appropriate:
    • !DEC$ ATTRIBUTES REFERENCE, C, VARYING :: cg_array_write_f
      !DEC$ ATTRIBUTES REFERENCE, C, VARYING :: cg_array_read_as_f
      !DEC$ ATTRIBUTES REFERENCE, C, VARYING :: cg_array_read_f

    - Replace condition statement for NormalListFlag  " if (NormalListFlag .eq. 1) then... " with  " if (NormalListFlag .ne.0) then..."
    - Correct writing or GridLocation_t under BCDataset_t.  Write under BC_t instead.

• ADF:
  • Corrected small typo in ADF_interface.c: "ADF 27: Node as no dimensions.",  <--- 'has'

Version 2.1 Beta 2:  February 27 2002

• API:
  • Incorporate small changes from version 2.0 revision 4.
  • Remove "index" from user defined data array fonctions
• F77_examples:   Small correction made to the Test_chemistry example.

Version 2.1 Beta 1:  February 18 2002

• API:  Addition of I/O functions to support the following new features:
  • User-Defined Data Arrays
  • Linked Nodes
  • Chemistry Data
• ADF:  Correction of inconsistency in the maximum string length allowed to defined links.
• ADF_Edit:
  • Addition of code to print out link information in 'print_the_kids'.
  • The pt command will now report these two link releated ADF errors: LINKED_TO_FILE_NOT_THERE, LINK_TARGET_NOT_THERE
• F77_examples:   Three new test cases to exercise the new API functions:
  • Test_UserDefinedData
  • Test_Links
  • Test_chemistry

Version 2.0 rev 5:  September 23 2002

• API:
  • When reading a newer file (than the API), the error message is "Error: Unable to determine the version number".  This was fixed in this revision.
  • Allow reading file with newer version number, as long as the first digit in the version number is the same.

Version 2.0 rev 4:  January 11 2002

• API:  Added BCType "FamilySpecified".

Version 2.0 rev 3:  October 15 2001

• ADF: Mark Fisher: "I have made a minor enhancement to the core to better handle the difference between 32 bit and 64 bit codes. In general the difference is that pointers and longs changes from 32 bit to 64 bit. Currently the ADF core if it sees any difference in machine type or size it call the read translated routine. This introduces a performance penalty on the IO. If the binary type is the same and only the size is different then the translated routine only needsto be called if the size of the data changes. I changed the ADF core to be smarter and look at the data size. Since most of the data is not I8 or U8 we can avoid any performance penalty when doing IO when reading a file with either 32 or 64 bit libraries on the same binary type."
• API: Fix a bug in GridConnectivity_t where the function cg_narrays wasn't returning the right value.

Version 2.0 rev 2:  August 27 2001

• ADF:  Incorrect version of ADF_internals.c was posted for release V2rev1.
• API:  Fix a bug in BCDataset

Version 2.0 rev 1:  July 27 2001

• ADF:  All error codes were moved from ADF_internals.h to ADF.h
• AU1:  Error codes conflicting with ADF error codes were given the prefix AU1_
• API:  Fix a bug with rind planes

Version 2.0 Beta release2: December 13 2000

• API: The following bugs were corrected in version 2.0 Beta release 2 only
  • In MODE_MODIFY:  FamilyName_t nodes  were incorrectly written
  • API function, cg_array_read_as was not freeing all allocated memory
  • Fix a bug in cg_goto_f
  • Fix a problem when 2 bases of different dimensions were opened at the same time.
• API:  Jan.06.01
  • Allow for R4 or R8 data type for all real data arrays under RigidGridMotion_t, ArbitraryGridMotion_t and BaseIterativeData_t
• ADF_edit: Mar.01.01
  •  A range is requested for non character data only.Fix the bug where a <cr> was supposed to print everything and it ended up printing nothing.
  • Modified the print out of Character data to be the same as the old version of ADF_edit.
  • Fixed the bug where you could not cd to similar nodes.
  • Modified the check in print_tree for a null file name, my Linux compiler did not like i

Version 2.0 Beta release2:  December 1 2000

• API:  The API was extensively modified to allow the definition of grid motion and iterative/time-accurate data
  • New functions to support multiple GridCoordinates_t nodes under any zone
  • New functions to support the node SimulationType_t under CGNSBase_t
  • New functions to support RigidGridMotion_t nodes under any zone
  • New functions to support ArbitraryGridMotion_t nodes under any zone
  • New functions to support the node BaseIterativeData_t under CGNSBase_t
  • New functions to support the node ZoneIterativeData_t under Zone_t

Bug Correction: November 14 2000

• API:  The following bugs were corrected in both version 1.2 and version 2.0 Beta release 1
  • In MODE_MODIFY:  FamilyName_t nodes could not be created
  • In MODE_MODIFY:  Nodes Family_t, GeometryReference_t, UnstructuredDonor_t (version 1.2 only) and Elements_t could not be reached with cg_goto.

Version 2.0 Beta release1:  October 16 2000

• ADF
  • fix bug in links platform portability
  • fix memory leak
  • open linked file in same mode as master file
  • fix problem freeing file pointer & closing a file after a read error.
• API
  • special definition of HUGE for the CRAY
  • compare file version using integer only to avoid  truncation error on the CRAY.
  • change NGONE_n for NGON_n (not backward compatible)
  • Move FamilyName under the data field of FamilyName_t instead of the previous location in the name field
  • Remove StructuredDonor_t and UnstructuredDonor_t from GridConnectivity_t and use same options for both Zonetypes of donor.
  • Move BCDataSet_t/GridLocation_t under BC_t, and remove ElementList and ElementRange under BC_t.  An ElementList can now be defined using PointList+FaceCenter, and an ElementRange with PointRange+FaceCenter.
• ADF_Edit
  • Remove menu option that are not yet supported.

Version 1.2

• Mar 15 2000, revision 0
  •  Add support for MIXED element sections
• Mar 27 2000, revision 1
  • Fix bug introduced is cg_elements_read with version 1.2, rev.0:  Backward compatibility bug when reading a file created with a previous version of library.
• April 15 2000, revision 2
  • Add function cg_ElementDataSize and cg_ElementDataSize_f to obtain the size of the element connectivity table when the ElementType=MIXED
• April 26 2000, revision 3
  • New supported architecture: Linux
• May 17 2000, revision 4
  • New version of the ADF core (version A02011) which is backward compatible but not forward compatible.  Files created with version A02011 of the ADF core can not be read with the previous version of the ADF Core (version A01010).
  • Correct problems when opening an older version file in mode "MODE_MODIFY".
  • Add option to record InwardNormalList on elements when BC patch are defined using ElementRange or ElementList for unstructured zones.
• May 22 2000, revision 5
  • Allow DiscreteData_t to be recorded at GridLocation=FaceCenter or EdgeCenter.
• June 5 2000, revision 6
  • Added check for NAN data in CGNS Library.

Version 1.1

• Jun 1999,  revision 0
  • Add support to unstructured grid and geometry-to-mesh association.
• Sep 1999,  revision 1
  • New supported architecture:  Window NT.
  • Distribute compiled software for both mips4 -n32 and mips4 -64
  • Fix a bug with CGNS Library Version number,  and a couple of errors in the test cases "write_cgns_1.F" and "read_cgns_1.F".
• Dec 15 1999, revision 2
  • Fix a bug in cg_field_write, for unstructured cell centered data only.
• Jan 25 2000, revision 3
  • Fix a bug when calling cg_open for an unstructured model containing cell centered solution data.

Version 1.05

• Nov 1998, revision 0
  • Covers all data structures for multiblock structured analysis.
• Mar 1999,  revision 3
  • Add MODE_MODIFY for multiple paths functions.

Version 1.0

• May 1998, revision 0  First release.
  • Covers the most importants data structures for multiblock structured analysis.

Acknowledgments

The Mid-Level Library was initially developed under a NASA Contract.